Installation & Procedure - Installation

Installation & Procedure - Installation

Table of Contents
INSTALLATION OF SAMCEF V13.1 .............................................................................................................1 Computer Requirements for SAMCEF V13.1.........................................................................................1 Supported platforms..........................................................................................................................1 Versions "i4" and "i8".......................................................................................................................2 Required resources............................................................................................................................2 Limitations .........................................................................................................................................3 Graphic Environment.......................................................................................................................3 Distribution media............................................................................................................................3 Documentation.................................................................................................................................3 Licensing Services...................................................................................................................................4 Installation on UNIX ................................................................................................................................4 Installing with a nodelock license....................................................................................................4 Installing with a floating license.......................................................................................................7 Updating the license file....................................................................................................................8 Configuration of SAMCEF on UNIX......................................................................................................8 SAMCEF Environment.....................................................................................................................8 FLEXlm Licensing...........................................................................................................................9 X-WINDOW Graphic Environment..............................................................................................10 PostScript Printer ............................................................................................................................11 Installation on Windows........................................................................................................................11 Preliminary.....................................................................................................................................11 Installing with a nodelock license...................................................................................................11 Installing with a floating license.....................................................................................................12 Updating the license file..................................................................................................................14 Configuration of SAMCEF on Windows..............................................................................................19 SAMCEF Environment...................................................................................................................19

INSTALLATION OF SAMCEF V13.1

Computer Requirements Licensing Services Installation on UNIX Installing with a nodelock license Installing with a floating license Updating the license file Configuration of SAMCEF on UNIX Installation on Windows Installing with a nodelock license Installing with a floating license Updating the license file Configuration of SAMCEF on Windows

Computer Requirements for SAMCEF V13.1

Supported platforms
Computer HP PA-RISC (64-bit) HP Itanium2 IBM power 5 (64-bit) Operating system HP-UX 11.00 HP-UX 11.22 AIX 5.1 AIX 5.2 AIX 5.3 AIX 5.3 Prerequisite (EXEC) Fortran Runtime Fortran Runtime Fortran Runtime xlfrte 8.1.0.2 Fortran Runtime xlfrte 12.1.0.0 ESSL 4.3 Prerequisite (LINK) f90 compiler 2.5.3 f90 compiler 2.8.5 f90 compiler 8.1.0.0 (1) (2) Note

IBM power 6 (64-bit)

f90 compiler 12.1.0.0

(2) (3) (2) (2)

Intel Itanium2 SUN UltraSparc IV (64-bit) x86_32 (Pentium)

Linux Red Hat Advanced Server 3.0 SOLARIS 8 SOLARIS 10 Windows XP Pro Windows Vista Microsoft .NET framework 2.0 SP1

Intel Fortran 8.1.025 Studio 11 Fortran Compiler Visual C++ .NET 2005 & Intel Fortran 9.1.028 Intel Fortran 10.1.011

x86_64 (amd64 & em64t) Linux Red Hat AS 4 update 4 & SuSE 9.1 x86_64 (amd64 & em64t) Windows XP x64 Windows Vista x64

(2) (3)

Microsoft .NET Visual C++ .NET (4) framework 2.0 SP1 and 2005 Microsoft Visual C++ & Intel Fortran 9.1.028 2005 SP1 Redistributable Package (x64) (1) FLEXlm is available on this system, but the FLEXlm server itself must be started on another type of system. (2) Parallel modules MECANO, ASEF and BACON (only a set of BACON commands is parallelized) are INSTALLATION OF SAMCEF V13.1 1

Installation & Procedure - Installation available on this system. MUMPS sequential and parallel solver is used in module MECANO and ASEF. This feature requires specific licenses. Other requirements that are platform dependent are detailed here. (3) A version "i8" is available on this platform. (4) Microsoft Visual C++ 2005 SP1 Redistributable Package (x64) must be installed before running the software. This package installs runtime components required to run 64-bit application developed with Visual C++ on a computer that does not have Visual C++ 2005 installed. If it is not installed, the following message may appear in an error window: "The application failed to initialize properly (0xc0150002). Click OK to terminate the application." Be sure that you download from Microsoft the Service Pack 1, which version number is 8.0.50727.762. It is possible to customize SAMCEF by integrating user's routines. Templates for user's function, element and material are provided in the documentation. Creating a user module requires a Fortran compiler is installed. The compiler version corresponds generally to the operating system version, except for IBM. The above table gives separately the prerequisite licenses to run SAMCEF and to link user modules.

Versions "i4" and "i8"

On platforms IBM Aix (power 6) and x86_64 Linux, two versions of SAMCEF are proposed to be installed: the "i4" version and the "i8" version. These versions differs by the maximum integer size. The "i4" version uses 32-bit integers and it is limited to 8 GB (gigabyte) of memory. The "i8" version uses 64-bit integers and it is practically limited to 16 TB (terabyte). All the SAMCEF versions older than 13.0-05 were " i4" versions. The "i4" version is adapted to Finite Element models up to a few millions degrees of freedom. For larger models, the "i8" version becomes attractive. Since the required memory is larger with the "i8" version than with the "i4" version, it is recommended to install the "i8" version on systems with 16 GB or more. Due to their different types of integers, the "i4" and "i8" versions are not binary compatible, except for some files with the following extensions: .sam, .sdb, .adb, .des and .fac. The command .F48 in module POSTFAC allows to convert a "i4" .u18 file to a "i8" one. The superelements created with a standard version, present or older, can be read with a "i8" version.

Required resources
a) To install SAMCEF Table below gives disk storage capacity (in MBytes) that is required to install different components of SAMCEF. Platform HP PA-RISC HP-UX HP Itanium2 HP-UX IBM Aix Itanium2 Linux SUN Solaris x86_32 Windows x86_64 Linux x86_64 Windows Exec directory 240 440 300 500 320 200 300 250 Object libraries 120 180 70 130 90 200 100 270 Documentation 100 100 100 100 100 100 100 100

Supported platforms

Installation & Procedure - Installation b) To run SAMCEF Disk Storage Capacity and Random Access Memory that are required to run SAMCEF depend on the type of analyses and on the size of models. Recommended swap is about 3 times the RAM. Table below gives minimal and recommended requirements. The given values are only indicative and should be adapted to analyses and models. Platform x86_32 (Windows) RAM (min) 512 MB RAM (recommended) 2 GB 8 GB or more 16 GB or more DISK (min) 20 GB 20 GB 20 GB DISK (recommended) 100 GB 100 GB 100 GB

Other ("i4" versions) 2 GB Other ("i8" versions) 8 GB

Limitations
In SAMCEF, there is a theoretical limit for the maximum memory allocated during an execution. The corresponding upper bound for the environment variable SAM_ZONE is given in double precision words (8-byte words) in the table below. This limit is theoretical in the sense that it can be approached only if the system resources allow it. Platform x86_32 (Windows) Other ("i4" versions) Other ("i8" versions) SAM_ZONE 180 000 000 to 210 000 000 (depends on the service packs) 800 000 000 > 1 000 000 000 (depends on the available physical memory)

Graphic Environment
X-Window is the standard graphic interface on all UNIX workstations. SAMCEF applications need release 5 of X11 driver. To use the Menu Driven Interfaces, minimal requested release of Motif is 1.2.3 on UNIX. A 3-button mouse is required.

Distribution media
DVD-ROM is the distribution media on all systems. There are: 1 DVD for Linux and Unix systems; 1 DVD for Windows systems (x86_32 and x86_64).

Documentation
On-line documentation is in HTML format and requires a HTML browser to be read (Internet Explorer 6+ or Mozilla Firefox or Netscape 6+). A search engine is available on Windows. It is located on the CD in the folder \Dochtml\afsearch. The product AFSearch is freely distributed by SAMTECH within its own products. It may not be sold as a standalone application. Distribution right does not pass to users other than SAMTECH. The search engine is delivered with a predefined index, but user may customize it in order to search in multiple HTML documentations. Just double-click on application afsearch.exe and choose Required resources 3

Installation & Procedure - Installation Quick Start topic in the Help menu.

Licensing Services
SAMCEF DVD's contain a start-up license file which authorizes the run of modules ASEF, DYNAM, STABI and REPDYN with a limited number of nodes (300) and for a limited duration. This file is named SAMCEF.CLE and it is located into the installation directory. To run SAMCEF in accordance with your license agreement, you need to install a regular license file, named SAMTECH.LIC. Regular license files are provided directly by SAMTECH Lige (Belgium). These files are text files and must be transferred from one computer to another with an ASCII file transfer protocol (ftp). To obtain information on license file, mail to keyfile@samcef.com. SAMCEF licensing is powered by FLEXlm license manager on all platforms. FLEXlm is marketed by Acresso under the name FLEXnet Publisher. The installation procedure on the distribution DVD makes it possible to install FLEXlm licensing service. There are two types of licenses: nodelock license authorizes uncounted accesses to SAMCEF on a limited number of CPU's, floating license authorizes limited number of simultaneous accesses to SAMCEF on any CPU of a UNIX/WINDOWS network. Access rights may vary from one SAMCEF module to an other. A floating license file is recognizable by the server lines it contains. Example: # Server lines # ------------ SERVER pcsamcef 00131a4b9fd4 VENDOR SAMTECH /usr/local/flexlm USE_SERVER The keyword SERVER is followed by a host name and by a host identifier. The host name is the name of the computer on which the license server will be installed. The host identifier is a string identifying uniquely this computer. The host identifier is to be communicated to SAMTECH in order to receive a valid license file. To get the host identifier refer to the installation procedure below. Nodelock license requires only that a valid license file is written in the SAMCEF installation directory. Floating license requires that a FLEXlm server is installed on any node of the network. This FLEXlm server is proper to SAMTECH products and it is unique to all the products of SAMTECH. Before installing a FLEXlm server for SAMTECH products, make sure that such a server is not already running.

Installation on UNIX
Installing with a nodelock license
During the installation of the product, you will be required to install the licensing service too. Step 1: Initialize the mount process Choose a system with CD drive and log on as a superuser (username root). If the directory /cdrom does not exist, create it (not necessary on SUN): mkdir /cdrom Make sure you have you must have write access to the target installation directory. From now, the installation directory is supposed to be /home/Samv131.

Documentation

Installation & Procedure - Installation Step 2: Mount the CD drive Insert the SAMCEF UNIX CD-ROM into the drive. Then proceed to the mount operation. This operation is host dependent. The table below gives typical mount commands. Device names are given as examples. If necessary, adapt the syntax to your system Operating System HP-UX IBM AIX Linux Mount command mount -rF cdfs -o cdcase /dev/dsk/c1t2d0 /cdrom mount -prv cdrfs /dev/cd0 /cdrom Automatic mounting

SUN SOLARIS Automatic mounting Present installation instructions can be found in the file readme.txt on the CD-ROM. This file is located in different directories, depending on the operating system.

Operating System SUN SOLARIS Linux

Installation instructions /cdrom/cdrom0/readme.txt /mnt/cdrom/readme.txt

Other Unix systems /cdrom/readme.txt Step 3: Change the working directory to the cdrom file system on SUN: cd /cdrom/cdrom0 on Linux: cd /mnt/cdrom on other: cd /cdrom Step 4: Start the installation of SAMCEF Type the following command: ./v131_inst.csh and reply to the successive prompts of the procedure. The procedure allows the installation of SAMCEF and of a FLEXlm server. Start with the installation of SAMCEF. After the prompt 'What type of license do you use ?', you have to select : Flexlm SAMTECH.LIC After the prompt 'What type of Flexlm license do you have ?', you have to select : Nodelock Flexlm uncounted license. After completing the installation of SAMCEF, you will have to copy a license file provided by SAMTECH into the installation directory (see Step 8 below). Step 5: Dismount the CD drive After installation, the CD drive can be dismounted using the appropriate command. Operating System Dismount command 5

Installing with a nodelock license

Installation & Procedure - Installation SGI IRIX SUN SOLARIS Linux Other Unix systems Remarks: eject /CDROM eject cdrom0 eject /mnt/cdrom umount /cdrom

On Linux, dismount operation requires to be 'root' user. The target architecture is automatically detected. If you want to share the SAMCEF installation on multiple platform with the same architecture you can mount by NFS the installation directory or duplicate this directory on the other platform. Step 6: Define the SAMCEF Environment Variables The installation procedure generates automatically a file named samrc.ini located in the installation directory (/home/Samv131). This file contains the description of 3 useful environment variables defining the default language the default print queue the location of the documentation These variables are default variables for the site. Some other variables can possibly be added to this file by the site administrator in order to tune SAMCEF's default behavior. See the pages about SAMCEF variables for more information. Step 7: Adapt the user environment The SAMCEF software is designed to be able to run without any environment variable definition in the .cshrc or .login files. To start execution, simply type the name of the SAMCEF procedure. For example: /home/Samv131/samcef (Access to SAMCEF gives full information on the subject) Site and user defaults are located in the site and user samrc.ini files. Environment variables are however still accepted, e.g. for tuning a particular session, and overwrite the defaults . It is the reason why it is not advised to keep environment definition in the .cshrc file, because it would hinder the user from managing his environment through the procedure. Thus, users of earlier versions should remove their SAMCEF environment definition from their .cshrc file. Step 8: Install the nodelock license At this stage you are able to run of modules ASEF, DYNAM, STABI and REPDYN with a limited number of nodes (300) and for a limited duration.

Installing with a nodelock license

Installation & Procedure - Installation In order to obtain the regular license according to your license agreement it is necessary to send to keyfile@samcef.com the hostid of your Unix system. To obtain easily this information you can launch Samcef with the hostid command. For example : /home/Samv131/samcef hostid It will return the information : lmhostid Copyright 1989-2001 Globetrotter Software, Inc. The FLEXLm host ID of this machine is . When you have received from SAMTECH your license file SAMTECH.LIC for version 13.1, simply copy it to the installation directory. Make sure that SAMCEF users have a read-access to this file. If you do not have your license file, contact your SAMCEF distributor.

Installing with a floating license

Steps 1 to 3: same as above Step 4: Start the installation of SAMCEF Type the following command: ./v131_inst.csh and reply to the successive prompts of the procedure. The procedure allows the installation of SAMCEF and of a FLEXlm server. Start with the installation of SAMCEF. After the prompt 'What type of license do you use ?', you have to select : Flexlm SAMTECH.LIC After the prompt 'What type of Flexlm license do you have ?', you have to select : Floating Flexlm license using tokens. After the prompt 'What is the hostname of your license server ?', you have to enter the hostname of the computer on which the FLEXlm server provided by SAMTECH is running or will run (if not yet installed). Steps 5 to 7: same as above Step 8: Install the FLEXlm server provided by SAMTECH ... either you do not have a valid license file SAMTECH.LIC Log on the host where FLEXlm server will be installed Mount SAMCEF CD Run the installation procedure ./v131_inst.csh Choose the topic 'Install Flexlm v10.8.5 licensing system' To the question 'Do you have a Flexlm license file', answer 'n'. Send to SAMTECH the information displayed at procedure stop (host name, host id,...) ... or you have a valid license file SAMTECH.LIC Log on the host where FLEXlm server will be installed Make sure you have copied the license file to your disk Installing with a floating license 7

Installation & Procedure - Installation Mount SAMCEF CD Run the installation procedure ./v131_inst.csh Choose the topic 'Install Flexlm v10.8.5 licensing system' To the question 'Do you have a Flexlm license file', answer 'y'. At procedure prompt, give the name of the directory where you have copied the license file At procedure prompt, give a pathname where to install FLEXlm files. A log file SAMTECH.log is created in the installation directory of FLEXlm. Check in this file that FLEXlm server has correctly started After installation, the license file used by FLEXlm is found in the subdirectory license of the FLEXlm installation directory. The initial license file that you have copied to your disk can be deleted to avoid future confusion.

Updating the license file

a) Nodelock license If you have received from SAMTECH your new license file SAMTECH.LIC for version 13.1, simply copy it to the SAMCEF installation directory, replacing the existing file. This file is text file and must be transferred from one computer to another with an ASCII file transfer protocol (ftp). Make sure that SAMCEF users have a read-access to this file. If you do not have your license file, contact your SAMCEF distributor. b) Floating license If you have received from SAMTECH your new license file SAMTECH.LIC for version 13.1, simply copy it to the FLEXlm installation subdirectory license, replacing the existing file. This file is text file and must be transferred from one computer to another with an ASCII file transfer protocol (ftp). Make sure the FLEXlm server is running. Use the flexlm_reread utility to reread the license file. If you do not have your license file, contact your SAMCEF distributor.

Configuration of SAMCEF on UNIX

SAMCEF Environment
SAMCEF modules must be run in a suited SAMCEF environment. The latter is built by the procedure sequentially by examining the site defaults definition (site configuration file samrc.ini in the installation directory); by examining the user defaults definition (user configuration file samrc.ini in the home directory); by examining the environment (this way is provided for compatibility and should be avoided); by taking into account user's requirements inside the procedure. The main SAMCEF variables are the following:

Updating the license file

Installation & Procedure - Installation VARIABLE SAM_EXE MEANING This variable is always automatically defined as the location of the procedure. It describes the directory containing the SAMCEF modules. It can not be modified by the user.

This variable is always automatically defined as $SAM_EXE/samcef.proc. It describes allocation file. It can not be SAM_SAMPROC modified by the user. For advanced users, to modify file allocations, use rather SAM_USERPROC. SAM_LANG SAM_ZONE Language used (vfr for French, van for English). Available memory workspace (in 8-bytes words). The required workspace depends upon the size of the problems to be processed. The command "samcef lis" lets you check the values assigned to each of these variables.

FLEXlm Licensing
How it works If the environment variable SAMTECH_LICENSE_FILE is defined, or if the file SAMTECH.LIC exists in the installation directory of SAMCEF, then SAMCEF modules use FLEXlm licensing. Otherwise, they use SAMTECH licensing (with SAMCEF.CLE). If both are found, the environment variable takes priority over the license file found in the installation directory of SAMCEF. For floating license, SAMTECH_LICENSE_FILE must be set to "@hostname", hostname being the name of the host where the FLEXlm server is installed. When 3 servers are used, the syntax is "@hostname1:@hostname2:@hostname3". Be aware that on Windows, colons (:) must be replaced by semicolons (;). This setting is automatically done by the procedure samcef which executes the file site located in the installation directory of SAMCEF. The license file itself is in the FLEXlm subdirectory license. For nodelock license, the license file SAMTECH.LIC must be copied to the installation directory of SAMCEF (in /home/Samv131 for example). Note: in the procedure samcef, the name of the installation directory of SAMCEF is written in the environment variable SAM_EXE. Utilities Several FLEXlm utilities are copied to the FLEXlm installation directory for SAMTECH products. Most of them are administration tools. Some are useful for the user and have been embedded in the procedure samcef. The table below describes those utilities. Name samcef license Category user Description Returns information about current server activity and available tokens. - For a nodelock license, the message is: 9

SAMCEF Environment

Installation & Procedure - Installation 'No SERVER lines in license file' - If the installation does not use FLEXlm licensing, the message is: 'Error Impossible to list license'. samcef hostid user Returns the host id of your computer, as expected by FLEXlm. Useful for checking host id for a nodelock license. Returns the operating system of your computer and the SAMCEF distribution installed on it.

samcef host flexlm_start flexlm_stop

user

administrator Manually starts the server administrator Stops the server

flexlm_reread administrator Rereads the license file In addition, a log file is created in the FLEXlm directory. This file collects activity of the FLEXlm server. Analyzing events in this file allows you to monitor your licensing. Users' Groups With FLEXlm, it is possible to define groups of users and to allocate to these groups a given number of tokens, in the range of available tokens. Accesses are granted by modules. It is then possible to attribute a given number of tokens for a given module. To do so, create a file named SAMTECH.opt in the subdirectory license, with the following contents: GROUP group_name list_of_users (other GROUP definitions) RESERVE number_of_tokens module_name GROUP group_name (other RESERVE statements) Users' names must be separated by one blank, module names must spell as in the license file, only one module per line.

X-WINDOW Graphic Environment

As for any other X-Window tool, the BACON or POSTFAC graphics window will be directed towards the screen defined via the DISPLAY environment variable. To define this variable, refer to the X-Window User Manuals supplied with your workstation. Here is the general command to be executed before running SAMCEF if the host name is alpha. Under C-shell

setenv DISPLAY alpha:0.0 Under K-shell

FLEXlm Licensing

10

Installation & Procedure - Installation DISPLAY=alpha:0.0;export DISPLAY Depending on the system configuration, the following message may appear when using graphics window with BACON: Can't open display This possibly comes from protection features provided by the server access control program xhost. For further details about security and X-Window environment, refer to the section entitled DRIVER X-WINDOW, Specific Features.

PostScript Printer
The command PLOT of BACON module allows to interactively print PostScript files. The access to the PostScript driver is optional and requires an authorization code (see your license).

To print a PostScript file, BACON starts a specific procedure named plotprint. The file plotprint is located in the directory SAM_EXE. By default, the print command is the following (Unix, System V): lp -s -w -c -dprinterdevice filename The name of the printer (printerdevice) is defined by the environment variable SAM_PLOTQUEUENAME On BSD Unix systems, the print command must be modified. A possible alternative is the following: % lpr -Pprinterdevice filename If your printer spooler uses the BSD system, define the SAM_SPOOLER variable to BSD in your samrc.ini file by adding this line: sam*spooler: BSD

Installation on Windows
Preliminary
For installing SAMCEF on Windows, many points require administrator privileges. During the installation of the product, you will be required to install the licensing service too. It is highly recommended to read the licensing chapter before starting installation.

Installing with a nodelock license

a) Installing the software X-WINDOW Graphic Environment 11

Installation & Procedure - Installation These steps must be carried out with the administrator privileges. 1. Insert the CD into your CD drive 2. Select your CD device in the file manager, and run the Setup program 3. Click on [NEXT] in InstallShield (Welcome Screen) 4. Read the license agreement ([YES] to continue) 5. Take a moment to read the Readme file ([NEXT] to continue) 6. Select the components to be installed and choose the Destination Folder ([BROWSE] to change, [NEXT] to continue) 7. Choose the SAM_WORK path ([BROWSE] to change, [NEXT] to continue). This path specifies the folder where SAMCEF saves its files when running 8. Wait until all components are copied to your disk 9. SAMCEF is installed. When files are copied, a new program group is created. At this stage you are able to run of modules ASEF, DYNAM, STABI and REPDYN with a limited number of nodes (300) and for a limited duration. b) Installing the license Run the FLEXlm Setup program in order to create a file named MAILME.TXT into the FLEXlm folder. This file contains the name and identification of your PC. This file must be sent to SAMTECH by e-mail (keyfile@samcef.com). Quit the FLEXlm Setup program by selecting the toggle 'Flexlm will be installed later'. When you receive back the license file SAMTECH.LIC, copy it to your disk and run again the FLEXlm Setup on CD to complete the installation. You enter in FLEXlm Setup program and the installation of FLEXlm starts. Next steps are specific to this installation and require administrator privileges. 1. To install a nodelock license, you need a valid license file ([NEXT] to continue) 2. Select the appropriate type of installation - Nodelock install : to install a nodelock license file on your PC 3. Enter the place where the license file SAMTECH.LIC is located. This file is then copied to the folder \Program files\Samtech\Flexlm and the installation of FLEXlm can go along. 4. License is installed The Setup program defines the environment variable path to the license file. SAMTECH_LICENSE_FILE as the

Installing with a floating license

a) Installing the software These steps are identical to those of the preceding paragraph. They must be carried out with the administrator privileges. 1. Insert the CD into your CD drive 2. Select your CD device in the file manager, and run the Setup program 3. Click on [NEXT] in Install Shield (Welcome Screen) 4. Read the license agreement ([YES] to continue) 5. Take a moment to read the Readme file ([NEXT] to continue) Installing with a nodelock license 12

Installation & Procedure - Installation 6. Select the components to be installed and choose the Destination Folder ([BROWSE] to change, [NEXT] to continue) 7. Choose the SAM_WORK path ([BROWSE] to change, [NEXT] to continue). This path specifies the folder where SAMCEF saves its files when running 8. Wait until all components are copied to your disk 9. SAMCEF is installed. At this stage you are able to run of modules ASEF, DYNAM, STABI and REPDYN with a limited number of nodes (300) and for a limited duration. b) Installing the license It is possible to install a FLEXlm server locally on your PC, or to use an existing remote FLEXlm server. In both cases, select the option 'Flexlm' in the SAMCEF Setup program. If you use a remote server, give the name of the remote host. Otherwise, you are prompted to give the location of the license file on your PC. The name of the license file is SAMTECH.LIC . ... either Install a FLEXlm server locally on your PC Run the FLEXlm Setup program in order to create a file named MAILME.TXT into the FLEXlm folder. This file contains the name and identification of your PC. This file must be sent to SAMTECH by e-mail (keyfile@samcef.com). Quit the FLEXlm Setup program by selecting the toggle 'Flexlm will be installed later'. When you receive back the license file SAMTECH.LIC, copy it to your disk and run again the FLEXlm Setup on CD to complete the installation : You enter in FLEXlm Setup program and the installation of FLEXlm starts. Next steps are specific to this installation and require administrator privileges 1. To install a license server on your PC, you need a valid license file ([NEXT] to continue) 2. Select the appropriate type of installation - Server install : to install a license server on your PC 3. Enter the place where the license file SAMTECH.LIC is located. This file is then copied to the folder \Program files\Samtech\Flexlm and the installation of FLEXlm can go along. 4. Once installed, the server is automatically configured as a service and started. 5. License is installed ... or connect to an existing FLEXlm server Run the FLEXlm Setup program. Next steps are specific to this installation. 1. Select the appropriate type of installation - Client install : to connect to an existent license server for SAMTECH products 2. Enter the name of the host where the FLEXlm license server is already running 3. License is installed In either case, the Setup program defines the environment variable SAMTECH_LICENSE_FILE as @hostname, hostname being the name of the host where the FLEXlm server for SAMTECH products is expected to run. When 3 redundant servers are used, the syntax is "@hostname1;@hostname2;@hostname3". Be aware that on Unix, semicolons (;) must be replaced by colons (:). Installing with a floating license 13

Installation & Procedure - Installation

Updating the license file

a) Update using "Add/Remove Programs" When receiving a new SAMTECH.LIC file for Windows, proceed as follows: Log on as administrator and copy the file to your PC Choose 'Control Panel' in the 'Start > Settings' menu and double-click on 'Add/Remove Programs' Choose 'Samtech Flexlm' in the scroll list and click on 'Change' Select the 'Modify' option and click on 'Next>' Select the 'Server' or 'Nodelock license' install and click on 'Next>' Choose to replace the existing file Enter the location of the file and click on 'OK' Click on 'Finish' to end the procedure. If you are connected to a remote FLEXlm server, the license update must be done on the remote host. b) Update using FLEXlm utilities Several FLEXlm utilities are copied to the FLEXlm installation directory for SAMTECH products. For the 32-bit Windows platforms, program LMTOOLS program is provided. You can run this program from the Start menu (Start >> Samtech >> Flexlm). With LMTOOLS, you can start, stop and configure FLEXlm license servers, get system information, including hostids, get server status, and more. LMTOOLS v7+ has two modes in which to configure a license server: Configuration Using License File Operations are performed on a particular license file. In this mode, you cannot start the lmgrd process, but you can do everything else. In the first tab, you need to select a license file. Configuration Using Services (default) Operations are performed on a Windows Service, which allows starting lmgrd processes. This service is configured automatically during the installation. If manual operation is required, proceed as follows. In the first tab, you need to select a service, as in the following example:

Updating the license file

14

Installation & Procedure - Installation

Then use the "Configure Services" tab to define a license service:

Updating the license file

15

Installation & Procedure - Installation When configuring a service, a license file is selected (similar to Configuration using License File), but in addition, locations for lmgrd and the debug log file are specified, the service is given a unique name. It is also recommended to indicate that the service should be started with system boot. The debug log file collects activity of the FLEXlm server. LMTOOLS allows you to read this file and then to monitor your licensing. Once the license file SAMTECH.LIC is modified in folder \Program Files\Samtech\Flexlm, it becomes active only after it has been reread. This operation is automatically performed when following the update procedure as described above. To do it manually, use the "Start/Stop/Reread" tab:

c) Troubleshooting After installing a new SAMTECH.LIC license file, there is no more license for a given SAMTECH application. Make sure that the newly installed license file is active by checking which license file is used (see below). Check that the new SAMTECH.LIC contains a corresponding FEATURE or INCREMENT line, with the correct version number and expiration date. A higher version number gives access to all the previous lower versions. If you have questions about the content of the license file, contact Samtech sales services. If the license file is correct, check that the environment variable SAMTECH_LICENSE_FILE gives the name of the host where the FLEXlm license file is installed. Updating the license file 16

Installation & Procedure - Installation If the given SAMTECH application was protected with a SAMCEF.CLE license file, it is necessary to transfer the contents of this file in the FLEXlm license file. It is not allowed to have one part of the product licenses in a SAMCEF.CLE file and the other part in a SAMTECH.LIC file. Which FLEXlm server is in use ? The name of the FLEXlm server is given by the environment variable SAMTECH_LICENSE_FILE . The name has the form [port number]@hostname. Port number is optional, but recommended when using a Unix FLEXlm server with a Windows application ; in that case, the port number is usually 27009, so the complete server name would be, for instance, 27009@theunixmachine. Which license file is in use ? For a nodelock license, the name of the license file in use is given by the environment variable SAMTECH_LICENSE_FILE . For a client-server license, the name of the server is given by the same environment variable SAMTECH_LICENSE_FILE . The license file is to be found in the folder \Program Files\samtech\flexlm, on the host where the server is installed. To become active, the license file must be read by the server. The file is automatically read at Windows start when FLEXlm server is installed as a service (by default, recommended). It can be read manually with LMTOOLS, clicking 'Reread License File' in the 'Start/Stop/Reread' tab. FLEXlm LMTOOLS is found in SAMTECH Program Group. It is also find in the folder \Program Files\samtech\flexlm. How to authorise FLEXlm in the Windows XP Firewall ? Connection to the FLEXlm license server can be refused when Windows Firewall is present on the server. System administrators should proceed as follows to enable floating licenses with Windows Firewall: 1. Stop FLEXlm: In the Windows Start Menu, choose 'All Programs', then 'Samtech', then 'Flexlm' and start the program FLEXlm Tools; In the 'Start/Stop/Reread' tab, click Stop Server. 2. In the Windows Start Menu, choose 'Control Panel' and then 'Security Center'. 3. Click on the Windows Firewall applet. 4. Select the 'General' tab and make sure 'On (recommended)' is selected and the check box 'Don't allow exceptions' is off. 5. Select the 'Exceptions' tab and choose 'Add Program'. 6. Choose 'Browse' and navigate to \Program Files\samtech\flexlm. 7. Select lmgrd.exe, choose 'Open', and then click on 'OK' to add lmgrd.exe to the list of Programs and Services. 8. With the 'Exceptions' tab of the Windows Firewall applet still active, again choose 'Add Program' 9. Choose 'Browse' and navigate to \Program Files\samtech\flexlm.

Updating the license file

17

Installation & Procedure - Installation 10. Select samtech.exe, choose 'Open', and then choose 'OK' to add samtech.exe to the list of Programs and Services. 11. Choose 'OK' to close Windows Firewall. 12. Start FLEXlm: In the Windows Start Menu, choose 'All Programs', then 'Samtech', then 'Flexlm' and start the program FLEXlm Tools; In the 'Start/Stop/Reread' tab, click Start Server. Clients should now be able to check out a license. How to free a license after the client application dies ? If the application dies for any reason and a license remains locked, it is normally freed after 45 minutes. To free a locked license you may also follow the procedure below : 1. Open a Command Prompt Window and go to the FLEXlm directory: > C: > cd \Program Files\samtech\flexlm 2. Perform a license status (make sure the screen buffer height is enough) > lmutil lmstat -a Note: to adjust the screen buffer height, click (right button) on the window title bar and select Properties. In the layout tab, you may change the screen buffer size. A height of 300 lines is generally large enough. 3. Locate the license to remove in the output list and note the corresponding feature, host, port and handle 4. Remove the license > lmutil lmremove -h feature host port handle Example: To remove the following license (as output by lmstat) : "MECANO_STRUCTURE" v13.01, vendor: SAMTECH floating license peter alpha.buytsoft.com /dev/tty (v9.0) (newton/27009 806), start Thu 2/19 14:17 You must type the following command : > lmutil lmremove -h mecano_structure newton 27009 806 In this example, the user is "peter", the computer he uses is "alpha.buytsoft.com", his display is "/dev/tty", the FLEXlm server host is "newton", the corresponding port is "27009" and the feature handle is "806".

Updating the license file

18

Installation & Procedure - Installation

Configuration of SAMCEF on Windows

SAMCEF Environment
SAMCEF modules must be run in a suited SAMCEF environment. The latter is built by the procedure sequentially by examining the site defaults definition (configuration file samrc.ini in C:\SAMCEFV13.1-xy\Exec); by examining the user defaults definition (configuration file samrc.ini in \Document and settings\user); by taking into account user's requirements inside the procedure. The main SAMCEF variables are the following:

VARIABLE SAM_EXE

MEANING This variable is always automatically defined as the location of the procedure. It describes the directory containing the SAMCEF modules. It can not be modified by the user. This variable is always automatically defined as $SAM_EXE/samcef.proc. It describes allocation file. It can not be modified by the user. For advanced users, to modify file allocations, use rather SAM_USERPROC. Language used (vfr for French, van for English). Available memory workspace (in 8-bytes words). The required workspace depends upon the size of the problems to be processed. Path to the folder where SAMCEF runs. It corresponds with the 'Start in' field of the shortcut.

SAM_SAMPROC SAM_LANG SAM_ZONE SAM_WORK

SAM_USETMPDIR Force the BACON module works in the folder defined by SAM_WORK.

Copyright 2009 SAMTECH. All rights reserved.

Last update: 28-Jul-2009

If you have any suggestions or comments, please e-mail to the Webmaster

Configuration of SAMCEF on Windows

19