Sun WorkShop Quick Install

Chapter 5 Requesting and Installing Domain-Based Licenses

This chapter describes domain-based licenses and how to request, install, and use them.

About Domain-Based Licenses

Domain-based licenses tie licensed products to a network domain. Domain-based licenses support products licensed through the GoldPass and ScholarPASS programs and link software to network domains rather than specific license servers. Domain-based licenses function without using a centralized license manager and without enforcing hard limits on the number of users.

The license agreement signed by your organization includes information about the network domains where licensed software is installed and any limitation on the number of users. Licenses 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 license 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 licenses 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 license for a particular subdomain (for example, eng.my_org.org) and limit access to that subdomain as well as its subdomains.

Requesting Domain-Based Licenses

Domain-based licenses are available one or two weeks after your GoldPass or ScholarPASS license agreement has been approved. Check the date of the agreement before requesting your license.

Follow these steps to request your domain-based licenses:

  1. Collect the following information:

    • 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 do not have this number, ask for it from the individual in your organization who signed the licensing agreement.

    • Your Sun WorkShop product name, version number, and serial number. The serial number is printed on the label attached to the Proof of License Certificate, which is part of your ScholarPASS or GoldPass product package.

    • Network domain names. The domain names that you supply are verified against the information that was provided in the license agreement. A license will be issued only if your requested domains are associated with your site number.

  2. Follow the steps in Chapter 2, Requesting Your Licenses to request and receive your license information from the Sun License Center.

    In section 6 of the License Request Form, add your site number and network domain name or names.

Installing Domain-Based Licenses

The current implementation of domain-based licenses does not require a separate license server, so it is not necessary to run a license server to use the GoldPass and ScholarPASS configured licenses.

Follow these steps to install your software and your licenses:

  1. Install your Sun WorkShop development tools by following the instructions in Chapter 3, Installing Software.

    There is no need for you to install FLEXlm 6.1 license manager software.

  2. Check your directories to see if you have the following directory:

    install-directory/SUNWspro/license_dir

    The default install-directory is /opt.

  3. Create a text file containing the license information you received from the Sun License Center.

    • If you received an email attachment, copy only the email attachment into the text file.

    • If you received an email with the license information embedded in the email message, copy only the license information into the text file (do not include the mail headers and the body of the email message).

    • If you received your license information by fax, input the license information into the text file.

  4. Save the text file in the following location with the following file name:

    • For GoldPass: install-directory/SUNWspro/license_dir/sunpro.lic,gp

    • For ScholarPASS: install-directory/SUNWspro/license_dir/sunpro.lic,sp


      Note -

      Make sure your file name contains both a period (.) and a comma (,).


      For the sunpro.lic text file you just saved, root should be the owner and have read and write permission; all others should have read-only access.

      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).


      Note -

      The number of licenses available is zero (unlimited) for a domain-based license.


You can now use your licensed software.

Using Domain-Based Licenses