Personal tools

Install a New Network License (Linux/Unix/Solaris)

    Important Note:

    Due to export regulations when using a virtual machine (VM) as license server, the server ID also does contain properties of the physical host system. So the license will get invalid when moving the VM to a different physical machine.

     

    1. 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
      HP/ALPHA OSF1 5.1a LSTC_LicenseManager_77918_alpha_51a.tgz
      HP/PA8000 HPUX 11.0 LSTC_LicenseManager_77918_hp8000_11.tgz
      HP/Itanium2 HPUX 11.0 LSTC_LicenseManager_77918_ia64_hp11.tgz
      IBM/Power4 AIX 5.2 LSTC_LicenseManager_77918_ibmpwr4_aix52.tgz
      IBM/Power5 AIX 5.3 LSTC_LicenseManager_77918_ibmpwr5_aix53.tgz
      SGI IRIX 6.5 LSTC_LicenseManager_77918_sgi_irix64.tgz
      SUN SPARC SUNOS 5.8-5.9 LSTC_LicenseManager_77918_sun_58.tgz
      AMD Opteron RedHat AS4.0 LSTC_LicenseManager_77918_amd64_redhat40.tgz
      INTEL/Itanium2 SuSE 9 LSTC_LicenseManager_77918_ia64_suse9.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 LSTC_LicenseManager_77918_xeon64_suse114.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

      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

       

    2. GENERATE A LICENSE REQUEST: Run lstc_server with the info command line option in order to generate a license request form
              ./lstc_server info
      The 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 your local LS-DYNA distributor with this information to obtain a valid network license
      You 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 A6899CA8 B92C6922 838B5CE4 35DC4FC9
              # Linux desktop 2.6.31.12-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.127
      After you have completed editing the license request form, please send your key request to your local LS-DYNA distributor along with any other information which is needed to fulfill your license request.
    3. START/STOP THE LICENSE SERVER: Your LS-DYNA distributor will send you a license file for your installation. Rename this license file to 'server_data' and then 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 log 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.
              ./server_kill
      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".

    4. 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 your LS-DYNA distributor for license key support.

       

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