test

Sun WorkShop Quick Install

Chapter 4 Installing Your Licenses

Before you can install your licenses, you must have:

This chapter describes how to install your licenses in the following ways:

Answers to Sun WorkShop licensing frequently asked questions (FAQ) are available through the World Wide Web at the following location:

http://www.sun.com/workshop/workshopFAQ.html

Special Cases

The following cases require special handling:

Note -

Single independent (including node-locked) and redundant server licenses cannot be mixed in the same license file (the licenses_combined file). A license server and its license file is for either a single independent server or a three redundant server set. A license server cannot handle both. A Personal Edition (node-locked) license can be installed on a three redundant server set. The Personal Edition hostid on the INCREMENT line in the license file can be the hostid of one of the redundant servers, if that is where the licensed application will be run, or it can be the hostid of an entirely different machine.

The lit GUI

This section describes how to start and use the lit graphical user interface.

Starting lit

This section describes how to start the lit GUI.

Note -

You must run lit on your license server.

If workshop_install Is Running

If your application server and your license server are different machines, run lit on your license server by following the instructions in "If workshop_install Is Not Running".

If your application server and your license server are the same machine and the WorkShop Install window is open, follow these steps:

  1. Click Install Licenses in the WorkShop Install window.

    The License Installation Tool window opens (see Figure 4-1).

  2. Skip to "Using lit".

If workshop_install Is Not Running

If your application server and your license server are different machines, run lit on your license server (not your application server).

Follow these steps:

  1. Enable client access by typing the following at a command line on your license server:

    % /usr/openwin/bin/xhost + hostname

    Replace hostname with the output of the /usr/bin/hostname command run on your license server.

  2. Become a superuser (root) by typing:

    % su

    Password: root-password

  3. Set your display.

    If you use a C shell, type:

    # setenv DISPLAY hostname:0

    If you use a Bourne shell, type:

    # DISPLAY=hostname:0

    # export DISPLAY

    If you use a Korn shell, type:

    # export DISPLAY=hostname:0

    Replace hostname with the output of the /usr/bin/hostname command.

  4. Start the License Installation Tool by typing:

    # /etc/opt/licenses/lit &

    The License Installation Tool window opens (Figure 4-1).

  5. Proceed to "Using lit".

Using lit

Depending upon how you received your license information from the Sun License Center, see either "Email License File Installation" or "Fax License Installation".

Email License File Installation

Note -

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

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

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

    Caution - Caution -

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

    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.

      lit reads the license information directly from the file where you saved the license information you received through email.

      Caution - Caution -

      If you are using a DOS-based email system, use the dos2unix command to convert the license file before using lit to read the license information. If you do not convert the license file before using lit, you might not be able to use your developer tools. See the dos2unix man page for more information.

    Figure 4-1 License Installation Tool Window

    Graphic

  2. In the File text box in the License Installation Tool window, type the pathname to the file where you saved the license information that the Sun License Center emailed to you, or click the browse button (...) to use a file chooser to find the saved file.

  3. Click Load File.

    Your licenses listed in the email you received from the Sun License Center appear in the Licenses to be Installed pane.

  4. If you requested a redundant license server configuration, click Set up Redundant Server Information.

    The Redundant Server Information window opens. Type the information for the other license servers, and click Ok.

    You must install FLEXlm license manager software and run lit on all three redundant servers. To install FLEXlm license manager software, see Chapter 3, Installing Software.

  5. Click Install.

    lit installs your licenses.

  6. When the installation is complete, click OK in the pop-up window.

  7. Click Exit in the License Installation Tool window.

  8. If the WorkShop Install window is open, click Exit to exit from the workshop_install GUI.

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

  10. 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 select.

    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.

  11. Exit from superuser privileges by typing:

    # exit

  12. Disable client access by typing the following:

    % /usr/openwin/bin/xhost - hostname

    Replace hostname with the hostname you used to enable client access earlier in this chapter.

    Note -

    Be sure to type the minus sign (-) in the xhost command.

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 by 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. Click Entered by Hand in the License Installation Tool window (Figure 4-1).

    The Add License window opens (Figure 4-2).

    Figure 4-2 Add License Window

    Graphic

  2. For Demo License, click No.

  3. Use the Product pulldown menu to select WorkShop5.0 if it is not already selected.

  4. Use the Feature Name pulldown menu to select the software for which you want to install a license.

    The information you received from the Sun License Center provides the feature names you need.

  5. For Feature Version, verify the software version you are installing.

    The information you received from the Sun License Center provides the software versions you need.

  6. For the Nodelocked to Host ID text box, do one of the following:

    • For a floating license, type none.

    • For a Personal Edition (node-locked) license, type your hostid in the Nodelocked to Host ID box. The hostid you type should match the hostid you typed in section 5 of your License Request Form.

  7. For Expiration Date, leave the field defined as none.

  8. In the Rights to Use (RTU) text box, type the number of rights to use that you received from the Sun License Center.

  9. In the Password text box, type the password that the Sun License Center provided.

    Note -

    A hostname and hostid are identified for each license. Be sure to enter the password that corresponds to the hostname of the license server listed in the License Installation Tool window.

  10. In the Vendor String (VS) text box, type the number that the Sun License Center provided.

  11. For Password Checksum (PC), verify the number that the Sun License Center provided.

    If there is a discrepancy, 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).

  12. For Data Checksum (DC), verify the number that the Sun License Center provided.

    If there is a discrepancy, 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).

  13. Click Add.

    lit adds this license to the Licenses to be Installed pane in the License Installation Tool window.

  14. If you have more licenses to install, click Clear in the Add License window.

    Repeat Step 4 through Step 13 to add licenses to the list in the Licenses to be Installed pane.

    If you requested a redundant license server configuration, click Set up Redundant Server Information in the License Installation Tool window. Then enter the information for the other license servers. You must install FLEXlm license manager software and run lit on all three redundant servers. To install FLEXlm license manager software, see Chapter 3, Installing Software.

  15. Click Exit in the Add License window.

  16. Click Install in the License Installation Tool window to install the licenses listed in the Licenses to be Installed pane.

    lit installs the licenses.

  17. When the installation is complete, click OK in the pop-up window.

  18. Click Exit in the License Installation Tool window.

  19. If the WorkShop Install window is open, click Exit.

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

    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.

  21. 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 (for example, flexlm), 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.

  22. Exit from superuser privileges by typing:

    # exit

  23. Disable remote client access by typing the following:

    % /usr/openwin/bin/xhost - hostname

    Replace hostname with the hostname you used to enable client access earlier in this chapter.

    Note -

    Be sure to type the minus sign (-) in the xhost command.

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

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.