C H A P T E R  3

Registering, Upgrading, and Initially Setting Up the Array

This chapter provides an overview of the management software and the steps required for first time you log in. It contains the following sections:


Starting the Management Software

The Sun StorageTek Common Array Manager provides two interfaces for accessing the configuration software and the monitoring software for the array:

For access instructions, see Logging In and Out Using the CLI.

For access instructions, see Logging In Using the Browser Interface.

When you register an array in Common Array Manager, the wizard analyzes the firmware installed on the array. If the firmware placed on the host is newer than the firmware installed on the array, the wizard performs an array firmware upgrade.

Logging In and Out Using the CLI

The following explains how to log in to and out of a remote host using the CLI. Do so either by remotely logging in to a management software station or by using the Solaris remote client on a remote host.

1. Access the CLI directory:

cd /opt/SUNWsesscs/cli/bin



Note - Be sure to add the /opt/SUNWsesscs/cli/bin directory to your path.



2. Log in by typing the following command:

% sscs login -h cam-hostname -u username

where:

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



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



3. Log out by typing the following command:

# sscs logout

Logging In Using the Browser Interface

You can start the management software on any system that is connected to the user LAN. 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 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 showing the server name, the User Name and Password text boxes, and the Log In button.

3. Login with the root or storage user 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, root already exists for the machine on which you installed the software.

For Windows, you will have to create a root user name. with Windows administrative privileges. For more information about adding users and roles to Windows, see Adding User Roles and New Users to Windows.

4. Click Log In.

The Java Web Console page is displayed.

At this point, you are logged in to 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.

The Storage System Summary page is displayed.

The figure shows the Common Array Manager Storage System Summary Screen where you select arrays managed by the software.

If you need help navigating the software or the online help, refer to Using the Browser Interface.

From here, you can carry out the setup tasks described in the following sections, including registering arrays, upgrading the array firmware, naming arrays, setting the array password, setting the system time, and adding new users.


Registering the Array

When you first log into the array's management software, select Storage Systems in the left navigation pane and on the Storage Summary page, click Register. The Array Registration wizard starts and you can choose to either search the subnet for arrays that are not already registered or to manually register an array as noted in the following sections:

At the end of the registration wizard, you can upgrade the array firmware for initial installations.

Searching the Subnet for Arrays to Register

You can automatically discover and register arrays that are on the same subnet as the management host. If the arrays are not on the same subnet as the management host, manually register the array in the wizard (see Manually Registering an Array).

The searching option sends out a broadcast message to identify any connected, but unregistered arrays. The discovery process displays the percentage of completion while the array management software polls devices in the network to determine whether any new arrays are available. When complete, a list of discovered arrays is displayed.


procedure icon  To Search the Subnet:

1. Click Storage Systems.

The Storage System Summary page is displayed.

2. Click Register.

The Register Storage System wizard is displayed.

3. In the Register Storage System wizard, click Auto Discover Arrays.

The management software detects the array you installed on its subnet and adds it to the Storage System Summary page.



Note - It takes approximately 2 minutes for the software to discover each array.



4. Verify that the array has been added to the Storage System Summary page.

5. If the array is not displayed, do one of the following:

If the array is still not displayed, you can register the array manually as described in the next section.

Manually Registering an Array

Manual registration enables you to register an array by identifying the IP address of its controller. This option is typically used only to add a storage array that is outside of the subnet of the management host.


procedure icon  To Manually Register an Array:

1. Click Storage Systems.

The Storage System Summary page is displayed.

2. Click Register.

The management software launches the Register Storage System wizard.

3. Follow the step-by-step instructions and click the buttons in the wizard to complete the registration.



Note - The password of the array is not a required entry. No array is shipped with a default password. This field is used only if the array being registered is one that was previously managed and had a set password. To give the array a password, see Setting an Array Password.



Unregistering an Array

You remove an array from the management software by unregistering the array.


procedure icon  To Unregister an Array:

1. Click Storage Systems.

The Storage System Summary page is displayed.

2. Select the check box to the left of the array you want to remove from the list of registered arrays.

This enables the Remove button.

3. Click Remove.


Upgrading the Array Firmware

You can upgrade your array firmware by either:

You can choose to modify the array firmware later with the next option.

As part of the installation of the Common Array Manager software, the script puts the array firmware files in a directory on the management host. When you upgrade the firmware, the software analyzes the firmware installed on the array. If the firmware on the host is newer, and you choose to upgrade, the software performs an array firmware upgrade.



Note - For optimal performance, Sun Microsystems recommends that the firmware on all arrays be at the level of the current firmware baseline.




procedure icon  To Upgrade the Array Firmware:

1. Choose one of the following:

a. Click Storage Systems.

The navigation pane and the Storage System Summary page are displayed.

The figure shows the Common Array Manager Storage System Summary Screen where you can select the array to upgrade.

.

2. Select the check box to the left of one of the displayed systems.

The Upgrade Firmware button is enabled.

3. Click Upgrade Firmware.

The management software launches the Analyze and Upgrade Array Firmware wizard. Step 1, the Overview, is displayed.

The following screen shows the Step 1: Overview screen of the Upgrade Array Firmware Wizard.

4. Click the Next button.

Step 2, Analyze Arrays, is displayed.

The following screen shows the Step 2: Analyze Arrays screen of the Upgrade Array Firmware Wizard showing the current firmware.

 

5. In the Action field, specify the type of upgrade, and click Next.

Step 2.1 verifies that the array password is correct.

The following screen shows the Step 2.1: Validate Array Password screen of the Upgrade Array Firmware Wizard.

6. Click Next.

The following screen shows the Step 3: Review screen of the Upgrade Array Firmware Wizard where you can verify the upgrade information. Note the following Caution.



caution icon

Caution - All management operations for the array should stop prior to the firmware upgrade. Disk I/O must be quiesced.



7. Review the current selections, and click Finish.

The following screen shows the Step 4: Results screen of the Upgrade Array Firmware Wizard where you can monitor the status of the firmware upgrade.

8. When the upgrade is complete, click Close.


Setting Up the Array Name and Other Initial Array Functions

To set up the array for basic operation, perform the procedures outlined in the following sections:

Naming an Array

Each array requires a unique name to be identified on the subnet.


procedure icon  To Name an Array:

1. In the navigation pane, choose the array you want to work with.

The General Setup page is displayed.

2. In the Name field, enter a unique name consisting of up to 30 characters.

The General Setup page contains other features that you may decide to configure. See the online help for more information before you change any default settings.

Creating a Hot-Spare Drive

From the drrop-down menu on the General Setup page, select a drive to serve as a hot spare drive to provide alternative drive space in case of a failure. Refer to the online help for information about this and other advanced configuration features.

Setting the System Time

You can also update the system time and date on the General Setup page for the array in the browser interface. When you set the time and date for a selected array, the values are updated for all arrays registered with this management software.

There are two ways in which you can update the system time and date:


procedure icon  To Set the Time Manually:

1. On the General Setup page, scroll down to the System Time section.

2. Select the current hour and minute according to a 24-hour clock.

3. If the date is incorrect, change the month, day, and year to the current date.

4. Click Save to save your changes.

The General Setup page is refreshed, and Success message is displayed at the top of the page.

For more information about the fields and buttons on the General Setup page that you can use after you set up your system, see the online help.

Setting an Array Password

A new Sun StorageTek array is shipped with a blank, or empty, password field. Sun recommends that you establish an array password during initial setup for security purposes. The password prevents other management hosts from unauthorized access to the configuration of the array.


procedure icon  To Set an Array Password on a New Array:

1. On the General Setup for the storage system page, click Manage Passwords.

The Manage Passwords page is displayed.

2. Select Change Array Password.

3. Leave the Old Password field blank.

This is the only time you can leave this field blank, when you establish a password for a new array.

4. Enter a new password consisting of up to 30 characters for the array.

5. Enter the password again to confirm the new password.

6. Click OK.

The General Setup page is displayed.

The management software stores an encrypted copy of the array password, known as the local password, on the management host.


Setting Up General Site and Contact Information

The General Configuration page contains information about the site, rather than the array, and differs from the General Setup page. Enter the following information for your site:


Setting Up Notification for Fault Management

The fault management features of the Sun StorageTek Common Array Manager software enables you to monitor and diagnose your arrays and storage environment. Alarm notification can be provided by:

1. In the navigation pane, under General Configuration, choose Notification.

The Notification Setup page is displayed:

The following figure shows the Notification Setup screen where you can specify the email server and addresses to use for notifications.

FIGURE 3-1 Email Fault Notification Setup


2. Enable local email.

a. Enter the name of the SMTP server.

If the host running this software has the sendmail daemon running, you can accept the default server, localhost, or the name of this host in the required field.

b. Specify the other optional parameters, as desired.

c. If you have changed or entered any parameters, click Save.

d. (Optional) Click Test Local Email to test your local email setup by sending a test email.

If you need help on any of the fields, click the Help button.

3. Set up local email notification recipients.

a. Click Administration > Notification > Email.

The Email Notification page is displayed.

b. Click New.

The Add Email Notification page is displayed.

c. Enter an email address for local notification. At least one address is required to begin monitoring events. You can customize emails to specific severity, event type, or product type.

d. Click Save.

4. (Optional) Set up remote notifications by SNMP traps to an enterprise management application.

a. Select SNMP as the provider.

b. Click Save.

5. Perform optional fault management setup tasks:


Adding Users And Assigning Roles

To set up the array for basic operation, perform the procedures outlined in the following sections:

Using Initial Administrative Roles

The first time that you access your array software, you sign on as an administrator:

You then assign a user role of storage or guest to each user of the software. The storage role allows a user access to all of the software features related to storage device configuration and array management.

The storage and guest roles must be added to the management host using its OS software. For Solaris OS, consult system administration documentation. For Windows, add groups for storage and guest and assign members to those groups. Refer to Adding User Roles and New Users to Windows for additional information about adding roles in Windows.

Assigning Roles to Users

The user role assigned to a user determines that user's access to the management functions for the array. TABLE 3-1 describes the valid user names and user role functions and the requirements for each.

 


TABLE 3-1 Valid User Names and User Roles

User Role/Group

Description

User Name

Required Password

storage (initial administrator)

Use the root or administrative user name to initially add other users. A storage user can use all of the software features related to storage device configuration and array management.

UNIX - root

 

Windows - administrator user, including root if so set up.

Root or administrator password on the management host

storage

A storage user can use all of the software features related to storage device configuration and array management.

Any valid user on the management host

Password assigned to the user on the management host

guest

A guest user has read-only privileges and can only view information. This user cannot modify any settings or features.

Any valid user on the management host

Password assigned to the user on the management host


Best Practices - User Roles and Names

1. Setting up with an administrative role.

In UNIX, by default, root has a storage role that allows full privileges. Before you can add other user and assign that user a user role, the user name must be defined in the Solaris Operating System /etc/passwd file or network information server (NIS).

In Windows, you can set up an administrative role with full privileges. You can even call it root, as noted in Adding User Roles and New Users to Windows.

2. Restrict use of the administrator role.

To maintain security on the server running the management host software, the root or administrator user name and password should be used only the first time you log in. At that time, create at least one user with a storage user role. Thereafter, that created user can perform all available management functions, including adding or modifying users.

3. Make rules for multiple users with storage roles.

Multiple instances of the same user name can be logged in concurrently. However, because users with the storage user role have write privileges, there is a risk that the changes of one logged-in user will overwrite previous changes of another logged-in user. Therefore, you should develop policies about who can make changes and how to notify others.


procedure icon  To Add New Users in UNIX

1. To view the list of defined users, choose General Configuration > User Management in the navigation pane.

The User Summary page is displayed.

2. To add a new user, click the Add button.

The Add New User page is displayed.Common Array Manager Add New User page where you can add a user name and assign a user role.


 

3. In the User Name field, enter a valid user name.

The user name must be defined in the Solaris Operating System /etc/passwd file or NIS.

4. From the User Role list, select the role you want to assign for this user.

You can assign a user to one of the user roles identified in TABLE 3-1.

5. Click OK.

The User Summary page is displayed with a success message, and the name is added to the list.



Note - Newly added users should enter the same password for the Sun Java Web Console that they use in their Solaris accounts.




procedure icon  To Add New Users in Windows

Refer to Adding User Roles and New Users to Windows.


Next Steps

You are now ready to review the planning concepts that will help you to configure storage. If you are familiar with the concepts, you can proceed to Configuring Basic Storage.