WorkShop Installation and Licensing Guide: 3 - Installing Product Software

# Installing Product Software | # 3 |

Software files are provided for the following platforms:

- SPARC with Solaris software version 2.4 or later

- Intel with Solaris software version 2.4 or later

You can install products using either a local or remote installation. Figure 3-1 illustrates the different installation methods.

##### Figure 3-1 Local and Remote Installation Methods

Source computer refers to the system with the CD-ROM drive where you will load the CD containing the WorkShop product files. Target computer refers to where you want to install the software.

## 3.1 Keeping Previous Software Versions

To support both previous Developer Products software releases and the new WorkShop software on the same machine, select a different installation directory for the new software.

For example, if your previously installed compilers are in `/opt/SUNWspro`, you may want to install the new compilers in `/current/SUNWspro` by creating a directory called `/current` in a file system with sufficient disk space. You would also need to have two separate settings for your `PATH` and `MANPATH` environment variables; one setting for your preexisting area, and the other setting for the `/current` area. Refer to Section 3.4, "Setting MANPATH and PATH Variables," on page 3-18 for instructions on how to set these environment variables.

## 3.2 Installing Software

> Note - Your CD-ROM name depends on the platform for which you purchased Sun WorkShop products.
> For SPARC with Solaris, substitute `devpro_v5n1_`<platform> with
> `devpro_v5n1_sparc`
> For Intel with Solaris, use `devpro_v5n1_intel`

> Note - Do not install your licensing software on a diskless client. The license daemon is not intended for use on a diskless client.

  1. Using your source computer window environment (OpenWindows for example), enable remote client access by typing the following at a command prompt:

    `%` xhost +

  2. Become root on your source computer by typing:

    `%` su

    `Password:` <root_password>

  3. Put your product CD in your CD-ROM drive.

    Make sure to use the CD appropriate for the operating system and workstation platform. If you have Solaris 2.x (SunOS 5.x) on your workstation, make sure you use the Solaris 2.x CD. If you have Solaris 1.x (SunOS 4.x), use the 1.x CD along with the WorkShop Quick Install for Solaris.

    Also, be sure to use the correct CD for your platform. For example, if you are using an x86 computer, you can only use the Intel platform CD; the SPARC platform CD will not provide software for your Intel platform.

  4. If Volume Manager is not running, type the following:

    # mkdir -p /cdrom/devpro_v5n1_<platform>

    # mount -F hsfs -r /dev/dsk/c0t6d0s2 \
    /cdrom/devpro_v5n1_<platform>

  5. Change your directory to the CD by typing:

    `#` cd /cdrom/devpro_v5n1_<platform>

  6. Refer to Figure 3-1 to decide which installation scenario you should use. To perform a local installation go to Step 7. For a remote installation, complete Step a through Step i.

    a. Add the following line to the `/etc/dfs/dfstab` file:

      share -F nfs -o ro /cdrom/devpro_v5n1_<platform>

    b. Make sure the source machine is an NFS server by typing:

      `#` ps -ef | grep nfsd

      A line similar to the following should appear:
      `root 237 1 17 Jun 04 ? 0:00 /usr/lib/nfs/nfsd -a 16`

    c. If you get a line similar to the above, export your product directory by typing:

      `#` shareall

      If you do not get a similar line, type:
      `#` /etc/init.d/nfs.server start

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

      `#` dfshares

    Lines similar to the following should appear:
    `RESOURCE SERVER ACCESS TRANSPORT
    `<server_name:><product_location>`` <server_name:>`- -`

    e. Log in to the target machine with root access by typing:

      `#` rlogin`` <target_machine_name> -l root

    f. Create a mount point and mount the product directory by typing:

      `#` mkdir /remote_products

      `#` mount -F nfs -r`\
      ` <source_machine_name>`:` /cdrom/devpro_v5n1_<platform>`\
      ` /remote_products

    g. Depending on the shell you use, redirect the remote machine's display by typing one of the following:

      Using a C shell, type:

      `#` `setenv DISPLAY <`source_machine_name`>:0`

      Using a Bourne shell, type:

      `#` DISPLAY=`<`source_machine_name`>`:0 export DISPLAY

    h. Change your directory to where you mounted the software by typing:

      `# cd /remote_products`

    i. Continue with Step 7.

  7. Run `workshop_install` by typing:

    `#` ./workshop_install

> Note - Do not type an ampersand (`&`) after `workshop_install` to invoke the tool in the background. The `workshop_install` script requires interaction.

  The script asks if you want to change the software installation location from `/opt`, the default directory.

  8. If you want to install your software in a directory other than /opt, type y; then enter the location where you want the software installed.

    Otherwise, type `n` to install in `/opt`.

    The Install Software window displays, as shown in Figure 3-2.

##### Figure 3-2 Install Software Window

  9. Select the License Manager Software and Utilities box.

    You must use a current version of the license manager software and utilities. FLEXlm 4.1 is provided with this release; use only FLEXlm version 4.1 or later.

  - To find out what version of FLEXlm you are currently running, type the following in `/etc/opt/licenses`:
    `# ./``lmver -l lmgrd.ste`

    Your product and license server can be different machines; therefore, you do not have to install your product software on your license server.

    If you will use more than one license server, install the license software on each license server. To decide how you want to configure your license servers, refer to Chapter 4, "Installing Your Licenses," for specific information on single independent, multiple independent, and redundant server systems.

  10. Select the boxes next to all the software products you want to install.

    Use your Proof of License Certificate to determine which software products you purchased.

> Note - To install Internet WorkShop, you must first install Solaris NEO. Refer to the Solaris NEO Installation Guide for procedures.

  11. Click the Customize button if you want to:

  - Get component descriptions

  - Deselect online documents

  - Deselect product components

> Warning - Only experienced users should deselect product components. If a product is only partially installed, the product will not run.

  The Admintool: Customize Installation window displays, as shown in Figure 3-3.

.

##### Figure 3-3 Admintool: Customize Installation Window

Some software products have package dependencies. If you install a package-dependent product, you must install all of the other packages included with the product.

Default installation includes all product components and online documents.

You can view a product's components by clicking the arrow to the left of its name in the component selection box.

  12. Click OK; then repeat Step 11 as necessary to customize each product.

  13. Click the Install button in the Install Software window.

    Your product software is installed by `workshop_install`.

  14. Now use the procedures in Section 3.3, "Installing Patches," to install the WorkShop patches.

## 3.3 Installing Patches

Operating system and product patches are provided for WorkShop products. To ensure proper use of the WorkShop products, install the required patches using the following instructions:

  1. Install WorkShop patches by typing:

    # ./workshop_install_patch

    To get patch information, type `help`.

  2. Now use the procedures in Section 3.4, "Setting MANPATH and PATH Variables," to access the man pages.

## 3.4 Setting MANPATH and PATH Variables

After installing your software, you must set the `PATH` and `MANPATH` variables. After you set these paths, you'll get the most recently released information; otherwise, you may get an inaccurate version.

You should copy this information and send it to product software users.

  1. Open a C shell to set the MANPATH and PATH environment variables.

  2. Set the MANPATH variable for FLEXlm licensing software and your WorkShop product manpages by typing:

      setenv MANPATH $MANPATH:<installation_directory>/SUNWspro/man: \
      /<installation_directory>/SUNWste/license_tools/man

  3. Change the PATH variable in your .cshrc file by typing:

      set path = (<installation_directory>/SUNWspro/bin $path)

The default installation directory is `/opt`. If you indicated another installation directory when you invoked `workshop_install`, provide your installation directory in place of <installation_directory>.