C H A P T E R 2 - Installing the Common Array Manager Software

C H A P T E R 2

Installing the Common Array Manager Software

This chapter describes how to install the management software using a graphical interface or the command line interface. It contains the following sections:

About the Software Installation CD

Checking Installation Requirements

Locating Files and Logs

Installation Command Summary

Using a GUI to Install on a System Running the Solaris OS

Using a CLI to Install on a System Running the Solaris OS

Using a GUI to Install the Software on Windows System

Using the CLI to Install on a Windows Systems

Installation Troubleshooting

Next Steps

About the Software Installation CD

The Sun StorageTek Common Array Manager Installation Software CD provides three installation-related wizards:

Management software installer - Enables you to use a graphical user interface or command-line interface (CLI) to install a selection of applications to support a local or remote management host.

Array Firmware Upgrade Installer - Enables you to upgrade the array to the latest versions of base, NVSRAM, and disk firmware.

Uninstaller - Enables you to uninstall the management and remote host software from a host.

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

Checking Installation Requirements

Before unpacking the compressed installation files, check that the following requirements are met. (The installation script verifies these requirements. If a requirement is not met, the script informs you.)

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

Locate the license certificates for premium features sent to the contact at the array site.

There are three methods of configuring IP addressing on the controller. Addressing via DHCP or static IP addressing via the serial port must be configured before you install the Common Array Manager files. Dynamic IP addressing of the array controllers uses the software and can be done after the software installation. For more information, see Appendix B Configuring IP Addressing.

To install using the graphic wizard in Solaris, set the X Windows DISPLAY setting. The following shows an example after telnetting to the host:

$ xhost +

$ su -

Password:

# DISPLAY=mgt_server.your_net:0.0; export DISPLAY

Verify the space requirements for the management and remote CLI client software listed in the following table:

TABLE 2-1 Installation Space Requirement s
OS	Total Space	Directory Space
Solaris	930 megabytes	`root` - 10 megabytes
		`/tmp` - 100 megabytes
		`/usr` - 20 megabytes
		`/var` - 500 megabytes
		`/opt` - 300 megabytes
Windows	800	On system drive (usually C:)

Check that previous versions of the management software are not installed.

Uninstall all previous versions of the Sun StorageTek Configuration Service management software prior to the Common Array Manager 5.0 release.

Check that previously installed services, such as the Storage Automated Diagnostic Environment, are not performing a function on the array over Ethernet port 1 of either array controller.

Note - Install this software on a host that does not have applications running a higher version of the Java Web Console. If the 3.x version of Sun Java Web Console is already in use on the management host, this installation will downgrade the version to 2.2.x. This could impact any other applications running the 3.x version.

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.

Locating Files and Logs

The following table shows the location of the files and logs for the Sun StorageTek Common Array Manager software.

TABLE 2-2 Software File Locations
OS	File Type	Directory
Solaris	Installation Files	/var/opt/CommonArrayManager/Host_Software_5.x.x.x/; /uninstall
	Installation Logs	`/var/sadm/install/se6000`
	Program Files -Various directories - examples:	/opt; /var/sadm/smimages/
Windows	Installation Files	\Program Files\Common Files\Sun Microsystems\se6000
	Installation Logs	`\Program Files\Common Files\Sun Microsystems\se6000`
	Program files	\Program Files\Sun Microsystems\StorageTek_Mgmt\

Installation Command Summary

TABLE 2-3 summarizes the commands you need to install the management software using either a GUI wizard or a CLI script.

If you are using the Solaris operating system and a path is not defined, use ./ to run the commands (./RunMe.bin).

If you are using a Windows platform, if the command alone does not work, add .\ to run the commands (.\RunMe.bat).

The following tabl,,Common Array Manager Software Installation Commands, shows the commands you need to install the management software and upgrade the firmware using either a GUI wizard or a CLI script.

TABLE 2-3 Common Array Manager Software Installation Commands
Installation Step	Graphical Interface	Command Line Interface
1. Install or upgrade the management software.	`RunMe.bin` (Solaris) `RunMe.bat` (Windows)	`RunMe.bin -c` (Solaris) `RunMe.bat -c` (Windows)
2. Reinstall the management software or install just the Remote CLI Client on a remote host.	`setup`	`setup -c`
3. Uninstall the management software. Note: In Windows you can also remove the software with the Add/Remove Programs feature in Control Panel.	`uninstall`	`uninstall -c`
4. Complete the cleanup of removing an installation. Note: Reboot the system after issuing the command in Windows.	`-`	`uninstall -f`
5. Install the array firmware.	`arrayinstall`	Note: Use of the Upgrade Array function in the management software is recommended. The `csmservice` command is for service only.

Using a GUI to Install on a System Running the Solaris OS

You can use a wizard to install the Common Array Manager software on a SPARC system running the Solaris 8, 9, or 10 Operating System, or on an X86 or X64 System running the Solaris Operating System.

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

The process unpacks the contents of the file on the host and then proceeds with the installation.

Note - Before you continue, check that all of the requirements are met, as listed in Checking Installation Requirements.

To Install the Software (Solaris):

1. Log in to the Solaris OS as root.

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

If the compressed installation files do 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 begin unpacking the contents of the compressed installation file, enter the following command or click the RunMe icon if using a file manager:

RunMe.bin

The files are unpacked in the default directory - /var/opt/CommonArrayManager.

The Host_Software_5.0.x.xx directory is unpacked into the default directory. The contents of this directory includes:

- bin/CsmServiceInstaller.bin

- bin/setup

- bin/tools

- bin/iam

- bin/SetupSolarisSpar.bin

- bin/arrayinstall

- bin/uninstall

- components/

- util/

If the wizard screen is not redisplayed or you receive an error message, recheck that the host requirements in Checking Installation Requirements are met.

5. Click Next.

Summary information about the installation is displayed.

The figure shows the screen capture of the Sun StorageTek 6140 Host Installer screen that says to use this installer to install the Sun StorageTek Common Array Manager.

6. Click Next to display the license agreement screen.

The following figure shows the Common Array Manager License Agreement Screen. Click the button to accept or not accept the license agreement.

7. Click the radio button to accept the license agreement, and then click Next to continue the host installation.

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

To install the entire software package, select Typical, then click Next.

To install individual software, select Custom, and click Next.

If you select Custom, you will be prompted to choose either the management software or the remote CLI client to install.

The following figure shows a screen where you select an installation type of Typical or Custom.

9. When prompted to review your selection, check it and click the Install button.

The following figure shows the Common Array Manager Windows Review Selections Screen. If you chose the Typical installation type, it will show that you selected to install the management host software and remote management (CLI) software.

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

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

10. Click Finish.

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

Using a CLI to Install on a System Running the Solaris OS

You can use the CLI to install the Common Array Manager software on a SPARC system running the Solaris 8, 9, or 10 Operating System, or on an X86 or X64 System running the Solaris OS.

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

The process unpacks the contents of the file on the host and then proceeds with the installation.

Note - Before you continue, check that all of the requirements are met, as listed in Checking Installation Requirements.

To Install the Software Using a CLI (Solaris):

1. Log in to the Solaris OS as root.

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

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, enter the following command:

RunMe.bin -c

The files are unpacked in the default directory - /var/opt/Common Array Manager.

The Host_Software_5.0.x.xx directory is unpacked into the default directory. To use a different directory, enter the following command:

RunMe.bin -c -d/path-to-new-directory

The following message is displayed:

Initializing InstallShield Wizard

Launching InstallShield Wizard

The host software installer is launched automatically after the installation files are unpacked and the initial host installer prompt is displayed.

5. When prompted about the license agreement, accept the agreement and press Return.

Note - If you need to run the installation again later, use the command setup -c.

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

To install the entire software package, select Typical.

To install individual software, select Custom.

If you select Custom, you will be prompted to choose either the management software or the remote CLI client to install.

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

7. Press Return to complete the installation.

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

Using a GUI to Install the Software on Windows System

You can use a wizard to install the Common Array Manager software on a system running Windows 2000, 2003, or XP.

The array installation files and installers are provided in a compressed file on the CD.

The process unpacks the contents of the file on the host and then proceeds with the installation.

Note - Before you continue, check that all of the requirements are met, as listed in Checking Installation Requirements.

To Install the Software (Windows):

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

If the compressed installation file does not appear in a directory window, click on the cd drive (example: D:).

2. To begin unpacking the contents of the compressed installation file, double click on the following icon:

RunMe

The following Common Array Manager Windows Extracting Screen displays the percent of the files that have been extracted.

The files are unpacked in the default directory path - \Program Files\Common Files\Sun Microsystems\se6000. When the unpacking is complete, the host software installer begins automatically.

If the wizard screen is not redisplayed or you receive an error message, check that the host requirements in Checking Installation Requirements are met.

Summary information about the installation is displayed.

The figure shows the screen capture of the Sun StorageTek 6140 Host Installer screen that says to use this installer to install the Sun StorageTek Common Array Manager.

3. Click Next to begin the installation of the software.

The license agreement screen is displayed.

The following figure shows the Common Array Manager License Agreement Screen. Click the button to accept or not accept the license agreement.

4. Click the radio button to accept the license agreement, and click Next to continue the host installation.

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

To install the entire software package, select Typical, and click Next.

To install individual software, select Custom, and click Next.

If you select Custom, you will be prompted to choose either the management software or the remote CLI client to install.

The following figure shows a screen where you select an installation type of Typical or Custom.

Note - During the host 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 host installation is complete, the host software installer Installation Summary screen is displayed.

The following figure shows the Installation Summary Screen which tells you if the installation is successful and notes that the installer files should not be removed.

6. Click Finish.

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

8. After the installation on a Windows platform, you will need to configure the Windows firewall.

Set the Windows firewall to allow an exception for port 6789. Some firewall programs prompt for your agreement to allow new programs to communicate through the firewall, and set the port for you. Refer to your firewall documentation for instructions on how to open a port through the firewall.

9. After the installation on a Windows platform, you must perform the following registry edit to disable guest users.

Without this step, users will not be able to log in.

Note - Regedit should be run only by experienced PC administrators.

a. Backup the registry before editing.

b. Run Regedit and set the following registry value to 0:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\ForceGuest

Using the CLI to Install on a Windows Systems

You can use the CLI to install the Common Array Manager software on a system running Windows 2000, 2003, or XP.

The array installation files and installers are provided in a compressed file on the CD.

The process unpacks the contents of the file on the host and then proceeds with the installation.

Note - Before you continue, check that all of the requirements are met, as listed in Checking Installation Requirements.

To Install the Software Using a CLI (Windows):

1. Log into Windows as Administrator.

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

If the compressed installation file does not appear in a directory window, access the cd drive (example: D:).

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

3. To unpack the contents of the compressed installation file in the default directory, enter the following command:

RunMe.bat -c

The following message is displayed:

Initializing InstallShield Wizard

Launching InstallShield Wizard

The files are unpacked in the default directory - \Program Files\Common Files\Sun Microsystems\se6000. When the unpacking is complete, the host software installer begins automatically.

Note - If you need to run the installation again later, use the command
.\setup -c.

4. When prompted about the license agreement, accept the agreement and press Return.

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

To install the entire software package, select Typical.

To install individual software, select Custom.

If you select Custom, you will be prompted to choose either the management software or the remote CLI client to install.

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.

6. Press Return.

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

8. After the installation on a Windows platform, you will need to configure the Windows firewall.

9. After the installation on a Windows platform, you must perform the following registry edit to disable guest users.

Without this step, users will not be able to log in.

Note - Regedit should be run only by experienced PC administrators.

a. Backup the registry before editing.

b. Run Regedit and set the following registry value to 0:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\ForceGuest

Installation Troubleshooting

You can verify the installation by bring up the Sun StorageTek Common Array Manager browser or CLI prompt, as discussed in Starting the Management Software of the next chapter.

In the browser, you can click the Version button to verify the release version information.

At the CLI prompt, enter:

sccs list magma-sw

Reviewing the Installation Logs

You can also verify the success of the installation by reviewing the installation logs. Note that the installation logs are mainly intended for debugging by developers. By scrolling to the end of the installation log, you can verify the successful installation message or any error messages.

If an error occurs, review the requirements in Checking Installation Requirements. Also, review the Readme.txt file located in the installation directory (see Locating Files and Logs) for late-breaking information and attempt a reinstallation.

The installation logs are located:

Solaris:

/var/sadm/install/se6000

Windows:

\Program Files\Common Files\Sun Microsystems\se6000

For Windows, verify that you made the firewall and registry changes after you finished the installation.

Next Steps

You are now ready to log in to the browser interface, discover the array, upgrade the array firmware, and set up an array.