You are on page 1of 11

SmartPlant� License Manager

1. Version Information
2. System Requirements
3. Version Compatibility
4. Special Instructions
5. Documentation
6. Training
7. Customer Support
8. New Features
9. Fixes
10. Open Problems
11. Legal Notices

=====================================
1 - Version Information
=====================================

Product: SmartPlant License Manager (SPLM)


Number: SEBY281AV-1200A
Version: 2012 (12.00.05.00)
Date: 21-Mar-2012

Description: PPM Licensing Product

-------------------------------------
///////// End of Version Information
-------------------------------------

=====================================
2 - System Requirements
=====================================

SPLM does not support any type of virtualization on the license machine (the
machine where you install the SPLM key.)

The SPLM license machine is sensitive to dynamic hardware configurations because


of security measures within the SPLM software.

Define a SPLM license machine that can best provide uninterrupted license
management for Intergraph applications.

The SPLM license machine should be a stable, single node, hardware configuration
(such as a simple PC), with a static IP address. The license key installation
and license seat usage authentication depends on the information gathered from
the physical hardware.

Any automated, intentional or unintentional changes that cause the hardware


information not to match with the information used to generate the license key
will result in a failure of the authentication process. Virtual, shadowed,
mirrored, dynamic, or distributed hardware configurations will not work as the
SPLM license machine. This can include terminal (application) servers, networked
and distributed storage management systems, etc. When these specialized systems
occur in the users' network.

The SPLM license system should be situated on the users'network where it can be
accessed by all systems that are running application software that relies on
the SPLM license machine for license management. Multiple SPLM license machines
can be used in the users' network as long as each system is a unique
system/installation.

If SLPM license machines are used to clone other hardware systems after the
license key has been installed then the license management will fail on the
cloned system. Each SPLM license system/installation requires its own unique
license key.

-------------------------------------
///////// End of System Requirements
-------------------------------------

=====================================
3 - Version Compatibility
=====================================

For up-to-date information on the software compatibility of this product in a


standalone or integrated environment, please refer to the Compatibility Matrix
on the Intergraph PPM Support Web site at http://crmweb.intergraph.com/.

Log on and perform the following steps:

1. Click the Service tab.


2. Click the Download Software Updates link.
3. On the Table of Contents page, click Products.
4. On the Product page under Compatibility Matrices (Now in Database Format), click
the 'PPM Compatibility Matrices Database' link.
5. On the PPM Compatibility Matrix - Product Report page, from the Select the
Product Code list, select SPLM.
6. From the Select the version list, select the desired version of SPLM.
For information about authoring tool versions that work with a particular version
of SmartPlant Foundation, follow the same steps listed above except select
SPEnterprise in step 5.

-------------------------------------
///////// End of Version Compatibility
-------------------------------------

=====================================
4 - Special Instructions
=====================================

----------------
Installing SPLM
----------------
The license software is delivered on SPLM media. You can also
download it from the Intergraph PPM Support Web site at
http://crmweb.intergraph.com

Log in and select the following options:

- "Download Software Updates"


- "Products"
- "SPLM"

The SmartPlant License Manager Installation and User's Guide DPDS3-PB-200019G


Version 2012 (12.0) June, 2012 is located at:

- "Download Software Updates"


- "Product Documenation"
- "SmartPlant License Manager"

To install this product, double-click on the setup.exe file. This activates


the install shield that allows you to select the installation options.

---------------
Upgrading SPLM
---------------

- For SPLM License Machine:

- If you currently have SPLM v11.00.17.00 installed on your license machine, you
can upgrade to
SPLM 2012 v12 directly, but you must generate a new machine ID and request a
new key after the upgrade.

- If you currently have SPLM 2008 v10 or previous version installed on your
license machine, you must
uninstall existing SPLM version prior to installing SPLM 2012 v12. You must
generate a SPLM v12
machine ID and request a v12 license key after you installed SPLM v12.00.05.00
on the license machine.

- To minimize downtime during the upgrade or uninstall/reinstall process on your


SPLM License Machine, you can
pre-request a SPLM 2012 v12 license key for your SPLM v11 or v10 or v9 License
Machine. Please refer to
"Important Upgrade Info for SPLM 2012" on eCustomer and eLicense sites for
details.

- SPLM 2012 v12 License Machine supports all previous versions of SPLM on Client
Machines.

- For SPLM Client Machine:

- If you currently have SPLM v11.00.17.00 installed on your Client machine, you
can upgrade to
SPLM v12 directly. No need to uninstall / reinstall SPLM.

- If you currently have SPLM 2008 v10 or previous SPLM version installed on your
Client machine, you must
uninstall existing SPLM version prior to installing SPLM 2012 v12.

- SPLM Client machine cannot have a newer version of SPLM than is installed on
the SPLM license machine.

Note:
A special upgrade document is available with additional information how to minimize
downtime during the upgrade process. The document "Important Upgrade Info for
SPLM 2012" is available on eCustomer and eLicense sites.

-------------
Helpful Hints
-------------

- Getting Started
------------------------------------------------
To use the SPLM license manager software it is necessary to contact Intergraph
to obtain a license key. The license key will correspond to the number of
licenses purchased. It will be necessary to furnish the Machine Identifier file

(generated using SmartPlant License Manager), the number of licenses requested


and the date the key will be installed. Please refer to License Key Request
Forms in the SmartPlant License Manager Installation and User's Guide
(DPDS3-PB-200019*) for the required forms.

- Generate Machine ID
------------------------------------------------
Machine ID is required from license machine to request a license key.

If SPLM 2012 v12 is installed on your license machine, you can run "Generate
Machine ID" from the Start > Programs > Intergraph SmartPlant License
Manager > Generate Machine ID. Select the Browse button and define the path
and filename for the Machine ID output file.

If a previous version of SPLM is installed on the license machine and you


need to request a v12 license key in advance to prevent production down time,
you need to download the Generate Machine ID 2012 executable from the
eCustomer web site. Copy the SPLMGenMachineID_2012.exe to a temporary
location and generate a v12 machine ID. Please refer to the "Important
Upgrade Info for SPLM 2012" on eCustomer SPLM site for details.

CAUTION:
After you send the machine ID to us, do NOT run Generate Machine ID
command again until the license key is installed. Running Generate Machine
ID again will invalidate the existing machine ID you sent to us and cause
the license key you receive not to install.

If you generate a new Machine ID after installing the license key, the
license machine will continue to work. However, you will have to supply
this new Machine ID to Intergraph when requesting a new or updated
license key.

- License Key installation


-------------------------------------------------
Removing the license key requires that you run generate Machine Identifier
again and receive a new license key from Intergraph. There is no need to
remove the old key because you can simply install the new key over the old
key. If you remove the key you will need to request a new one.

- SPLM installation File Path


------------------------------------------------
We recommend you install SPLM in its default location (c:\winapp32\ingr)

- SPLM with Firewall


------------------------------------------------
pdlice.exe must be added to the Exception List in Windows Firewall to
allow the license machine to scavenge properly if a workstation
abnormally closes a product. If it is not added to the Exception List,
the scavenge request will timeout for the workstation and not recover the seat.

- Restore Prohibited
------------------------------------------------
SPLM key files are stored on the license machine in the Windows
registry under:
HKEY_LOCAL_MACHINE\SOFTWARE\Intergraph\Pdlice_etc

DO NOT RESTORE this key or any of its sub-keys from a backup, as this
invalidates the data stored in these files and requires a new key to
be installed.

- Select License Machine requires administrator's privilege.


--------------------------------------------------

- TCP/IP Port No.


-------------------------------------------------
SPLM uses the TCP/IP port no. 807 to communicate with other systems
over the network. Since port numbers are not distributed by a central
authority on Windows, there is a very small likelihood that some other
program may already be using the same port number.
The SPLM service may fail to start on account of such a conflict.
If the Application Event Log so identifies the problem, please disable
the offending program and restart SPLM.

- SPLM Error Messages


-------------------------------------------------
Please consult the Windows Application event log for possible
SPLM Error Messages. SPLM writes to the event log if there is no
other avenue for presenting error messages - particularly for
unattended service related failures. Also check the Troubleshooting
section on the documentation and the product log and scavenge file.

- SPLM product removal


-------------------------------------------------
To remove SPLM use Add/Remove Programs from Control Panel. After
removing the product, user will need to generate a new Machine Identifier
and request a new key for the license machine.

-----------
Limitations
-----------

- SPLM does not support any RAID or SAN configuration on License Machine.

- It is required to have a static TCP IP address on the license machine. If


that is not possible we suggest to create a virtual network connection
by installing Microsoft Loopback Adapter.

- The SmartPlant License Manager licensing machine is not fully functional


when communicating across any network device that obscures the client's IP
address. This includes but is not limited to NAT routers or VPN solutions.

- SPLM 2012 v12 license usage log file will not contain the domain name for
PDS products.

- SPLM doesn't support client and machines working behind a firewall application.

- In a networked configuration where users workstations are accessing one or


more engineering application servers the SPLM machine should be installed on
a separate node, not on the application server. SPLM machine is not tested,
certified or supported when configured on an Application Server running Windows
Terminal Server and/or products such as Citrix Server.
- Virus scan software is not supported on the license machine.

- SPLM does not support NT.

- SPLM license machine doesn't support multiple network devices such as NIC
team on a single system.

- SPLM does not support the license machine to be inside a VM session. It is


supporting SPLM client inside a VM session.

- EMBASSY Trust Suite by Wave Systems is not supported on the license machine.
One would get �[Reading Socket] Connection reset by peer� message when
reserving license. This software is often found on many of different Dell
laptops. One needs to remove this software on the license machine.

- SPLM does not support Acceleration client in AT&T or Cingular Communication


Manager on license machine. One would get �[Reading Socket] Connection
reset by peer� message when reserving seat. One needs to uninstall
Acceleration client in AT&T or Cingular Communication Manager (Tools >
Settings > Acceleration tab > Client: Uninstall) and reboot the license
machine.

- If you are working in a heterogeneous environment, you need to use the


license machine's IP address instead of the actual name (node name).

-------------------------------------
//////// End of Special Instructions
-------------------------------------

=====================================
5 - Documentation
=====================================

Use the Help menu to access the Help files and Printable Guides for this product.
To suggest a change or to ask a question about the documentation, send an e-mail
message to PPMdoc@intergraph.com

Printed documentation is not available for separate purchase.

PDF File Reader


The documentation is provided as .pdf files. To view the .pdf files, you must
install a PDF file reader.

-------------------------------------
//////// End of Documentation
-------------------------------------

=====================================
6 - Training
=====================================

Currently no training is available for this product.

For current information on Intergraph training in general, use a World Wide Web
browser to connect to http://www.intergraph.com/training/.
-------------------------------------
///////// End of Training
-------------------------------------

=====================================
7 - Customer Support
=====================================

For the latest Support Services information for this product, including solutions
to known software issues, use a World Wide Web browser to connect to
http://support.intergraph.com/.

To open service requests outside the U.S., please contact your local Intergraph
office.

-------------------------------------
///////// End of Customer Support
-------------------------------------

=====================================
8 - New Features
=====================================

- CR 70851
A new counted type seat for the license key is now available for use by some
products.

- CR 73949
The Status window of the SPLM gui is now resizable.

- CR 105019
The SPLM GUI tag list for Test Reserve Seat command now displays the tag list
from the license key of the selected license machine.

- CR 105272
After upgrading the license machine software from v11 to v12, the License
Machine options in the GUI are available for use.

- CR 105385
Disabled the pdlice -Q and pdlice -N commands on the client machine.

- CR 106107
Disabled the pdlice -c command on the client machine.

- CR 106119
Disabled the pdlice -L command on the client machine.

- CR 107631
Added Chinese SLA to SPLM setup.

- CR 107667
Added GUI options for Test Seat Reservation and Test Seat Release using the
Current User registry settings to obtain the list of license machines.

- CR 108219
Stopped GUI from closing the "Install License Key" window when an invalid key
is entered.

- CR 109830
Added SPLM version to the machine id output file.
- CR 109850
Added GUI options to allow the creation of the registry settings under
Current User for Select License Machine and Remove License Machine commands.

- CR 109929
Removed requirement that pdlice_etc had to be exported if you were upgrading
the license machine and had already obtained a new license key for the new version
of SPLM.

- CR 112291
During installation the Log Product Usage setting is activated and the log
file name is defined. The log file name is located in the SPLM \bin directory and
is named loggingfileV12.txt.
WARNING: The log file could grow very large.

- CR 112292
During installation the Scavenge output file name is defined. The scavenge
file name is located in the SPLM\bin directory and is named scavengeV12.txt.

- CR 113587
The journal file for SPLM 2012 (v12) is now named SPLMv12journal. The
journal files will retain the v12 in their name when they are moved to the archive
folder by SPLM.

- CR 114468
Added Intergraph logo to the GUI.

- CR 118741
On the license machine added the ability for the user to define the number of
days to display the expiring license key message. The default is 45 days.

- CR 123163
On the license machine added the ability for the user to define the minimum
number of counted seats remaining on a tag in the license key before displaying a
warning message. The default is 100 counted seats.

- CR 124698
When you run setup for SPLM 2012 (v12) and SPLM 2010 (v11) is currently
installed on your machine, setup will display an upgrade message.

- CR 127456
When you run setup for SPLM 2012 (v12) and SPLM 2010 (v11) license machine is
currently installed on your machine, setup will display a warning message that the
existing license key will become invalid when you upgrade.

- CR 127603
Enhanced Audit Code to include information on new counted seats.

-------------------------------------
///////// End of New Features
-------------------------------------

=====================================
9 - Fixes
=====================================

- TR 106992
Before installing a key, the client would get "License Key has Expired"
message from the license machine.

- TR 108765
When running the Repair option, the SPLM service was not stopped and
restarted correctly.

- TR 108984
If you enter the license machine with a space at the end, the SPLM gui will
crash when using the "Select License Machine for Client" command.

- TR 111113
In options to display the Key, i.e, Show Key Status or Status of Reserved
License, the SPPD tag includes an extra character.

- TR 113815
Changed error message in pdlice -l (display license machine) when there are
no license machines defined.

- TR 114996
The GUI options changed on license machine in same open session after
generating machine identifier.

- TR 115407
In the GUI Install Key command When the key contained tags for all tags, the
key was not displayed correctly in the field.

- TR 116195
Intergraph was misspelled in the Help About dialogue box.

- TR 120421
The content on SPLM Help About should be read only.

- TR 124986
In the GUI Test Seat Reservation command, the SPPD tag included a garbage
character in the tag list.

- TR 124990
Added new pdlice commands pdlice -Z and pdlice -r n in pdlice -? and pdlice
-h.

- TR 125373
Corrected problems when installing key after IP was modified.

-------------------------------------
///////// End of Fixes
-------------------------------------

=====================================
10 - Open Problems
=====================================

- TR 72999 � "Connection Reset by Peer" message when reserving a license seat


caused by Panda Antivirus on the license machine only. This can be caused by
other virus scan software too.
Workaround: Uninstall virus scan software on your license machine.
- TR 77218 - SPLM fails to return the seat when the client machine changes
IP addresses between the get seat request and the return seat request.
Workaround: Scavenge will release the seat immediately if it can communicate
with the client or after 16 hours if it cannot communicate with the client.

- TR 106102 � Strange characters are reported in the usage log file for node
name for SPRD and SPMAT products.
Note: This is pending fix from SmartPlant Materials and SmartPlant Reference
Data.

- TR 106104 � Usage log file has SYSTEM reported as the UserName for SPRD product.

Note: This is pending fix from SmartPlant Materials and SmartPlant Reference
Data.

- TR 108316 � The usage log file incorrectly reports the UserName when using
Citrix server or Remote Desktop Services.
Note: To implement this fix, product applications must be rebuilt with SPLM
20102 v12.

- SmartPlant Instrumentation TR � 72957


If SPLM client has multiple license machines in the license machine list and
the first license machine does not have an SPI license/option word defined, SPI
will not start.
Workaround: Make sure that the license machine that has SPI license/option
word is the first one in the license machine list.

-------------------------------------
///////// End of Open Problems
-------------------------------------

=====================================
11 - Legal Notices
=====================================

Copyright (c) 1991-2012 Intergraph Corporation


All Rights Reserved

Including software, file formats, and audiovisual displays; may be used pursuant to
applicable software license agreement; contains confidential and proprietary
information of Intergraph and/or third parties which is protected by copyright and
trade secret law and may not be provided or otherwise made available without proper
authorization.

RESTRICTED RIGHTS LEGENDS

Use, duplication, or disclosure by the U.S. Government is subject to restrictions


as set forth in subparagraph (c) (1) (ii) of The Rights in Data and Computer
Software clause at DFARS 252.227-7013 or subparagraphs (c) (1) and (2) of
Commercial Computer Software-Restricted Rights at 48 CFR 52.227-19, as applicable.

Intergraph and the Intergraph logo are registered trademarks of Intergraph


Corporation in the United States and in other countries. The following are
trademarks and service marks owned by Intergraph Corporation or its subsidiaries
worldwide: http://www.intergraph.com/terms/trademarks.asp

Unpublished--rights reserved under the copyright laws of the United States.


Intergraph Corporation
Huntsville, Alabama 35894-0001
-------------------------------------
///////// End of Legal Notices
-------------------------------------

You might also like