Sun WorkShop Quick Install

Fax License Installation

If you received your license information from the Sun License Center through a fax, follow these instructions to install your licenses.


Note -

If you have not filled out a License Request Form, see Chapter 2, Requesting Your Licenses for instructions.


  1. Become a superuser (root) by typing the following at the command line:

    % su

    Password: root-password

  2. Start lit_tty by typing:

    # /etc/opt/licenses/lit_tty


    Note -

    If you get a message that a LIC_CONFIG_FILE file cannot be found, you must install the SUNWwslic package (which is part of FLEXlm License Manager Software and Utilities when you install Sun WorkShop). See Chapter 3, Installing Software for installation instructions.


  3. In the Select Product to License screen, type an x next to WorkShop5.0.

    If instead of the Select Product to License screen you see the Select Product screen, skip to Step 4.

    Press Return to navigate down the product list to WorkShop5.0.

  4. In the Select Product screen, type an x next to the product for which you want to install a license.

    Your Proof of License Certificate provides information about the product(s) you purchased. If you do not want to install a license for the product where the cursor is, press Return to navigate to the next product on the list.


    Note -

    Only one product can be selected at a time. The process is iterative and will prompt you at the end of each cycle to install a license for the remaining products on the list.


  5. To designate a regular (not DEMO) license, press Return.

  6. Type an x to select the number of servers you will use.

    Press Tab to select a different number of servers.

  7. Verify the license server name and hostid.

    The license server name and hostid default to the machine where you are installing the license. Your hostid is the output of the /usr/bin/hostid command; your server name is the output of the /usr/bin/hostname command.

  8. Press Return to navigate past Phone Number List.

    For Sun License Center telephone and fax numbers, see your Proof of License Certificate.

  9. For Nodelocked to Host ID, type one of the following:

    • For a floating license, type none.

    • For a Personal Edition (node-locked) license, type the same hostid you typed on your License Request Form.

  10. For the expiration date, type none.

  11. For Rights to Use, type the number of rights to use that you received from the Sun License Center.

  12. For Password, type the password that you received from the Sun License Center.

  13. For Vendor String (VS), type the number from the VS column in the license information that the Sun License Center provided.

  14. Verify the Data Checksum (DC).

    If the data checksum is different from the number that the Sun License Center provided, recheck the checksum against the information provided by the Sun License Center, and then contact the Sun License Center (see your Proof of License Certificate for access information).

  15. Verify the Password Checksum (PC).

    If the password checksum is different from the number the Sun License Center provided, recheck the checksum against the information provided by the Sun License Center, and then contact the Sun License Center (see your Proof of License Certificate for access information).

  16. Type an x next to Done Setting Up This License.

  17. Press any key to return to selecting products for which you want to install a license, and repeat Step 4 through Step 16.

    If you are done selecting products for which you want to install a license, press Return to navigate to the bottom of the screen.


    Note -

    A server name and hostid are identified for each license. Make sure you use the license that is unique to the license server's server name and hostid.


  18. Decide whether you want to install the licenses.

    • To install the licenses, type an x next to Exit - Save Licenses.

    • To quit without installing the license, type an x next to Exit - Don't Save Licenses.

      If you will be using a redundant server configuration, you must install FLEXlm license manager software and run lit_tty on all three redundant servers. To install FLEXlm license manager software, see Chapter 3, Installing Software.

  19. If your application server and your license server are different machines, copy the /etc/opt/licenses/LIC_CONFIG_SCRIPT script and run it on each of the application servers that will access the software.

  20. Change the owner of the license server daemon (optional).

    The license server daemon is automatically configured to be owned by nobody. The adjust_flexlm_owner script is provided to allow you to change the user name to a valid account. The user name you select starts the license server daemon and has access to the license manager software utilities. Permissions are updated to allow group read and execute privileges for the user name you selected.


    Note -

    If you decide to use a user name that does not exist, create the user account before running the adjust_flexlm_owner script.


    Run the adjust_flexlm_owner script by typing the following at a command line:

    # /etc/opt/licenses/adjust_flexlm_owner


    Caution - Caution -

    To avoid potential security risks, do not use root as the user name.


    For your changes to take effect, you must stop the license daemon (if it is running) and restart it. To do so, follow the instructions at the end of the script. Run the adjust_flexlm_owner script at any time to change the user name.

  21. Exit from superuser privileges by typing:

    # exit

You are now ready to use your Sun WorkShop development tools.