Professional Documents
Culture Documents
© 2012 Siemens Product Lifecycle Management Software Inc. All Rights Reserved.
Siemens and the Siemens logo are registered trademarks of Siemens AG. NX is a trademark or
registered trademark of Siemens Product Lifecycle Management Software Inc. or its subsidiaries in
the United States and in other countries. All other trademarks, registered trademarks or service marks
belong to their respective holders.
Table of Contents
Proprietary & Restricted Rights Notice ..................................................................................... 1
Table of Contents ......................................................................................................................... iii
Preface ........................................................................................................................................... iii
Intended Audience...................................................................................................................... iii
Scope of this Guide .................................................................................................................... iii
Conventions ................................................................................................................................ iii
Introduction ................................................................................................................................... 3
Background ................................................................................................................................. 3
Pre-installation Considerations ................................................................................................... 4
System Requirements .................................................................................................................. 4
SuSE and Red Hat Linux: ........................................................................................................ 4
Mac OS: ................................................................................................................................... 4
License File ................................................................................................................................. 4
Administrative Access ................................................................................................................. 4
Previous Licensing Installations.................................................................................................. 5
Installation ..................................................................................................................................... 6
Windows...................................................................................................................................... 6
UNIX and Linux .......................................................................................................................... 6
Mac OS ........................................................................................................................................ 6
Advanced Installation Options .................................................................................................... 7
Command Line Install (No GUI) ................................................................................................ 7
Windows .................................................................................................................................. 7
UNIX and Linux ...................................................................................................................... 7
Silent Install (No GUI and No Prompts) ..................................................................................... 7
Windows .................................................................................................................................. 7
UNIX and Linux ...................................................................................................................... 7
Detailed Switch Explanations ..................................................................................................... 8
Properties File ............................................................................................................................. 8
Windows: ................................................................................................................................. 8
UNIX and Linux: ..................................................................................................................... 8
Security........................................................................................................................................ 9
Run License Server under a Different Account .......................................................................... 9
Post-installation Considerations ................................................................................................ 10
Review Log Files ...................................................................................................................... 10
Install Log .............................................................................................................................. 10
SPLM Licensing Debug ......................................................................................................... 10
Updating License File ............................................................................................................... 10
Repairing the License Server .................................................................................................... 10
Uninstalling SPLM Licensing .................................................................................................... 11
Uninstalling ............................................................................................................................... 11
Windows ................................................................................................................................ 11
UNIX and Linux .................................................................................................................... 11
Mac OS................................................................................................................................... 11
Troubleshooting .......................................................................................................................... 12
Invalid Server Name Present .................................................................................................. 12
Vendor Daemon was not Detected Following the Install ...................................................... 12
Diagnostics ................................................................................................................................... 13
Communication Diagnostic ....................................................................................................... 13
Steps for checking the license daemon is running using lmutil ............................................. 13
Preface
Intended Audience
This guide was written for system administrators responsible for installing and managing
Siemens PLM License Server. Those responsible need a good knowledge of system management
procedures and their systems.
To install Siemens PLM License Server, you need to know basic system commands. This
material is not covered in this document.
Conventions
• All references to “SPLM Licensing” in this manual refer to Siemens PLM License
Server.
• The terms administrative, root, super user, and sudo are interchangeable. They all refer
to the user having the permissions to access and modify system directories and files.
• SPLM Licensing releases are independent of Siemens PLM Software client product
releases. They do not have the same version numbering as the client products.
• Text in [] and italicized is not to be read literally but should be substituted with an
interpreted value. For example: [YourNameHere] is reading this document.
Background
The installation of SPLM Licensing is accomplished using the supplied install. It will (if you
accept the defaults) install the files into a valid directory displayed during the install.
SPLM Licensing is a common license server intended to be shared by several but not all Siemens
PLM Software products. It is not backward compatible with the old (non-SPLM Licensing or
non-UGS Licensing) license servers previously used by Siemens PLM Software products.
However, both the old and new license servers may be installed on the same system.
Note The SPLM Licensing installation is only required on license server nodes. It is not
necessary to install this license server on clients unless the client is also serving licenses,
e.g. a standalone workstation.
Note Some Siemens PLM Software products support a ”Standalone Node-Locked License”
scenario, whereby there is no license server required and licensing information is acquired
directly from a file. This requires access to a specially locked license file called a
“Standalone Node-Locked License” file. In this scenario it is not necessary to install the
SPLM Licensing product.
System Requirements
The SPLM Licensing product requires Java 1.6+ to be installed on the system and some
platforms may require additional packages to be installed. These platforms and their
requirements are listed below:
• LSB 4.0
Mac OS:
License File
Prior to beginning the SPLM Licensing installation, you must have a license file. The file should
have already been provided. It does not exist on the software media and is not generated by the
installation. We recommend that the license file be saved as a text file in the administrator’s
home directory and that the file be named splm<major version number>.lic.
Note Please make sure you have the license file available on your system before beginning the
installation. The installation will NOT be possible without a license file.
Warning Merging of Siemens PLM Software license files with any other license file is not
supported. This includes other Siemens PLM Software license files.
Administrative Access
The install must be run with a user account that has administrative permissions.
Windows
Launch SPLMLicenseServer_[version]_win[bit]_setup.exe and follow the instructions. If you
want to run without a GUI see the Advanced Installation Options Section.
Mac OS
Open SPLMLicenseServer_[version]_macos_setup.zip in Finder. Then launch
SPLMLicenseServer_[version]_macos_setup.app and follow the instructions.
Windows
SPLMLicenseServer_[version]_win[bit]_setup.exe -i console
SPLMLicenseServer_[version]_[plat]_setup.bin -i console
Windows
Launch with the UI mode set to “silent” and provide a value for all properties.
SPLMLicenseServer_[version]_[plat]_setup.bin -i silent
-DUSER_INSTALL_DIR="C:\Program Files\Siemens\PLMLicenseServer"
-DUSER_SELECTED_LICENSE_FILE=C:\tmp\splm.lic
Launch with the UI mode set to “silent” and provide a value for all properties.
SPLMLicenseServer_[version]_[plat]_setup.bin -i silent
-DUSER_INSTALL_DIR=/usr/Siemens/PLMLicenseServer
-DUSER_SELECTED_LICENSE_FILE=/var/tmp/splm.lic
-DUSER_SELECTED_ACCOUNT=<username for running the license server>
Properties File
The properties file used with the -f option should contain property values that correspond to
each question in the install. The file should have each property and value pair on an individual
line separated by and equal sign. If the value contains whitespace NO quotes are needed. If the
value contains backslashes (\) two backslashes are need for every single backslash.
Windows:
USER_INSTALL_DIR=C:\\Program Files\\Siemens\\PLMLicenseServer
USER_SELECTED_LICENSE_FILE=C:\\tmp\\splm.lic
USER_INSTALL_DIR=/usr/Siemens/PLMLicenseServer/
USER_SELECTED_LICENSE_FILE=/var/tmp/splm.lic
USER_SELECTED_ACCOUNT=<username for running the license server>
The installer also supports the creation of a default user and group while installing the license
server, which is explained in details in the next section.
Note The user install directory and all directories in the path leading to it must have execute
permission for the aforementioned user.
Note This feature is only available on the Linux, Unix and Mac OS platforms.
Note The owner and group identifier of all the files in the install directory is the user mentioned
above and the user’s primary group respectively.
Install Log
The install creates a log file that should be reviewed if any issues are experienced during the
installation. The install’s log file is named install.log and will be located in the install directory.
If the install is not able to write the log file into the install directory it will be placed in a
platform specific location. The location for Windows is the desktop for all other platforms it is
in the user’s home directory.
The license service creates a debug log to aid in troubleshooting server issues. The debug log is
named splm_ugslmd.log and is located in the install directory.
Uninstalling
Windows
From the Control Panel go to Uninstall a program and remove Siemens PLM License
Server.
Or
All Programs
Start Siemens PLM License Server
Uninstall
Launch the Uninstall executable located in the SPLM Licensing install directory. In order to run
the Uninstall executable without a GUI use the -i flag with the value of console as you would
with the install.
Mac OS
Using Finder locate the Uninstall application in the SPLM Licensing install directory and
double-click.
This occurs when the license file has a hostname on the SERVER line that does not match the
machine’s hostname. To resolve this issue open the license file that was provided to the install
and confirm the hostname matches what the command hostname returns. Then restart the
service.
This occurs when the install has completed but was unable to confirm the server was up and
running. This might not indicate an error if the install did not wait long enough for the service to
start before checking it status. To resolve this issue perform the Communication Diagnostic and
confirm whether the server is communicating or not. If the server is communicating, there is no
issue. If the server is not communicating, look for errors in the license server’s debug log
(splm_ugslmd.log).
3. Run lmutil with the lmstat option and license server flags.
If the test fails to connect to the license server, the license server is either not running or it is
having trouble communicating with the system the test was run on. Check the license server log
file for errors and confirm there are no firewalls up and running between the client system and
the server.