C H A P T E R 5 - Installing Management and Data Host Software on Solaris OS Hosts

C H A P T E R 5

Installing Management and Data Host Software on Solaris OS Hosts

This chapter describes how to install the management and data host software. It contains the following sections:

About the Software Installation CD

Before You Begin

Unpacking the Installation File

Using the Host Software Installer

Using the Array Firmware Upgrade Installer

Using the Uninstall Wizard

Next Steps

About the Software Installation CD

The Sun StorageTek 6140 Host Installation Software CD provides three installation-related wizards:

Management Software Installer - The host software installer enables you to install a selection of applications and drivers to support a local management host, a data host, or a remote management host.

Array Firmware Upgrade Installer - The array firmware upgrade installer enables you to upgrade the array to the latest versions of base and NVSRAM firmware.

Uninstaller - The uninstall wizard enables you to uninstall the management and data host software from a host.

Note - Alternatively, you can install the management and data host software using the ./setup -c command in the command-line interface (CLI). Refer to the Sun StorageTek 6140 Array Release Notes for instructions.

Before You Begin

The README.txt file on the CD contains the latest information and instructions for the software installation CD. Before unpacking the compressed installation file on the target host, be sure to review the README.txt file on the CD.

Before unpacking the compressed installation file, check that the following requirements are met:

The operating system is Solaris 8 OS Update 4, Solaris 9 OS for the SPARC platform, or Solaris 10.

The root password of the management or data host is available so that you can run the installation wizards and log in to the Sun Java Web Console for the first time.

The DISPLAY environment variable is set to mgt_server:0.0. This is required in either of the following scenarios:

you log in to the management host as a user other root, and then use the su command to log in as root.

you log in to any host and use the telnet command to log in to the management host as root.

There is 550 megabytes of space for the unpacked the installation files in a local directory of the host.

To install the management and data host software, the following disk space is available in the specified directories of the management host:

root - 20 megabytes

/tmp - 150 megabytes

/usr - 40 megabytes

/var - 90 megabytes

/opt - 1,000 megabytes (1.0 gigabytes)

Previous versions of the management software are not installed.

Previous versions of the Storage Automated Diagnostic Environment will be detected and automatically upgraded by the installer. See Setting Up a Local Management Host for further details.

Sun StorEdge SAN Foundation software was not installed when you installed Solaris OS 8 and OS 9. The SAN software will be installed with the management host software for hosts running Solaris OS 8 or Solaris OS 9.

However, Sun StorEdge SAN Foundation software is installed with Solaris OS 10 and should not be removed. Install the latest patches for Solaris OS 10 to ensure that the host has the latest Sun StorEdge SAN Foundation software.

A previously installed service, such as the Storage Automated Diagnostic Environment, is not performing a function on the array over Ethernet port 1 of either array controller.

The installation script verifies these requirements. If a requirement is not met, the script informs you or, in some cases, exits the installation script.

Note - If a version of Sun Java Web Console prior to 2.2.5 is installed on the management host, the script prompts you to upgrade to the current version of the Sun Java Web Console. If you choose not to upgrade, the script exits.

Unpacking the Installation File

Sun StorageTek 6140 management software is distributed on the Sun StorageTek 6140 Host Installation Software CD that is shipped with the array.

Note - Note that you can also download the latest version of the software from the following site: http://www.sun.com/download/index.jsp?cat=Systems%20Administration&tab=3&subcat=Storage%20Management

The array installers are provided in a compressed .bin file on the CD.

Before you can use the installers, you must unpack the contents of this file on the host in which you will use the installers.

To unpack the installers:

Note - Before you continue, check that all of the requirements are met, as listed in Before You Begin.

1. Log in to the Solaris OS as root.

2. Insert the host software installation CD into a local drive.

The following items should appear in a directory window:

- README.txt

- RunMe.bin

- HostSoftwareInstaller.bin

- copyright information

- doc/819-5045-10.pdf (this guide)

If the compressed installation file does not appear in a directory window:

a. Change to the /cdrom/cdrom0 directory:

cd /cdrom/cdrom0

b. Display the contents of the CD.

ls -l

3. Review the README.txt file for the latest information on the product and the installation process.

4. To unpack the contents of the compressed installation file, do one of the following:

Double-click the RunMe.bin icon

Type the following command to launch RunMe.bin:

./RunMe

5. When prompted, specify the full path of the directory location in which the files will be unpacked.

The files are unpacked into the following directory in the location you specify:

Host_Software_2.0.0.xx

where xx is the software version number of the installed files.

The default location for the directory is /var/tmp.

The contents of the Host_Software_2.0.0.xx directory include:

- copyright

- bin/README.txt

- bin/setup

- bin/arrayinstall

- bin/uninstall

- bin/backout

- components/

- util/

The host software installer is launched after the installation file is unpacked. Complete the following step before using the wizard.

6. Review the README.txt file in the Host_Software_2.0.0.xx directory for a summary of the command syntax required for each wizard.

7. Eject the CD and remove it from the drive.

Using the Host Software Installer

The host software installer provides a wizard interface to enable you to install management and data host software for any of three host functions:

Local management host

Data host

Remote management host

Software Installation Options

The specific management applications and tools you install on a host depend on the intended function of the host. The host software installer provides the installation options identified as shaded blocks in TABLE 5-1.

TABLE 5-1 Software Installation Option s
Component	Typical Installation	Custom Installation
Component	Typical Installation	Management Host	Data Host	Remote Management Host
Sun Java Web Console
Java Runtime Environment (JRE)
Sun StorageTek Configuration Services browser interface
Sun StorageTek Configuration Services command-line interface (CLI)
Sun Storage Automated Diagnostic Environment, browser interface
Sun Storage Automated Diagnostic Environment, Enterprise Edition CLI
Sun StorageTek Software Manager (SSM)
Sun StorageTek 6140 Controller Module Firmware Patches
Storage area network (SAN) Drivers (including multipathing driver)

Note - *The SAN drivers are installed only on servers running Solaris OS 8 and 9. Servers running Solaris OS 10 should be updated with the latest Solaris OS 10 patches, which include the SAN drivers.

Setting Up a Local Management Host

Note - Before you start the installation, check that all of the host requirements are met, as listed in Before You Begin.

To set up a local management host, complete the procedures in the following sections:

Launching the Software Installer

Installing the Local Management Host Software

Enabling Multipathing Software

Completing Post-Installation Tasks

Launching the Software Installer

Note - Alternatively, you can install software using the ./setup -c command in the command-line interface (CLI). For instructions and command syntax for the CLI installer commands, refer to the bin/README.txt file in the installation directory and the Sun StorageTek 6140 Array Release Notes.

The host software installer is automatically launched after the CD installation file is unpacked.

To manually launch the host software installer:

1. Log in to the host as root.

2. Change to the Host_Software_2.0.0.xx directory in which the compressed installation file was unpacked:

cd <user-specified location>/Host_Software_2.0.0.xx

where xx is the software version number of the installed files.

3. Start the host software installer by typing the following command:

./setup

Installing the Local Management Host Software

Screen capture showing the Host Software Installation menu choices. Screen capture showing the prompts of the packages you want to install.

Screen capture showing confirmation prompts of the packages you want to install.When you launch the host software installer, the initial wizard screen is displayed.

If the initial wizard screen is not displayed or you receive an error message, recheck that the host requirements in Before You Begin are met.

Screen capture of the Sun StorageTek 6140 Host Installer screen.

1. Follow the steps in the wizard.

2. When prompted to select the installation type, do one of the following:

If the host will function as both a management host and a data host, select Typical, then click Next.

If the host will function as a management host only, select Custom, click Next, and then Select Management Host and deselect the other custom options.

See TABLE 5-1 to decide which installation option is right for the local management host.

Screen capture of the Sun StorageTek 6140 Host Installer Option Screen

Note - During the software installation, the progress indicator initially reflects 0% for a significant portion of the installation process. This is the expected progress indication for the typical installation process.

When the installation is complete, the host software installer Installation Summary screen is displayed.

3. Click Finish.

4. If the management host is also a data host, enable the Multipathing Software (See Enabling Multipathing Software).

Enabling Multipathing Software

Sun StorEdge SAN Foundation software includes the Sun StorEdge Traffic Manager multipathing software.

The procedure you use to enable multipathing software depends on the version of Solaris OS running on the host:

Enabling Multipathing Software for Solaris 8 or 9 OS

Enabling Multipathing Software for Solaris 10 OS

Enabling Multipathing Software for Solaris 8 or 9 OS

To enable the multipathing software on hosts running Solaris OS 8 or 9:

1. Open the /kernel/drv/scsi_vhci.conf file with a text editor.

2. Set mpxio-disable=no in the file.

3. Save the updated file.

4. Reboot the host.

Enabling Multipathing Software for Solaris 10 OS

To enable multipathing software for all Fibre Channel (FC) ports on hosts running Solaris OS 10:

1. Type the following command:

# stmsboot -e

Note - See stmsboot(1M) for complete details.

You are prompted to confirm the command:

WARNING: This operation will require a reboot.

Do you want to continue ? [y/n] (default: y)

2. Press the Return key to reboot the host.

Completing Post-Installation Tasks

After you install the management host software on a local management host, you need to do the following:

1. Configure IP addressing for the array.

See Configuring IP Addressing.

2. Register the array.

See Registering the Array.

3. Upgrade the base and NVSRAM firmware levels of the array.

All arrays managed by the management host must be at the same base and NVSRAM firmware levels.

You can choose to upgrade the firmware during the process of registering the array, or you can wait and upgrade the firmware in either of two ways:

Using the Array Firmware Upgrade Wizard (see Using the Array Firmware Upgrade Installer).

Using the firmware upgrade function in the Sun StorageTek Configuration Service browser interface (see the online help).

Setting Up a Data Host

The Sun StorageTek 6140 Array provides data path support for data hosts running Solaris, Windows 2000, Windows Server 2003, Red Hat Linux, HP-UX, NetWare, and SGI IRIX operating systems.This section applies to hosts running Solaris OS 8, 9, or 10.

See the Sun StorageTek 6140 Array Release Notes for the latest operating system versions that are supported.

Note - To install data host software on systems that are not running Solaris OS, see Installing Data Host Software for Operating Systems Other Than Solaris.

To set up a data host, complete the procedures in the following sections:

Preparing to Set Up a Data Host

Installing the Data Host Software

Configuring the Data Host Agent

Preparing to Set Up a Data Host

Before setting up a data host, verify the following for each data host:

All of the requirements are met, as listed in Before You Begin.

The operating system and version are supported as described in the release notes.

The host bus adapter (HBA) is installed as described in the release notes.

HBA firmware is at the required level as described in the release notes (HBA drivers are distributed through the Sun Download Center).

Data hosts are cabled to the array as described in Connecting Data Hosts.

The installation files are unpacked on the data host (see Unpacking the Installation File).

Note - See the Sun StorageTek 6140 Array Release Notes for a list of supported operating systems, operating system patches, and HBAs.

Launching the Software Installer

Note - Alternatively, you can install software using the ./setup -c command in the command-line interface (CLI). For instructions and command syntax for the CLI installer commands, refer to the bin/README.txt file in the installation directory and the Sun StorageTek 6140 Array Release Notes.

The host software installer is automatically launched after the CD installation file is unpacked.

To manually launch the host software installer:

1. Log in to the host as root.

2. Change to the Host_Software_2.0.0.xx directory in which the compressed installation file was unpacked:

cd <user-specified location>/Host_Software_2.0.0.xx

where xx is the software version number of the installed files.

3. Start the host software installer by typing the following command:

./setup

Installing the Data Host Software

Note - Before you start the installation, check that all of the requirements are met, as listed in Preparing to Set Up a Data Host.

Screen capture showing the Host Software Installation menu. Screen capture showing the prompts for the available packages you can install. Screen capture showing the confirmation prompt for the packages you selected to install. Screen capture showing an example of the date, time, and location of the installation log that is displayed when the installation is finished.

Use the procedures in this section to install only the data host software on a data host. The data host software enables the data host to interact with management hosts.

Screen capture showing the Host Software Installation menu choices. Screen capture showing the prompts of the packages you want to install.

Screen capture showing confirmation prompts of the packages you want to install.When you launch the host software installer, the initial wizard screen is displayed.

If the initial wizard screen is not displayed or you receive an error message, recheck that the host requirements in Before You Begin are met.

To use t he host software installer to install data host software:

Screen capture of the Sun StorageTek 6140 Host Installer screen.

1. Follow the steps in the wizard.

2. When prompted to select the installation type, select Custom and then click Next.

Screen capture of the Sun StorageTek 6140 Host Installation Options Screen

3. When prompted to select the software you want to install, select Sun StorEdge Data Host Software, deselect all other options, and click Next.

4. When the software installation is complete, click Finish.

5. Enable the Sun StorEdge Traffic Manager multipathing software (see Enabling Multipathing Software).

Configuring the Data Host Agent

After you have done all of the following, you are ready to configure the Sun Storage Automated Diagnostic Environment slave agent on the data host and synchronize it with the master agent on the management host:

Installed the management host software on your management host

Defined the IP address of the management host

Installed the data host software on a data host

To configure the slave agent on the data host, type:

/opt/SUNWstade/bin/ras_install

Note - Only use the ras_install command on data hosts, never on the management host that contains the management software with the master agent.

The ras_install script is displayed. Type the following when prompted:

S for the slave agent

The IP address of management host

C to start the slave agent

The following is the output from a sample ras_install script:

+----------------------------------+

| Installing the Package and Crons |

+----------------------------------+

? Are you installing a Master or a Slave Agent? (Enter M=master,S=slave, E=Empty Master) [M/S/E]: (default=M) S

The address of the master must already be defined before a slave

can be installed.

If the master has not been installed yet, abort this install and

go install this package on the host that was selected to be the master.

? Enter the IP Name/Address of the Master Host Agent 10.x.xx.xxx

- Testing communication with host '10.xx.xx.xxx' ..

- Communication successful.

- Starting the Storage A.D.E service (rasserv):

/opt/SUNWstade/rasserv/bin/apachectl startssl: ./rasserv started

- Setting up crons:

? Do you want to C=start or P=stop the Agent cron [C/P] : (default=C) C

- cron installed.

- Testing access to rasserv (this test will timeout after 4 tries of 10 secs):

- ping '10.x.xx.xxx' succeeded!

- 1/4 attempting to contact agent service...

- Contacted agent with hostid=xxcffxxx.

+-------------------------------+

| SUNWstade installed properly |

+-------------------------------+

- Sending monitored device-list to agent at 10.x.xx.xxx

-- diag-xxxx.Central.Sun.xxx already there

OK

Setting Up a Remote Management Host

You can select a custom software installation to install only the Sun StorageTek Configuration Services command-line interface (CLI) and the Java Runtime Environment (JRE).

This section applies to hosts running Solaris OS 8, 9, or 10.

Note - To install remote management host software on systems that are not running Solaris OS, see Installing Remote Management Host Software for Operating Systems Other Than Solaris.

To set up a data host, complete the procedures in the following sections:

Preparing to Set Up a Data Host

Installing the Data Host Software

Configuring the Data Host Agent

Preparing to Set Up a Remote Management Host

Before setting up a remote management host, verify the following for each remote management host:

All of the requirements are met, as listed in Before You Begin.

The operating system and version are supported as described in the release notes.

The installation files are unpacked on the data host (see Unpacking the Installation File).

Note - See the Sun StorageTek 6140 Array Release Notes for a list of supported operating systems and operating system patches.

Launching the Software Installer

The host software installer is automatically launched after the CD installation file is unpacked.

To manually launch the host software installer:

1. Log in to the host as root.

2. Change to the Host_Software_2.0.0.xx directory in which the compressed installation file was unpacked:

cd <user-specified location>/Host_Software_2.0.0.xx

where xx is the software version number of the installed files.

3. Start the host software installer by typing the following command:

./setup

Installing the Remote Management Host Software

Note - Before you start the installation, check that all of the requirements are met, as listed in Preparing to Set Up a Remote Management Host.

Use the procedures in this section to install only the remote management host software on a remote management host. The remote management host software enables the remote management host to perform monitoring functions using the command-line interface (CLI) of the Sun StorageTek Configuration Service.

Screen capture showing the Host Software Installation menu choices. Screen capture showing the prompts of the packages you want to install.

Screen capture showing confirmation prompts of the packages you want to install.When you launch the host software installer, the initial wizard screen is displayed.

If the initial wizard screen is not displayed or you receive an error message, recheck that the host requirements in Before You Begin are met.

To use the host software installer to install remote management host software:

Screen capture of the Sun StorageTek 6140 Host Installer screen.

1. Follow the steps in the wizard.

2. When prompted the installation type, select Custom and then click Next.

Screen capture of the Sun StorageTek 6140 Host Installation Options Screen

3. When prompted to select the software you want to install, select Sun StorEdge Remote Management Host Software, deselect all other options, and click Next.

4. When the software installation is complete, click Finish.

Using the Array Firmware Upgrade Installer

Note - Before you can upgrade the firmware on the array, you must first use the Sun StorageTek Configuration Service to register the array. See Registering the Array for instructions.

Use the array firmware upgrade installer to install the latest base and NVSRAM firmware levels on the Sun StorageTek 6140 Array.

Note - Alternatively, you can upgrade the firmware of the array using the ./arrayinstall -c command in the command-line interface (CLI). For instructions and command syntax for the CLI installer commands, refer to the bin/README.txt file in the installation directory and the Sun StorageTek 6140 Array Release Notes.

To install the latest base and NVSRAM firmware on the array:

1. Log in to the management host as root.

1. Ensure that the installation files are unpacked on the management host.

If the installation files are not unpacked on the host, see Unpacking the Installation File for instructions.

2. Change to the Host_Software_2.0.0.xx directory in which the compressed installation file was unpacked:

cd user-specified-location/Host_Software_2.0.0.xx

where xx is the software version number of the installed files.

3. Start the array firmware upgrade installer by typing the following command:

./arrayinstall

The array firmware upgrade installer wizard is displayed.

4. Follow the steps in the wizard.

5. When the installation is complete, click Finish.

Using the Uninstall Wizard

Use the Uninstall wizard to remove all management and data host software from a host.

Note - Alternatively, you can uninstall the management and data host software using the ./uninstall -c command in the command-line interface (CLI). For instructions and command syntax for the CLI installer commands, refer to the bin/README.txt file in the installation directory and the Sun StorageTek 6140 Array Release Notes.

To remove all management and data host software from a host:

1. Log in to the management host as root.

2. Ensure that the installation files are unpacked on the management host.

If the installation files are not unpacked on the host, see Unpacking the Installation File for instructions.

3. Change to the Host_Software_2.0.0.xx directory in which the compressed installation file was unpacked:

cd user-specified-location/Host_Software_2.0.0.xx

where xx is the software version number of the installed files.

4. Start the uninstall wizard by typing the following command:

./uninstall

The array uninstaller wizard is displayed.

5. Follow the steps in the wizard.

6. When the uninstall operation is complete, click Finish.

Next Steps

You are now ready to set up IP addressing for the array, as described in Chapter 6 or to install management or data host software on operating systems other than Solaris as described in Chapter 8,.