Upgrade a Network License (Linux/Unix/Solaris)
- UPDATE THE LICENSE FILE: Find the existing LSTC License Manager software installation directory, and 'cd' into this directory. The existing installation directory will contain the LSTC License Manager executable "lstc_server", as well as an existing license file "server_data". Move the existing license file to a new name
mv server_data server_data.oldCopy the new license file obtained from your LS-DYNA distributor into the current directory under the name "server_data" . When the server is restarted next, it will pick up the new license file. Check the permissions and ownership of this file in order to guarantee that the license server will be able to read the new license file. The best practice is to match the permissions and ownership of the old license data.
*** WARNING *** If there are any user-specified lines in the previous license file, then you must manually copy these lines into the new license files. Such lines start with HOST:, HOST1:, HOST2:, HOST3:, PORT:, PORT1:, PORT2: and PORT3:.
UPGRADE THE LICENSE SOFTWARE (optional): We recommend that you upgrade the license server at the same time that you obtain a new license file from your LS-DYNA distributor. Regardless of whether or not you upgrade the existing license software, you must stop and restart the license server whenever you obtain a new license. If the server is down for a few minutes only, then running licenses should not be lost in the process.
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_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
After downloading the software archive which is appropriate for your platform, move the archive into the current installation directory. In preparation for the upgrade, rename the existing license server executable:
mv lstc_server lstc_server.oldNow unpack the new software archive. For example,
gunzip LSTC_LicenseManager_77918_hp8000_11.tgz tar xvf LSTC_LicenseManager_77918_hp8000_11.tarCheck the permissions on the LSTC License Manager executable "lstc_server" in order to ensure that the server will start properly.
STOP AND RESTART THE SERVER: You will now have a new license file "server_data" and, optionally, a new server executable "lstc_server".
If there are start and kill scripts "server_start" and "server_kill" in the current working directory, then execute them in order
./server_kill ; ./server_startThe new server should now be running, which you can verify using
./lstc_qrun -qIf this does not work, then check "server_data" for any non-standard port number "PORT:" spec, and connect directly to this port
./lstc_qrun -s port@localhost -qThe output from this command will include the version number of the server. If this server number does not match the version number on the archive you just downloaded, then the server_kill script failed. In that case, then proceed to the next case, ignoring the scripts "server_start" and "server_kill".
If you do not have "server_start" and "server_kill" scripts in the current working directory, find the PID of the "lstc_server" process, and use that PID to kill the process manually
ps -lef | grep lstc_server kill -TERM PIDThen start the process manually
SYNTAX: ./lstc_server [-l job_log_file_name] [-a|-n|-N] [-q] where the command line options are -l file : log job request/completion/error/warrning to 'file' -a : Allow programs to be killed by anyone. -n : Allow programs to be killed based on user name alone (default). -N : Require user/host to match in order to kill jobs. -q : Do not allow programs to be queued when there are no available licenses.The start options will be saved to a new script "server_start" so that you may restart the server using the "server_start" script.
VERIFY THE NEW LICENSES: You should be able to contact the license server directly using
./lstc_qrun -rIf this command fails, then look for any non-standard port numbers for your server which are specified in "server_data", and try to connect to the port directly
./lstc_qrun -s localhost -r or ./lstc_qrun -s port@localhost
*** WARNING *** If the new server fails to start for some reason, then restore the older server, start the old server, and contact your LS-DYNA distributor.
mv lstc_server lstc_server.new cp lstc_server.old lstc_server ./lstc_server [-l job_log_file_name] [-a|-n|-N]