A P P E N D I X  B

Options for Experienced Users

This chapter provides experienced users information about other Sun StorageTek Common Array Manager tools and installation options for the Sun Storage J4200, J4400, and J4500 arrays. It contains the following sections:

 


Common Array Manager Installation Options

 

The recommended software installation in Chapter 2 did not detail the installation options. The section provides more information about the installation options in the following section:

Full Management Software

This install option creates a management station that contains the full set of CAM services:

The full install can either be installed locally on a data host connected to the array or on a central management server that communicates with the array via a proxy agent.

CLI-only Management Software

This option creates a compact, standalone installation which can be as little as 25mb in size.

This light-weight management solution is installed on a data host attached to the array. The data host can also serve as a management host using the CLI only installation option and provides:

This option is also used to load the proxy agent that allows communication between the full management software on a central management server and the array.

The Cli-only management software will manage the array without using the proxy agent. Deactivate the proxy agent when the management host is directly attached.

FIGURE B-1 shows the CAM CLI-only option installed on a data host that is also acting as a management host.

FIGURE B-1 Using the CAM CLI-Only Option to Manage the Array



Figure Legend

1

Terminal session on host

2

Data Host with CAM CLI-only installation and data to store

3

In-band SAS connection

4

J4000 Array Family


Remote CLI Client

This option installs a thin scripting client that connects via secure HTTP (HTTPS) to the management host. Login to the management host and navigate to the CLI directory to manage the J4000 Array Family.

See the Sun StorageTek Common Array Manager Software Release Notes, Release 6.1.2 for a list of supported operating systems for the client.

Locating Files and Logs

The following tables show the location of the files and logs for the Sun StorageTek Common Array Manager software by Operating System.


TABLE B-1 Solaris Software File Locations

File Type

Directory

Unpacked install files

/var/opt/CommonArrayManager/Host_Software_6.x.x.x/bin

Installation logs

/var/sadm/install/se6000

Sun copyright notice

/var/opt/CommonArrayManager/Host_Software_6.x.x.x/bin

ThirdPartyReadme.txt

/cdrom/cam-6.x.x.x-solaris/doc on the cd-rom

Remote SSCS (CLI) directory

/opt/SUNWsesscs/cli/bin

Local CLI directory

/opt/SUNWstkcam/bin

Man page directory

/opt/SUNWsesscs/cli/man


TABLE B-1, Solaris Software File Locations, shows the file type and location of Linux files on the management host.

 


TABLE B-2 Linux Software File Locations

File Type

Directory

Unpacked install files

/var/opt/CommonArrayManager/Host_Software_6.x.x.x

Installation logs

/var/opt/cam

Remote SSCS (CLI) directory

/opt/sun/cam/se6x20/cli/bin/sscs

Local CLI directory

/opt/sun/cam/bin

Sun copyright notice

/var/opt/CommonArrayManager/Host_Software_6.x.x.x/bin

ThirdPartyReadme.txt

/cdrom/cam-6.x.x.x-linux/doc on the cd-rom

Man page directory

/opt/sun/cam/se6x20/cli/man/man1m/sscs.1m


TABLE B-2, Linux Software File Locations, shows the file type and location of Linux files on the management host.

 


TABLE B-3 Windows Software File Locations

File Type

Directory

Unpacked install files

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

Installation logs

\Program Files\Common Files\Sun Microsystems\se6000 

Program files are in
various directories.

Example:
\Program Files\Sun\Common Array Manager\

Sun copyright notice

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

ThirdPartyReadme.txt

 

\doc on cd-rom

Remote SSCS (CLI) directory

<system drive>:\Program Files\Sun\Common Array Manager\Component\sscs\bin

Local CLI directory

<system drive>:\Program Files\Sun\Common Array Manager\bin

Man page directory

 

A copy of the man page and CLI Reference is located in the CD doc directory.


Installation Command Summary

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

 
TABLE B-4 Common Array Manager Software Installation Commands

Installation Task

Graphical User Interface

Command Line Interface

Install the management software.

 

 

RunMe.bin (Solaris, Linux)

RunMe.bat (Windows)

RunMe.bin -c (Solaris, Linux)

RunMe.bat -c (Windows)

Uninstall the management software.

 

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

 

uninstall

uninstall -c

Force a complete cleanup and removal of an installation.

Not Available

uninstall -f


If you are using the Solaris or Linux 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).

 


Command Line Interface Options

Chapter One recommended that using Sun StorageTek Common Array Manager’s browser interface option was the best option for new users. This section discusses the options available to use a Command Line Interface (CLI).

The CLI performs the same control and monitoring functions available through the browser interface. It is the interface for scripting tasks.

There are two forms of the CLI:

The only difference is that the local CLI requires a user has to run the command as administrator from a shell on the management host and because of this limitation the login and logout commands aren’t supported.

Both CLIs can manage any array that has been registered and added to the Common Array Manager inventory in the same way that the browser interface can manage any array in the inventory. The array type and array management path (in-band, out-of-band, proxy agents) has no limitations with local or remote CLI usage. Both CLIs manage the same arrays with the same command set.

Logging In and Out Using the CLI

The following explains how to log in to and out of a the management host using the CLI. The options for accessing the CLI are presented in the next section.

There are different CLI directories for the remote and local CLIs.

1. Access the local CLI directory:

2. Access the remote CLI directory:

3. Log into the remote CLI by typing the following command:

% sscs login -h cam-hostname -u username

where:



Note - The Local CLI on a data host does not require the login command. You will need the terminal window login to the host.


You can now use CLI commands to perform the same software operations as those available in the browser interface.

For more information about CLI commands, see:



Note - To locate the sscs(1M) man page, you must update your MANPATH variable or use the -m option with the man command.


4. Log out by typing the following command:

# sscs logout

Accessing the Command-Line Interface Remotely

The local and remote CLIs can be accessed remotely through the full management workstation using:

Navigate to the Local CLI directory to manage the J4000 arrays via the proxy agent.

This thin scripting client uses HTTPS to communicate with the management host. Login to the management host and navigate to the Local CLI directory to manage the J4000 arrays via the proxy agent.

Login to the management host and navigate to the Local CLI directory to manage the J4000 arrays via the proxy agent.

 


Installing the CAM Software
Using a CLI Script

 

This section describes how to install the management software using a command line interface script and other options for experience users. It contains the following sections:

Using a CLI to Install on the Solaris OS

You can use a CLI script to install the Common Array Manager software with the same options as the GUI install wizard 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.

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


procedure icon  To Install the Software Using a CLI (Solaris)

You can install from a CD or from a download of the install files from the Sun Software Download Center. If installing from a download, run tar xvf filename to unpack the file, then change to the Host_Software_6.x.x.x directory and begin the following procedure at Step 3.

1. Log in to the host’s Solaris OS as root.

2. Insert the host software installation CD into a drive on the management host.

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_6.x.x.x directory is unpacked into the default directory. To use a different directory, enter the following command:

RunMe.bin -c /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.

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

If you select Custom, you will be prompted to choose:

This install option creates a management station that contains the full set of CAM services:

This option creates a compact, standalone installation which can be as little as 25mb in size. This light-weight management solution is installed on the data host provides:

This option is also used to load the proxy agent that allows communication between the full management software on the management workstation and the array.

Do not activate the proxy if the management host is directly connected to the array.

There is also an option to install array firmware using the CLI.

Same as the last option, but without firmware files. Use this option to install the proxy agent on a data host.

This option installs a thin scripting client that connects via secure HTTP (HTTPS) to the management host. Login to the management host and navigate to the Local CLI directory to manage the J4000 arrays via the proxy agent.

See the Sun StorageTek Common Array Manager Software Release Notes, Release 6.1.2 for a list of supported operating systems.



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 host software installer Installation Summary screen is displayed.

7. During a custom install, choosing to install a CLI only install will display the Proxy for Remote Access screen.

Do not activate the proxy if the management host is directly connected to the array

a. Select the Enable button to enable remote access to the array via a proxy agent.

The proxy agent receives out-of band communication from the management software over Ethernet and delivers the information over an in-band SAS connection between the data host and the array. Access is over https and port 8653.

b. Enter and confirm a proxy agent password of up to 15 characters for remote access to this host.

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


8. Press Return to complete the installation.

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

Using a CLI to Install on the Linux OS

You can use a CLI script to install the Common Array Manager software with the same options as the GUI install wizard 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 CD.

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

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


procedure icon  To Install the Software Using a CLI (Linux)

You can install from a CD or from a download of the install files from the Sun Software Download Center. If installing from a download, run tar xvf filename to unpack the file, then change to the Host_Software_6.x.x.x directory and begin the following procedure at Step 3.

1. Log in to the management host Linux OS as root.

2. Insert the host software installation CD into a drive on the management host.

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

a. Change to the /media/cdrom directory:

cd /media/cdrom

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/CommonArrayManager/Host_Software_6.x.x.x

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

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

The following message is displayed:

Initializing Install Shield 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.

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

If you select Custom, you will be prompted to choose:

This install option creates a management station that contains the full set of CAM services:

This option creates a compact, standalone installation which can be as little as 25mb in size. This is light-weight management solution installed on the data host provides:

This option is also used to load the proxy agent that allows communication between the full management software on the management workstation and the array.

Do not activate the proxy if the management host is directly connected to the array

There is also an option to install array firmware using the CLI.

Same as the last option, but without firmware files. Use this option to install the proxy agent on a data host.

This option installs a thin scripting client that connects via secure HTTP (HTTPS) to the management host. Login to the management host and navigate to the Local CLI directory to manage the J4000 arrays via the proxy agent.

See the Sun StorageTek Common Array Manager Software Release Notes, Release 6.1.2 for a list of supported operating systems.



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 host software installer Installation Summary screen is displayed.

7. During a custom install. choosing to install the CLI only management software will display the Proxy for Remote Access screen.

Do not activate the proxy if the management host is directly connected to the array

a. Select the Enable button to enable remote access to the array via a proxy agent.

The proxy agent receives out-of band communication from the management software over Ethernet and delivers the information over an in-band SAS connection between the data host and the array. Access is over https and port 8653.

b. Enter and confirm a proxy agent password of up to 15 characters for remote access to this host.

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


8. Press Return to complete the installation.

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

Using a CLI to Install on a Windows OS

You can use a CLI script to install the Common Array Manager software with the same options as the GUI install wizard 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.

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


procedure icon  To Install the Software Using a CLI (Windows)

1. Log into Windows as Administrator.

2. 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:).

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

RunMe.bat -c 

The following message is displayed:

Initializing Install Shield Wizard

Launching Install Shield Wizard

The files are unpacked in the default directory:

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

When the unpacking is complete, the host software installer begins automatically.

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

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

If you select Custom, you will be prompted to choose:

This install option creates a management station that contains the full set of CAM services:

 

This option creates a compact, standalone installation which can be as little as 25mb in size. This light-weight management solution is installed on the data host provides:

This option is also used to load the proxy agent that allows communication between the full management software on the management workstation and the array.

Do not activate the proxy if the management host is directly connected to the array.

There is also an option to install array firmware using the CLI.

Same as the last option, but without firmware files. Use this option to install the proxy agent on a data host.

This option installs a thin scripting client that connects via secure HTTP (HTTPS) to the management host. Login to the management host and navigate to the Local CLI directory to manage the J4000 arrays via the proxy agent.

See the Sun StorageTek Common Array Manager Software Release Notes, Release 6.1.2 for a list of supported operating systems.



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 host software installer Installation Summary screen is displayed.

7. During a custom install. choosing to install a CLI only management software will display the Proxy for Remote Access screen.

Do not activate the proxy if the management host is directly connected to the array

a. Select the Enable button to enable remote access to the array via a proxy agent.

The proxy agent receives out-of band communication from the management software over Ethernet and delivers the information over an in-band SAS connection between the data host and the array. Access is over https and port 8653.

b. Enter and confirm a proxy agent password of up to 15 characters for remote access to this host.

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


8. Press Return to complete the installation.

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

10. 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. 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.


Uninstalling Software

If you need to remove the Common Array Manager software from your system, there are wizards and scripts to uninstall the software and its baseline firmware in the following prceedures:



caution icon Caution - Do not attempt to remove individual Common Array Manager components. If you want to remove the Common Array Manager, uninstall the entire application using the uninstall.bat script or using Control Panel - Add/Remove Programs.



procedure icon  To Uninstall the Management Software on Solaris or Linux Using the Uninstall GUI

1. Log in to the management host as root.

2. Change to the bin directory in the installation directory as described in Locating Files and Logs.

Example:

cd /var/opt/CommonArrayManager/Host_Software_6.x.x.x/bin

3. Run the uninstall command.

./uninstall

The uninstall GUI opens.


The following figure shows the Uninstallation window. Click the Uninstall button to begin the uninstall

4. Click Next.

The Review Selections window is displayed.

5. Select the software to be uninstalled, and click the Uninstall button.

When the uninstall completes, the View Results screen is displayed.


The following fiugre shows the View Results window, indicating that the uninstall operation was a success.

6. Click Finish.


procedure icon  To Uninstall the Management Software on Solaris or Linux Using the CLI

1. Log in to the management host as root.

2. Change to the bin directory in the installation directory as described in Locating Files and Logs.

Example:

cd /var/opt/CommonArrayManager/Host_Software_6.x.x.x/bin

3. Execute the uninstall command

./uninstall -c

4. Follow the prompts in the install console dialog.

If for any reason the uninstallation has failed, run the uninstall script with the -f option:

./uninstall -f


The following figure shows the Uninstallation window. Click the Uninstall button to begin the uninstall

5. Click Next.

The Review Selections window is displayed.

6. Select the software to be uninstalled, and click the Uninstall button.

When the uninstall completes, the View Results screen is displayed.


The following fiugre shows the View Results window, indicating that the uninstall operation was a success.

7. Click Finish.


procedure icon  To Uninstall the Management Software on a Windows System

1. Navigate to the host CD bin directory:

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

2. Click on the uninstall.bat icon.

To run the uninstaller in console mode, enter: uninstall.bat -c

To clean up (remove all associated files), enter: uninstall.bat -f

Alternatively, you can remove the Common Array Manager using the Control Panel - Add/Remove Programs.



caution icon Caution - Do not attempt to remove individual Common Array Manager components. If you want to remove the Common Array Manager, uninstall the entire application using the uninstall.bat script or using Control Panel - Add/Remove Programs.


3. Follow the uninstall wizard steps as described in the To Uninstall the Management Software on Solaris or Linux Using the Uninstall GUI.


Installation Troubleshooting

You can verify the installation by bringing up the CLI prompt, as discussed in Logging In and Out Using the CLI.

At the CLI prompt, enter:

sccs list mgmt-sw

Review the installation logs as noted in Reviewing the Installation Logs