test

Sun WorkShop Quick Install

The lit_tty Command-Line Executable

This section describes how to use the lit_tty command-line executable to install your licenses on your license server. Use the instructions that correspond to how you received your license information from the Sun License Center.

Email License File Installation

If you received an email from the Sun License Center containing your license information, follow these instructions to install your licenses on your license server.

Note -

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

  1. Save to a file the license information that you received from the Sun License Center.

    The email you received from the Sun License Center has the license information either in an email attachment or embedded in the body of the email message:

    • If you received an email attachment, save only the email attachment to a directory and a file name of your choice on your system.

    • If you received an email with the license information embedded in the email message, strip out the mail headers and the body of the email message, and save only the license information to a directory and a file name of your choice on your system.

      Caution - Caution -

      Do not modify the license information that you received from the Sun License Center. Any modification could invalidate all your licenses.

      lit_tty reads the information directly from the file where you saved the license information.

  2. Become a superuser (root) on your license server by typing the following at the command line:

    % su

    Password: root-password

  3. Start lit_tty by typing:

    # /etc/opt/licenses/lit_tty -f license-file

    Replace license-file with the pathname to the file where you saved the license information that the Sun License Center emailed to you. Refer to the lit_tty man page for more information.

  4. Decide if you want the displayed license installed.

    • If you want the displayed license installed, type y. lit_tty installs and saves your licenses.

    • If the license listed is not the license you want to install, type n. Contact the Sun License Center (see your Proof of License Certificate for access information).

      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.

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

    Running the LIC_CONFIG_SCRIPT script creates an elementary license file on your application server. For information on elementary license files, see Chapter 2 in the Sun WorkShop Installation and Licensing Reference.

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

  7. Exit from superuser privileges by typing:

    # exit

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

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.