WorkShop Installation and Licensing Guide: 4 - Installing Your Licenses

# Installing Your Licenses | # 4 |

Sun offers a concurrent user license model through the incorporation of network licensing software. This license manager software is provided for monitoring and controlling access to the software products.

A license can be checked out by any developer, at any computer on your network and then returned for others to use. A license token is checked out transparently by each user who accesses a product. When two or more users invoke the same application at the same time, they are considered "concurrent."

## 4.1 Configuring Your License Server

The workstation or server running the license daemon is called the license server. Select a very stable machine as your license server; do not select a machine that is frequently shut down or rebooted.

Depending on your licensing needs, configure your license servers using the criteria described in Section 4.1.1, "Single Independent Server Configuration," Section 4.1.2, "Multiple Independent Server Configuration," and Section 4.1.3, "Redundant Server Configuration." Once you have selected the machine as a redundant license server, that machine cannot be used in a different licensing configuration.

For additional licensing information, refer to Appendix B, "General Licensing Information."

### 4.1.1 Single Independent Server Configuration

A single independent server administers all product licenses. This scenario is best suited for sites where programmers, the license server, and product servers are all fairly close together on the network.

The single independent server configuration is the default and the easiest to install and administer. With this configuration, customers with smaller installations can focus their administrative resources on a few key servers.

### 4.1.2 Multiple Independent Server Configuration

When you use two or more servers independently, you create a multiple independent server configuration. Using this configuration, you indicate a number of rights to use (RTUs) for each server, and users can obtain a license token from any one of the servers. This scenario is most common for medium to large software development environments distributed over a network.

Distributing the total number of license tokens purchased among multiple license servers increases the likelihood that at least some license tokens will always be available, although any license tokens served by computers that are offline are unavailable until those machines are returned to the network.

While you can have any number of independent servers, it is recommended that you find a balance by placing license servers strategically throughout your network. This way you maximize the responsiveness of license requests and minimize the administrative overhead.

### 4.1.3 Redundant Server Configuration

A redundant server configuration enables you to have three servers managing a set of license tokens, in essence acting as one logical server. This configuration requires that a majority of redundant license servers be operative and able to contact each other. If the redundant servers cannot contact each other, none of the license tokens will be available.

At any time one of the redundant servers is the master server: the server that actually issues license tokens, thus having a heavier processing load. If the master server becomes unavailable, then the next available "peer" in the configuration becomes the master server.

The main advantage of redundant servers is an increased likelihood that if any tokens are available, then all tokens will be available; the cost is additional administration. Use of this configuration should be limited to special situations where its advantages outweigh the increased complexity of installation and maintenance.

## 4.2 Installing Your Licenses

You can use either a graphical user interface (GUI) or command-line interface to install your WorkShop products, depending on your preference. You can use a GUI by bringing up `workshop_install` and selecting the Install Licenses button to bring up a Motif interface of the License Installation Tool (lit). If you want to use a command-line interface you will invoke `lit_tty`.

To install your licenses, you must have received the license information from the Sun License Center. Use Chapter 2, "Getting Your Licenses," to obtain the license information.

Prior to installing your licenses, you must also install the license software. Use Chapter 3, "Installing Product Software," to install the license software on each license server. Once you install the FLEXlm licensing software, you can proceed with installing your licenses.

> Note - Your CD-ROM name depends on the platform for which you purchased Sun WorkShop products.
> For SPARC with Solaris, substitute `devpro_v5n1_`<platform> with `devpro_v5n1_sparc
> ` For Intel with Solaris, use `devpro_v5n1_intel`

### 4.2.1 Installation Using the Graphical User Interface

Using `workshop_install`, you can install your licenses with the file the Sun License Center sent you or with the information they provided via fax or telephone. Use the procedures in the section that corresponds to the response you received from the Sun License Center.

#### 4.2.1.1 Email License File Installation

  1. Save the license attachment you receive.

    Do not modify this attachment; any modification could invalidate all your licenses! The licensing software reads the information directly from the saved file.

  2. Using your window environment (OpenWindows, for example), enable remote client access by typing the following at a command prompt:

    `% xhost +`

  3. Using a command-line, become root by typing:

    `%` su

    `Password:` <root_password>

  4. Change your current directory to the CD-ROM drive by typing:

    # cd /cdrom/devpro_v5n1_<platform>

> Note - Your CD-ROM name depends on the platform for which you purchased Sun WorkShop products.
> For SPARC with Solaris, substitute `devpro_v5n1_`<platform> with
> `devpro_v5n1_sparc`
> For Intel with Solaris, use `devpro_v5n1_intel`

  5. If workshop_install is not running, invoke the License Installation Tool by typing:

    `#` ./lit

    If `workshop_install` is running, click the Install Licenses button to invoke the License Installation Tool.

    The License Installation Tool (lit) window is displayed, as shown in Figure 4-1.

##### Figure 4-1 License Installation Tool (lit) Window

  The radio button next to "loaded from an email message saved to a file" is selected by default.

  6. In the File field, enter the path to the file where you saved the license attachment you received from the Sun License Center.

    Or click the ellipsis (...) button; then find the path to the file you saved, using a file chooser.

  7. Click the Load License Information from File button.

    The Licenses to be installed pane, in the License Installation Tool (lit) window, is populated with a list of licenses from the email file.

  8. Click the Install button.

    The License Installation Tool installs your licenses.

  9. If your product server is different from your license server copy /etc/opt/licenses/LIC_CONFIG_SCRIPT and run this on each of the product servers that will access the product software.

  10. If you configured your license servers as either multiple independent or redundant, continue with the procedures in "Setting Up Your Multiple and Redundant License Servers" on page 4-30.

    Otherwise, if you have a single independent server configuration, go to "Checking Your License Files" on page 4-31.

#### 4.2.1.2 Fax or Phone License Installation

The License Installation Tool automatically sets the hostname and hostid with the hostname and hostid of the license server machine you're using.

  1. Using your window environment (OpenWindows, for example), enable remote client access by typing the following at a command prompt:

    `% xhost +`

  2. Using a command-line, become root by typing:

    `%` su

    `Password:` <root_password>

  3. Change your current directory to the CD-ROM drive by typing:

    # cd /cdrom/devpro_v5n1_<platform>

  4. If workshop_install is not running, invoke the License Installation Tool by typing:

    # ./lit

    If `workshop_install` is running, click the Install Licenses button to invoke the License Installation Tool.

    The License Installation Tool (lit) window is displayed, as shown in Figure 4-1 on page 4-23.

  5. Click the radio button next to "entered by hand from a FAX, telephone call or email message."

    The lit: Add license to be installed window is displayed, as shown in Figure 4-2.

##### Figure 4-2 lit: Add license to be installed Window

The Demo License should be defined as No, unless you are installing a Try`n'Buy license that has an expiration date.

WorkShop software is not nodelocked; therefore, this field is dimmed.

  6. Select the feature name for which you want to install a license, using the Feature Name field.

  7. Select the Feature Version field to enter the version of the license you are installing.

  8. If your licenses have an expiration date, enter the date in dd-mmm-yy format. For example, 15-aug-97.

    Otherwise, leave the field defined as "none."

  9. Enter the number of rights to use you received from the Sun License Center in the rights to use (RTU) field.

  10. In the Password field, enter the number the Sun License Center provided.

  11. In the Password Checksum (PC) field, verify the number the Sun License Center provided.

  12. In the Data Checksum (DC) field, verify the number the Sun License Center provided.

  13. Click the Add button.

    The License Installation Tool adds this license to the list of licenses to be installed.

  14. Complete Step 6 through Step 13 for each license you want to install.

  15. Click the Close button after adding all the licenses to the list of licenses to be installed.

    The License Installation Tool (lit) window is displayed.

    If you want to install another license not listed in the Licenses to be installed pane, click the Add button to display the lit: Add license to be installed window again. Use Step 6 - Step 15 to add licenses to the list of Licenses to be installed.

  16. If you will have a redundant license server configuration, click the "Set up redundant server information" button and enter the information for the other license servers.

  17. Click the Install button to install the licenses listed in the Licenses to be installed pane.

    The License Installation Tool (lit) installs the licenses.

  18. If your product server is different from your license server copy /etc/opt/licenses/LIC_CONFIG_SCRIPT and run this on each of the product servers that will access the product software.

  19. If you configured your license servers as either multiple independent or redundant, continue with the procedures in "Setting Up Your Multiple and Redundant License Servers" on page 4-30.

    Otherwise, if you have a single independent configuration, go to "Checking Your License Files" on page 4-31.

### 4.2.2 Installation Using the Command-Line Interface

Using `lit_tty`, you can install your licenses with the email file the Sun License Center sends you or with the information they provide via fax or telephone. Use the procedures in the section that corresponds to the response you received from the Sun License Center.

#### 4.2.2.1 Email License File Installation

  1. Save the license attachment you receive.

    Do not modify this attachment! The licensing software reads the information directly from the saved file.

  2. At a command-line, become root by typing:

    `%` su

    `Password:` <root_password>

  3. Start lit_tty by typing:

    `#` /etc/opt/licenses/lit_tty -f <license_file_pathname>

    Here `<``license` `_` `file` `_` `pathname``>` is the path to the file where you saved the license attachment you received from the Sun License Center.

  4. If you want the displayed licenses installed, type y.

    The License Installation Tool installs and saves your licenses.

    Otherwise, if the licenses listed are not the licenses you want to install, type `n` and contact the Sun License Center to explain which licenses you purchased and want to install.

  5. If your product server is different from your license server copy /etc/opt/licenses/LIC_CONFIG_SCRIPT and run this on each of the product servers that will access the product software.

  6. If you configured your license servers as either multiple independent or redundant, continue with the procedures in "Setting Up Your Multiple and Redundant License Servers" on page 4-30.

    Otherwise, if you have a single independent server configuration, go to "Checking Your License Files" on page 4-31.

#### 4.2.2.2 Fax or Phone License Installation

The License Installation Tool automatically sets the license server name and hostid with the hostname and hostid of the machine you're using.

  1. At a command-line, become root by typing:

    `%` su

    `Password:` <root_password>``

  2. Start lit_tty by typing:

    `#` /etc/opt/licenses/lit_tty

  3. Enter an X next to the product for which you want to install a license.

    Press Return to go to the next product listed, enter `n` to go to the next page; enter `p` to go to the previous page.

  4. If you are installing a Try'n'Buy license, enter an X next to DEMO License.

    Otherwise, if you are installing a perpetual license, press Return to select the number of servers you will use.

  5. Enter an X to select the number of servers you will use.

    Press Tab to select a different number of servers.

> Note - Hostnames and hostids of previously installed servers appear on the screen automatically. After you select the hostnames and hostids, you cannot change them.

  6. Enter the hostnames and hostids of the license servers.

  7. If you are installing a Try'n'Buy license, enter the expiration date.

  8. Enter the number of rights to use (RTUs) in the Rights to Use field.

    If you are installing demo licenses, do not complete this field.

  9. Enter the license password in the Password field.

  10. Verify the data checksum number.

    If the data checksum number is different from the number the License Center provided, contact the Sun License Center using the appropriate email address, fax number or phone number from the License Certificate.

  11. Verify the password checksum.

    The Checksum field displays the password checksum. If the password checksum number is different from the number the License Center provided, reenter the password, RTUs, expiration date, or vendor string. If the password checksum is still incorrect, contact the Sun License Center using the appropriate email address, fax number or phone number from the License Certificate.

  12. Enter X next to Done Setting Up This License.

    The license is added to the list of licenses to be installed.

  13. Repeat Step 3 through Step 12 for each license you want to install.

  14. Enter an X next to Exit-Install Licenses.

    `lit_tty` installs your licenses.

  15. If your product server is different from your license server copy /etc/opt/licenses/LIC_CONFIG_SCRIPT and run this on each of the product servers that will access the product software.

  16. If you configured your license servers as either multiple independent or redundant, continue with the procedures in "Setting Up Your Multiple and Redundant License Servers" on page 4-30.

    Otherwise, if you have a single independent server configuration, go to "Checking Your License Files" on page 4-31.

## 4.3 Setting Up Your Multiple and Redundant License Servers

If you set up your server configuration as multiple independent complete the steps in Section 4.3.1, "Multiple Independent Server Setup." If your license servers use a redundant configuration, complete the steps in Section 4.3.2, "Redundant Server Setup."

### 4.3.1 Multiple Independent Server Setup

  1. Using Chapter 3, "Installing Product Software," install the FLEXlm 4.1 licensing software on each license server.

  2. Depending on the section you used (either Section 4.2.1.1, Section 4.2.1.2, Section 4.2.2.1, or Section 4.2.2.2), install the appropriate license on each server using the same section.

    Make sure you use the license that is unique for the license server; a hostname and hostid are identified for each license.

  3. If you want to configure a product server to access licenses from two or more license servers, you must copy and run each license server's LIC_CONFIG_SCRIPT to the product server.

    For example, if the product server, swim, contacts the license server, ski, for a C compiler license but there are no licenses available. The product server can contact a second license server, run,

### 4.3.2 Redundant Server Setup

  1. Using Chapter 3, "Installing Product Software," install the FLEXlm 4.1 licensing software on each license server.

  2. Depending on the section you used (either Section 4.2.1.1, Section 4.2.1.2, Section 4.2.2.1, or Section 4.2.2.2), install the appropriate license on each server using the same section.

## 4.4 Checking Your License Files

After you install your software licenses, the License Installation Tool generates a `licenses_combined` file and elementary license files. You can use these files to troubleshoot many licensing problems.

- To display all installed licenses, become root and type:

  `#` lmstat -a -c /etc/opt/licenses/licenses_combined

- To get information about the licenses used by a compiler, use the
  `-xlicinfo` parameter. For example, for the C compiler type:

  `%` cc -xlicinfo

### 4.4.1 The `licenses_combined` File

The license daemon uses the `licenses_combined` file. This file is located on the license server in the `/etc/opt/licenses` directory.

### 4.4.2 Elementary License Files

The elementary license files are partial or complete copies of the `licenses_combined` file. Elementary license files are located on each product server in the `/opt/SUNWspro/license_dir` directory. Files have names like `sunpro.lic,1`, `sunpro.lic,2`, and so on.

WorkShop software checks the <installation_directory> for licenses, which by default is `/opt`. The product software automatically looks for the elementary license file relative to where it was installed.

If you're using either a multiple independent or redundant license server configuration, product servers may be served by more than one license server. Each license server is represented by an elementary license file on the product servers. Each product server must contain at least one elementary license file.

After completing the procedures in this chapter, you should be able to invoke your software products. If you are having difficulty running your tools, consult Chapter 5, "Managing Your Licenses," for troubleshooting information and additional license details.