Installing the License Administration Tools
8.1 Overview of License Server Tasks 65 8.2 Prepare 66
8.3 Installing the License Administration Tools 67
8.1 Overview of License Server Tasks
To run a license server that distributes Wind River software licenses to your workgroup, you must perform the following steps:
1. Obtain a license file for your server.
See 3. Obtaining Server License Files.
2. Gather the materials that you will need.
See 8.2 Prepare, p.66.
3. Install the License Administration Tools.
See 8.3 Installing the License Administration Tools, p.67.
4. If your organization has named-user licenses, specify named users and apportion licenses in a user options file.
See 9. Controlling Access to Products with the User Options File.
5. Configure and start the license server.
See 10. Starting Your License Server.
6. If your organization has named-user licenses, configure how license usage is logged, and generate reports from these usage logs.
See 11. License Usage Logging and Reporting.
7. Finally, perform any necessary maintenance tasks on your license server.
See 13. Maintaining a License Server.
8.2 Prepare
Before you can install and configure a license server, you must have the following available:
■ A server license file (see the instructions in 3. Obtaining Server License Files).
■ The Wind River License Administration Tools disc, or its downloaded equivalent.
■ The License Administrator Essentials sheet from the product box.
■ Hardware and software that meet the requirements listed below.
Hardware and Software Requirements
This section discusses minimum hardware and software requirements for the computer(s) on which you will install the License Administration Tools. They do not take into consideration any other software you are running on this computer.
Windows License Server
■ One of the following operating systems:
– Windows XP Professional, Service Pack 3 (32-bit) – Windows 7, Service Pack 1 (32- or 64-bit)
■ Administrator rights.
■ Intel Pentium 4-class processor minimum, 1GHz minimum.
■ 270 MB of disk space for a complete installation.
If you have named-user licenses, make sure any license server machines you use have available disk space (1-2.5 GB) to hold the intermediate license-usage logs as they are rotated and transferred.
■ A local DVD drive or access to network for installation.
■ An active Internet connection is recommended during initial installation to access patches, documentation, and other important information from the Wind River Online Support Web site.
Solaris License Server
■ Solaris 10.
■ A Blade 150 workstation with a 500 MHz processor, or a server or workstation with higher performance.
■ 270 MB of disk space for a complete installation.
If you have named-user licenses, make sure any license server machines you use have available disk space (1-2.5 GB) to hold the intermediate license-usage logs as they are rotated and transferred.
■ A local DVD drive or access to network for installation.
■ 32-bit application support.
NOTE: After this release of the License Administration Tools, Solaris will no longer be supported for license servers for Wind River products.
8 Installing the License Administration Tools 8.3 Installing the License Administration Tools
■ An active Internet connection is recommended during initial installation to access patches, documentation, and other important information from the Wind River Online Support Web site.
Linux License Server
■ One of the following operating systems:
– Red Hat Enterprise Linux Workstation 4.0, Update 9 (32-bit) – Red Hat Enterprise Linux Workstation 5.0, Update 7 (32- or 64-bit) – Red Hat Enterprise Linux Workstation 6.0, Update 1 (32- or 64-bit) – Ubuntu 10.04 (32- or 64-bit)
– Fedora 13 (32- or 64-bit)
– SUSE Linux Enterprise Desktop 11.0 (32- or 64-bit) – openSUSE Linux 11.2 (32- or 64-bit)
■ 32-bit application support.
■ Intel Pentium 4-class processor, 1 GHz minimum
■ A DVD drive or networked CD-ROM for installation.
■ 270 MB of disk space for a complete installation.
If you have named-user licenses, make sure any license server machines you use have available disk space (1-2.5 GB) to hold the intermediate license-usage logs as they are rotated and transferred.
■ An active Internet connection is recommended during initial installation to access patches, documentation, and other important information from the Wind River Online Support Web site.
8.3 Installing the License Administration Tools
The tools for running and controlling a license server are contained on the Wind River License Administration Tools disc. To install the tools, do the following:
1. Put the disc into your drive.
2. Navigate to that drive, and run the Setup program appropriate for your OS:
■ setup.exe for Windows (normally this will run automatically when the disc is inserted)
■ setup_linux for Linux
■ setup_solaris for Solaris
3. When prompted, select the desired installation directory.
Proceed through the screens of the Installer program.
4. At the Choose Activation Type screen, accept the default setting of Use your existing product activation (install.txt) file and click Next.
5. Finish the installation process and examine the results.
The tools are installed at installDir/licadmintools-1.3/hostType. For a description of the installed tools, see What Tools Are Installed?, p.68.
If at some point you need to remove the License Administration Tools, see Removing the License Administration Tools, p.105.
What Tools Are Installed?
Your installed License Administration Tools include the following elements:
■ the license server application
The license server application consists of two processes that work together:
– wrsd
The Wind River vendor daemon. It tracks how many of the available seats of a particular product have been assigned, and to whom.
For an overview of the functions of wrsd, see What Happens When You Start the License Server, p.81.
– lmgrd
The FLEXlm license manager daemon. When a development workstation requests a license, lmgrd routes the request to the correct vendor daemon.
For detailed information on lmgrd options and syntax, see C. FLEXlm Command Reference.
■ tools and utilities – wrsd_util
The Wind River utilities program for license server management and administration. It allows you to configure the log settings that wrsd uses.
For examples and detailed information on wrsd_util, see 11.3 Logging License Usage, p.86.
– lmutil
The FLEXlm utility for license server management and administration. It allows you to query a license server for information.
NOTE: If you have an existing, older installation of the License Administration Tools, you can use the same installation directory in this step, or select a new directory if you prefer. In either case, the new tools will be created in a separate, parallel directory, and will not overwrite the older version.
However, Wind River recommends that you remove the old versions of the tools, to avoid confusion—particularly in generating reports, as the reporting utility has changed. For uninstallation instructions, see Removing the License Administration Tools, p.105.
8 Installing the License Administration Tools 8.3 Installing the License Administration Tools
For detailed information on lmutil, see C. FLEXlm Command Reference.
– wrsd_report
The Wind River report generator. It produces plain-text license usage reports based on the binary logs that wrsd creates.
For full instructions on generating reports with wrsd_report, see 11.4 Reporting License Usage, p.92.
– lmtools.exe
A GUI-based tool for configuring the license server (Windows hosts only).
For examples of lmtools.exe use, see 10. Starting Your License Server, and 13. Maintaining a License Server.