C H A P T E R  3

Custom Installation Options

This chapter describes the custom and command-line interface (CLI) installation options.


Installing the Management Host and Optional GUI

This feature bundle creates a management station that contains the full set of Sun Storage Common Array Manager services, with the option to install the browser GUI interface.

You can install the management host software locally on a data host connected to the array or on a central management server that communicates with the array via a proxy agent. It contains:

During installation, you will be prompted to select the arrays installed for your site and the corresponding firmware.

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.



Note - You can also use RunMe.bin -s (silent mode), to perform an unattended installation at the command line or from a 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.



Note - You can also use Runme.bat -s (silent mode), to perform an unattended installation at the command line or from a script.


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

2. From the Welcome panel, click Next.

3. Accept the license agreement and click Next.

4. Select Custom to reveal other installation options and click Next.

5. Select Management Host Software, and click Next.

6. Select the array types installed at your site, select Enable GUI if you want to install the browser interface, and then click Next.

7. Review the software to be installed, and click Next to start the installation.



Note - The progress indicator reflects 50% 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.

8. Click Finish.

9. Configure the firewall on the data host 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.


Installing the Data Host Proxy Agent for JBOD Arrays

This option installs all core packages on a data host attached to the array for management of storage expansion (i.e., JBOD) arrays. This option includes:

With this option, a host can act as a proxy for the management host (this allows aggregation of information from multiple hosts as well as delegation to other hosts for firmware upgrades, and access configuration changes).

Installing the Data Host Proxy Agent for JBOD Arrays

For each Storage Expansion Array (i.e., JBOD) to be managed, the Data Host Proxy Agent must be installed on each data host that accesses the device.

FIGURE 3-1 Data Host Proxy Agent Monitoring JBOD Arrays


llustration showing a JBOD configuration and location of proxy agent installed on data host.


1

Full (typical) array management software installed on management host with in-band management connection

2

Data host proxy agent installed on data host with in-band management connection


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.

3. Accept the license agreement and click Next.

4. Select Custom to reveal other installation options.

5. Select Data Host Proxy Agent to install the proxy agent on the data host, and click Next to proceed.

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

7. Click Finish.

8. Configure the firewall on each data host to allow an exception for port 8653 for the JBOD proxy agent.

Your firewall program might prompt you 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.

Remote Access via Proxy Agent

During installation, you will have the option 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 connection between the data host and the array. Access is over HTTPS and port 8653.

If remote access is enabled, you will need to choose an access password (15 characters maximum). Be sure to remember this password, as it will be needed during array registration.



Note - Do not enable remote access if the management host is directly connected to the array.



Installing the Administrator Host CLI Client

This feature bundle installs a thin scripting client that connects via secure HTTP (HTTPS) to the management host (CLI only). The remote command-line interface (CLI) is used to communicate with a host that has Sun Storage Common Array Manager core software installed.

You can also manage and configure storage using the CLI. The CLI provides the same control and monitoring capability as the web browser, and it is scriptable for running frequently performed tasks.

FIGURE 3-2 Administrator Host CLI Client


Illustration showing a sample configuration for the administrator host command line interface installation option.


Figure Legend

1

Full (typical) array management software installed on management host

2

Administrator Host CLI installed


The CLI is available by telnetting to the management host or from a remote CLI client that you install on the remote host. It is available for Solaris OS, Windows, Linux, and several other operating systems. See the Sun Storage Common Array Manager Software Release Notes for a list of supported operating system platforms.

For more information about CLI commands, see the sscs man page and the Sun Storage Common Array Manager CLI Guide.

Installing the Administrator Host CLI Software

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.

3. Accept the license agreement and click Next.

4. Select Custom to reveal other installation options, and click Next.

5. Select Administrator Host CLI Client.

6. Click next to display the Review Selections screen.

7. To continue, click the Install button.



Note - During the software installation, the progress indicator reflects 50% 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.

8. Configure the firewall on administrator host and management host to allow an exception for ports 6789 and 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 Oracle 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 Oracle Java Web Console and the Sun Storage Common Array Manager, 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


Installing and Configuring the Software Using a CLI

This section describes how to install Sun Storage Common Array Manager using a command-line interface script and other options for experienced users.

Installing the Software Using a CLI (Solaris OS and OpenSolaris OS)

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

After downloading the software, 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 2.

1. Log in to the host OS.

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, 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

After a few moments, an InstallShield note will briefly display, then the software installer will begin automatically.

4. When prompted to proceed, press 1 for Next.

5. When prompted about the license agreement, read and accept the agreement by pressing 1 then Enter to select, 0 then Enter to confirm, and 1 then Enter to proceed.

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

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

7. Continue following the prompts to install the software.



Note - During the software installation, the progress indicator reflects 50% 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 software installer Installation Summary screen is displayed.

8. Press Return to complete the installation.

9. Configure the firewall on the management host, data host, and administrator host (if applicable).

a. Set the firewall to allow an exception for port 6789. If you have a JBOD proxy agent or CLI-only installation, also allow an exception to port 8653.

b. 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 Software Using a CLI (Linux)

You can use a CLI script to install Sun Storage Common Array Manager with the same options as the GUI install wizard on a host system running the Red Hat or SUSE Linux Operating System.

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

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

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, 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

After a few moments, an InstallShield note will briefly display, then the software installer will begin automatically.

4. When prompted to proceed, press 1 for Next.

5. When prompted about the license agreement, read and accept the agreement by pressing 1 then Enter to select, 0 then Enter to confirm, and 1 then Enter to proceed.

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

7. Continue following the prompts to install the software.



Note - During the software installation, the progress indicator reflects 50% 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.

8. Press Return to complete the installation.

9. Configure the firewall on the management host, data host, and administrator host (if applicable).

a. Set the firewall to allow an exception for port 6789. If you have a proxy agent or CLI-only installation, also allow an exception to port 8653.

b. 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 Software Using a CLI (Windows)

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.

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

1. Log into Windows as Administrator.

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 

After a few moments, an InstallShield window will briefly display, then the software installer will begin automatically.

The files are unpacked in the default directory:

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

4. When prompted to proceed, press 1 for Next.

5. When prompted about the license agreement, read and accept the agreement by pressing 1 then Enter to select, 0 then Enter to confirm, and 1 then Enter to proceed.

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

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

7. Continue following the prompts to install the 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 installation is complete, the host software installer Installation Summary screen is displayed.

8. Press Return to complete the installation.

9. Configure the firewall on the management host, data host, and administrator host (if applicable).

a. Set the firewall to allow an exception for port 6789. If you have a proxy agent or CLI-only installation, also allow an exception to port 8653.

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