2014sflm Users1
2014sflm Users1
2014sflm Users1
Manager
Installation and User’s Guide
Silvaco, Inc
4701 Patrick Henry Drive, Bldg. 2 January 8, 2014
Santa Clara, CA 95054
Phone: (408) 567-1000
Web: www.silvaco.com
Notice
Style Conventions
Chapter 1
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
1.1 What is SFLM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
1.1.1 Installation Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
1.2 What's New in SFLM 8.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.2.1 What’s New in SFLM8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.2.2 What was New in SFLM7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.2.3 What was New in SFLM6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.3 Installing Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.3.1 Installing a Windows Full Package (*.exe). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.3.2 Installing a Unix (Solaris or Linux) Full Package (*.tar.gz). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.3.3 Installing a Windows update (*.ssu). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.3.4 Installing a Unix (Solaris or Linux) update (*.ssu). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1.4 License Server Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
1.4.1 License Server Registration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
1.4.2 License Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.4.3 Setting up License Server(s) for Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.5 Running the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
1.5.1 Specifying the License Server(s). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
1.5.2 Specifying a Path to the Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Chapter 2
Registration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
2.1 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.2 Online Registration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
2.3 Offline Registration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Chapter 3
License Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
3.1 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
3.2 Automatic Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
3.3 Install Locally Saved License File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Chapter 4
Specifying the License Server(s) Using SFLM Access . . . . . . . . . . . . . . . . . . . . . . . . . .34
4.1 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
4.1.1 Starting SFLM Access. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
4.2 Starting the Server List Configuration Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
4.3 Choosing Configuration Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
4.4 Adding a Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
4.4.1 Adding a Normal Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
4.4.2 Adding a Redundant Server Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Chapter 5
Customer Environment Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41
5.1 Setting The Path To The Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
5.2 Choosing A Single License Server for a Specific User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
5.2.1 Local Settings for Individual Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
5.2.2 How to Set the SFLM_SERVERS Environment Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
5.3 Choosing Multiple License Servers for a Specific User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
5.4 Choosing a Redundant Server Cluster for a Specific User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
5.5 Testing User Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Chapter 6
Administration Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47
6.1 Administration Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
6.1.1 Install New License(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
6.1.2 Change Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
6.1.3 Re-Register License Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
6.1.4 Setup Redundant Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
6.1.5 Customize Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
6.1.6 Synchronize Server Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
6.1.7 Send Test Log Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Chapter 7
Reports Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56
7.1 Types of Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
7.1.1 Active Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
7.1.2 Valid Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
7.1.3 Token Charges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
7.1.4 License Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
7.1.5 Installed License Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Chapter 8
Support Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .65
8.1 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Chapter 9
Virtual Private Networks (VPNs) and Firewalls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .67
9.1 Virtual Private Networks (VPNs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
9.2 Firewalls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Chapter 10
SFLM Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70
10.1 Older Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
10.2 License Server ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
10.3 Upgrading an SFLM4 Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Appendix A
Frequently Asked Questions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
A.1 How do I bring up the web front end to SFLM? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
A.2 I have installed a new version but still seem to be running the old one? . . . . . . . . . . . . . . . . . . . . . . . 73
A.3 What version of SFLM do I have? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
A.4 What is registration? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
A.5 What is activation? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
A.6 What should I choose - online or offline registration? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
A.7 I have forgotten my password, what should I do? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
A.8 When I run an application I cannot get a license, what should I do? . . . . . . . . . . . . . . . . . . . . . . . . . . 74
A.9 How do I find out who has checked out a particular product license? . . . . . . . . . . . . . . . . . . . . . . . . . 74
A.10 What are redundant servers? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
A.11 How do I set up redundant servers?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
A.12 What can cause me to need to re-register? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
A.13 How can I reset the SFLM? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
A.14 How can I get a status similar to flexLM's "lmstat -a"?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
A.15 How do I get a quick status from the license server from the command line? . . . . . . . . . . . . . . . . . 76
Appendix B
Command Line Options for SFLM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
B.1 Command Line Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Appendix C
Hourly Charge Clock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
C.1 SFLM Hourly Charges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Appendix D
License Usage Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Register SFLM License Server Section 1.4.1 “License Server Registration” Chapter 2 “Registration”
Install License File Section 1.4.2 “License Installation” Chapter 3 “License Installation”
Set Default License Server for Run sflm_access Chapter 4 “Specifying the License
this Installation Directory Server(s) Using SFLM Access”
Set up User Environment Add /<installdir>/bin to user path (in Chapter 5 “Customer Environment
Unix only). Settings”
Note: Check Chapter 9 “Virtual Private Networks (VPNs) and Firewalls” for Firewall and VPN connection
problems.
Note: The online registration requires that the browser is able to access the internet. These are representations of
web pages but not their exact content.
Note: The automatic update requires that the browser is able to access the internet. These are representations of
web pages but not their exact content.
The alternative offline route is to send the license file by E-mail, floppy disk or some other
means. You would then use a file browser to find this file and load it with your web browser.
2.1 Overview
This chapter describes how to install the SFLM software and how the process of machine
registration works using a web browser. This step must be performed by all new users of
SFLM server. Figure 2-1 shows how the process of SFLM registration.
The first step is to obtain the SFLM software from the software vendor, unpack it onto your
machine and install it. Instructions for unpacking the software will be supplied with the
software delivery. After unpacking the software, install SFLM on the machine designated as
the license server. SFLM server software is included in all baseline release packages. Then,
start SFLM server on the license server.
The SFLM installation is performed from a command line on Solaris and Linux RedHat
operating systems. As the root user, execute the following command:
/<installdir>/bin/sflm -install
where <installdir> is the installation directory where the software was unpackaged.
If you are using a parallel HASP 4 key on a Linux platform, execute:
/<installdir>/bin/sflm -install -hasp
The -hasp option is not required for USB HASP.
On Windows platforms, InstallShield will take care of this first step but you need to have
administration rights.
Note: Running the sflm command requires root access. Once you run the sflm -install command, the
server will automatically start when the machine boots up. The rest of the registration may be from a regular
user account.
On all platforms, you will be asked to provide a new password. Some of the web pages for
SFLM affect how the license server functions. Therefore, you must use give the original
password before accessing these functions. All other pages that are standard reports will be
accessible to users without this password.
Note: The SFLM password is only for protecting certain SFLM pages. It is not an existing system password.
After installation, bring up a web browser (either FireFox 3 and above or Internet Explorer)
and type in:
http://<server-name>:3162
in the address bar. Here, <server-name> is the hostname or machine name of the computer
where sflm -install or InstallShield was run. If you do not know the name of your current
machine, you can use the special name 127.0.0.1 instead of <server-name>. For
example, http://127.0.0.1:3162.
Note: The web browser does not need to be run on the license server machine. After the sflm -install, you
may use any machine to run the browser. The <server-name>, however, MUST be the machine where
sflm -install was performed.
When the web browser pops up, it should display a page similar to the one shown in
Figure 2-3. This is the beginning of a wizard that will guide you through the process of
registration.
At anytime, you can click on Help in the browser to provide more information about the
current page.
Note: Existing Simucad users can unpack the new SFLM software on top of their existing SFLM4 installation.
Note: For online registration, it is the machine running the web browser that needs access to the internet, and not
the license server where SFLM was installed.
Note: No direct access to the internet is needed. The machine running the browser can reside behind a firewall as
long as the proxy configuration is set properly.
Note: Online registration is available only if the browser can access pages on the internet.
Registration is now complete and a page similar to Figure 2-8 will appear when you click on
OK. You will now wait until the software vendor informs you that a license file(s) is ready to
be retrieved.
At this point, if you click on Next, the Code Name and Activation Code Page (Figure 2-10)
will appear but cannot be completed. The Code Name and Activation Code will be issued on
receipt of the registration data above. When you receive this information, return to the Offline
Registration Page and enter the Code Name and Activation Code.
You can return to this page any time by opening the main SFLM home page
(http://<server-name>:3162), clicking on Admin, Re-register License Server,
Register Offline, and finally Next.
When you enter the Code Name and Activation Code, you will see the Registration
Complete Page (Figure 2-7) that lets you know the activation was successful. Click OK on
this screen to complete the SFLM activation. The SFLM system is now ready to accept
license files.
In response to your E-mail, you will receive a message like the following.
CodeName 0SSMID00009009
ActivationCode 1234 ABCD 5678 EFGH
MachineID mrtall-8327948c-f832f653
Registration is now complete and a page similar to Figure 2-12 will appear when you click on
OK.
3.1 Overview
After completing registration successfully, the software vendor will inform you that a license
file is ready. Figure 3-1 shows the process of installing the SFLM License.
Click on the Install New License(s) option (shown in Figure 5-8) to display Figure 3-2. In
this screen, you can choose the Automatic Update or an Install Saved File options.
Note: The Automatic upload is available only if the browser can access pages on the internet.
Once you find the license file, click Next to load it. If the license file is valid, the following
confirmation page will appear (Figure 3-6). Otherwise, an error message will appear.
4.1 Overview
There are two ways to specify which license server(s) to use. First, you can specify a list of
license servers using sflm_access, which sets the default list of servers used by the
applications installed in the same location as the sflm_access program. This is normally
done by the person installing the software as other users may have write permission problems
to the configuration file.
Alternatively, you can set the environmental variable SFLM_SERVERS, which is described in
Section 5.2.2 “How to Set the SFLM_SERVERS Environment Variable”.
Note: /<installdir> is the path to the top directory of the vendor's installed software.
Note: The name sflmserver is the machine name of the new license server.
Note: SFLM_SERVERS has replaced the environmental variable SFLM_SERVER. If both variables are set,
SFLM_SERVERS will be used for new applications (SFLM 5 and above). SFLM_SERVER will be used for
old applications (SFLM4 and below).
Note: 1. It is important that spaces exist only between machine names. No spaces are allowed within one machine
name.
2. Each machine has a full SFLM installation, which is stand alone. This is not a redundant server setup.
3. All the servers need to undergo the Registration process.
Note: All the redundant servers need to undergo the Registration process and the license file is specifically
generated by the vendor to allow redundant servers.
<install_drive>: C:
cd <installdir>\bin cd \simucad\bin
Note: You may need a new license file generated by the vendor if the re-registration process assigns a different
Code Name to your server. Your Code Name is shown in the machine IDs list at the bottom of the SFLM
web page http://<server-name>:3162. For example, in Figure 6-1 it is 0SSMID10001820. This will depend
on the extent of the changes on your machine.
Note: This system is only available to software vendor applications that are SFLM6 (or above) compliant.
SFLM4 applications should point to the primary server and will only run as long as that server is up and
running.
The order that servers are shown in the Server list will decide which is primary,
which is secondary and so on. You can change the order any time by selecting a
server from the list and using the control buttons on the right hand side (Move to
Top, Move Up, Move Down, Move to Bottom, and Delete). If communication is
broken with a server, a line will be drawn through the name of that server in the
Redundant Groups line.
Note: All 4 steps must be performed on all 3 of the redundant servers. The servers will then be able to
communicate with each other. This will be displayed at the bottom of the web browser SFLM page on the
Redundant Groups line. The environment for each user then needs to be changed to specify the redundant
server names.
Option Description
Off No logging.
ProductSummary Generates a summary of each product (license ID) usage.
UserSummary Generates a summary of each product (license ID) used by each user as
well as the combined product usage for all users.
ProductLog All license check-outs and check-ins are logged. The
ProductSummary is also generated.
AllLogging All license check-outs and check-ins are logged. The UserSummary is
also generated, which includes the ProductSummary.
Note: Logging check-outs and check-ins may require significant amounts of disk space.
Option Description
File Name This specifies the file to append the log message onto.
Log Level This pull down menu controls the individual logging level for the user
defined log file. See “Log Levels”. The default level is Off.
Verbose logging/messaging
This is Off by default. Switching to Yes will result in more details in some web pages and
some log messages.
You can reload all the current server settings from the server by clicking on Restore. To save
any changes you made, click on Save Changes.
Log Levels
These log levels control the seriousness of the messages being logged. When set to a level,
messages from that level and above are logged. For example, if the log level is Error, then
Error, Critical, Alert, and Emergency messages are also logged. These levels coincide with
the standard UNIX log message levels.
Severity Levels
Column Description
User and Prorgram User name of the person running the application and the program name and
version that checked out the license(s) from the SFLM server.
Job The job number (aka Process ID) of the application on a particular machine.
Each time an application is run the operating system assigns a unique ID to
that job, which is commonly known as the PID.
Host Host name or machine name on which an application is running.
License Information on which licenses the job is using. If a license request failed if
shows the licenses that failed to be granted.
Column Description
ID The ID of the license (aka product). Clicking on this link will provide a detailed list
of all licenses related to this license ID in all license files installed.
Name The name of the license (aka product). Clicking on this link will provide a detailed
list of all licenses related to this license ID in all license files installed.
Note: Licenses that have completely expired will not show up in this list at all.
Note: There is almost but not quite 95:52:46 left in this example. This shows how "Hourly Tokens" and "One
Second Tokens" are just different representations of the same value.
Column Description
ID The ID of the license (aka product). Clicking on this link will provide a detailed list
of all licenses related to this license ID in all license files installed.
Name The name of the license (aka product). Clicking on this link will provide a detailed
list of all licenses related to this license ID in all license files installed.
Cost The number and type of tokens required to grant this type of license, when tokens
are used.
Active The number of valid (purchased) token licenses active for this server.
Free The number of valid licenses that are currently free for use.
Maintenance Date This is the date license maintenance expires for this license. There may be
multiple dates if licenses expire at different times. Applications that are newer than
the maintenance date cannot use that license.
Note: Licenses that have completely expired will not show up in this list at all.
This screen again shows the Tokens purchased and the remaining time on the Hourly Tokens
in the Active column. In the Free column, it shows combined free licenses and remaining
time. The Token Charge Matrix shows that utility programs take 1 Universal Utility Token
and later that a One Second Token can be used instead of a Universal Utility Token when
needed. It also shows that SMARTSPICE takes 6 Universal Tokens and that an Hourly Token
can be used to replace a Universal Token when needed.
Column Description
License ID The ID of the license (aka product). Clicking on this link will provide a detailed list of
all licenses related to this license ID in all license files installed.
License Name The name of the license (aka product). Clicking on this link will provide a detailed list
of all licenses related to this license ID in all license files installed.
This page shows the combined status of licenses that can be checked out, as opposed the
licenses actually purchased. For example, this shows that DECKBUILD has 10 licenses
available for its use (the 10 Universal Utility Tokens). If all those are in use, there are 342165
runs available using One Second Tokens.
For SMARTSPICE, the situation is more complicated. This shows that the user brianb has 2
SmartSpice licenses checked out and davel also has 2 licenses checked out. It also shows that
0 normal and Universal Token are free and that if 1 SMARTSPICE was running only using
Hourly Tokens there would be 15:50:28 (hours:minutes:seconds) left to be used. Further
down, it shows brainb is effectively using 12 Universal Tokens and davel is only using 6 (he
is using 1 normal license). Even further down it shows that brain is using 8 Hourly Tokens,
meaning 8 seconds of Hourly Token time is being used for each second that elapses.
In reality, an application is give approximately 5 minutes of run time and the balance is
returns when the applications finishes or is killed. The application request to extent this time
about 2 minute before it expires.
To see a clock of the hourly token status, run sflm -clock. See Appendix Appendix C,
“Hourly Charge Clock,” for more information.
Column Description
License Filename The current location of the license file on the license server machine.
License ID A unique identifier for the license that your Vendor has provided. If you
contact your Vendor regarding licensing or general support then you should know
this license ID number before you contact them.
Status Active and expired machine IDs that are found in that license file. These IDs
identify the machine(s) where the license may be installed.
8.1 Overview
The support utilities are intended to be used whenever the license server has a problem and
will not issue a license to a user request. It is not a part of the general operation of the SFLM
license server. To access the support utilities, click on the Support Utilities link on the main
SFLM home page (Figure 8-1).
9.2 Firewalls
Currently, many machines have firewalls or port blocking software especially Windows XP
machines.
XP Service Pack 2 enables a firewall that prevent local web servers from being accessed from
other machines. Because SFLM is a Web server, it cannot be accessed by other machines
once Service Pack 2 has been installed. To overcome this problem, issue the following four
commands.
netsh firewall set portopening proto=tcp port=3162 "SFLM-Standard Floating
License Manager"
netsh firewall set portopening proto=udp port=3162 "SFLM-Standard Floating
License Manager (UDP)"
netsh firewall set portopening proto=tcp port=111 "ONC/RPC portmap"
netsh firewall set portopening proto=udp port=111 "ONC/RPC portmap (UDP)"
SIPC may also have problems so include the command that opens its port.
netsh firewall set portopening proto=tcp port=2809 "SIPC-Corba Name Service"
If you wish to be more secure, you can enable certain programs to receive messages through
the firewall. Since these programs are versioned, you will have to perform these procedures
again when a version is installed. For example:
C:\Simucad\bin\rpc.sflmserverd -WV
returns something such as 6.4.2.R. Substitute the number returned for 6.4.2.R below.
netsh firewall set allowedprogram "C:\Simucad\lib\rpc.sflm-
serverd\6.4.2.R\x86-nt\rpc.sflmserverd.exe" "SFLM-Standard Floating License
Manager"
netsh firewall set allowedprogram "C:\Windows\system32\portmap.exe" "ONC/RPC
portmap"
Also, for example:
C:\Simucad\bin\sipc -WV
returns something such as 1.0.9.R. Substitute the number returned for 1.0.9.R below.
netsh firewall set allowedprogram C:\Simucad\lib\sipc\1.0.9.R\x86nt\sipc.exe
SIPC-Corba Name Service"
A.2 I have installed a new version but still seem to be running the old one?
To run a new version, you need to restart it and possibly reinstall as a service.
On UNIX (Solaris or Linux)
su root
<install_dir>/bin/sflm -install
If <install_dir> is /opt/sedatools, it would be “/opt/sedatools/bin/sflm -
install”.
On Windows
Select Start and select Run... .
In the Run window, enter C:\sedatools\exe\sflm -deinstall -install -start.
See Section 1.3 “Installing Software” and Appendix Appendix B, “Command Line Options
for SFLM,” for more information.
A.8 When I run an application I cannot get a license, what should I do?
Make sure the license server is still alive. The SFLM software is designed to automatically
start itself if, for any reason, it should be forced to close by any other program. You can check
if the SFLM is running with the web front end. Click on Reports and then on List Installed
License Files. The table that is displayed will tell you if the server is running.
If SFLM is not running, you will need to restart it from the command prompt. As root (or
administrator), run the command:
sflm -start
A.9 How do I find out who has checked out a particular product license?
Open the web front end and click on Reports and click on Show Active Users.
<install_drive>: C:
cd <installdir>\exe cd \sedatools\exe
sflm -start sflm -start
sflm -stop sflm -stop
A.15 How do I get a quick status from the license server from the
command line?
Use the command:
/<install_dir>/bin/sflm -report current
Note: Because DOS needs the server to be installed as a service before it can run, some commands do slightly
different things.
-install Installs SFLM as a service and runs the Installs SFLM as a service but does not start
SFLM service. it.
-start Stops the SFLM service if running and Stops the SFLM service if running and starts
starts the SFLM but does not install it. the SFLM service and installs it if needed.
-stop Stops the SFLM service.
-deinstall Stops the SFLM service and removes it as a service. (This does not remove in files.)
-set-password Sets the administrative password. The service should be stopped when this is done.
These reports can also be viewed in a web browser using a URL like:
http://<server-name>:3162/Site/<report-name>
For example:
http://sflmhost:3162/Site/lmstat-a
or if web browser is running on the server machine:
http://127.0.0.1:3162/Site/lmstat-a
Example
prompt> sflm -report lmstat-a
none: UP v8.0.6.B
To track license usage and create statistical usage tables, you can turn on license usage
logging using AdminCustomize Logging (see “License Usage Logging” on page 53).
When license usage logging is turned on, a directory structure will be created in the specified
directory. In that directory, subdirectories and files are created for each day the usage is
logged. For example, if all logging was turned on for July 1, 2007, the following files would
be created.
• 2007/07/01/Summary.txt : A summary of license usage by product on July 1, 2007. A
line will exist for each product used during that day. If UserLogging is turned on, another
line will be added for each user and product combination. The line for the product
(without a user) will still exist as a summary of all users.
• 2007/07/01/Log.txt : Log of license check-out and check-in times on July 1, 2007.
Note: All licenses checked out at the end of the day are considered to be checked-in and immediately checked-out
for the next day.
Summary.txt
The summary files contain product (and maybe user) information about the total period
logging was turned on for the related period. It also contains summaries by time of day and
day of week to better grasp how licenses are being used. The columns of the summary files
are documented in this table.
Note: Single day entries do not have day of week summaries for obvious reasons.
UserName The login name of the user. If this is empty or (null), this refers to a
summary of all users.
ProductId The unique ID that identifies a product or program feature.
ProductName The name given for the ProductId above.
NrHours Number of hours that logging was turned on for this summary mode.
AverageDesired The average number of licenses desired for the product (and user). This
is a weighted average that tries to calculate the average over the 8
busiest hours during the day and the 5 busiest days of the week. It
slightly underestimates this value so it can be calculated on an ongoing
basis instead of just at the end of the week.
AverageUsed The average number of licenses granted for the product (and user).
This is a weighted average that tries to calculate the average over the 8
busiest hours during the day and the 5 busiest days of the week. It
slightly underestimates this value so it can be calculated on an ongoing
basis instead of just at the end of the week.
MaxDesired This is the peak number of licenses desired over the period logged.
MaxUsed This is the peak number of licenses granted over the period logged.
TotalDesired This is the number of licenses desired times the length of time they
were desired. Therefore, the unit is in “license hours”.
TotalUsed This is the number of licenses granted times the length of time they
were granted. Therefore, the unit is in “license hours”.
Hours00 Number of hours that logging was turned on for this summary mode
between 12am and 1am GMT.
AverageDesired00 The average number of licenses desired for the product (and user)
between 12am and 1am GMT. This is a weighted average that tries to
calculate the average over the 5 busiest days of the week. It slightly
underestimates this value so it can be calculated on an ongoing basis
instead of just at the end of the week.
AverageUsed00 The average number of licenses granted for the product (and user)
between 12am and 1am GMT. This is a weighted average that tries to
calculate the average over the 5 busiest days of the week. It slightly
underestimates this value so it can be calculated on an ongoing basis an
instead of at the end of the week.
MaxDesired00 This is the peak number of licenses desired over the period logged
between 12am and 1am GMT.
MaxUsed00 This is the peak number of licenses granted over the period logged
between 12am and 1am GMT.
TotalDesired00 This is the number of licenses desired times the length of time they
were desired between 12am and 1am GMT. Therefore, the unit is in
“license hours”.
TotalUsed00 This is the number of licenses granted times the length of time they
were granted between 12am and 1am GMT. Therefore, the unit is in
“license hours”.
Hours01 This is the same as Hours00 except 01 refers to between 1am and 2am
- Hours23 GMT– 23 refers to between 11pm and 12am GMT.
AverageDesired01 This is the same as AverageDesired00 except 01 refers to between
- AverageDesired23 1am and 2am GMT– 23 refers to between 11pm and 12am GMT.
AverageUsed01 This is the same as AverageUsed00 except 01 refers to between 1am
- AverageUsed23 and 2am GMT– 23 refers to between 11pm and 12am GMT.
MaxDesired01 This is the same as MaxDesired00 except 01 refers to between 1am
- MaxDesired23 and 2am GMT– 23 refers to between 11pm and 12am GMT.
MaxUsed01 This is the same as MaxUsed00 except 01 refers to between 1am and
- MaxUsed23 2am GMT– 23 refers to between 11pm and 12am GMT.
TotalDesired01 This is the same as TotalDesired00 except 01 refers to between 1am
- TotalDesired23 and 2am GMT– 23 refers to between 11pm and 12am GMT.
TotalUsed01 This is the same as TotalUsed00 except 01 refers to between 1am and
- TotalUsed23 2am GMT– 23 refers to between 11pm and 12am GMT.
HoursSunday Number of hours that logging was turned on for this summary mode on
Sunday.
AverageDesiredSunday The average number of licenses desired for the product (and user) on
Sunday. This is a weighted average that tries to calculate the average
over the 8 busiest hours of the day. It slightly underestimates this value
so it can be calculated on an ongoing basis instead of just at the end of
the week.
AverageUsedSunday The average number of licenses granted for the product (and user) on
Sunday. This is a weighted average that tries to calculate the average
over the 8 busiest hours of the day. It slightly underestimates this value
so it can be calculated on an ongoing basis instead of just at the end of
the week.
MaxDesiredSunday This is the peak number of licenses desired over the period logged on
Sunday.
MaxUsedSunday This is the peak number of licenses granted over the period logged on
Sunday.
TotalDesiredSunday This is the number of licenses desired times the length of time they
were desired on Sunday. Therefore, the unit is in “license hours”.
TotalUsedSunday This is the number of licenses granted times the length of time they
were granted on Sunday. Therefore, the unit is in “license hours”.
HoursMonday This is the same as HoursSunday except it refers to Monday–
- HoursSaturday Saturday.
AverageDesiredMonday This is the same as AverageDesiredSunday except it refers to Monday
- AverageDesiredSaturday –Saturday.
AverageUsedMonday This is the same as AverageUsedSunday except it refers to Monday–
- AverageUsedSaturday Saturday.
MaxDesiredMonday This is the same as MaxDesiredSunday except it refers to Monday–
- MaxDesiredSaturday Saturday.
MaxUsedMonday This is the same as MaxUsedSunday except it refers to Monday–
- MaxUsedSaturday Saturday.
TotalDesiredMonday This is the same as TotalDesiredSunday except it refers to Monday–
- TotalDesiredSaturday Saturday.
TotalUsedMonday This is the same as TotalUsedSunday except it refers to Monday–
- TotalUsedSaturday Saturday.
Log.txt
Each log file contains all the check-outs and check-ins for a day while logging was turned on.
The columns of the log files are documented in this table.
UserName The login name of the user running the process that checked-out the license.
HostName Name of the host (machine) the process was running on.
ProcessId The process ID number (a.k.a. PID).
ProductId The specific product this check-out refers to.
ProductName The specific product name this check-out refers to.
StartTime(InSeconds) When the number of granted licenses were checked-out in numder of
seconds since the start of the the Common Era (CE a.k.a. AD). An absolute
time is used here so license logs can be combined without lossing any date.
EndTime(inSeconds) When the number of granted licenses were checked-in in numder of seconds
since the start of the the Common Era (CE a.k.a. AD). If you substract the
StartTime, you know how long the license was checked out for.
NumberDesired The number of licenses of this product the process wished to check-out.
NumberGranted The number of licenses of this product the process checked-out.
Date The date in human readable form (YYYY/MM/DD). This should be the
same for every line in a file but may be useful when files are combined.
StartTime The time a license was checked out on this date in human readable form
(HH:MM:SS). If a license checkout spans from one date in another, an
EndTime for the end of day will be specified and a new entry for the next
day will be added with StartTime for the beginning of the new day.
EndTime The time a license was checked in on this date in human readable form
(HH:MM:SS). See StartTime for more details.
A M
Adding .............................................................................. 38 Multiple License Servers ........................................................44
Administration Privileges
Changing Passwords ........................................................ 49 R
Customize Logging ..................................................... 52–55
Redundant Server Clusters ....................................................45
Installing Licenses ............................................................ 48
Re-registering License Servers ............................................ 49 Registration
Sending Test Logs ........................................................... 55 Offline ......................................................................23–26
Setting Up Redundant Servers ...................................... 50–51 Online ......................................................................20–22
Synchronizing Server Time ................................................. 55 Reports .......................................................................57–64
Running SFLM
C Specifying License Servers .....................................14, 36, 43
Specifying Paths for Applications .............................14, 42–46
Charge Clocks .................................................................... 82
Command Line Options ................................................... 78–80
S
Compatibility ....................................................................... 71
Server ...............................................................................36
Custom Environment Settings
Testing User Environment .................................................. 46 Servers
List Configuration Wizard ...................................................36
Local / Network ................................................................39
F Redundant ......................................................................40
FAQs .......................................................................... 73–76 Set ...................................................................................40
Firewalls ............................................................................ 69 Setup ................................................................................50
SFLM Access
I Adding Servers ................................................................38
Installing ...................................................................... 10–11 Configuration Actions ........................................................37
Server List Configuration Wizard ..........................................36
Starting ..........................................................................35
L
SFLM_SERVERS ..........................................................35, 43
License Installation for SFLM
Automatic Update ............................................................. 30 T
License Servers
ID ................................................................................. 71 The ...................................................................................88
Multiple .......................................................................... 44 Tokens ........................................................................61–62
Redundant Server Clusters ................................................. 45
SFLM_SERVERS ............................................................ 43 U
SFLM_SERVERS. See SFLM_SERVERS ............................. 35
Utilities ..............................................................................66
User Settings .................................................................. 43
Licensing
Active User Reports .................................................... 58–59 V
Automatic Updates ........................................................... 30 Virtual Private Networks (VPNs) ..............................................68
Installation .................................. 13, 28–??, 28–??, 28–33
Installation Reports ........................................................... 64
Registering Servers .............................................. 12, 16–26
Reports for Valid Licenses ............................................ 59–60
Re-Registering Servers ..................................................... 49
Setting up Redundant Servers ....................................... 50–51
Setting Up Servers ............................................... 13, 35–40
Status Report ............................................................ 62–63
Trobuleshooting Server ..................................................... 66
Usage Statistics ......................................................... 84–88
Locally Saved License Files ............................................. 32–33