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:
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.
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.
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
When installing from a downloaded file on Solaris OS or Linux, do the following to unpack the file and run the install program:
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.
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:
3. Begin the Windows installation procedure at Step 3.
This chapter contains the following sections:
Before installing the management software, do the following:
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.
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.
Information regarding any available patches for CAM will be located here:
http://www.sun.com/storage/management_software/resource_management/cam/support.xml
For more information, contact Sun Microsystems Support Services at:
http://www.sun.com/contact/support.jsp
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 the following incoming and outgoing ports for secure-by-default Solaris, OpenSolaris, Linux, and Windows platforms:
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
TABLE 2-2 summarizes the commands you need to install the management software using CAM’s GUI installation wizard.
Uninstall the management software. Note: The Add/Remove Programs feature in Windows is supported. |
Note: Stop all java.exe or javaw.exe applications running on Windows before starting the uninstaller. |
Appendix E describes the uninstall -f command line option to force a complete cleanup. |
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.
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.
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.
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:
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.
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
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
Windows <system drive>: (Example: D:)
b. Display the contents of the DVD:
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:
The files are unpacked in the default directory - /var/opt/CommonArrayManager.
b. Windows - double click on the following icon:
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:
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.
Summary information about the installation is displayed.
7. Click Next to display the license agreement screen.
8. Click the radio button to accept the license agreement, and then click Next to display the Installation Type screen.
9. Choose Typical to install the full management software on the management host.
10. Click next to display the Review Selections screen.
11. To continue, click the Install button.
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.
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.
a. Open a shell or terminal window.
b. Go to the directory containing the software you extracted.
c. Become superuser by typing su.
The Welcome panel appears. Go to Step 2 to continue.
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. |
The Welcome panel appears. Go to Step 2 to continue.
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. Choose Custom to reveal other installation options.
5. Click Next and proceed to the next step.
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:
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.
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.
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
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.
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.
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.
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. |
5. Select Sun StorageTek Common Array Manager from the Storage section of the Sun Java Web Console page.
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.
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:
\Program Files\Common Files\Sun Microsystems\se6000
Verify that you made the firewall changes after you finished the installation as noted in Step 13.
Copyright © 2009 Sun Microsystems, Inc. All rights reserved.