test

Sun WorkShop Quick Install

The clustadd Command-Line Executable

These instructions describe how to use clustadd to install the FLEXlm license manager software and your Sun WorkShop development tools.

Note -

If you use the workshop_install GUI to install your software, you have an uninstall script available to remove the software. The only way to remove software installed using the clustadd command-line executable is to use the pkgrm command for each package you want to remove. See Chapter 7, Removing Software for more information.

Preparing To Use the clustadd Command-Line Executable

This section describes the steps to follow to prepare your system to use clustadd.

Note -

Throughout these instructions, replace platform with sparc if you use the Solaris SPARC Platform Edition or with intel if you use the Solaris Intel Platform Edition.

  1. Decide on a local or remote installation method.

    In a remote installation, you perform the installation on the system with the CD-ROM drive where you loaded the Sun WorkShop CD (the source computer) and install the software on another machine (the target computer). In a local installation, the source computer and the target computer are the same machine.

  2. Make sure your Sun WorkShop CD is in your CD-ROM drive.

  3. On your source computer, become a superuser (root) by typing:

    % su

    Password: root-password

  4. Follow the instructions for a local or a remote installation (see "Local Installation" or "Remote Installation").

Local Installation

For a local installation, follow these steps:

  1. If you have not already done so, go to the CD by typing:

    # cd /cdrom/devpro_v6n1_platform

  2. Skip to "Using the clustadd Command-Line Executable".

Remote Installation

For a remote installation, follow these steps:

  1. Add the following line to your /etc/dfs/dfstab file:

    share -F nfs -o ro /cdrom/devpro_v6n1_platform

  2. Find out if your source machine is an NFSTM server by typing:

    # ps -ef | grep nfsd

    If you see screen output that contains /usr/lib/nfs/nfsd, then nfsd is running. If nfsd is running, type:

    # /usr/sbin/shareall

    If nfsd is not running, start nfsd by typing:

    # /etc/init.d/nfs.server start

    # ps -ef | grep nfsd

    You should then get screen output that contains /usr/lib/nfs/nfsd. If not, contact your system administrator or your Sun authorized service provider.

  3. Make sure your source machine is exporting your product directory by typing:

    # /usr/sbin/dfshares

    Screen output shows the resource and server. See the dfshares man page for more information.

  4. Log in to the target machine.

    Replace user with your user login name (not root), and use a lowercase l (not the number 1) in the following command:

    # rlogin target-machine -l user

    Password: user-password

    % su

    Password: root-password

  5. Go to the source machine by typing:

    # cd /net/source-machine/cdrom/devpro_v6n1_platform

    If you cannot change to that directory and you do not have an automounter on your network, create a mount point on the target machine and mount the product directory by typing the following commands (do not type the backslash (\) as it indicates that the command must be typed as one line):

    # mkdir /remote_products

    # /usr/sbin/mount -F nfs -r source-machine:/cdrom/\

    devpro_v6n1_platform /remote_products

    # cd /remote_products

  6. Proceed to "Using the clustadd Command-Line Executable".

Using the clustadd Command-Line Executable

To use clustadd, follow these steps:

  1. Find the names of the metaclusters you want to install by typing the following:

    # bin/clustinfo

    Note -

    It might take a few moments before you get the output from the clustinfo command.

    See the clustinfo man page for more information; to access the clustinfo man page, type:

    man -M /cdrom/devpro_v6n1_platform/man clustinfo

    Review the output of the clustinfo command for the names to use to replace metacluster in Step 2.

    You must install FLEXlm version 6.1 (available with this release) to get the new sunwlicd vendor daemon binary; otherwise, licensing will not function properly. If your application server and your license server are different machines, install FLEXlm 6.1 license manager software on your license server, not on your application server (install your Sun WorkShop development tools on your application server). To identify FLEXlm as a metacluster to be installed, use FLEXlm_6.1 in place of metacluster in the clustadd command in Step 2.

  2. Type the following:

    # bin/clustadd metacluster( ... metacluster)

    Replace metacluster with the output of the clustinfo command described in Step 1 for each metacluster you want to install.

    See the clustadd man page for usage and options, including how to install in a non-default location (not in /opt) and how to install only 32-bit packages (the default SPARC installation is 64-bit and 32-bit packages). To access the clustadd man page, type:

    man -M /cdrom/devpro_v6n1_platform/man clustadd

    If you install the Sun WorkShop AnswerBook2 document collections (the SPROWSDOC metacluster), you must add the Sun WorkShop AnswerBook2 document collections to your AnswerBook2 Documentation Server. For information about adding and working with document collections, see Installing and Administering an AnswerBook2 Server online in the AnswerBook2 Help Collection, in your Solaris printed documentation, or on the web at http://docs.sun.com. For information about downloading AnswerBook2 Documentation Server software packages and viewing Sun WorkShop AnswerBook2 document collections, see Chapter 6, Viewing Online Documents.

    Note -

    If you are upgrading to FLEXlm 6.1 license manager software from an earlier FLEXlm version, you will automatically bring down your license manager during the upgrade. After you install your new licenses in Chapter 4, Installing Your Licenses, the license installation tool will start your license manager again. During the upgrade, your licensed software will be unavailable.

  3. Install the required operating system and product patches by typing:

    # ./install_required_patches

    To get patch information, type help at the install_required_patches prompt. Then follow the instructions on the screen to install all the patches for this release.

    Note -

    Read the README files in each of the patch directories to understand the fixes addressed by the patches.

    To access current Sun WorkShop product patches, see the following web site:

    http://access1.sun.com

  4. If you mounted the product directory during a remote installation, unmount by typing:

    # cd /

    # /usr/sbin/umount /remote_products

  5. Exit from superuser privileges by typing:

    # exit

  6. If you performed a remote installation, follow these steps (if you did not perform a remote installation, skip to Step 7):

    1. Exit from the remote machine by typing:

      % exit

    2. Regarding the NFS server, follow these steps if they apply:

      If nfsd was already running, type the following command.

      # /usr/sbin/unshare /cdrom/devpro_v6n1_platform

      If you manually started nfsd, stop it by typing:

      # /etc/init.d/nfs.server stop

    3. Remove the following line from the /etc/dfs/dfstab file:

      share -F nfs -o ro /cdrom/devpro_v6n1_platform

    4. Exit from superuser privileges by typing:

      # exit

  7. Review the README files located in the top directory of the software you installed.

  8. Set your PATH and MANPATH variables by following the steps in "PATH and MANPATH Variables".