Professional Documents
Culture Documents
Preface .................................................................................................................................. 3
Intended Audience ......................................................................................................................... 3
Scope of this Guide......................................................................................................................... 3
Conventions ................................................................................................................................... 3
Introduction .......................................................................................................................... 3
Background .................................................................................................................................... 3
License File..................................................................................................................................... 4
Administrative Access .................................................................................................................... 4
Previous Licensing Installations....................................................................................................... 4
Installation ............................................................................................................................ 4
Windows........................................................................................................................................ 5
UNIX and Linux............................................................................................................................... 5
Mac OS .......................................................................................................................................... 5
Security.......................................................................................................................................... 6
Run License Server under a Different Account ................................................................................. 6
Troubleshooting .................................................................................................................... 8
Invalid Server Name Present ................................................................................................................................. 8
Vendor Daemon was not Detected Following the Install ..................................................................................... 8
Diagnostics............................................................................................................................ 8
Communication Diagnostic ............................................................................................................. 8
Steps for checking the license daemon is running using lmutil ............................................................................ 8
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.
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.
Files, commands, and directories will be written in bold letters.
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.
Introduction
This document explains how to install SPLM Licensing on supported systems.
The following topics are covered in this document:
Background
Pre-Installation Considerations
Installation
Advanced Installation Options
Post-Installation Considerations
Uninstalling SPLM Licensing
Troubleshooting
Diagnostics
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.
4
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.
Pre-installation Considerations
The SPLM Licensing product installation is supported on a variety of operating systems. For the supported
operating systems consult the following Customer Support (GTAC) Web site:
http://support.industrysoftware.automation.siemens.com/gtac.shtml .
System Requirements
The SPLM Licensing product requires Java 1.7+ to be installed on the system and some platforms may
require additional packages to be installed. These platforms and their requirements are listed below:
SuSE and Red Hat Linux:
LSB 4.0
libudev (only on cloud platforms)
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 administrators 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.
Installation
It is assumed that you have checked the Pre-Installation Considerations and are ready to begin the
installation.
5
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.
SPLMLicenseServer_[version]_win[bit]_setup.exe -i console
SPLMLicenseServer_[version]_[plat]_setup.bin -i console
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
UNIX and Linux:
USER_INSTALL_DIR=/usr/Siemens/PLMLicenseServer/
USER_SELECTED_LICENSE_FILE=/var/tmp/splm.lic
USER_SELECTED_ACCOUNT=<username for running the license server>
Security
We highly recommend running the license server by a user other than root since processes started by root
can introduce security risks. The best practice would be to create a user and group with proper security
and use that user 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 users primary group respectively.
Post-installation Considerations
The following paragraphs outline steps that the system manager may want to take after completion of the
installation.
Uninstalling
Windows
From the Control Panel go to Uninstall a program and remove Siemens PLM License Server.
or
Start All Programs Siemens PLM License Server Uninstall
8
Mac OS
Using Finder locate the Uninstall application in the SPLM Licensing install directory and double-click.
Troubleshooting
After the installation you might get one of the following issues.
Invalid Server Name Present
This occurs when the license file has a hostname on the SERVER line that does not match the machines
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.
Vendor Daemon was not Detected Following the Install
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 servers debug log (splm_ugslmd.log).
Diagnostics
Communication Diagnostic
This can be done by running the lmutil utility. The lmutil utility is a command line license administration
tool. This test can also be executed from the client if the lmutil executable is present on the client.
Steps for checking the license daemon is running using lmutil
1. Open a command prompt or shell
2. Change directory to the install directory.
3. Run lmutil with the lmstat option and license server flags.