C H A P T E R  2

Installing CAM Software

This chapter describes how to prepare for and perform two common installations of the management software using a graphical interface: Typical (full) and Data Host Proxy Agent. Other installation options, including CLI installation, are described in Appendix E: Options for Experienced Users.

The following topics are discussed:


About Installation

This chapter describes two types of full installation of Common Array Manager software:

These procedures apply equally to installing on a new host or a new release of the software on a host already running an earlier version of the software. When you proceed to upgrade an existing management host to a new release, you run the install program exactly as described for a fresh installation. The install script searches to see if there is an earlier version of the software present on the system and if so, updates and adds only those files that require change. Existing settings and other data are preserved, and after the upgrade, normal operations can resume. Normally it is not necessary to manually uninstall or re-register devices, redefine users, or reset other system parameters.

Any release-specific considerations, including those pertaining to upgrades, are provided in the Sun StorageTek Common Array Manager Software Release Notes.


About the Software Installation DVD

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

To simplify the installation process for new users, this chapter will present the GUI Install Option. See Appendix E for CLI options.


Installing From a Downloaded File

You can download the latest version of the Common Array Manager software from the following Sun web site:

http://www.sun.com/storage/management_software/resource_management/cam/get_it.jsp

Solaris OS, OpenSolaris OS, and Linux Downloads

When installing from a downloaded file on Solaris OS or Linux, do the following to unpack the file and run the install program:

1. Unpack the file:

tar xvf filename.tar

2. Change to the directory where the install files are unpacked, for example:

cd /install_dir/Host_Software_6.x.x.x

3. Begin the applicable installation procedure at Step 3.

Windows Downloads

1. Unzip the host_sw_windows_6.x.x.x file using a Windows zip application.

2. Change to the directory where the install files are unpacked. For example:

Host_Software_6.x.x.x

3. Begin the Windows installation procedure at Step 3.


Checking the Installation Requirements

This chapter contains the following sections:

Prerequisites

Before installing the management software, do the following:

TABLE 2-1, Installation Space Requirements, shows the amount of directory space, in megabytes, required for the program directories on Solaris, OpenSolaris, Linux, and Windows hosts.

Note - These space requirements are for a full installation, including Sun Java Web Console. (You sign into the Sun Java Web Console to access the CAM software.) If Sun Java Web Console Version 3.02 and JDK are pre-installed on the system, the required space is smaller by approximately 150 megabytes. On the Solaris OS this is in /opt; on Linux, this is in /usr; on Windows this is on the system drive.


Solaris OS and Linux: Uninstall all versions of the Sun StorageTek Configuration Service management software prior to the Common Array Manager 5.0.1.1 release. Later versions do not have to be removed.

Windows: Uninstall all versions of the Sun StorageTek Configuration Service management software prior to the Common Array Manager 5.1.0.10 release. Later versions do not have to be removed.



Note - If a version of Sun Java Web Console prior to 2.2.5 is installed, 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 and you cannot install the software.


The management software is distributed on the Sun StorageTek Common Array Manager Software DVD and is also available from the Sun website.

To obtain a general overview and detailed technical information, go to:

http://www.sun.com/storage/management_software/resource_management/cam/

Click the “Get It” tab to obtain the latest information and version available.

http://www.sunsolve.sun.com

Information regarding any available patches for CAM will be located here:

http://www.sun.com/storage/management_software/resource_management/cam/support.xml

Prerequisites for Solaris Zones

For more information, contact Sun Microsystems Support Services at:

http://www.sun.com/contact/support.jsp

About Windows Service Packs



caution icon Caution - Before installing CAM on Windows: Be sure a file or directory named “%SystemDrive%\Program” does not exist. This file can prevent some applications from functioning properly. If it does exist, rename the file to “%SystemDrive%\Program1.”


If needed, download the files from the Microsoft Download site. You must be logged in to the Windows system as an administrative user.



Note - Open Storage management requires a hot-fix patch for Win2K3, # 943545 and a Win2K8 patch, # KB958387-v2-x64 (64-bit Win2008).


The array installation files and installers are provided in a compressed file on the DVD. The process unpacks the contents of the file on the host and then proceeds with the installation.

After the installation on a Windows platform, you will need to configure the Windows firewall on each host to allow an exception for port 6789.

For more information, refer to the appropriate product documentation.

Open Ports Required on Management Host

Open the following incoming and outgoing ports for secure-by-default Solaris, OpenSolaris, Linux, and Windows platforms:

Enabling Remote Access to Sun Java Web Console

Solaris OS 10 update 6 restricts port 6789 to listen to localhost only. To change this setting and enable remote access to the Java Web Console and CAM, do the following:

1. Become superuser or assume an equivalent role on the system where the console is running.

Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services:

http://docs.sun.com/app/docs/doc/816-4557/rbactask-15?a=view

2. Set a property to allow the console server to respond to network requests, refresh the service, and restart the console server.

# svccfg -s svc:/system/webconsole setprop options/tcp_listen=true
# svcadm refresh svc:/system/webconsole:console
# /usr/sbin/smcwebserver restart

Installation Command Summary

TABLE 2-2 summarizes the commands you need to install the management software using CAM’s GUI installation wizard.

 
TABLE 2-2 CAM Software Installation Commands

Installation Task

Graphical User Interface

Install the management software.

RunMe.bin (Solaris OS, Linux)

RunMe.bat (Windows)

or click the RunMe button if using a file manager

Uninstall the management software.

 

Note: The Add/Remove Programs feature in Windows is supported.

uninstall

 

Note: Stop all java.exe or javaw.exe applications running on Windows before starting the uninstaller.

Force a complete cleanup and removal of an installation.

Not Available

Appendix E describes the uninstall -f command line option to force a complete cleanup.


TABLE 2-2, Common Array Manager Software Installation Commands, shows the commands you need to install or uninstall the management software.


Installing CAM

The following sections cover OS-specific installation information, as well as the GUI installer steps for two common installation options: Typical (full) and Data Host Proxy Agent. Other installation option details and installation steps can be found in Appendix E.

Installing on the Solaris OS and OpenSolaris OS

You can install the Common Array Manager software on a SPARC, X86, or X64 system running the Solaris Operating System or OpenSolaris.

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

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

After the installation, you will need to configure the firewall on each host to allow an exception for port 6789 as noted in Step 12.



Note - CAM installs a Sun GUI framework called Sun Java Web Console (also known as Lockhart). Some advanced users might install Lockhart separately. For Solaris 10, do not attempt to run the Lockhart setup script when logged into the local zone. (The software installation prevents this.) Either install Lockhart into a whole root zone or install/upgrade Lockhart in the global zone before installing the Common Array Manager software into the local zone.


Installing on Linux OS

You can install the Common Array Manager software on a host system running the Red Hat or SUSE Linux Operating System.

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

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

After the installation, you will need to configure the firewall on each host to allow an exception for port 6789 as noted in Step 12.

Installing on Windows OS

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

Windows Installer 3.1 must be installed and the service packages listed in TABLE 2-3 are required:


TABLE 2-3 Windows Service Pack Requirements

Windows OS

Required Service Pack Version

Windows 2003

SP1 or higher

Windows 2008

SP1

Windows XP

SP2 or higher


TABLE 2-3, Windows Service Pack Requirements, shows the required Windows service packs by Windows OS.

If needed, download the files from the Microsoft Download site.

You must be logged in to the Windows system as an administrative user. For information on setting up administrative users and root users on Windows, see Adding Users And Assigning Roles.

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

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

After the installation, you will need to configure the firewall on each host to allow an exception for port 6789 as noted in Step 12.

Installing a Full Version of CAM on a Central Management Server or a Data Host

1. Log in to the management host OS.

2. Load the software from either a download or DVD installation:

a. Solaris OS, OpenSolaris OS, and Linux - run tar filename to unpack the file

tar xvf filename.tar

b. Windows - Unzip the host_sw_windows_6.x.x.x file using a Windows zip application.

c. Change to the Host_Software_6.x.x.x directory where the files were unpacked.

If the compressed installation files do not appear in a directory window:

a. Change to the cd-rom directory:

Solaris OS, OpenSolaris OS: /cdrom/cdrom0

Linux /media/cdrom

Windows <system drive>: (Example: D:)

b. Display the contents of the DVD:

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, perform one of the following:

a. Solaris OS, OpenSolaris, and Linux - 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.

b. Windows - double click on the following icon:

RunMe

The files are unpacked in the default directory path:

<system drive>:\Sun\CommonArrayManager\Host_Software_6.x.x.x\bin.

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

The Host_Software_6.x.x.x directory is unpacked into the default directory. The unpacking process takes a couple of minutes. The contents of this directory include:

- bin/tools

- bin/iam

- bin/uninstall

- components/

- util/

If the wizard screen is not redisplayed or if you receive an error message, recheck that the host requirements in TABLE 2-1 are met.

6. Click Next.

Summary information about the installation is displayed.


Screenshot showing the first Common Array Manager installation screen.

7. Click Next to display the license agreement screen.


 This screenshot shows the Common Array Manager License Agreement Screen.

8. Click the radio button to accept the license agreement, and then click Next to display the Installation Type screen.


This screenshot shows the installation type choices.

9. Choose Typical to install the full management software on the management host.

10. Click next to display the Review Selections screen.


The screenshot shows the installation type that you selected.

11. To continue, click the Install button.



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 installation is complete, the View Results screen is displayed.

For information on installation logs, refer to Reviewing the Installation Logs.

12. If you have no other CAM installations, eject the DVD.

13. Configure the firewall on the data host.

Set the firewall to allow an exception for port 6789. Since a proxy agent was not installed or activated with this installation option, there is no need to open port 8653.

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.

Installing the CAM Data Host Proxy Agent on Other Hosts

If you have a central CAM installation or a full CAM installation on the same subnet, you only have to install the CAM proxy agent on other hosts attached to arrays.

1. Start the installation using the steps for your OS.

Solaris OS/Linux

a. Open a shell or terminal window.

b. Go to the directory containing the software you extracted.

c. Become superuser by typing su.

d. Run the RunMe.bin script.

The Welcome panel appears. Go to Step 2 to continue.

OpenSolaris OS

a. Open a shell or terminal window.

b. Go to the directory containing the software you extracted.

c. Run the RunMe.bin script using the pfexec(1) command:



Note - You must have the appropriate profile rights to run the pfexec(1) command.


pfexec ./RunMe.bin

The Welcome panel appears. Go to Step 2 to continue.

Windows OS

Prerequisite: You must have Windows OS Administrator privileges to install the software.

a. Open the folder containing the extracted software.

b. Double-click the RunMe.bat icon.

The Welcome panel appears. Go to Step 2 to continue.

2. From the Welcome panel, click Next.


Screenshot showing the first Common Array Manager installation screen.

3. Accept the license agreement and click Next.


This screenshot shows the Common Array Manager License Agreement Screen.

4. Choose Custom to reveal other installation options.


This screenshot shows the installation type choices.

5. Click Next and proceed to the next step.


This screen shows the various installation options.

6. Select Data Host Proxy Agent to install the proxy agent on the data host.



Note - The other options are explained in Appendix E, but are not needed by new users using the recommended installation.


7. Click the Next button to proceed.

The following menu will appear:


Screen capture of the Remote Access option menu.

8. Select whether to enable or disable remote access.

Enabling remote access via proxy will allow remote control of locally attached storage from Common Array Manager software installed on other machines. If you choose to enable this option, you must supply an access password as directed. Do not activate the proxy if the management host is directly connected to the array.



Note - Be sure to remember the access password. You will need to enter the proxy agent password when registering the array.


9. Click next to display the Review Selections screen.


The screenshot shows the installation type that you selected.

10. Review your selections and click Install.



Note - During the software installation, the progress indicator reflects 0% for a significant portion of the installation process.


When the installation is complete, the View Results screen is displayed.

For information on installation logs, refer to Reviewing the Installation Logs.

11. If you have no other CAM installations, eject the DVD.

12. Configure the firewall on both the management host and the data host.

Set the firewall to allow an exception for port 6789. If you have a proxy agent, also allow an exception to port 8653. 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.

Enabling Remote Access to Sun Java Web Console

Solaris OS 10 update 6 restricts port 6789 to listen to localhost only. To change this setting and enable remote access to the Java Web Console and CAM, do the following:

1. Become superuser or assume an equivalent role on the system where the console is running.

Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services:

http://docs.sun.com/app/docs/doc/816-4557/rbactask-15?a=view

2. Set a property to allow the console server to respond to network requests, refresh the service, and restart the console server.

# svccfg -s svc:/system/webconsole setprop options/tcp_listen=true
# svcadm refresh svc:/system/webconsole:console
# /usr/sbin/smcwebserver restart


Starting the Management Software

The Sun StorageTek Common Array Manager provides a browser interface for accessing the management software from any host that is connected to the site LAN. The web-based browser interface is the primary interface for configuring, managing, and monitoring the system.

Command-line interfaces options are also provided. For more information, experienced users should refer to Appendix E.

Logging In Using the Browser Interface

You can start the management software on any system that is connected to the network. Before you log in, you need to set up a storage role or group in your OS and assign users to it. See Adding Users And Assigning Roles.

1. Open a supported web browser.



Note - For information about supported web browsers, see the Sun StorageTek Common Array Manager Release Notes.


2. Enter the IP address of the management host using this format:

https://cam-management-host:6789

cam-management-host is the IP address or hostname of the host where you installed the Sun StorageTek Common Array Manager software.

The login page is displayed.


Screen capture of the Sun Java Web Console login page.

3. Login with the root or administrator name.

You need root and storage users on the system. For more information about user names and roles, see Adding Users And Assigning Roles.

For Solaris OS and Linux, root already exists for the machine on which you installed the software.Later, you may want to add a user accounts with the storage role.

For Windows, you can initially login with any user account with Windows administrative privileges. Later, you may want to add a user accounts with the storage role. For more information about adding users and roles to Windows, see Adding New Users in Windows.

4. Click Log In.

The Sun Java Web Console page is displayed.

At this point, you are logged into the system.



Note - The connection closes automatically if there is no activity for approximately 15 minutes.



Screen capture of the Java Web Console page.

5. Select Sun StorageTek Common Array Manager from the Storage section of the Sun Java Web Console page.


Installation Troubleshooting

You can verify the installation by bringing up the Sun StorageTek Common Array Manager browser, as discussed in Starting the Management Software.

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

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 the 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:

/var/sadm/install/se6000/

/var/opt/cam/

\Program Files\Common Files\Sun Microsystems\se6000

Verify that you made the firewall changes after you finished the installation as noted in Step 13.