Professional Documents
Culture Documents
Va One Installation and Licensing Guide
Va One Installation and Licensing Guide
VA One 2013
The documents and related know-how herein provided by ESI Group subject to contractual conditions are to remain confidential. The CLIENT shall not disclose the documentation and/or related know-how in whole or in part to any third party without the prior written permission of ESI Group.
July 2013
UM/VA1_/13/02/00/A
CONTENTS
INTRODUCTION 1
General --------------------------------------------------------------------------------------- 1 Organization -------------------------------------------------------------------------------- 2 Getting Help & Technical Support ----------------------------------------------------- 3 Additional Sources of Information ----------------------------------------------------- 4 Media Contents ---------------------------------------------------------------------------- 5
SYSTEM REQUIREMENTS
INSTALLATION
Windows ------------------------------------------------------------------------------------- 9
Installing VA One --------------------------------------------------------------------------9 Configuration ----------------------------------------------------------------------------- 13 Uninstalling VA One -------------------------------------------------------------------- 13
LINUX --------------------------------------------------------------------------------------- 15
Installing VA One using the Compressed TAR Archive ------------------------ 15 Installing VA One using the RPM Package --------------------------------------- 16 Configuration ----------------------------------------------------------------------------- 17 Uninstalling VA One using the RPM Package ------------------------------------ 18 Additional Information on RPM ------------------------------------------------------- 18 Verifying the Installation of VA One ------------------------------------------------- 19
STANDALONE LICENSES
21
FLOATING LICENSES
23
Windows Client Workstation Setup ------------------------------------------------- 23 UNIX Client Workstation Setup ------------------------------------------------------ 25
Bourne-like Shells ----------------------------------------------------------------------- 25 C-Shells------------------------------------------------------------------------------------ 25
CONTENTS
ii
Borrowing ---------------------------------------------------------------------------------- 48
Command Line --------------------------------------------------------------------------- 48 License Manager ------------------------------------------------------------------------ 51
TROUBLESHOOTING
53
CONTENTS
INTRODUCTION
GENERAL
This guide provided by ESI Group, describes the installation and licensing procedures of VA One and its optional modules (i.e. Foam, etc.) on supported Windows and Linux platforms. The procedures used to control the end-user usage of these software applications are FlexNet license-controlled through either standalone or network floating type licenses. It is important that you have received a license file before following the license installation and setup procedures provided in this guide. If you have not yet received a license file, contact your local sales representative or ESI Group.
INTRODUCTION General
ORGANIZATION
The Media Contents chapter lists the contents of the software package shipped by ESI Group. The System Requirements chapter discusses the system requirements necessary to optimize the performance of VA One on Windows and Linux workstations. The chapter also lists the system requirements necessary for Windows and UNIX based server machines. The Installation chapter gives instructions on the installation and un-installation procedures of VA One on a Windows based platform and a Linux workstation. The Standalone Licenses chapter pertains to the workstation setup necessary to run VA One with a standalone license issued by ESI Group. The Floating Licenses chapter discusses the client workstation setup and server setup related to floating licenses issued by ESI Group. The sections dealing with server setup contain instructions for both Windows and UNIX based platforms. This section also discusses the license borrowing functionality provided within VA One. The Troubleshooting chapter provides answers to some commonly encountered installation and run-time problems associated with VA One and the FlexNet license manager. This chapter addresses problems related to all supported license configurations.
INTRODUCTION Organization
For further documentation on how to set up, use, and manage a FlexNet license manager, refer to the Flexera Software website at http://www.flexerasoftware.com/support.htm.
MEDIA CONTENTS
The VA One software package for Windows workstations shipped by ESI Group contains the following items: 1. One DVD containing: VA One 2013 software executables (32 and 64 bit) VA One 2013 Linux batch solver (64 bit) VA One 2013 CATIA v5 Import Plug-in (32 and 64 bit)1 VA One 2013 Validation and QA files VA One 2013 Installation & Licensing Guide VA One 2013 Release Notes.
2. A printed copy of the VA One 2013 Release Notes. Depending on licensing arrangements, the package may also contain additional DVDs and printed manuals for the optional modules available for use with VA One.
SYSTEM REQUIREMENTS
CLIENT/STANDALONE WORKSTATIONS
Windows
IBM-compatible PC with Intel Pentium 4 (or later) or equivalent AMD processor Windows XP Professional (SP3), Windows XP Professional x64 Edition, Windows Vista, Windows Vista x64 Edition, Windows 7 or Windows 7 x64 Edition2. Minimum of 2 GB RAM for 32bit version; 4+ GB RAM for 64bit version Minimum of 1.7 GB available disk space Ethernet network interface card 3D graphic acceleration card supporting OpenGL version 2.1 and higher3 Monitor capable of 16-bit/Hi-color display at 1024x768 resolution DVD-ROM, Mouse and Keyboard
Linux 64
Intel 64 or AMD64 processor Minimum 4 GB RAM GLIBC version 2.5 or greater Red Hat Enterprise 5 WS or Fedora 6
2 3
To properly view VA One dialogs in Windows 7, the display theme must be set to Windows 7 Basic. ESI recommends installing the latest graphics drivers from the vendors website.
LICENSE SERVERS
Windows
Windows XP Service Pack 3 Windows Server 2003 x86 edition Windows Vista (for FLEXnet server version v11.11) Windows 7 (for FLEXnet server version v11.11)
Linux
Linux i686 2.1 (for RedHat 6.2) Linux i686 2.2 (for RedHat 7.x & 8 or SuSE 8.x) Linux i686 2.3 (for RedHat 9 or RHEL 3 & 4 or SuSE 9.x & 10.0 or Fedora Core 3) Linux ia64 2.2 (for SuSE 10.1 & 10.2) Linux x86 64 2.3 (for RHEL 5 or Fedora Core 6)
HP-UX
HP-UX 11.00 HP-UX 11.22
SUN
SunOS 5.8
SGI
IRIX64 6.5 IRIX6.5
MISC
AIX 4.3 OSF1 V5.1
INSTALLATION
WINDOWS
Installing VA One
This section details the standard installation procedure for both the 32 and 64 bit versions of VA One. The 32-bit version of VA One should not be installed on 64-bit machines. It is recommended, that you have Administrator privileges when installing the software. To complete the installation simply following the instructions in the dialogs presented by the installation program. For a more detailed explanation of this process, refer to the text below. 1. Insert the VA One DVD into the disc drive. The installation program for the 64 bit version of VA One will run automatically. In order to install the 32 bit version of VA One cancel this automatic installation and run the 32 bit installer directly from the DVD. If the installation program does not start automatically, open a Windows Explorer window, click on the DVD drive icon, and double-click on the VAOne2013-32bit.msi or VAOne2013-64bit.msi program. 2. The InstallShield Wizard dialog is displayed and begins extracting all the files necessary for the VA One installation. This operation may take several minutes. The dialogs of the 32 and 64 bit installers are very similar. The following steps use dialogs for the 64 bit installation, but can be easily adapted to the 32 bit installation. 3. After the necessary files are extracted the following dialog appears. Read the instructions on this dialog and click the Next > button. The installation can be cancelled at any time during the process, by simply clicking the Cancel button located at the bottom right corner of the installation dialog.
INSTALLATION Windows
10
4. The next dialog will display a License Agreement. In order to continue with the installation, the I accept the terms in the license agreement radio button must be selected. When the button is selected, the Next > button will become active.
5. The next dialog is used to specify the installation directory. The default Destination Folder path is shown in this dialog next to the folder icon. To specify another location, click the Change button next to the default path. When the destination location of the installation is correct, click the Next > button.
INSTALLATION Windows
11
6. Now the program is ready to install. To modify the installation destination location, use the < Back button to return to the previous dialog and make the relevant changes. Click the Install button to begin the installation.
7. The installation program will install all necessary files and directories associated with the VA One software. A dialog will appear displaying information about the status of the setup operation. This step of the setup process may take several minutes.
INSTALLATION Windows
12
8. When the setup is complete the following dialog is displayed. Click the Finish button to exit the installation VA One 2013 64bit Installation Wizard.
The installation of VA One is now complete. A shortcut for running VA One was added to the Start > All Programs menu in the ESI Group > VA One 2013 folder. The installation program also creates a temp folder on the system drive, c:\ESI\TEMP, for use by the BEM and PEM solvers. This directory is utilized by an environment
INSTALLATION Windows
13
variable, DIRCTY, which is set by the installer. The directory can be modified through this environment variable, but the name of the directory can not contain any spaces. VA One runs in conjunction with a license file provided by ESI Group. Refer to the licensing sections of this document for instructions on how to access the license file and run VA One. Depending on the status of your license, you should now be able to run VA One.
Configuration
A number of environment variables exist for use with VA One that enable advanced users to modify how memory is managed. OS_AS_SIZE controls the maximum amount of address space used by VA One on
32-bit systems. The default value for this variable is 2GB. The VA One installer does not automatically set this variable to override the default. If this value is not set correctly an ObjectStore error will occur on VA One startup for machines using 32bit Windows operating systems due to the limitations of the 32-bit address space. Please refer to the Troubleshooting: Installation & Start-Up section of this document for instructions on setting this variable. OS_CACHE_SIZE defines the memory reserved for the object cache. The object
cache ensures that frequently used objects can be accessed quickly (rather than being stored in a location that is slower to access). On Windows this cache resides in shared memory. Memory is only taken for the cache when needed, however larger values can improve performance when working with big databases. The default value of this variable is 4 GB (4000000000) on 64-bit machines or 25% of the available RAM, whichever is smaller. On machines with limited memory this value may need to be set to a smaller value. This value may also need to be decreased when running multiple instances of VA One on the same machine. Symptoms that indicate this parameter may need to be adjusted are that subsequent instances of VA One fail to launch or hang at launch as VA One cannot reserve memory for the additional object cache.
Uninstalling VA One
The following section uses dialogs for uninstalling the 64 bit version of VA One, but they can be easily adapted to the 32 bit version. It is recommended, but not strictly necessary, that you have Administrator privileges when uninstalling the software. 1. Using the Windows 7 Control Panel select the Programs and Features (or the Add or Remove Programs option in Windows XP).
INSTALLATION Windows
14
2. Search the list and select the VA One 2013 64bit entry. 3. Select the Uninstall button. 4. A dialog will be displayed to verify the remove operation. Selecting the Yes button will activate the uninstall process. 5. A VA One 2013 64bit dialog will appear displaying information about the status of the uninstall operation. When the dialog closes, the uninstall operation is complete. VA One and all its related components have now been completely removed from the computer. The license file and any user-created model files (e.g. *.va1, *.xml) will be left intact on the hard drive.
INSTALLATION Windows
15
LINUX
The following sections detail the standard installation procedure for the 64 bit version of the VA One batch solver for Linux. The batch solver allows you to solve and save model files (.xml or .va1) that are platform independent. A .va1 file saved by the batch solver on Linux can also be opened by the graphical user interface of VA One on Windows 64-bit. The Linux version of the VA One batch solver is distributed on the VA One DVD in two ways: as a compressed tar archive, VAOne2013_solver_[version].x86_64.tar.gz, and as a RPM package file, VAOne2013_solver_[version].x86_64.rpm. Note, in each file name [version]represents the latest software version number. Both distributions are identical. The RPM package contains the exact same files as the compressed tar archive. The RPM package is provided for users and system administrators who are familiar with using RPM for installing, uninstalling and managing software on Linux. For optimum performance, it is recommended that the VA One batch solver not be installed on a network drive.
3. Extract the content of the compressed archive to create the VA One 2013 directory.
$ tar xvzf VAOne2013_solver_1.8.0-8.x86_64.tar.gz
INSTALLATION LINUX
16
2. Choose a location for the files on the workstation, for example /opt/ESI.
$ mkdir /opt/ESI
3. Copy the RPM file the from the VA One 2013 DVD (Linux folder) into the chosen destination folder.
$ cd /opt/ESI $ cp -p /media/cdrom/Linux/VAOne2013_solver_1.8.08.x86_64.rpm
5. Install the RPM package (Note the -prefix option allows for the selection of a target directory).
$ rpm -i -v --nomd5 --prefix=/opt/ESI VAOne2013_solver_1.8.08.x86_64.rpm
7. Query the RPM database to verify VA One has been registered as installed software.
$ rpm -q VAOne2013_64
INSTALLATION LINUX
17
Configuration
Running the Installation Script
Before running the VA One solver on a LINUX system, the install.sh installation script must be executed as shown below.
$ cd /opt/ESI/VAOne2013_64 $ ./install.sh
The script will set the following environment variables. OS_CACHE_DIR defines the directory location of the object cache file on LINUX
machines only. This location must exist on the local disk. The value defaults to the directory of the .va1 file. OS_LOGDIR defines the directory location of the database transaction log on
LINUX machines only. This location must exist on the local disk. This value defaults to the /tmp directory.
In VA One, the OS_AS_SIZE environment variable sets the size in bytes of the persistent storage region and defaults to 1 TB (1000 GB). To prevent client failures, the value of the MAX_MAP_COUNT kernel parameter must be increased. Follow the steps listed below to determine the value needed for this parameter. 1. Identify the value of OS_AS_SIZE in bytes. 2. Divide that value by the size in bytes of a memory page frame (4096 on Linux). 3. Add at least 8192 for other use of address space in the process.
MAX_MAP_COUNT>=(OS_AS_SIZE/4096)+8192
4. Based on the formula given in step 3, the valued for the MAX_MAP_COUNT parameter should be 244148817. The value of this parameter can be modified at runtime.
INSTALLATION LINUX
18
Another way to modify this value is by adding the following line to the /etc/sysctl.conf file. Modifying this file will require a system reboot.
vm.max_map_count = 244148817
2. Uninstall VA One.
$ rpm -e -v VAOne2013_64
3. Query the RPM database to verify that VA One has been uninstalled properly.
$ rpm -q VAOne2013_64
INSTALLATION LINUX
19
More information on RPM can be found in your system manual pages (man rpm) or on the web at http://en.wikipedia.org/wiki/RPM_Package_Manager and http://www.rpm5.org/.
************************************ VAOne 2013 (1.8.0.8) solver Usage... solver [-extra_ntf <filename>] [-runoptimization] [-runmontecarlo] [-runparametervariation] [-nofullsolve] [-runinternalfesolver] [-runbemsolver] [-bemrestart] [-runinternalacousticfesolver] [-runpemsolver] [-pemmegawords <N>] [-runallintermediatesolvers] [-feresultsfile <filename>] [-feresultsfile_units <L> <M>] [-pressureresultsfile <filename>] [-appendmodes] [-export <filename>] [-nocommit] [-solveloadcases] [-va1file <filename>] [-resonantmodes <N>] [-startband <N>] [-endband <N>] [-script <filename>.ebs,.ebc] file[.va1,.xml]
INSTALLATION LINUX
20
21
STANDALONE LICENSES
A standalone license refers to a license that is tied to a single workstation and can only be accessed by users working on that particular workstation. FlexNet also refers to these types of licenses as node-locked or uncounted. A standalone license file is sent to you by email from ESI Group or your local sales representative. The name of the license file may be vaone.lic or an informative name such as, <YourOrganization>-<DateIssued>.esi_cro.cry. The license file is a text file that includes the hostid of the licensed machine, the applications/modules licensed, and the expiration date of the license.
WINDOWS SETUP
From the Control Panel select the Environment Variables button on the Advanced tab of the System utility to define or update the environment variable PAM_LMD_LICENSE_FILE. If the environment variable PAM_LMD_LICENSE_FILE does not already exist on your system, create it and assign it the full path location of the license file, for example: c:\Program Files\ESI Group\vaone.lic.
If the environment variable PAM_LMD_LICENSE_FILE does exists, add the location of the new license file followed by a semicolon, for example:
c:\Program Files\ESI Group\vaone.lic;c:\Program Files\ESI Group\ProCast\.
22
UNIX SETUP
Create or update the PAM_LMD_LICENSE_FILE environment variable as discussed in the following sections.
Bourne-like Shells
% export PAM_LMD_LICENSE_FILE=/etc/lic/vaone.lic:$PAM_LMD_LICENSE_FILE
C-Shells
% set PAM_LMD_LICENSE_FILE=/etc/lic/vaone.lic:$PAM_LMD_LICENSE_FILE
23
FLOATING LICENSES
A floating or counted license is issued to end-users as a pool of one or more licenses managed by a license server. Network floating licenses allow multiple users to concurrently use licensed applications on their workstations by checking out an individual license from the license pool on the server. ESI Group uses FlexNet as the license manager to control and manage floating licenses for VA One 2013 and its optional modules. The license manager can be set up on a single server or a pool of closely connected servers acting as a three-way redundant server. Instructions for setting up the client and server machines are provided in this guide in the following sections.
The server domain name or IP address and the TCP/IP port number (27012 by default) will be needed to setup the client side workstation. 1. From the Control Panel select the Environment Variables button on the Advanced tab of the System utility to define the environment variable PAM_LMD_LICENSE_FILE on every client workstation where VA One 2013 is installed.
24
2. Set the environment variable to port@host: 27012@myserver.mynetwork.com. If the license manager is a 3-way redundant server, the environment variable should contain all three port@host addresses separated by semicolons:
27012@master.mynetwork.com;27012@server1.mynetwork.com; 27012@server2.mynetwork.com.
SINGLE SERVER: 3-WAY REDUNDANT SERVER:
25
Bourne-like Shells
% export PAM_LMD_LICENSE_FILE=27012@licenseserver:$PAM_LMD_LICENSE_FILE
C-Shells
% set PAM_LMD_LICENSE_FILE=27012@licenseserver:$PAM_LMD_LICENSE_FILE
26
2. Follow the instructions on the website for installing the FNP services. 3. Download the ESI server kits for your platform (described in the next section) and extract the files. The only files you will need from the archive are pam_lmd.exe (Windows) and pam_lmd (Linux/Unix). 4. It is recommended that the pam_lmd.exe file extracted above be copied to the directory where the lmadmin is located. On Windows this is
C:\Program Files\FlexNet Publisher License Server Manager
5. Import the ESI license file through the web browser based interface of FlexNet Publisher.
6. Please see http://www.globes.com/support/fnp_utilities_download.htm for more details on how to install and administer a lmadmin based server manager.
27
Windows
Installing the FlexNet License Manager
The following instructions pertain to setting up a PC-Windows based server to host the FlexNet license manager. It is recommended that a network or system administrator with administrator privileges perform the procedures. 1. Locate the server-side license file, vaone_server.lic, sent by ESI Group. If this file cannot be located contact your sales agent or support.vaone@esi-group-na.com. 2. Choose or create a folder structure on the server hard drive for the location of the license file. The following is the path chosen for the examples in this sections instructions for PC-Windows single servers.
c:\FLEXnet\v11.11\
There are three important rules to follow when choosing a location for the license file: (1) the selected hard drive must be a local drive and not a network drive; (2) there should be no blank spaces in the path name associated with the file location; and (3) the last folder in the path sequence cannot be named pam_lmd. The following is an example of an erroneous path.
j:\Program Files\FLEXnet\pam_lmd
3. Copy the server-side license file, vaone_server.lic, to the FLEXnet\v11.11 folder referenced in step 2 above. 4. Insert the VA One DVD into the disc drive. Open a Windows Explorer window and locate the <FLEXnet> folder on the DVD.
E:\FLEXnet\PC-Windows (i86_n3)
28
If the DVD is unavailable the files can be downloaded from the following ftp location.
ftp://ftp.esi-us-rd.com/pub/flexnet/FLEXnet-server-kitv11.11-i86_n3.zip
5. Unzip the .zip file or copy the contents of the folder <FLEXnet> to the FLEXnet\v11.11 folder. Five files should now exist in this folder. vaone_server.lic Server-side license file provided by ESI Group. lmgrd.exe Generic license manager daemon provided by FlexNet. lmtools.exe Graphical user interface for FlexNet utilities. lmutil.exe Generic FlexNet utility program. pam_lmd.exe Vendor-specific license manager daemon provided by ESI Group.
6. Open the server-side license file, vaone_server.lic, in a text editor. Verify that the path on the DAEMON line is correct (i.e. the path referenced in step 2). If this path is not correct, modify the path and save the vaone_server.lic file. Refer to the text block below for an example.
SERVER myserver.mynetwork.com 00105a0025d0 27012 DAEMON pam_lmd c:\flexnet\v11.11\pam_lmd.exe
7. Modify the DNS hostname or IP address that appears right next to the SERVER keyword. Do not modify the hostid number or the license file will become invalid. 8. While the vaone_server.lic is open in the text editor, verify the availability of TCP/IP port number, 27012, proposed by ESI Group as the default port to use for the FlexNet license manager for VA One on the server machine. Use one of the following commands from the command prompt to list all non-available ports.
netstat a | more
29
If the 27012 port is not available, modify the SERVER line of the license file by replacing the current port number with an available port number. Refer to the above text block for an example. 9. Save the vaone_server.lic file and exit the text editor. 10. For convenience, add a shortcut pointing to the lmtools.exe application onto the desktop of the server. Rename this shortcut with an easily recognizable description, such as, FlexNet license manager. 11. Open the LMTOOLS application. 12. Using the Service/License File tab, select the radio button option for Configuration using Services in the Server List. See image below.
13. Select the Config Services tab and modify the controls as shown in the figure on page 30.
Service Name ESI Group License Manager (PAM_LMD) Path to the lmgrd.exe file c:\FlexNet\v11.11\lmgrd.exe Path to the license file c:\FlexNet\v11.11\vaone_server.lic Path to the debug log file c:\FlexNet\v11.11\debug.log
14. Check the two checkboxes, Start Server at Power Up and Use Services. 15. Select the Save Service button. The FlexNet license manager and all its corresponding software applications have now been installed on the designated server. Refer to the following section, Starting the FlexNet License Manager, for instructions on how to start and properly maintain the license manager.
30
31
3. Using the Start/Stop/Reread tab, select FlexNet license manager for VA One from the FlexNet license services installed on this computer list.
4. Click the Start Server button. 5. Select the Server Status tab and click the Perform Status Enquiry button. All available licenses for VA One and its optional modules will be listed in the window below the button.
The license manager should now be running properly on the server. If the current available licenses are not displayed properly after performing a status enquiry, refer to the TROUBLESHOOTING chapter of this document for further assistance.
32
5. Modify the DNS hostname or IP address that appears right next to the SERVER keyword. Do not modify the hostid number or the license file will become invalid. 6. While the vaone_server.lic is open in the text editor, verify the availability of TCP/IP port number, 27012, proposed by ESI Group as the default port to use for the FlexNet license manager for VA One. Use one of the following commands from the command prompt to list all non-available ports.
c:\> netstat a | more
33
If the 27012 port is not available, modify the SERVER line of the file by replacing the current port number with an available port number. Save the vaone_server.lic file and exit the text editor. Refer to the above text block for an example. 7. Using the Start/Stop/Reread tab, select FlexNet license manager for VA One from the FLEXnet license services installed on this computer list.
8. Click the ReRead License File button. 9. Select the Server Status tab and click the Perform Status Enquiry button. All available licenses for VA One and its optional modules should be listed in the window below the button. The license manager server will now refer to the newly issued license file when accepting or denying requests from client workstations to execute VA One or any of its optional modules.
34
4. Click the Stop Server button. If licenses have been borrowed from the server, the application will not allow the license manager to be stopped. Although it is not recommended, it is still possible to stop the license manager by forcing the server shutdown. This is done by selecting the Force Server Shutdown check box and clicking the Stop Server button. 5. Select the Server Status tab and click the Perform Status Enquiry button. A message should appear in the window below the button stating the server is down. When the license manager is no longer running, any requests to access licenses of VA One and its optional modules will be denied.
UNIX
Installing the FlexNet License Manager
The following instructions pertain to setting up a UNIX based server to host the FlexNet license manager. For security reasons, it is recommended by the makers of FlexNet that a network or system administrator be logged in as guest when performing the procedures. 1. Locate the server-side license file, vaone_server.lic, sent by ESI Group. If this file cannot be located contact your sales agent or support.vaone@esi-group-na.com. 2. Choose or create a folder structure on the server hard drive for the location of the license file. The following is the path chosen for the examples in this sections instructions for a UNIX single server:
/apps/flexnet/v11.11
There are three important rules to follow when choosing a location for the license file: (1) the selected hard drive must be a local drive and not a network drive; (2)
35
there should be no blank spaces in the path name associated with the file location; and (3) the last folder in the path sequence cannot be named pam_lmd. The following is an example of an erroneous path.
/remote_disk/ESI Group/pam_lmd
3. Copy the server-side license file, vaone_server.lic, to the flexnet/v11.11 folder (refer to step 2). 4. Insert the VA One DVD into the disc drive and locate the <FLEXnet> folder on the DVD that corresponds to the type of UNIX server being setup. If the DVD is unavailable the file can be downloaded from the following ftp location.
ftp://ftp.esi-us-rd.com/pub/flexnet/FLEXnet-server-kitv11.11-linux.zip
5. Using the unzip UNIX utility, decompress and extract the contents of the downloaded .zip file or copy the contents of the <FLEXnet> folder to the flexnet/v11.11 folder. The following executable files should exist in the folder, lmgrd Generic license manager daemon provided by FlexNet. lmutil Generic FlexNet utility program. pam_lmd Vendor-specific license manager daemon provided by ESI Group.
6. Open the server-side license file, vaone_server.lic, in a text editor. Verify that the path on the DAEMON line is correct (i.e. the path referenced in step 2). If this path is not correct, modify the path and save the vaone_server.lic file. Refer to the text block below for an example.
SERVER myserver.mynetwork.com 83A0FC24 27012 DAEMON pam_lmd /apps/flexnet/v11.11
7. Modify the DNS hostname or IP address that appears right next to the SERVER keyword. Do not modify the hostid number or the license file will become invalid 8. While the file vaone_server.lic is open in the text editor, verify the availability of TCP/IP port number, 27012, proposed by ESI Group as the default port to use for the FlexNet license manager on the server machine. Use one of the following commands to list all non-available ports.
% netstat a | more
or
% netstat a | fgrep 27012
If this port is not available, modify the SERVER line of the file by replacing the current port number with an available port number. Refer to the above text block for an example. 9. Save the file vaone_server.lic and exit the text editor.
36
The FlexNet license manager and all its corresponding software applications have now been installed on the designated server. Refer to the following section, Starting the FlexNet License Manager, for instructions on how to start and properly maintain the license manager.
Please note that the l in the above command represents the lower case letter L and not the number one. 3. Using the commands given below, verify that the license manager is running properly.
% ps elf | fgrep pam_lmd % ps elf | fgrep lmgrd % more debug.log % ./lmutil lmstat -c /etc/lic/vaone_server.lic -S pam_lmd
If any error messages are present in the debug.log file or the lmstat command does not list all available licenses, refer to the TROUBLESHOOTING chapteer of this document for further assistance. If the new license manager server is running properly, it will accept or deny requests via TCP/IP from any client workstation on the same network to execute a license of VA One or any of its optional modules.
37
3. Copy the new server-side license file, vaone_server.lic, to the license folder on the hard drive, e.g.,
/etc/lic/vaone_server.lic.
If an older vaone_server.lic file exists in this location, override it with the new file. 4. Open the file vaone_server.lic in a text editor. Verify that the path on the DAEMON line is correct. If this path is not correct, modify the path and save the vaone_server.lic file. Refer to the text block below for an example.
SERVER myserver.mynetwork.com 83A0FC24 27012 DAEMON pam_lmd /apps/flexnet/v11.11
5. Modify the DNS hostname or IP address that appears right next to the SERVER keyword. Do not modify the hostid number or the license file will become invalid. 6. While the vaone_server.lic is open in the text editor, verify the availability of TCP/IP port number, 27012, proposed by ESI Group as the default port to use for the FlexNet license manager on the server machine. Use one of the following commands to list all non-available ports.
% netstat a | more
or
% netstat a | fgrep 27012
If this port is not available, modify the SERVER line of the file by replacing the current port number with an available port number. Refer to the above text block for an example. 7. From the opened UNIX shell, use the following command to reread the license file and refresh the FlexNet license manager.
% ./lmutil lmreread -c /etc/lic/vaone_server.lic
The license manager server will now refer to the newly issued license file when accepting or denying requests to execute a license of VA One or any of its optional modules.
38
3. In the opened UNIX shell, use the following command to stop the FlexNet license manager.
% ./lmutil lmdown -c /etc/lic/vaone_server.lic
4. If licenses have been borrowed from the server, the lmutil application will not allow the license manager to be stopped. Although it is not recommended, it is still possible to stop the license manager by forcing the server shutdown. This is done using the following command.
% ./lmutil lmdown -c /etc/lic/vaone_server.lic -force
When the license manager is no longer running, any requests to access licenses of VA One and its optional modules will be denied.
39
Windows
Installing the FlexNet License Manager
The following instructions pertain to setting up a PC-Windows based 3-way redundant server to host the FLEXnet license manager as a quorum. It is recommended that a network or system administrator with administrator privileges perform the procedures. All procedures should be performed first on the MASTER server and immediately followed by the other two server machines. 1. Locate the server-side license file, vaone_server.lic, sent by ESI Group. If this file cannot be located contact your sales agent or support.vaone@esi-group-na.com. 2. Choose or create a folder structure on the each server hard drive for the location of the license file. The following is the path chosen for the examples in this sections instructions for PC-Windows 3-way redundant servers.
c:\FlexNet\v11.11
There are three important rules to follow when choosing a location for the license file: (1) the selected hard drive must be a local drive and not a network drive; (2) there should be no blank spaces in the path name associated with the file location; and (3) the last folder in the path sequence cannot be named pam_lmd. The following is an example of an erroneous path.
j:\Program Files\FLEXnet\pam_lmd
3. Copy the server-side license file, vaone_server.lic, to the FLEXnet\v11.11 folder referenced in step 2 above on each server.
40
4. Insert the VA One DVD into the disc drive. Open a Windows Explorer window and locate the <FLEXnet> folder on the DVD.
E:\FLEXnet\PC-Windows (i86_n3)
If the DVD is unavailable the files can be downloaded from the ftp URL:
ftp://ftp.esi-us-rd.com/pub/flexnet/ FLEXnet-server-kit-v11.11-i86_n3.zip
5. Unzip the .zip file or copy the contents of the folder <FLEXnet> to the FLEXnet\v11.11 folder. Five files should now exist in this folder. vaone_server.lic Server-side license file provided by ESI Group. lmgrd.exe Generic license manager daemon provided by FlexNet. lmtools.exe Graphical user interface for FlexNet utilities. lmutil.exe Generic FlexNet utility program. pam_lmd.exe Vendor-specific license manager daemon provided by ESI Group.
6. Open the file vaone_server.lic in a text editor on each machine. Verify that the path on the DAEMON line for each server is correct (i.e. the path referenced in step 2). If this path is not correct, modify the path and save the vaone_server.lic file. Refer to the text block below for an example.
SERVER master.myorganization.com 00105a0025d5 27012 DAEMON pam_lmd c:\flexnet\v11.11\pam_lmd.exe SERVER server1.myorganization.com 00105a0025d6 27012 DAEMON pam_lmd c:\flexnet\v11.11\pam_lmd.exe SERVER server2.myorganization.com 00105a0025d7 27012 DAEMON pam_lmd c:\flexnet\v11.11\pam_lmd.exe
7. Modify the DNS hostname or IP address that appears right next to the SERVER keyword. Do not modify the hostid number or the license file will become invalid. 8. While the vaone_server.lic is open in the text editor, verify the availability of TCP/IP port number, 27012, proposed by ESI Group as the default port to use for the FlexNet license manager on each server machine. Use one the following commands from the command prompt to list all non-available ports.
c:\> netstat a | more
or
c:\> netstat a | find /I 27012
If this port is not available, modify the SERVER line of the file by replacing the current port number with an available port number. Refer to the above figure for an example. 9. Save the vaone_server.lic file and exit the text editor.
41
10. For convenience, add a shortcut pointing to the lmtools.exe application onto the desktop of the server. Rename this shortcut with an easily recognizable description, such as, FlexNet license manager. 11. Open the LMTOOLS application. 12. Starting with the MASTER server, use the Service/License File tab to select the radio button option for Configuration using Services in the Server List. 13. Referring to the figure below, select the Config Services tab and modify the controls as follows,
Service Name ESI Group License Manager (PAM_LMD) Path to the lmgrd.exe file
c:\FlexNet\v11.11\lmgrd.exe
Path to the license file c:\FlexNet\v11.11\vaone_server.lic Path to the debug log file c:\FlexNet\v11.11\debug.log
14. Check the two checkboxes, Start Server at Power Up and Use Services. 15. Select the Save Service button. The FlexNet license manager and all its corresponding software applications have now been installed on the designated servers. Refer to the following section, Starting the FlexNet License Manager, for instructions on how to start and properly maintain the license manager.
42
5. While the vaone_server.lic is open in the text editor, verify the availability of TCP/IP port number, 27012, proposed by ESI Group as the default port to use for the FlexNet license manager for VA One on each server. Use one of the following commands from the command prompt to list all non-available ports.
c:\> netstat a | more
or
c:\> netstat a | find /I 27012
If this port is not available, modify the SERVER line of the file by replacing the current port number with an available port number. Save the vaone_server.lic file and exit the text editor. Refer to the above text block for an example. 6. Starting with the MASTER server, use the Start/Stop/Reread tab to the select FLEXnet license manager for VA One option from the FLEXnet license services installed on this computer list.
43
7. Click the ReRead License File button. 8. After the license file has been reread on all servers, using the MASTER server select the Server Status tab and click the Perform Status Enquiry button. All available licenses for VA One and its related modules should be listed in the window below the button. The license manager server will now refer to the newly issued license file when accepting or denying requests from client workstations to execute VA One or any of its optional modules.
UNIX
Installing the FlexNet License Manager
The following instructions pertain to setting up a UNIX based 3- way redundant server to host the FlexNet license manager as a quorum. For security reasons, it is recommended by the makers of FlexNet that a network or system administrator be
44
logged in as guest when performing the procedures. All procedures should be performed first on the MASTER server and immediately followed by the other two server machines. 1. Locate the server-side license file, vaone_server.lic, sent by ESI Group. If this file cannot be located contact your sales agent or support.vaone@esi-group-na.com. 2. Choose or create a folder structure on each server hard drive for the location of the license file. The following is the path chosen for the examples in this sections instructions for UNIX 3-way redundant servers.
/etc/lic/vaone_server.lic
There are three important rules to follow when choosing a location for the license file: (1) the selected hard drive must be a local drive and not a network drive; (2) there should be no blank spaces in the path name associated with the file location; and (3) the last folder in the path sequence cannot be named pam_lmd. The following is an example of an erroneous path.
/remote_disk/ESI Group/pam_lmd
3. Copy the server-side license file, vaone_server.lic, to the flexnet/v11.11 folder on each server workstation (refer to step 2). 4. Insert the VA One DVD into the disc drive and locate the <FLEXnet> folder on the DVD that corresponds to the type of UNIX server being setup. If the DVD is unavailable the file can be downloaded from the following ftp location.
ftp://ftp.esi-us-rd.com/pub/flexnet/FLEXnet-server-kitv11.11-linux.zip
5. Copy this compressed archive file onto each server. Using the unzip UNIX utility, decompress the file and extract the contents to the flexnet/v11.11 directory (e.g. /apps/esi/flexnet/v11.11). If the extraction is successful, the following executable files should exist in the folder, lmgrd Generic license manager daemon provided by FlexNet. lmutil Generic FlexNet utility program. pam_lmd Vendor-specific license manager daemon provided by ESI Group.
6. Open the server-side license file, vaone_server.lic, in a text editor on each server. Verify that the path on the DAEMON line is correct (i.e. the path referenced in step 2). If this path is not correct, modify the path and save the vaone_server.lic file. Refer to the text block below for an example.
SERVER master.myorganization.com 83A0FC24 27012 DAEMON pam_lmd /apps/flexnet/v11.11 SERVER server1.myorganization.com 83A0FC25 27012 DAEMON pam_lmd /apps/flexnet/v11.11 SERVER server2.myorganization.com 83A0FC26 27012
45
7. While the vaone_server.lic is open in the text editor, verify the availability of TCP/IP port number, 27012, proposed by ESI Group as the default port to use for the FlexNet license manager on each server machine. Use one of the following commands to list all non-available ports.
% netstat a | more
or
% netstat a | fgrep 27012
If this port is not available, modify the SERVER line of the file by replacing the current port number with an available port number. Refer to the above figure for an example. 8. Save the vaone_server.lic file and exit the text editor. The FlexNet license manager and all its corresponding software applications have now been installed on the designated servers. Refer to the following section, Starting the FLEXnet License Manager, for instructions on how to start and properly maintain the license manager.
Please note that all three systems must be running at the time the license manager is started. However, once the license manager is running, only two systems need to be running at any time. 3. Use the commands given below on the MASTER license server to verify that the license manager is running properly.
% ps elf | fgrep pam_lmd % ps elf | fgrep pam_lmd % more debug.log % ./lmutil lmstat -c /etc/lic/vaone_server.lic -S pam_lmd
If any error messages are present in the debug.log file or the lmstat command does not list all available licenses, refer to the TROUBLESHOOTING chapter of this document for further assistance.
46
If the new license manager server is activated and running properly, it will accept or deny requests via TCP/IP from any client workstation on the same network to execute a license of VA One or any of its optional modules.
2. Open the file vaone_server.lic in a text editor. Verify that the path on the DAEMON line is correct for each server. If this path is not correct, modify the path and save the vaone_server.lic file. Refer to the text block below for an example.
SERVER master.myorganization.com 83A0FC24 27012 DAEMON pam_lmd /apps/flexnet/v11.11 SERVER server1.myorganization.com 83A0FC25 27012 DAEMON pam_lmd /apps/flexnet/v11.11 SERVER server2.myorganization.com 83A0FC26 27012 DAEMON pam_lmd /apps/flexnet/v11.11
3. Starting with the MASTER server, copy the new server-side license file, vaone_server.lic, to the license folder on the hard drive of each of the three server machines (e.g. /etc/lic/vaone_server.lic). If the old vaone_server.lic file exists in this location, override it with the new file. 4. Copy the new server-side license file, vaone_server.lic, to the license folder on the hard drive of each server (e.g. /etc/lic/vaone_server.lic). If an older vaone_server.lic file exists in this location, override it with the new file. 5. While the vaone_server.lic is open in the text editor, verify the availability of TCP/IP port number, 27012, proposed by ESI Group as the default port to use for the FlexNet license manager on each server machine. Use one of the following commands to list all non-available ports.
% netstat | more
or
% netstat a | fgrep 27012
If this port is not available, modify the SERVER line of the file by replacing the default port number with an available port number. Save the vaone_server.lic file and exit the text editor. Refer to the above text block for an example.
47
6. Starting with the MASTER, use the following command from the opened UNIX shell to reread the license file and refresh the FlexNet license manager.
% ./lmutil lmreread c /etc/lic/vaone_server.lic
The license manager server will now refer to the newly issued license file when accepting or denying requests to execute a license of VA One or any of its optional modules.
3. In the opened UNIX shell, use the following command to stop the FlexNet license manager.
% ./lmutil lmdown -c /etc/lic/vaone_server.lic
4. If one other license manager has been stopped and licenses have been borrowed from the server, the lmutil.exe application will not allow the license manager to be stopped. Although it is not recommended, it is still possible to stop the license manager by forcing the server shutdown. This is done using the following command.
% ./lmutil lmdown -c /etc/lic/vaone_server.lic -force
If two of the license managers are no longer running, any requests to access licenses of VA One and its optional modules will be denied.
48
BORROWING
ESI Group can issue a floating license with a special BORROW functionality. This type of license allows an end-user to borrow a license away from the server in order to use that licensed application at another time when the workstation is no longer connected to the server. The license server keeps the borrowed license checked out from the server until the borrow period ends or the license is returned early by the user. The FLEXnet utilities installed with VA One provide a way to borrow and return licenses from the command line or using the License Manager (accessed through the Tools menu). Due to known issues with the Flexnet API, it is recommended that the lmborrow command line option be used when borrowing licenses away from a server, instead of the License Manager.
Command Line
Borrow
1. Open a DOS command line window. 2. Locate the VA One 2013 installation folder and change directory to
<VA One 2013 folder>\flexnet
3. Activate the borrowing of licenses with the following command, where the date represents the date the borrowing period will expire.
lmborrow pam_lmd 19-jan-2010
Note the format of the borrowing end date is dd-mmm-yyyy. In addition to the date, a time may be specified as hh:mm (e.g. 18:30). 4. Start VA One in order to borrow the application. When borrowing has been initiated all subsequent uses of borrowable licensed applications by ESI Group will cause these applications to be borrowed (e.g. VA One, Foam, Shock, RAYON, etc). 5. Exit VA One. 6. Use the following command to check the status of borrowed licenses.
lmborrow -status
7. Stop the borrowing of any further licenses using the following command.
lmborrow clear
8. Disconnect the workstation from the network. 9. Run VA One and any other borrowed applications or modules.
49
Return
1. Reconnect the borrowing workstation to the network. 2. Open a command line window. 3. Use the following command to check the status of borrowed licenses.
lmborrow -status
4. Return the borrowed licenses individually using the following command on Windows:
lmutil lmborrow return -c PAM_LMD_LICENSE_FILE vaone
It is important to note that this step must be repeated for every borrowed optional module of VA One as listed by the command issued in Step 3 (e.g. vaone_sea, vaone_foam, vaone_structural_fea, vaone_cosmic, etc). The list of borrowed licenses is indicated by lmborrow -status. If the user does not return the licenses early, they will be returned to the license server automatically on the expiration date given when the license was borrowed.
Help
For more information about using lmborrow: 1. Open a DOS command line window. 2. Use the following command to check the status of borrowed licenses.
lmborrow -help.
Example
Below is an example showing how to borrow a license of VA One and several modules (structural FEA, internal COSMIC FE solver, acoustic FEA, acoustic BEM, SEA, and coupled FEA/SEA solver). The licenses are borrowed for two days from 11-may-2007 until 13-may-2007 at 19:00. In this example, after borrowing has been initiated VA One is started from the flexnet subfolder using the command ..\vaone. Alternatively, VA One can be started from a Windows menu or shortcut. Licenses will also be borrowed if the user starts the solver (named solver.exe on Windows) from the command-line.
50
On May 12th (one day before the borrow end date), the user decides to return all borrowed licenses. The user reconnects to the license server and executes the command lmborrow return several times as shown below.
51
License Manager
Borrow
1. Open the License Manager using the Tools menu. 2. Use the Information tab on the dialog to verify the current workstation is connected to the proper license manager server. 3. Select the Borrow tab on the License Manager dialog. 4. Select the checkbox for each application license you wish to borrow. 5. Select the desired Borrow End Date. 6. Select the Borrow button. After each license has been borrowed a message box will appear stating whether or not borrowing was successful. It is important to note that when borrowing has been initiated through the License Manager all subsequent uses of licensed applications within VA One will cause the applications to be borrowed. VA One must be exited in order to stop any further borrowing of licenses. If optional modules have been borrowed, VA One must also be borrowed in order to run the modules when the workstation is no longer connected to the network.
Return
1. Reconnect the borrowing workstation to the network. 2. Open the License Manager using the Tools menu. 3. Use the Information tab on the dialog to verify that licenses are borrowed to the current workstation. This information will be in the Borrowed Until column. 4. Select the Borrow tab on the License Manager dialog. 5. Select the Return All button. After each license has been returned a message box will appear stating whether or not the return was successful. It is important to remember that all licensed applications that are borrowed to the current workstation will be returned to the server.
52
53
TROUBLESHOOTING
The following sections of this chapter provide answers to some commonly encountered installation and run-time problems associated with VA One and the FlexNet license manager. If a specific problem is not addressed in the following sections, email the error message, error number, and debug.log file to support.vaone@esi-group-na.com.
ObjectStore internal error: VirtualAlloc failed at any address - Not enough storage is available to process this command. (8)
This error applies to machines using 32-bit Windows operating systems due to the limitations of the 32-bit address space. Set the environment variable OS_AS_SIZE to a smaller value than the default. 1. Open the Windows Control Panel using the Start menu. 2. Activate the System settings (Control Panel\All Control Panel Items\System).
54
3. Select the Advanced system settings option, which activates a System Properties dialog. 4. Click the Environment Variables... button on the Advanced tab of the dialog. 5. Using the Environment Variables dialog, select OS_AS_SIZE in the System variables group and click the Edit... button. 6. Set the Variable value to a number less than 2, such as 1.5. Click the OK button. 7. Click the OK button on the Environment Variables dialog and close all related system dialogs. Restart VA One. If you have at least 3GB of RAM, enable the 3GB switch to make more memory available to applications. If you experience any unexpected or abnormal behavior with the 3GB switch enabled, we recommend that you disable it and move to a 64 bit application. To enable the 3GB switch on Windows Vista or Windows 7: 1. Right-click Command Prompt in the Accessories program group of the Start menu. Select Run as Administrator. 2. At the command prompt, enter: bcdedit /set IncreaseUserVa 3072 3. Restart the computer. To disable the 3GB switch on Windows Vista or Windows 7: 1. Right-click Command Prompt in the Accessories program group of the Start menu. Select Run as Administrator. 2. At the command prompt, enter: bcdedit /deletevalue IncreaseUserVa 3. Restart the computer. To enable the 3GB switch on Windows XP: 1. Right-click My Computer. Select Properties. 2. In the System Properties dialog, activate the Advanced tab. 3. Using the Advanced tab, select the Settings button in the Startup and Recovery group. 4. In the Startup and Recovery dialog, select the Edit button in System startup. The Windows boot.ini file will be opened in Microsoft Notepad. 5. Create a backup copy of the boot.ini file. Note: Boot.ini files may vary from computer to computer. 6. Select the following line in the boot.ini file:
multi(0)disk(0)rdisk(0)partition(2)\WINDOWS="Microsoft Windows XP Professional" /fastdetect
7. Use Ctrl+C to copy the line and then Ctrl+V to paste it immediately below the original line. Note: The text string may vary from the text string in this
55
solution, so be sure to copy the text string from your boot.ini file, and not the text string included here. 8. Modify the copied line to include /3GB, as shown in the following example:
multi(0)disk(0)rdisk(0)partition(2)\WINDOWS="Microsoft Windows XP Professional 3GB" /3GB /fastdetect
Note: Do not overwrite any existing lines. 9. Save and close the boot.ini file. 10. Select the OK button to close each dialog. 11. Restart your computer. 12. During startup, select the 3GB option. If you do not select the 3GB option, the system will default to the 2GB total memory setting.
If the latest drivers cannot be installed, open the NVIDIA Control Panel and set the 3D Settings to 3D App Visual Simulation (as shown in the figure below).
56
If after modifying the above setting VA One is still unresponsive, the nVidia drives will need to be replaced. Replace the nVidia OpenGL DLLs with the MESA DLLs provided in the VA One installation folder (i.e. c:\Program Files\ESI Group\VAOne...\MESA). 1. Quit VA One. 2. Copy the files OPENGL32.DLL and GLU32.dll from the MESA subdirectory into the installation directory of VA One. 3. Launch VA One 4. Activate the About VA One dialog (Help > About VA One...) and verify the reference to the MESA OpenGL driver. Note: using the MESA OpenGL DLLs to render the graphics in software, will reduce performance as compared to a hardware graphics card.
57
STANDALONE LICENSES
Cannot find license file.
Verify the vaone.lic file exists and is located in the proper directory. Contact your local sales representative or ESI Group to obtain a license file.
The hostid of this machine does not match the hostid in the license file (-9,57).
If the problem occurs on a laptop computer, verify the network card supports Ethernet. Also verify the power management options do not turn off the Ethernet network card automatically when the laptop is not connected to a network.
The system clock of this machine has been set back (-88,309).
The system clock on the current workstation has been set back more than 24 hours. Set the system clock to the proper date and time.
58
FLOATING LICENSES
Client
Cannot find license file.
Set the environment variable, PAM_LMD_LICENSE_FILE, to the port@host address of the server. Contact your local sales representative or ESI Group to obtain a license file.
If the ping succeeds and the server responds there is a problem with the FlexNet license manager. If the ping fails with no response from the server there is a network problem between the workstation and the license server or the license server is down. Contact the local system/network administrator for further details.
If the ping succeeds and the server responds there is a problem with the FlexNet license manager. If the ping fails with no response from the server there is a LAN problem with the workstation or the server is down. Contact the local system/network administrator for further details.
License file does not support this version of VA One (-21, 126).
The floating license file on the server does not support the requested version of VA One. Contact ESI Group or your local sales representative.
59
Clock difference is too large between this machine and the license server (-34,147).
The client workstation system clock has been set back more than 24 hours. Change the clock back to the proper date and time.
Server
Refer to the following two sections when problems occur while setting up, refreshing and stopping the license manager or server.
PC-Windows
While using LMTOOLS, scan the dialog box for displayed error messages and warnings. Use the Config Services tab, View Log button to review the debug.log file. If an error exists it is very clearly presented and explained in this file. Please note the file can be quite large and the error may not be referenced until the end of the file. When you are finished reviewing the debug.log file, close the file with the Close Log button.
60
Contact your local system/network administrator for resolving any error or warning messages related to networking.
UNIX
While the lmgrd or lmutil processes are running, note any error message that may be output to the UNIX shell window. Review the debug.log file for possible sources of error. The following command is useful when quickly searching for errors.
% fgrep error debug.log
If an error exists it is very clearly presented and explained in this file. Please note the file can be quite large and the error may not be referenced until the end of the file. Contact your local system/network administrator for resolving any error or warning messages related to networking.