Install v131

Installation & Procedure - Installation

Table of ContentsINSTALLATION OF SAMCEF V13.1.............................................................................................................1

Computer Requirements for SAMCEF V13.1.........................................................................................1Supported platforms..........................................................................................................................1Versions "i4" and "i8".......................................................................................................................2Required resources............................................................................................................................2Limitations.........................................................................................................................................3 Graphic Environment.......................................................................................................................3 Distribution media............................................................................................................................3 Documentation.................................................................................................................................3

Licensing Services...................................................................................................................................4Installation on UNIX................................................................................................................................4

Installing with a nodelock license....................................................................................................4Installing with a floating license.......................................................................................................7Updating the license file....................................................................................................................8

Configuration of SAMCEF on UNIX......................................................................................................8SAMCEF Environment.....................................................................................................................8 FLEXlm Licensing...........................................................................................................................9 X-WINDOW Graphic Environment..............................................................................................10 PostScript Printer............................................................................................................................11

Installation on Windows........................................................................................................................11 Preliminary.....................................................................................................................................11Installing with a nodelock license...................................................................................................11Installing with a floating license.....................................................................................................12Updating the license file..................................................................................................................14

Configuration of SAMCEF on Windows..............................................................................................19SAMCEF Environment...................................................................................................................19


i

INSTALLATION OF SAMCEF V13.1Computer 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 Operating system Prerequisite(EXEC)

Prerequisite (LINK)

Note

HP PA-RISC (64-bit) HP-UX 11.00 Fortran Runtime f90 compiler 2.5.3

HP Itanium2 HP-UX 11.22 Fortran Runtime f90 compiler 2.8.5 (1)

IBM power 5 (64-bit) AIX 5.1AIX 5.2AIX 5.3

Fortran Runtime xlfrte8.1.0.2

f90 compiler 8.1.0.0 (2)

IBM power 6 (64-bit) AIX 5.3 Fortran Runtime xlfrte12.1.0.0ESSL 4.3

f90 compiler 12.1.0.0 (2)(3)

Intel Itanium2 Linux Red HatAdvanced Server 3.0

Intel Fortran 8.1.025 (2)

SUN UltraSparc IV(64-bit)

SOLARIS 8SOLARIS 10

Studio 11 FortranCompiler

(2)

x86_32 (Pentium) Windows XP ProWindows Vista

Microsoft .NETframework 2.0 SP1

Visual C++ .NET2005& Intel Fortran 9.1.028

x86_64 (amd64 & em64t) Linux Red Hat AS 4update 4 & SuSE 9.1

Intel Fortran 10.1.011 (2)(3)

x86_64 (amd64 & em64t) Windows XP x64Windows Vista x64

Microsoft .NETframework 2.0 SP1 andMicrosoft Visual C++2005 SP1 RedistributablePackage (x64)

Visual C++ .NET2005& Intel Fortran 9.1.028

(4)

(1) FLEXlm is available on this system, but the FLEXlm server itself must be started on another type ofsystem.(2) Parallel modules MECANO, ASEF and BACON (only a set of BACON commands is parallelized) are

INSTALLATION OF SAMCEF V13.1 1

available on this system. MUMPS sequential and parallel solver is used in module MECANO and ASEF. Thisfeature 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 thesoftware. This package installs runtime components required to run 64-bit application developed with VisualC++ on a computer that does not have Visual C++ 2005 installed. If it is not installed, the following messagemay appear in an error window: "The application failed to initialize properly (0xc0150002). Click OK toterminate the application." Be sure that you download from Microsoft the Service Pack 1, which versionnumber is 8.0.50727.762.

It is possible to customize SAMCEF by integrating user's routines. Templates for user's function, element andmaterial 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 tablegives 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" versionuses 32-bit integers and it is limited to 8 GB (gigabyte) of memory. The "i8" version uses 64-bit integers andit 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 largermodels, the "i8" version becomes attractive. Since the required memory is larger with the "i8" version thanwith the "i4" version, it is recommended to install the "i8" version on systems with 16 GB or more. Due totheir different types of integers, the "i4" and "i8" versions are not binary compatible, except for some fileswith the following extensions: .sam, .sdb, .adb, .des and .fac. The command .F48 in module POSTFACallows to convert a "i4" .u18 file to a "i8" one. The superelements created with a standard version, present orolder, 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 ofSAMCEF.

Platform Exec directory Object libraries DocumentationHP PA-RISC HP-UX 240 120 100

HP Itanium2 HP-UX 440 180 100

IBM Aix 300 70 100

Itanium2 Linux 500 130 100

SUN Solaris 320 90 100

x86_32 Windows 200 200 100

x86_64 Linux 300 100 100

x86_64 Windows 250 270 100


Supported platforms 2

http://www.microsoft.com/downloads/details.aspx?familyid=EB4EBE2D-33C0-4A47-9DD4-B9A6D7BD44DA&displaylang=en

b) To run SAMCEF

Disk Storage Capacity and Random Access Memory that are required to run SAMCEF depend on the type ofanalyses and on the size of models. Recommended swap is about 3 times the RAM. Table below givesminimal and recommended requirements. The given values are only indicative and should be adapted toanalyses and models.

Platform RAM (min) RAM(recommended) DISK (min) DISK

(recommended)x86_32 (Windows) 512 MB 2 GB 20 GB 100 GB

Other ("i4" versions) 2 GB 8 GB or more 20 GB 100 GB

Other ("i8" versions) 8 GB 16 GB or more 20 GB 100 GB

Limitations

In SAMCEF, there is a theoretical limit for the maximum memory allocated during an execution. Thecorresponding 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 thesystem resources allow it.

Platform SAM_ZONE

x86_32 (Windows) 180 000 000 to 210 000 000(depends on the service packs)

Other ("i4" versions) 800 000 000

Other ("i8" versions) > 1 000 000 000 (depends on theavailable physical memory)

Graphic Environment

X-Window is the standard graphic interface on all UNIX workstations. SAMCEF applications needrelease 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+ orMozilla Firefox or Netscape 6+). A search engine is available on Windows. It is located on the CD in thefolder \Dochtml\afsearch. The product AFSearch is freely distributed by SAMTECH within itsown products. It may not be sold as a standalone application. Distribution right does not pass to users otherthan SAMTECH. The search engine is delivered with a predefined index, but user may customize it in orderto search in multiple HTML documentations. Just double-click on application afsearch.exe and choose


Required resources 3

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, STABIand REPDYN with a limited number of nodes (300) and for a limited duration. This file is namedSAMCEF.CLE and it is located into the installation directory. To run SAMCEF in accordance with yourlicense agreement, you need to install a regular license file, named SAMTECH.LIC. Regular license files areprovided directly by SAMTECH Liège (Belgium). These files are text files and must be transferredfrom one computer to another with an ASCII file transfer protocol (ftp). To obtain information on licensefile, mail to [email protected].

SAMCEF licensing is powered by FLEXlm license manager on all platforms. FLEXlm is marketed byAcresso 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 limitednumber of CPU's, floating license authorizes limited number of simultaneous accesses to SAMCEF on anyCPU of a UNIX/WINDOWS network. Access rights may vary from one SAMCEF module to an other. Afloating 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 thecomputer on which the license server will be installed. The host identifier is a string identifying uniquely thiscomputer. The host identifier is to be communicated to SAMTECH in order to receive a valid license file. Toget 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 isproper to SAMTECH products and it is unique to all the products of SAMTECH. Before installing a FLEXlmserver 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. Fromnow, the installation directory is supposed to be/home/Samv131.


Documentation 4

mailto:[email protected]

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. Devicenames are given as examples. If necessary, adapt the syntax to your system

OperatingSystem

Mount command

HP-UX mount -rF cdfs -o cdcase /dev/dsk/c1t2d0/cdrom

IBM AIX mount -prv cdrfs /dev/cd0 /cdrom

Linux Automatic mounting

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

Operating System Installation instructionsSUN SOLARIS /cdrom/cdrom0/readme.txt

Linux /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 ofthe 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 haveto select : Nodelock Flexlm uncounted license.

After completing the installation of SAMCEF, you will have to copy a license file provided bySAMTECH 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


Installing with a nodelock license 5

SGI IRIX eject /CDROM

SUN SOLARIS eject cdrom0

Linux eject /mnt/cdrom

Other Unix systems umount /cdromRemarks:

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 canmount 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 theinstallation directory (/home/Samv131). This file contains the description of 3 useful environmentvariables 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 thesite administrator in order to tune SAMCEF's default behavior. See the pages about SAMCEF variables formore information.

Step 7: Adapt the user environment

The SAMCEF software is designed to be able to run without any environment variabledefinition in the .cshrc or .login files. To start execution, simply type the name of theSAMCEF 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. Environmentvariables are however still accepted, e.g. for tuning a particular session, and overwrite thedefaults . 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 theprocedure.

Thus, users of earlier versions should remove their SAMCEF environment definition fromtheir .cshrc file.

Step 8: Install the nodelock license

At this stage you are able to run of modules ASEF, DYNAM, STABI and REPDYN with alimited number of nodes (300) and for a limited duration.



In order to obtain the regular license according to your license agreement it is necessary tosend to [email protected] the hostid of your Unix system. To obtain easily thisinformation 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 FLEXLmhost ID of this machine is … .

When you have received from SAMTECH your license file SAMTECH.LIC for version 13.1, simply copy itto the installation directory. Make sure that SAMCEF users have a read-access to this file. If you do not haveyour 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 ofthe 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 haveto 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 bySAMTECH 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, hostid,...)

♦

... 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


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 thelicense 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. Checkin this file that FLEXlm server has correctly started

♦

After installation, the license file used by FLEXlm is found in the subdirectory license of the FLEXlminstallation directory. The initial license file that you have copied to your disk can be deleted to avoid futureconfusion.

Updating the license file

a) Nodelock license

If you have received from SAMTECH your new license file SAMTECH.LIC for version13.1, simply copy it to the SAMCEF installation directory, replacing the existing file. Thisfile is text file and must be transferred from one computer to another with an ASCII filetransfer protocol (ftp). Make sure that SAMCEF users have a read-access to this file. If youdo 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 version13.1, simply copy it to the FLEXlm installation subdirectory license, replacing theexisting file. This file is text file and must be transferred from one computer to anotherwith an ASCII file transfer protocol (ftp). Make sure the FLEXlm server is running. Usethe 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 theprocedure sequentially

by examining the site defaults definition (site configuration file samrc.ini in theinstallation directory);

♦

by examining the user defaults definition (user configuration file samrc.ini in thehome directory);

♦

by examining the environment (this way is provided for compatibility and should beavoided);

♦

by taking into account user's requirements inside the procedure.♦ The main SAMCEF variables are the following:


Updating the license file 8

VARIABLE MEANING

SAM_EXEThis variable is always automatically defined as the location of theprocedure. It describes the directory containing the SAMCEF modules. Itcan not be modified by the user.

SAM_SAMPROC

This variable is always automatically defined as$SAM_EXE/samcef.proc. It describes allocation file. It can not bemodified by the user. For advanced users, to modify file allocations, userather SAM_USERPROC.

SAM_LANG Language used (vfr for French, van for English).

SAM_ZONEAvailable memory workspace (in 8-bytes words). The required workspacedepends 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 fileSAMTECH.LIC exists in the installation directory of SAMCEF, then SAMCEF modules useFLEXlm licensing. Otherwise, they use SAMTECH licensing (with SAMCEF.CLE). If bothare found, the environment variable takes priority over the license file found in theinstallation 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 serversare used, the syntax is "@hostname1:@hostname2:@hostname3". Be aware that onWindows, colons (:) must be replaced by semicolons (;). This setting is automatically done bythe procedure samcef which executes the file site located in the installation directory ofSAMCEF. The license file itself is in the FLEXlm subdirectory license.

For nodelock license, the license file SAMTECH.LIC must be copied to the installationdirectory of SAMCEF (in /home/Samv131 for example).

Note: in the procedure samcef, the name of the installation directory of SAMCEF is writtenin the environment variable SAM_EXE.

Utilities

Several FLEXlm utilities are copied to the FLEXlm installation directory for SAMTECHproducts. Most of them are administration tools. Some are useful for the user and have beenembedded in the procedure samcef. The table below describes those utilities.

Name Category Description samceflicense

user Returns information about currentserver activity and available tokens. - For a nodelock license, themessage is:


SAMCEF Environment 9

'No SERVER lines inlicense file' - If the installation does not useFLEXlm licensing, the message is: 'Error Impossible tolist license'.

samcef hostid user

Returns the host id of yourcomputer, as expected by FLEXlm.Useful for checking host id for anodelock license.

samcef host userReturns the operating system ofyour computer and the SAMCEFdistribution installed on it.

flexlm_start administrator Manually starts the server

flexlm_stop administrator Stops the server

flexlm_reread administrator Rereads the license fileIn addition, a log file is created in the FLEXlm directory. This file collects activity of theFLEXlm 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 givennumber of tokens, in the range of available tokens. Accesses are granted by modules. It isthen possible to attribute a given number of tokens for a given module. To do so, create a filenamed 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 (otherRESERVE 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 thescreen defined via the DISPLAY environment variable. To define this variable, refer to the X-Window UserManuals 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

DISPLAY=alpha:0.0;export DISPLAYDepending on the system configuration, the following message may appear when using graphics window withBACON:

Can't open display

This possibly comes from protection features provided by the server access control program xhost. Forfurther 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 thePostScript 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 islocated 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 yoursamrc.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 ofthe product, you will be required to install the licensing service too. It is highly recommended to read thelicensing chapter before starting installation.

Installing with a nodelock license

a) Installing the software


X-WINDOW Graphic Environment 11

These steps must be carried out with the administrator privileges.

Insert the CD into your CD drive1. Select your CD device in the file manager, and run the Setup program2. Click on [NEXT] in InstallShield (Welcome Screen)3. Read the license agreement ([YES] to continue)4. Take a moment to read the Readme file ([NEXT] to continue)5. Select the components to be installed and choose the Destination Folder ([BROWSE] to change,[NEXT] to continue)

6.

Choose the SAM_WORK path ([BROWSE] to change, [NEXT] to continue). This path specifies thefolder where SAMCEF saves its files when running

7.

Wait until all components are copied to your disk8. SAMCEF is installed.9.

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. Thisfile contains the name and identification of your PC. This file must be sent to SAMTECH by e-mail([email protected]). Quit the FLEXlm Setup program by selecting the toggle 'Flexlm will be installedlater'.

When you receive back the license file SAMTECH.LIC, copy it to your disk and run again the FLEXlmSetup on CD to complete the installation.

You enter in FLEXlm Setup program and the installation of FLEXlm starts. Next steps are specific to thisinstallation and require administrator privileges.

To install a nodelock license, you need a valid license file ([NEXT] to continue)1. Select the appropriate type of installation- Nodelock install : to install a nodelock license file on your PC

2.

Enter the place where the license file SAMTECH.LIC is located. This file is then copied to thefolder \Program files\Samtech\Flexlm and the installation of FLEXlm can go along.

3.

License is installed4.

The Setup program defines the environment variable SAMTECH_LICENSE_FILE as thepath to the license file.

Installing with a floating license

a) Installing the software

These steps are identical to those of the preceding paragraph. They must be carried out withthe administrator privileges.

Insert the CD into your CD drive1. Select your CD device in the file manager, and run the Setup program2. Click on [NEXT] in Install Shield (Welcome Screen)3. Read the license agreement ([YES] to continue)4. Take a moment to read the Readme file ([NEXT] to continue)5.




Select the components to be installed and choose the Destination Folder ([BROWSE] to change,[NEXT] to continue)

6.

Choose the SAM_WORK path ([BROWSE] to change, [NEXT] to continue). This path specifies thefolder where SAMCEF saves its files when running

7.

Wait until all components are copied to your disk8. SAMCEF is installed.9.

At this stage you are able to run of modules ASEF, DYNAM, STABI and REPDYN with a limited number ofnodes (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. Inboth cases, select the option 'Flexlm' in the SAMCEF Setup program. If you use a remote server, give thename of the remote host. Otherwise, you are prompted to give the location of the license file on your PC. Thename 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. Thisfile contains the name and identification of your PC. This file must be sent to SAMTECH by e-mail([email protected]). Quit the FLEXlm Setup program by selecting the toggle 'Flexlm will be installedlater'.

When you receive back the license file SAMTECH.LIC, copy it to your disk and run again the FLEXlmSetup on CD to complete the installation :

You enter in FLEXlm Setup program and the installation of FLEXlm starts. Next steps are specific to thisinstallation and require administrator privileges

To install a license server on your PC, you need a valid license file ([NEXT] to continue)1. Select the appropriate type of installation- Server install : to install a license server on your PC

2.

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.

3.

Once installed, the server is automatically configured as a service and started.4. License is installed5.

... or connect to an existing FLEXlm server

Run the FLEXlm Setup program. Next steps are specific to this installation.

Select the appropriate type of installation- Client install : to connect to an existent license server for SAMTECH products

1.

Enter the name of the host where the FLEXlm license server is already running2. License is installed3.

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 isexpected to run. When 3 redundant servers are used, the syntax is"@hostname1;@hostname2;@hostname3". Be aware that on Unix, semicolons (;) must be replaced bycolons (:).


Installing with a floating license 13


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 theremote host.

b) Update using FLEXlm utilities

Several FLEXlm utilities are copied to the FLEXlm installation directory for SAMTECHproducts. For the 32-bit Windows platforms, program LMTOOLS program is provided. Youcan run this program from the Start menu (Start >> Samtech >> Flexlm). With LMTOOLS,you can start, stop and configure FLEXlm license servers, get system information, includinghostids, get server status, and more. LMTOOLS v7+ has two modes in which to configure alicense server:

Configuration Using License File

Operations are performed on a particular license file. In this mode, you cannot start the lmgrdprocess, 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. Thisservice 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:



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



When configuring a service, a license file is selected (similar to Configuration using LicenseFile), but in addition, locations for lmgrd and the debug log file are specified, the service isgiven a unique name. It is also recommended to indicate that the service should be startedwith system boot. The debug log file collects activity of the FLEXlm server. LMTOOLSallows you to read this file and then to monitor your licensing.

Once the license file SAMTECH.LIC is modified in folder \ProgramFiles\Samtech\Flexlm, it becomes active only after it has been reread. This operationis automatically performed when following the update procedure as described above. To do itmanually, use the "Start/Stop/Reread" tab:

c) Troubleshooting

After installing a new SAMTECH.LIC license file, there is no more license for a given SAMTECHapplication.

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 INCREMENTline, with the correct version number and expiration date. A higher version number givesaccess to all the previous lower versions. If you have questions about the content of thelicense file, contact Samtech sales services.

If the license file is correct, check that the environment variableSAMTECH_LICENSE_FILE gives the name of the host where the FLEXlm license file isinstalled.



If the given SAMTECH application was protected with a SAMCEF.CLE license file, it isnecessary to transfer the contents of this file in the FLEXlm license file. It is not allowed tohave one part of the product licenses in a SAMCEF.CLE file and the other part in aSAMTECH.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 recommendedwhen using a Unix FLEXlm server with a Windows application ; in that case, the port numberis 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 environmentvariable 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 \ProgramFiles\samtech\flexlm, on the host where the server is installed. To become active, the licensefile must be read by the server. The file is automatically read at Windows start when FLEXlmserver is installed as a service (by default, recommended). It can be read manually withLMTOOLS, clicking 'Reread License File' in the 'Start/Stop/Reread' tab. FLEXlm LMTOOLS isfound in SAMTECH Program Group. It is also find in the folder \ProgramFiles\samtech\flexlm.

How to authorise FLEXlm in the Windows XP Firewall ?

Connection to the FLEXlm license server can be refused when Windows Firewall is presenton the server. System administrators should proceed as follows to enable floating licenseswith Windows Firewall:

Stop FLEXlm:1. 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.◊ In the Windows Start Menu, choose 'Control Panel' and then 'Security Center'.2. Click on the Windows Firewall applet.3. Select the 'General' tab and make sure 'On (recommended)' is selected and the checkbox 'Don't allow exceptions' is off.

4.

Select the 'Exceptions' tab and choose 'Add Program'.5. Choose 'Browse' and navigate to \Program Files\samtech\flexlm.6. Select lmgrd.exe, choose 'Open', and then click on 'OK' to add lmgrd.exe to the listof Programs and Services.

7.

With the 'Exceptions' tab of the Windows Firewall applet still active, again choose'Add Program'

8.

Choose 'Browse' and navigate to \Program Files\samtech\flexlm.9.



Select samtech.exe, choose 'Open', and then choose 'OK' to add samtech.exe to thelist of Programs and Services.

10.

Choose 'OK' to close Windows Firewall.11. Start FLEXlm:12.

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 after45 minutes. To free a locked license you may also follow the procedure below :

Open a Command Prompt Window and go to the FLEXlm directory:

> C:> cd \Program Files\samtech\flexlm

1.

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 barand select Properties. In the layout tab, you may change the screen buffer size. Aheight of 300 lines is generally large enough.

2.

Locate the license to remove in the output list and note the corresponding feature,host, port and handle

3.

Remove the license

> lmutil lmremove -h feature host port handle

4.

Example:

To remove the following license (as output by lmstat) :

"MECANO_STRUCTURE" v13.01, vendor: SAMTECHfloating 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 displayis "/dev/tty", the FLEXlm server host is "newton", the corresponding port is "27009" and thefeature handle is "806".



Configuration of SAMCEF on Windows

SAMCEF Environment

SAMCEF modules must be run in a suited SAMCEF environment. The latter is built by the proceduresequentially

by examining the site defaults definition (configuration file samrc.ini inC:\SAMCEFV13.1-xy\Exec);

•

by examining the user defaults definition (configuration file samrc.ini in \Document andsettings\user);

•

by taking into account user's requirements inside the procedure.•

The main SAMCEF variables are the following:

VARIABLE MEANING

SAM_EXEThis variable is always automatically defined as the location of the procedure. Itdescribes the directory containing the SAMCEF modules. It can not be modified by theuser.

SAM_SAMPROCThis variable is always automatically defined as $SAM_EXE/samcef.proc. Itdescribes allocation file. It can not be modified by the user. For advanced users, tomodify file allocations, use rather SAM_USERPROC.

SAM_LANG Language used (vfr for French, van for English).

SAM_ZONEAvailable memory workspace (in 8-bytes words). The required workspace dependsupon the size of the problems to be processed.

SAM_WORKPath to the folder where SAMCEF runs. It corresponds with the 'Start in' field of theshortcut.

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


Documents

Install v131