UGS Licensing
UGS Licensing
PLM Software
Licensing V4.0 for
Windows
Proprietary & Restricted Rights Notice
This software and related documentation are proprietary to Siemens Product Lifecycle
Management Software Inc.
© 2011 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
TROUBLESHOOTING ............................................................................................................. 14
WINDOWS DIAGNOSTIC TOOLS ................................................................................................................................ 14
CREATING INSTALLATION LOG FILES ....................................................................................................................... 15
CHECKING THE LICENSE SERVICE ............................................................................................................................ 16
USING THE LMUTIL UTILITY ...................................................................................................................................... 17
CHECKING SERVER LINES ......................................................................................................................................... 18
SECURITY DEVICE NOT INSTALLED .......................................................................................................................... 19
Version 4.0
Preface
Intended Audience
This guide was written for system administrators at your site responsible for installing and
managing Siemens PLM Software Common Licensing. Those responsible need a good
knowledge of Windows system administration procedures.
To install Siemens PLM Software Common Licensing, you may need to know basic Windows
commands. This material is not covered in this document.
Conventions
All references to "Windows" in this manual refer to (32 or 64-bit) versions of Windows XP,
Windows Vista and Windows 7.
All references to “Common Licensing” in this manual refer to Siemens PLM Software Common
Licensing.
The “UGS” company name has changed to “Siemens PLM Software”. However, program
names, folder names and the product kit name retain the old UGS name.
When presenting a series of choices from a Windows pull-down menu, an arrow will be used
to represent the series of submenus, (e.g., Start Programs Accessories Windows
Explorer).
Introduction
This document explains how to install Common Licensing on Windows (32 or 64-bit)
operating systems.
Background
This document describes the installation and running of Common Licensing on Windows
operating systems.
Note Only a 32-bit version of Common Licensing is available. It may be installed on 64-bit
machines. However, on 64-bit machines the Microsoft OS will enforce their convention
of putting 32-bit products in the “Program Files (x86)” folder.
Note Some Siemens PLM Software products may support a ”Standalone Licensing” scenario,
whereby there is no Windows license server service required and licensing information is
acquired directly from a file. This requires access to a specially locked license file called
a “Standalone License” file. In this scenario it is not necessary to install the Common
Licensing product.
Pre-installation Considerations
Windows system
The Common Licensing product installation is supported on (32 or 64-bit) versions of
Windows XP, Windows Vista and Windows 7.
Note Networking Protocol. The UGSLicensing V4.0 installation distributed with NX 8.0,
does not support the IPV6 networking protocol. The IPV6 networking must be disabled
for the Common Licensing daemon (ugslmd) to work. This can be accomplished by
going to the Microsoft web page: http://support.microsoft.com/kb/929852 and selecting
the option to disable IPV6.
License file
Prior to beginning the Common Licensing installation, you must have the license file.
The file should have already been provided via e-mail from Siemens PLM Software. It
does not exist on the software media and is not generated by the install. We recommend
that you save the e-mailed license file as a text file in your temporary directory
%TEMP% and that you name this file ugs4.lic. The file may have any name and may
exist anywhere on your system but the install uses the default location for the license file
prompt: %TEMP%\ugs4.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.
Note Merging Siemens PLM Software license files with any other license file is not supported.
Administrator privilege
To install Common Licensing, you must use the Administrator account or an account
with full Administrator privileges.
Common Licensing must be installed on a locally mounted disk drive; the Windows OS
will not allow the installation of a “service” on a remotely mapped drive.
TCP/IP services are required to run Common Licensing. Please make sure that TCP/IP
services are set up and configured for your system. To do this, click on
Start Settings Control Panel Network Connections Local Area
Connection Properties button. TCP/IP should be displayed as one of the installed
protocols.
Siemens PLM Software applications use the TCP/IP network protocol to communicate
with the license server. Even if the UGS License Server (ugslmd) is running on the same
computer, TCP/IP is still used.
If your computer does not have an Ethernet Card configured, you must install the
Microsoft Loopback Adapter, which is a "virtual" network adapter that will allow your
computer to "talk to itself" via TCP/IP.
You may use the ping utility to check that your TCP/IP connection is operational. On the
computer where you will be running the Siemens PLM Software application, open a
Command Prompt window, and type
ping <hostname>
where <hostname> is the name of the computer you will be using as your License
Server. If the network connection is working correctly, several lines of diagnostic output
will be displayed, indicating the time required to transmit packets of data.
If the network connection is not working, you will receive an error message. You must be
able to ping your License Server (and vice versa) in order to run Siemens PLM Software
applications. For help with the ping utility, please consult your Windows documentation
or Help.
Note The Common Licensing installation will automatically install the “Sentinel” driver by
default on 32-bit machines. If you are not using a hardware key, the “Sentinel” driver
may be safely removed with Add/Remove programs.
Note Hardware keys are not a valid hostid for a license server. The Composite Hostid (CID) is
the only valid hostid for a Common License server.
Installation Instructions
It is assumed that you have checked all of the pre-installation considerations and are
ready to begin the installation.
Use the following steps to perform the installation from disk or DVD:
3. Select Install License Server from the media Launch screen (if available). {A
media launch screen may not be available, or may be disabled on your system}
OR
Using Windows Explorer, navigate into the ugslicensing040 folder on the DVD
drive, and double click on setup.exe to start the setup program.
4. Welcome dialog - At the welcome dialog, click Next to continue. Clicking on the
Cancel button at anytime during the installation will discontinue (and roll back)
the install.
5. Destination directory - Enter the destination directory path or accept the default
directory path provided. The installation will create the directory if it does not
exist. Click the Browse button to change the destination location.
6. License file - Enter the path to the license file stored on your system or accept the
default path provided. Click the Browse button to change the license file path.
7. Confirmation - The final dialog is the Setup Confirmation screen. To change the
license file path or destination directory, use the Back button to return to the
appropriate dialog.
The setup will install Common Licensing in the destination directory and will be
immediately available to serve licenses.
Unattended Installations
Caution Use of this type of installation is intended for experienced installers only.
A few of the commonly used command line switches for msiexec are:
LICENSEDIR – this property sets the value of the folder containing the
license file to use. If not specified the default is the %TEMP% folder for
your login account.
Note To specify a complete path to your license file, you must specify BOTH the
LICENSEDIR and LICENSEFILENAME. These two properties are concatenated to
produce the full path.
If you place your license file in %TEMP%\ugs4.lic, you will not need to
specify either parameter.
Caution If the install cannot find the license file, it will not complete.
Caution These examples may appear on multiple lines because of document formatting but
they must be entered on your computer as one line. Any arguments with imbedded
spaces must be quoted.
Default install - The following example installs silently using a default installation. It
will install in the default location and attempt to locate the license file at
%TEMP%\ugs4.lic. The “/qn+” switch will cause one ending message dialog to appear.
Custom License file - The following example installs silently, to the default destination
folder but specifies a full path to the license file. The “/qn+” switch will cause one ending
message dialog to appear.
Log switch - The “/L*v” switch can be added to any example above and will cause a
verbose log file to be generated in the location specified in the next argument. Note that
there is no space in the “/L*v” switch. The following example shows a customized
installation with one ending dialog and with a verbose log file in c:\temp\install.log. See
also msiexec help for various log switch options
Uninstall - The following example shows an uninstall. Only an ending dialogue will
appear. It is not necessary to specify a previous custom INSTALLDIR.
Note The uninstall does not remove the license file or log file.
To remove the Common Licensing product, run the Common Licensing setup and select
“Remove” or use the Windows Add/Remove utility and select:
You may also use the msiexec silent install option “/x” to uninstall Common Licensing
{e.g msiexec.exe /x “UGSLicensing.msi” /qn+}
Lmtools utility
The Common Licensing install will install the lmtools utility and provide a Start Menu
shortcut.
The LMTOOLS interface combines license administration tools and the utilities in the
lmutil executable.
To run from Start menu, double click on the program icon under:
Start Programs UGS Licensing lmtools
Refer to the Macrovision FLEXnet Licensing End User Guide for additional information
on LMTOOLS.
Note The Macrovision company name was changed to Acresso and then again to Flexera.
Troubleshooting
If you need help with any of these tools, please consult your Windows documentation or
Help.
See also log file examples in the section Unattended Installation of Common Licensing.
Note The msiexec.exe program supports many levels of log file information from terse
start/stop messages to the very verbose log example shown above. See “Help and
Support” on msiexec for information on the levels of logging available.
In Task Manager, you should see running process entries for two lmgrd.exe
processes and one ugslmd.exe process.
If the service is present, but not running, you may attempt to start it manually. Control
Panel Administrative Tools Services. Right-click the service name "UGS License
Server (ugslmd)", and click Start.
If the UGS License Server (ugslmd) service is unable to start, there may be other
problems. Choose Start Programs UGS Licensing LMTOOLS. In the
Service/License File section, select "Configuration using Services". Click on the "Config
Services" tab. The "UGS License Server (ugslmd)" service should appear in the Service
Name field. Verify that all "path to" entries are valid.
These entries displayed on the LMTOOLS screen should not be blank. If these entries are
blank, enter the correct service name as shown above. Use the browse button to search
the drive for the location of the installed license program (lmgrd.exe). Browse for the
correct license file. The default location for the log file should be set to C:\Program
Files\UGS\UGSLicensing\ugslicensing.log, provided that the directory path is where you
installed Common Licensing. Use the browse button to update this field. Make sure the
two checkboxes, “Start Server at Power Up” and “Use Services”, are both checked (after
checking “Use Services”, “Start Server at Power Up” will become available). Click the
“Save Service” button.
To start the license service from LMTOOLS, open the Start/Stop/Reread tab. Click the
Start button.
Note The graphically-oriented license administration utility LMTOOLS is also available on the
Siemens PLM Software Licensing client if installed.
from the server machine to verify that the vendor daemon is alive. Run the same
command from a client machine to verify the connection across the network from client
to vendor daemon. Other information may be extracted using different switches or
options; these are documented in the Macrovision FLEXlm End User Manual.
For example:
Diagnostic messages will appear telling you some possible sources of your problem.
License File Could Not If you are receiving your license data file via e-mail, you
Be Read need to save it in text format. Some users using MSWord as
their reader may receive garbage in the license file (ugs4.lic)
when it is received in mail. To verify if a license file is
corrupted:
cd /d c:\Program Files\UGS\UGSLicensing
lmutil lmcksum –c ugs4.lic | findstr BAD
See ugslicensing.log When the lmgrd service is started, the log file
ugslicensing.log is created. The ugslicensing log can give
you the best information on the state of the license server.
This file is a text file that can be opened with standard text
editors. Errors may be a result from a corrupted license file,
the lmhostid not matching the license file, or networking
problems involving TCP/IP or DNS configuration. Use the
instructions given earlier to check that there is a working
TCP/IP network connection to your Common License
Server. The log file is located by default at:
c:\Program Files\UGS\UGSLicensing\ugslicensing.log {Win 32}
c:\Program Files (x86)\UGS\UGSLicensing\ugslicensing.log
{Win 64}
If the Hardware Key is not installed properly or if the Sentinel System Driver is not
installed and started, when a node-locked feature is attempted to be checked out, an error
message similar to the following will be displayed:
FLEXnet Licensing error: -9
Invalid host
The hostid of this system does not match the hosted specified in the license file.
Feature: gateway
Hostid: UG_HWKEY_ID=13625
License path: 28000@server1
FLEXnet Licensing error: -9,333
In addition, the debug log ugslicensing.log file will contain errors like the following: