WorkShop Installation and Licensing Guide: A - Installing Domain-Based Password Licenses

# Installing Domain-Based Password Licenses | # A |

This chapter provides instructions for acquiring and installing domain-based passwords. Domain-based passwords support products licensed through the GoldPass and ScholarPass sales programs and link software to network domains rather than specific license servers (machine as indicated by hostid).

Follow these steps for installation:

  1. Install your software packages using the procedures in Chapter 3, "Installing Product Software."

  2. Acquire and install your domain-based passwords, following the instructions in "Getting Domain-Based Passwords" on page A-58.

## Introduction to Domain-Based Passwords

A standard password ties a product to a particular machine as defined by its hostid, but domain-based passwords tie licensed products to a network domain. To provide a simple method for controlling access to the software, individual passwords can be ordered for domains or subdomains.

Domain-based passwords function without using a centralized license manager and without enforcing hard limits on the number of users. However, your software license may limit the number of users; these limits are defined in the licensing agreement.

The licensed software operates as long as the requesting user of the licensed software is on a valid network domain.

The license agreement signed by your organization includes information about the network domains where licensed software is installed. Passwords are issued only for the domains associated with your site as described in your agreement. Depending on how your network domains are set up, you can acquire a password for a single product (or product feature) that makes it available on all of the network domains at your site.

You can also receive individual passwords for each domain and subdomain. This allows you reasonable control of user access to the software. For example, the license agreement may simply identify `my_org.org` as the domain on which licensed software may operate. However, you can acquire a password for a particular subdomain (for example, `eng.my_org.org`) and limit access to the subdomain as well as its subdomains.

## Getting Domain-Based Passwords

Domain-based passwords are available one to two weeks after your GoldPass or ScholarPass license agreement has been signed and approved. Check the date of the agreement before requesting your password.

You get your passwords from the Sun License Center. You can contact the Sun License Center by email, fax, or telephone. We recommend that you contact the center by email.

The Sun License Center will need the following from you:

- Site number
  This number identifies your organization for all ScholarPass or GoldPass licensed software. Upon approval of your agreement, a site number is assigned to each site in your organization. If you don't have this number, ask for it from the individual who signed the licensing agreement for your organization.

- Serial number from your Proof of License Certificate
  The serial number is printed on the label attached to the Proof of License Certificate. The Proof of License Certificate is part of your ScholarPass or GoldPass product package. For an indication of the valid serial number on your certificate, look for a value of 0 RTUs (which translates to unlimited).

- General information, including:

- Your name and title

- Name and address of your organization--including zip code

- Your telephone and fax numbers

- Your email address

- The network domain names for the passwords
  The domain names that you supply are verified against the information that was provided in the license agreement. A password will be issued only if your requested domains are associated with your site number. We recommend that you use the widest network domains possible in your organization, taking into account that you do not violate the terms of your licensing agreement by providing access to ineligible users.

- The Sun License Center will also need the name and version number of the products for which you are requesting passwords.

- Use Chapter 2, "Getting Your Licenses," for the procedures to contact the Sun License Center.

## Installing Domain-Based Passwords

You will receive license passwords from the Sun License Center. The current implementation of domain-based passwords does not use a separate license server, so it is not necessary to run a license server to use the GoldPass and ScholarPass configured licenses.

  1. Check your directories to see if you have one of these directories:

    For Solaris 2.x: <installation_directory>/SUNWspro/license_dir
    For Solaris 1.x: /usr/lang/license_dir

    The default installation directory is `/opt`.

    If you have the appropriate directory, go to Step 3. If not, continue with
    Step 2.

  2. Become `root`; then create one of the following directories by typing:

    For Solaris 2.x: # mkdir \
    <installation_directory>/SUNWspro/license_dir
    For Solaris 1.x: # mkdir /`usr/lang`/license_dir

  3. Save the password information provided by the License Center in a text file named as follows:

    GoldPass license filename: sunpro.lic,gp
    ScholarPass license filename: sunpro.lic,sp

    Make sure your filename contains both a period (.) and a comma (,). You can append the contents of this new file to an existing domain-based password file or create additional files with an incremental name (for example, sunpro.lic,sp1, or sunpro.lic,sp2).

  4. Check the software with the -`lmstat` command-line option.

    # lmstat -A

    This will print the current license status of all products installed.

> Note - The number of licenses available is zero, which translates to unlimited, for a domain-based password.

  5. You can now use your licensed software.

### DNS Domain Name for Current Machine

- If a domain is specified in `/etc/resolv.conf,` it will be used (for SPARC for Solaris 2.x and SPARC for Solaris 1.x).

- If hostname is set to be a value that contains at least one period (`.`), the value to the right of the first period will be used as the domain value.

- If both are available, the domain listed in `/etc/resolv.conf` has precedence over the hostname value.

- If both NIS and DNS results are non-null, a case-insensitive comparison is performed with the domain listed on the license. If the domain value from the license is a subset of either the NIS or DNS values, the license will be granted.