Install a New Network License (Unix/Linux/Solaris)
- INSTALL THE LICENSE SOFWARE: If you have purchased a new network license for LS-DYNA, then you should decide where you want to run the license server. The LSTC License Server may reside on a Linux, Unix, Solaris, or Microsoft Windows platform. All versions of LS-DYNA may acquire permission to run from this server, regardless of architecture or OS. A typical installation is found on this web page. More information can be found in the complete PDF Installation Guide.
Choose a stable machine in order to minimize license down-time. Then download the LSTC Network License software for the machine which will run the license server. It is generally easier to install, upgrade and administer network licenses if the LSTC License Server is installed under the Microsoft Windows OS. However, those familiar with Unix/Linux/Solaris should not find it difficult to administer licenses on these platforms.
Once you have chosen a platform on which to install the LSTC License Server, then download the LSTC License Software for the chosen target architecture.
HARDWARE OS ARCHIVE AMD Opteron RedHat AS4.0 LSTC_LicenseManager_77918_amd64_redhat40.tgz INTEL/AMD SuSE 11.2 LSTC_LicenseManager_77918_xeon64_suse11.tgz INTEL/AMD SuSE 11.4 LSTC_LicenseManager_77918_xeon64_suse114.tgz INTEL/AMD SuSE 12.0 LSTC_LicenseManager_77918_xeon64_suse12.tgz INTEL/AMD RedHat AS5.0 LSTC_LicenseManager_77918_xeon64_redhat50.tgz INTEL/AMD RedHat RHEL 3-5 LSTC_LicenseManager_77918_ia32_redhat30.tgz INTEL/AMD SuSE 9-10 LSTC_LicenseManager_77918_ia32_redhat30.tgz INTEL/AMD MS Windows 32/64-bit LSTC_LicenseManager_85971_win.exe
After downloading the appropriate archive, choose a directory where you want to install the license server, move the archive to the installation directory, and cd into that directory. Then unpack the archive into the installation directory. For example,
gunzip LSTC_LicenseManager_77918_alpha_51a.tgz tar xvf LSTC_LicenseManager_77918_alpha_51a.tar
You should now see the following files in the installation directory
lstc_server lstc_proxy lstc_client lstc_qrun lstc_vrun lstc_qkill lstc_logreport gmid
- GENERATE A LICENSE REQUEST:Run lstc_server with the info command line option in order to generate a license request form
./lstc_server infoThe server will print the following message to the terminal, indicating that it has created the sample request form LSTC_SERVER_INFO:
Getting server information ... The hostid and other server information has been written to LSTC_SERVER_INFO. Please contact LSTC with this information to obtain a valid network licenseYou will need to edit the top portion on this file, which looks like
Your Company Name Here EMAIL: NONE FAX: NONE TELEPHONE: NONE # SERVER: E3707F52 # Linux desktop 18.104.22.168-0.1-desktop #1 SMP PREEMPT 2010-01-27 # Host ID : e3707f52 # ALLOW_RANGE: XXX.XXX.XXX.XXX XXX.XXX.XXX.XXX #Replace "Your Company Name Here" with the name of your company or organization. Specify the EMAIL address and TELEPHONE number of the primary technical contact for your organization. FAX is optional. The ALLOW_RANGE statement is required so that licenses are locked to your local network. You may specify any number of such statements such as
ALLOW_RANGE: 127.000.000.001 127.000.000.001 (recommended) ALLOW_RANGE: 192.168.053.000 192.168.053.255 ALLOW_RANGE: 192.168.054.000 192.168.054.127After you have completed editing the license request form, please send your key request to the distributor through whom you purchased LS-DYNA (send to at firstname.lastname@example.org only if you purchased LS-DYNA directly from LSTC.) Be sure to include any other information which is needed by LSTC to fulfill your license request.
START/STOP THE LICENSE SERVER:LSTC will send you a 'server_data' license file for your installation. Place this file in the server installation directory specified in (2). It is recommended that you specify a log file for job reporting. Human-readable entries are created in the log file for each job as it starts and stops. Any errors which occur during licensing will result in error/warning log entries. Use the following command to create a lot file named lstclm.log in the current working directory:
./lstc_server -l lstclm.log
The server runs in the background by default. The server automatically creates a kill script which may be used to kill the server.
The server also saves the last start-up arguments in a file named "server_start", so that you may restart the server using the previous set of command line arguments, without having to remember them.
NOTE: Make sure that the user who runs the server has permission to create/edit/remove any specified log file and script files "server_start" and "server_kill". The server must also create/edit status files "server_status" and "server_done_list".
VERIFY THE INSTALLATION:Make sure the license server is running.
./lstc_qrun -s localhost -r
You should see a full table of products that you have licensed, complete with (a) numbers of licenses and (b) exiration dates. Verify that the information is correct. If the server does not start for some reason, then you will see the message
*** ERROR failed to open server localhost
In that case, try starting the server in the foreground using the -f command line option. The server should print verbose information about the cause of failure. If you cannot correct the problem on your own, then contact LSTC license key support.
FIREWALL SETTINGS:By default, the license server listens on port 31010 (both UDP and TCP/IP.) So you must configure any firewall on the license server machine to allow inbound data/connections on these ports. You may choose a different port for the server by adding a "PORT:" entry into the license file. For example, if you would like to use port 31111, then add the following "PORT:" entry into "server_data" directly beneath the "SERVER:" line:
SERVER: E3707F52 PORT: 31111
*** WARNING *** Changing other lines in the file may invalidate the license file.
If you change the default port number, then all utilities (as well as LS-DYNA) require that you manually set the port number. For example, you will need to specify the port for "lstc_qrun"
./lstc_qrun -s 31111@localhost -r
Adding a file named LSTC_FILE to the server installation directory with the following line will eliminate the need to specify a default port/host name for the license utilities. This will make it easier to administer licenses:
#LICENSE_SERVER: port@host_or_ip or (if using the default port) #LICENSE_SERVER: host_or_ip
However, this only affects the behavior of "lstc_qrun" and other utilities if you run the particular utility located in the server installation directory. Instead of running "./lstc_qrun -s 31111@localhost -r", you may now run "./lstc_qrun -r" Of course, you may override the default in LSTC_FILE by specifying the -s command line option.