A    The Storage Administrator (lsmsa)

This chapter describes how to manage AdvFS domains, filesets, and volumes and LSM objects, including disks, disk groups, volumes, plexes, and subdisks using the Storage Administrator GUI, also called lsmsa. The tasks described in this chapter can also be accomplished by using:

See Appendix B for more information on how to track Storage Administrator activities and how to customize the Storage Administrator GUI.

A.1    Overview

The Storage Administrator is a Java-based graphical user interface (GUI) for LSM. The Storage Administrator displays a hierarchical view of LSM objects, AdvFS domains, and their relationships. You use the Storage Administrator to view and manage LSM objects and AdvFS domains on a local or remote (client) system.

The Storage Administrator consists of a server (daemon) and a client. The Storage Administrator server runs on a system that you want to administer. If LSM is not initiated, then the interface starts up in AdvFS-only mode. The Storage Administrator client runs on any machine that supports the Java run-time environment.

The Storage Administrator provides dialog boxes in which you enter information to create or manage LSM objects or AdvFS domains. Completing a dialog box might be the equivalent of entering several commands.

Note the following considerations when using the Storage Administrator:

A.1.1    Installing and Starting the Storage Administrator GUI

To install the Storage Administrator, choose the LSM GUI option during the LSM installation. Install the Storage Administrator on all systems on which you want to use the Storage Administrator to remotely manage the LSM software. See Chapter 3 for information on initializing the LSM software.

To use the Storage Administrator, you must log in as root unless your user name is in the /etc/group file for the system, in the group defined for Storage Administrator administration (lsmsa_admin by default).

To start the Storage Administrator, enter:

# /usr/bin/lsmsa

The Session Initiation dialog box is displayed. Enter the following information, then click on Ok:

When the Storage Administrator is started, the system attempts to connect it with the server process on the indicated host.

If the Storage Administrator cannot connect to the server, try the following:

A.1.2    Storage Administrator Main Window Components

The Storage Administrator main window consists of two panes. The left pane displays a hierarchical tree of objects. The right pane displays an object table that lists the properties of the object you select on the left. The window also has a Menu Bar and a Command Launcher that you can hide or display to initiate LSM options. Figure A-1 shows the components of the main window.

Figure A-1:  Storage Administrator Main Window

The Object Tree displays the hierarchical relationship between LSM objects and between objects in AdvFS domains. Each object represents a group of components of the same type. When you select the icon to the left of an object, components of that type appear in the right pane. You can expand objects (by clicking on the plus sign) to display their hierarchy.

The Object Table displays component objects that belong to the currently selected object in the Object Tree. The Object Table is dynamic and constantly updates its contents to reflect changes to the system.

The Command Launcher displays a list of tasks that you can perform on objects. When you click on a task in the Command Launcher list, the task starts and the dialog box for the task appears.

The Menu Bar contains the following menus:

The toolbar consists of the following buttons that provide access to the following windows:

A.2    Performing Tasks with the Storage Administrator

You perform most tasks by selecting objects or tasks, then providing information in resulting dialog boxes. You perform tasks using:

A.2.1    Selecting Objects

To select a single object, click on it. To deselect the object, click on it again.

To select or deselect multiple objects, hold down the Control key while selecting the objects. The objects that you select do not have to be adjacent.

To select a range of adjacent objects, select the first object and then hold down the Shift key while selecting the last object in the range. You can also select multiple adjacent objects by dragging the mouse over the desired objects while pressing the Shift key.

A.2.2    Using the Console Menu and Selected Menu

You can launch tasks from the Console and Selected menus in the Menu Bar.

Choose New from the Console menu to create:

The context-sensitive Selected menu changes to reflect which object you selected in the Object Table.

For example, to change a volume name, select Volumes in the Object Tree and the volume you want to rename in the Object Table. From the Volumes menu choose Rename, enter information in the Rename Volume dialog box, and click on OK.

A.2.3    Using the Right Mouse Button to Display a Pop-Up Menu

Click on the right mouse button to access a context-sensitive pop-up menu to display common task information that you can apply to the selected object. Additional tasks are available through the Menu Bar or the Command Launcher.

For example, to create a new volume in a disk group, select Disk Groups in the Object Tree, right-click on the disk group in the Object Table, choose New Volume from the pop-up menu, enter information in the New Volume dialog box, and click on OK.

A.2.4    Using the Command Launcher Window

The Command Launcher window contains a list of objects and associated tasks. To display the Command Launcher window, choose Command Launcher from the Window menu. To hide the Command Launcher window, choose Command Launcher again from the Window menu.

To perform a task on a specific type of object, select the appropriate object-command combination from the Command Launcher list. For example, to create a volume, choose Volume-New from the Command Launcher, enter information in the New Volume dialog box, and click on OK.

Caution

The Command Launcher does not restrict context. If you choose inappropriate commands and ignore the warning dialogs, you can perform operations that might result in permanent loss of data.

A.2.5    Exiting the Storage Administrator

To exit the Storage Administrator, choose Exit from the Console menu.

A.3    Managing LSM Disks

The following sections describe LSM disk management tasks that you can complete using the Storage Administrator.

A.3.1    Adding an Entire Disk

When you add a disk for use with the LSM software, the disk is either initialized or encapsulated. If the disk is not set up, initialize it. If you want to use a disk with partitions that are in use, encapsulate it. Encapsulation preserves any existing data on the disk in the form of volumes. Initialization destroys any existing data on the disk. Initialized disks are placed in the free disk pool and are available to add to a disk group.

To add a disk for use with the LSM software:

  1. In the Object Tree, select Disks and in the Object Table, select a disk to place under LSM control.

    If the disk is new and does not show up in the Object Table when you highlight Disks, click on Storage Administrator (at the top of the Object Tree) and choose Scan Disks from the System menu.

    In the Scan Disks dialog box, click on Ok to begin the search. From the Object Tree displayed, select a disk to add.

  2. From the Disks menu, choose Add.

    The Add Disk(s) dialog box (Figure A-2) is displayed.

    Figure A-2:  Add Disk(s) Dialog Box

  3. In the Add Disk(s) dialog box:

    1. If the correct disk device name is not displayed in the Disk Device field, enter the disk device name or click on Browse to select the disk. You can enter more than one name separated by spaces.

    2. Specify where to add disks:

      • To add disks to an existing disk group, select Existing Disk Group. Enter the disk group name in the Disk Group Name field or click on Browse to select a disk group.

      • To add disks to a new disk group, select New Disk Group. Enter the name of the new disk group in the Disk Group Name field. The new disk group is created.

      • To place disks in the free disk pool, select Free Disk Pool. Disks in the free disk pool are under LSM control (initialized) but do not belong to a disk group and cannot be used to create volumes.

    3. In the Options section:

      1. Specify the LSM disk names for the disks by typing a disk name in the Disk Name(s) field. This name must be unique within the disk group. If no LSM disk name is specified, the Storage Administrator assigns a default name to the disk.

      2. Enter a comment if desired.

    4. Click on Ok.

A.3.2    Adding a Hot-Spare Disk

You can add one or more unused disks to a disk group and designate them as hot-spare disks. If an I/O failure occurs, the hot-spare feature automatically relocates any redundant (mirrored or RAID 5) subdisks to the spare disk and restores the affected LSM objects and data. You are notified of the failure and relocation details by electronic mail. See Section 3.4.4 for more information on the hot-spare feature.

If you designate a hot-spare disk, provide at least one per disk group. In the event of disk failure, the hot-spare disk automatically replaces the failed disk. Volumes can use hot-spare disks only from within the same disk group.

To add a disk as a hot-spare disk:

  1. In the Object Tree, select Disk Groups and in the Object Table, select the LSM disk to be designated as a hot-spare disk.

  2. From the Disk Groups menu, choose Properties.

  3. In the Disk Properties window:

    1. Select the General tab.

    2. Select Spare.

    3. Click on Ok.

      Note

      The Properties dialog box is associated with the disk you have highlighted when you choose Properties. If you select a different disk from the Object Table, you must open a new Properties dialog box.

A.3.3    Evacuating a Disk

You can evacuate (or move) the contents of a disk to other disks in the same disk group if there is sufficient free space. If no target disk is specified, LSM uses available disks with sufficient free space. Evacuating a disk is useful in the event of disk failure.

If the disk being evacuated contains part of a mirrored, striped, or RAID 5 volume, do not move the contents of the disk to another disk containing a copy of the mirrored volume or part of the striped or RAID 5 volume.

To evacuate a disk:

  1. In the Object Tree, select Disks and in the Object Table, select the disk that contains the objects and data to be moved.

  2. From the Disks menu, choose Evacuate.

    The Evacuate Disk dialog box (Figure A-3) is displayed.

    Figure A-3:  Evacuate Disk Dialog Box

  3. In the Evacuate Disk dialog box:

    1. If the correct disk name is not displayed in the Disk Name field, enter the disk name or click on Browse then click on the Object Tree to select the disk.

    2. Enter the name of the target disk to which you want to move the contents of the evacuated disk or click on Browse then click on the Object Tree to select one or more target disks.

      If you choose Browse, the total evacuated space (in kilobytes) is displayed so you can choose your target disk accordingly.

    3. Click on Ok.

A.3.4    Mirroring a Disk

You can mirror all LSM objects on a disk to provide high availability for the volumes on that disk. Mirroring also improves read performance, because multiple reads to the same volume can be done simultaneously using the multiple copies of data.

If possible, mirror the objects onto a disk on a different bus to reduce the risk of a single point of failure for the volumes.

To mirror all volumes on a disk:

  1. In the Object Tree, select Disks and in the Object Table, select the disk that contains the volumes to be mirrored onto another disk.

  2. From the Disks menu, choose Mirror.

    The Mirror Disk dialog box (Figure A-4) is displayed.

    Figure A-4:  Mirror Disk Dialog Box

  3. In the Mirror Disk dialog box:

    1. If the correct disk name is not displayed in the Disk Name field, enter the disk name or click on Browse to select the disk.

      If you choose Browse, the mirrored total space is displayed so you can choose your target disk accordingly.

    2. To specify the disks to contain the new mirrors, enter the target disk name or click on Browse and complete the Target Disk dialog box.

    3. Click on Ok.

A.3.5    Taking a Disk Off Line

You can take a disk off line to prevent LSM from accessing it. You must remove a disk from its disk group before you take it off line. An offline disk remains unavailable until you restore access to the disk by placing it on line.

You take a disk off line to protect it from unintentional use; for example, if attempts to access it might have a negative effect on the system. You cannot take a disk that is in use off line.

To take a disk off line:

  1. In the Object Tree, select Disks and in the Object Table, select the disk to be taken off line.

  2. From the Disks menu, choose Offline.

    The Offline Disk dialog box is displayed.

  3. In the Offline Disk dialog box:

    1. If the correct disk name is not displayed in the Disk Name field, enter the disk name or click on Browse to select the disk.

    2. Click on Ok.

A.3.6    Placing a Disk On Line

Placing a disk on line restores access to a disk that is off line. The disk is placed in the free disk pool and is accessible to LSM again. After bringing a disk back on line, the disk must be added to a disk group before it can be used for volumes.

Only disks that are off line can be placed on line.

To place a disk on line:

  1. In the Object Tree, select Disks and in the Object Table, select the disk to be brought on line.

  2. From the Disks menu, choose Online.

    The Online Disk dialog box is displayed.

  3. In the Online Disk dialog box:

    1. If the correct disk name is not displayed in the Disk Name field, enter the disk name or click on Browse to select the disk.

    2. Click on Ok.

A.3.7    Recovering Volumes on a Disk

A recovery operation depends on the types of volumes on the disk and includes starting disabled volumes, resynchronizing mirrors in mirrored volumes, and resynchronizing parity in RAID 5 volumes.

Alert icons and the Alert Monitor window might indicate when a volume recovery is needed.

If recovery of a volume is not possible, restore the volume from backup.

To recover all volumes on a disk:

  1. In the Object Tree, select Disks and in the Object Table, select the disk that contains the volumes to be recovered.

  2. From the Disks menu, choose Recover.

    The Recover Disk dialog box is displayed.

  3. In the Recover Disks dialog box:

    1. If the correct disk name is not displayed in the Disk Name field, enter the disk name or click on Browse to select the disk.

    2. Click on Ok.

A.3.8    Removing an LSM Disk from a Disk Group

An LSM disk no longer in use can be removed from a disk group.

Caution

Do not remove LSM disks that are currently in use (for example, disks that contain subdisks for a volume); doing so can result in loss of data or of data redundancy.

After an LSM disk is removed from a disk group, it is still initialized for use with the LSM software. Therefore, after removing the disk from a disk group, it can be either immediately added to another disk group, removed from LSM, or left for later use.

To remove an LSM disk from a disk group:

  1. In the Object Tree, select Disks and in the Object Table, select the disk to be removed.

  2. From the Disks menu, choose Remove.

    The Remove Disk dialog box (Figure A-5) is displayed.

    Figure A-5:  Remove Disk Dialog Box

  3. In the Remove Disk dialog box:

    1. If the correct disk name is not displayed in the Disk Name field, enter the disk name or click on Browse to select the disk.

    2. To move the contents of the disk to another disk before the disk is removed, select Evacuate. Click on Target Disks to specify one or more disks to which you want the contents moved.

    3. Specify how to handle the disk after removal:

      • To remove the disk from its disk group and place it in the free disk pool, select Return to Free Disk Pool. The disk remains under LSM control.

      • To remove the disk from LSM control, select Return to Uninitialized State.

    4. Click on Ok.

A.3.9    Renaming a Disk

Because disk access names are defined by the operating system and media names are defined by you, you can rename only disk media names for disks in a disk group.

To rename the disk media name for an LSM disk:

  1. In the Object Tree, select Disks and in the Object Table, select the disk to be renamed.

  2. From the Disks menu, choose Rename.

    The Rename Disk dialog box is displayed.

  3. In the Rename Disk dialog box:

    1. If the correct disk name is not displayed in the Disk Name field, enter the disk name or click on Browse to select the disk.

    2. Enter the new LSM disk name.

    3. Click on Ok.

A.3.10    Replacing a Disk

You might need to replace a disk if the disk fails and needs to be removed and repaired. You can replace an existing disk with a new physical disk, move volumes to the new disk, and attempt to recover any redundant (mirrored or RAID 5) volumes on the disk. You cannot recover nonredundant volumes. You should restore nonredundant volumes from backup. If the disk being replaced is a boot disk, you can set up the new disk as a boot disk.

If you replace a good disk, you need to remove the disk from its disk group before you replace the disk. If you replace a disk that has failed and is disconnected, you do not need to remove the disk from the disk group.

To replace a disk:

  1. In the Object Tree, select Disks and in the Object Table, select the disk to be replaced.

  2. From the Disks menu, choose Replace.

    The Replace Disk dialog box (Figure A-6) is displayed.

    Figure A-6:  Replace Disk Dialog Box

  3. In the Replace Disk dialog box:

    1. If the correct disk name is not displayed in the Disk Name field, enter the LSM disk name for the disk to be replaced or click on Browse to select the disk.

    2. Enter the physical disk name for the new (replacement) disk or click on Browse to select a disk.

    3. Click on Ok.

A.3.11    Scanning for New Disks

You can search your configuration for disks that are not under LSM control. Disks that are found are added to the free disk pool.

To scan for a new disk:

  1. Select a disk from the Object Table.

  2. From the Disks menu, choose Add.

  3. Click on Scan Disk.

  4. To view disks that are found, click on Free Disk Pool in the Object Tree.

A.4    Managing Disk Groups

The following sections describe disk group management tasks that you can complete using the Storage Administrator.

A.4.1    Creating a Disk Group

You must place disks into a disk group before you can use them to create volumes. The default disk group (rootdg) is created during LSM installation and always exists on a system running LSM. You can create additional disk groups to organize your disks into logical sets.

Each new disk group must contain at least one disk and must have a unique name. You can use only disks that are on line and do not already belong to a disk group.

To create a disk group:

  1. From the Console menu, choose New then Disk Group.

    The New Disk Group dialog box (Figure A-7) is displayed.

    Figure A-7:  New Disk Group Dialog Box

  2. In the New Disk Group dialog box:

    1. Enter the name of the disk group to be created. Click on View to view the names of existing disk groups.

    2. To set up any new disks on the system, click Scan Disks. This runs the disk setup commands appropriate for the operating system.

    3. Enter the disk devices to be placed in the new disk group or click on Browse to select the devices.

    4. There are two options:

      • To specify the LSM disk name for the disk, enter a disk name in the Disk Name(s) field. If no LSM disk name is specified, the Storage Administrator assigns a default name to the disk.

      • Enter a comment if desired.

    5. Click on Ok.

A.4.2    Adding a Disk to a Disk Group

To add a disk to a disk group, follow the instructions for adding a disk (Section A.3.1). In the Add Disk dialog box, specify an existing disk group.

The LSM disk name must be unique within the disk group. If multiple disks are specified in the Disk Device(s) field and only one disk name is specified in the Disk Name(s) field, LSM appends numbers to the disk name so that each disk name is unique within its disk group.

You must place disks that belong to a disk group in the free disk pool before you can add them to another disk group. You must add disks in the free disk pool to a disk group before you can use them to create volumes.

Disks must be on line before you can add them to a disk group or the free disk pool. You cannot add disks to deported disk groups.

You must place the root disk in the root disk group (rootdg). If the root disk is placed in any other disk group, you cannot use the root disk to boot the system.

A.4.3    Adding a Disk Partition to a Disk Group

To add a disk partition to an LSM disk group:

  1. In the Object Tree, select Free Partitions and in the Object Table, select the partition to be added.

  2. From the Free Partitions menu, choose Add.

    The Add Disk Partition dialog box (Figure A-8) is displayed.

    Figure A-8:  Add Disk Partition Dialog Box

  3. Enter the name of the Disk Group to which you will add a partition or click on Browse to select a name.

  4. Click on Ok.

A.4.4    Deporting a Disk Group

After a disk group is created, the LSM software automatically imports it for use whenever the system is booted.

To disable access to a disk group, you deport the disk group. You must stop all the volumes within the disk group before deporting it.

To deport a disk group:

  1. In the Object Tree, select Disk Groups and in the Object Table, select the disk group to deport.

  2. From the Disk Groups menu, choose Deport.

    The Deport Disk Group dialog box (Figure A-9) is displayed.

    Figure A-9:  Deport Disk Group Dialog Box

  3. In the Deport Disk Group dialog box:

    1. If the correct disk group name is not displayed in the Disk Group Name field, enter the disk group name or click on Browse to select the disk group.

    2. Use the following Expert Options with caution:

      • To change the name of the disk group at deport, enter a new disk group name in the New Name field.

      • To set up a host machine to import the deported disk group at restart, enter the host ID in the New Host field.

    3. Click on Ok.

A.4.5    Importing a Deported Disk Group

You can import a disk group to make a deported (inaccessible) disk group and its volumes accessible again. To import a deported disk group, you must know the disk group's former name. This disk group name must have remained unused. In addition, at least one disk formerly assigned to the deported disk group must remain unused. If all disks associated with a deported disk group were reused because the disk group was deported, that disk group cannot be imported.

The import might fail for a number of reasons; for example, if the host cannot find one or more disks in the disk group. If the import fails because a disk has failed, you can import the disk group by selecting the Force Import Expert option. If the import fails for another reason, a forced import can cause serious problems.

When you import a disk group, the system stamps its host ID on all disks in the disk group. A disk group import fails if one of the disks is stamped with a host ID that does not match the others. This ensures that dual-ported disks cannot be managed (and possibly corrupted) by two systems at the same time. If you are sure that the disk group is not in use by another host, you can clear the host IDs and import the disk group by selecting the Clear Host ID Expert option.

To import a deported disk group:

  1. In the Object Tree select Disk Groups.

  2. From the All Disk Groups menu, choose Import Disk Group.

    The Import Disk Group dialog box (Figure A-10) is displayed.

    Figure A-10:  Import Disk Group Dialog Box

  3. In the Import Disk Group dialog box:

    1. If the correct disk group name is not displayed in the Disk Group Name field, enter the disk group name or click on Browse to select the disk group.

    2. Use the following Expert Options with caution:

      • To start all volumes in the disk group at import, select Start All Volumes.

      • To clear the existing host ID stamp on all disks in the disk group at import, select Clear Host ID. Do not use this option if another host is using any disk in the disk group.

      • To force the disk group import when the host cannot access all disks in the disk group, select Force Import.

    3. Enter the name of the disk group to be imported or click on Browse to select the disk group.

    4. To change the name of the disk group at import, enter a new disk group name in the New Name field. To indicate that the name change is temporary, select Use New Name as Temporary. If you indicate a temporary name change, the original name is restored when the system is restarted.

    5. Click on Ok.

A.4.6    Recovering Volumes in a Disk Group

You can recover volumes in a given disk group. The recovery operations depend on the types of volumes in the disk group and include starting disabled volumes, resynchronizing mirrors in mirrored volumes, and resynchronizing parity in RAID 5 volumes.

Alert icons and the Alert Monitor window might indicate when volume recovery is needed.

In some cases, recovery might not be possible. If the volume recovery fails, you can attempt to restore the volume from backup.

To recover all volumes in a disk group:

  1. In the Object Tree, select Disk Groups and in the Object Table, select the disk group containing the volumes to be recovered.

  2. From the Disk Groups menu, choose Recover.

    In the Recover Disk Groups dialog box, click Yes to recover the volumes in the disk group.

A.4.7    Renaming a Disk Group

You can rename a disk group. The new disk group name must be unique. If volumes in the disk group are in use (mounted), the disk group cannot be renamed.

Renaming a disk group updates the /etc/fstab file.

To rename a disk group:

  1. In the Object Tree, select Disk Groups and in the Object Table, select the disk group to be renamed.

  2. From the Disk Groups menu, choose Rename.

    The Rename Disk Group dialog box (Figure A-11) is displayed.

    Figure A-11:  Rename Disk Group Dialog Box

  3. In the Rename Disk Group dialog box:

    1. If the correct disk group name is not displayed in the Disk Group Name field, enter the disk group name or click on Browse to select the disk group.

    2. Enter the new name for the disk group.

    3. Click on Ok.

A.4.8    Moving a Disk Group to Another System

You can move a disk group (and LSM objects in that disk group) from one system to another. LSM and the Storage Administrator (server) must be running on both systems.

To move a disk group from one system to another:

  1. Stop and unmount all volumes in the disk group to be moved.

  2. Follow the instructions in Section A.4.4 to deport the disk group to be moved to the other system.

  3. Attach all the physical disks in the disk group to the new system.

  4. On the new system, follow the instructions in Section A.4.5 to import the disk group.

  5. In the Object Tree, select the Storage Administrator.

  6. From the System menu, choose Scan Disks to set up the newly attached disks on the system.

  7. Follow the instructions in Section A.4.6 to restart and recover all volumes in the disk group on the new system.

A.4.9    Destroying a Disk Group

You can destroy a disk group permanently to remove the group from LSM control. This process reinitializes all the disks in the disk group as empty disks and places them in the free disk pool for reuse. You cannot destroy a disk group if any volumes in that disk group are in use. When a disk group is destroyed, the volumes in the disk group are removed.

Destroy a disk group only if you are sure that you no longer need the volumes and data in the disk group. Because the last disk in an existing disk group cannot be removed, destroying a disk group is a way to free the last disk in a disk group for reuse.

You cannot destroy the rootdg disk group.

To destroy a disk group:

  1. In the Object Tree, select Storage Administrator.

  2. From the System menu, choose Destroy Disk Group.

    The Destroy Disk Group dialog box is displayed.

  3. In the Destroy Disk Group dialog box:

    1. Enter the name of the disk group to be destroyed in the Disk Group Name field or click on Browse to select the disk group.

    2. Click on Ok.

A.5    Managing Subdisks

Subdisks are created as the result of creating a volume. You cannot use the Storage Administrator to create subdisks.

The following sections describe the subdisk management tasks that you can complete using the Storage Administrator.

A.5.1    Joining Subdisks

You can join two or more subdisks to form a single, larger subdisk. Subdisks can be joined only if they belong to the same volume and occupy adjacent regions of the same disk and mirror. The joined subdisk can retain the name of one of the subdisks being joined.

For a volume with a striped plex, the subdisks must be in the same column.

To join subdisks:

  1. In the Object Tree, select Volumes and in the Object Table, select the volume with the subdisks to be joined.

  2. From the Volumes menu, choose Show Layout.

  3. In the Volume Layout Details window, hold down the Shift key and click to select the subdisks to be combined. Subdisks must be contiguous.

  4. From the Subdisks menu, choose Join.

    The Join Subdisks dialog box (Figure A-12) is displayed.

    Figure A-12:  Join Subdisks Dialog Box

  5. In the Join Subdisks dialog box:

    1. If the correct disk group name is not displayed in the Disk Group Name field, enter the name of the disk group that contains the subdisks to be joined.

    2. If the correct subdisk names are not displayed, enter the subdisk names or click on Browse to select the subdisks. Specify at least two subdisk names separated by a space.

    3. In the Target Subdisk Name field, enter the name of the new, combined subdisk.

    4. Click on Ok.

  6. Optionally, view the new volume layout by selecting Update from the View menu.

  7. Close the Volume Layout Details window.

A.5.2    Splitting a Subdisk

You can divide a subdisk into two or more subdisks. Once split, the new, smaller subdisks can be moved elsewhere or rejoined later. This feature is useful for reorganizing volumes or for improving performance. The original subdisk must contain a sufficient number of sectors for the specified split to work.

The name of the first new subdisk remains the same as the original subdisk. The other subdisks are automatically named by the Storage Administrator. The new, smaller subdisks occupy the same regions of the disk that the original subdisk occupied.

You cannot split a log subdisk.

To split a subdisk into multiple subdisks:

  1. In the Object Tree, select Volumes and in the Object Table, select the volume with the subdisk to be split.

  2. From the Volumes menu, choose Show Layout.

  3. In the Volume Layout Details window, select the subdisk to be split into multiple subdisks.

  4. From the Subdisks menu, choose Split.

    The Split Subdisk dialog box (Figure A-13) is displayed.

    Figure A-13:  Split Subdisk Dialog Box

  5. In the Split Subdisk dialog box:

    1. If the correct subdisk name is not displayed, enter the subdisk name or click on Browse to select the subdisk.

    2. In the Number of Target Subdisks field, enter the number of subdisks into which the subdisk should be split. A subdisk can be split into two or more subdisks.

    3. Click on Ok.

  6. Optionally, view the new volume layout by selecting Update from the View menu.

  7. Close the Volume Layout Details window.

A.5.3    Moving a Subdisk

You can move the data in subdisks to a different disk to improve performance. The disk space occupied by the original subdisk is returned to the free space pool.

Do not move a subdisk in a mirrored, striped, or RAID 5 volume to a disk that already contains a copy or part of that volume.

If the process of moving a subdisk leaves some unused subdisks (that is, subdisks that are not associated with a volume) on the system, you can remove the subdisk (Section A.5.4) to free the space occupied by the unused subdisks.

To move a subdisk:

  1. In the Object Tree, select Volumes and in the Object Table, select the volume with the subdisk to be moved.

  2. From the Volumes menu, choose Show Layout.

  3. In the Volume Layout Details window, select the subdisk to be moved to another disk.

  4. From the Subdisks menu, choose Move.

    The Move Subdisks dialog box (Figure A-14) is displayed.

    Figure A-14:  Move Subdisks Dialog Box

  5. In the Move Subdisks dialog box:

    1. If the correct disk group name is not displayed in the Disk Group Name field, enter the name of the disk group that contains the subdisk to be moved.

    2. If the correct source subdisk name is not displayed in the Source Subdisks field, enter the subdisk's name or click on Browse to select the subdisk.

    3. In the Target Disk Name field, enter the name of the target disk to which the subdisk should be moved or click on Browse to select a disk.

    4. Choose the Move Policy to specify whether the subdisk can be split into smaller subdisks that fit in available space(s) on the target disk. The One to One options do not split the subdisk. The Split as Required option allows the subdisk to be split if needed.

    5. In the Starting Offset for Gap Search field, enter the minimum disk offset for the subdisk.

  6. Click on Ok.

  7. Optionally, view the new volume layout by selecting Update from the View menu.

  8. Close the Volume Layout Details window.

A.5.4    Removing a Subdisk

You can remove a subdisk that is not associated with a volume. The disk space occupied by the unused subdisks is returned to the free space pool.

To remove a subdisk:

  1. In the Object Tree, select Disks and in the Object Table, select the disk with the subdisk to be removed.

  2. From the Disks menu, choose Properties.

  3. In the Disk Properties window, click the Subdisks tab.

  4. Select the subdisk to remove.

  5. From the Subdisk menu, choose Remove.

    In the Remove Subdisks dialog box, click Yes to remove the subdisk.

  6. Close the Disk Properties window.

A.6    Managing LSM Volumes

The following sections describe the volume management tasks that you can complete by using the Storage Administrator. Most tasks described in this section are appropriate only for UFS.

Notes

AdvFS volumes are not the same as LSM volumes. This section deals with LSM volumes. For information about AdvFS volumes, see Section A.7.1.

In a cluster, AdvFS file systems are supported in all modes; UFS file systems are supported in read-only mode.

A.6.1    Creating a Volume

You can create a volume that is less than or equal to the available free space on the LSM disks. If you do not specify the disks, the Storage Administrator uses any available space on disks in the selected disk group.

The data in a striped or concatenated volume is not protected against disk failure unless the volume is mirrored.

To create a volume:

  1. From the Console menu, choose New then Volume.

    The New Volume dialog box (Figure A-15) is displayed.

    Figure A-15:  New Volume Dialog Box

  2. In the New Volume dialog box:

    1. If the correct disk group name is not displayed, enter the disk group name or click on Browse to select the disk group.

    2. Accept the default new volume name or enter a new volume name.

    3. Enter a comment if desired.

    4. Enter the volume size:

      • To specify a size unit, attach an s (sectors), k (kilobytes), m (megabytes), or g (gigabytes) to the size. The default size unit is sectors.

      • To determine the largest possible size for the volume, click Maxsize. Units are displayed in kilobytes.

    5. Choose the volume layout:

      • Concatenated

      • Striped--Enter the number of columns and stripe unit size.

      • RAID 5--Enter the number of columns and stripe unit size. This option is not available in a cluster.

    6. If you have chosen a concatenated or striped volume, you can choose to mirror it.

      1. To mirror the volume, select Mirrored.

      2. In the Total Number of Mirrors field, enter the total number of mirrors for the volume.

        Note that each plex is a mirror, so if you create a volume with one mirror, the total number of plexes is 2.

    7. The Enable Logging box is selected by default when you create a mirrored or RAID 5 volume. To disable logging for the volume, deselect Enable Logging.

    8. To place the volume on a specific disk, click Assign Disks.

      • Select the disk you want to use from the Space Allocation-New Volume dialog box and click on Ok.

    9. To place a file system on the volume, click Add File System.

    10. In the Add File System dialog box:

      1. Enter the mount point for the file system. The mount point must be an absolute pathname; that is, it must begin with root (/). If the path specified for the mount point does not exist, it is created.

      2. Select Mount at Boot if you want the /etc/fstab file automatically updated and the file system mounted at system startup.

      3. Select the file system type. If you select AdvFS, enter the Domain Name and the Fileset name. If you select UFS, you can also select Extra Options in the Newfs Details dialog box. This option is not available in a cluster environment.

      4. Click on Mount Details to make the file system read-only or to add extra options. Click on Help in the Mount Details dialog box for more information.

      5. Click on Ok to close the Add File System dialog box.

    11. Click on Ok to close the New Volume dialog box.

A.6.2    Adding a Mirror to a Volume

You can create a mirror (copy) of a volume on a disk that is not being used. When mirrored, the data in the volume is redundant. If a disk fails, the data remains available on another mirror. A volume can have multiple mirrors, but each must reside on a separate disk. Sufficient disk space must be available. You cannot mirror a RAID 5 volume.

You can use only disks in the same disk group to create a mirror. If you do not specify the disks, LSM uses available disk space to create the mirror. Adding a mirror requires resynchronization, so this task might take some time.

A volume can contain up to 32 plexes, which can be any combination of mirrors and logs.

To add one or more mirrors to an existing volume:

  1. In the Object Tree, select Volumes and in the Object Table, select the volume to be mirrored.

  2. From the Volumes menu, choose Mirror then Add.

    The Add Mirror dialog box (Figure A-16) is displayed.

    Figure A-16:  Add Mirror Dialog Box

  3. In the Add Mirror dialog box:

    1. If the correct volume name is not displayed in the Volume Name field, enter the volume name or click on Browse to select the volume.

    2. Click on Layout to:

      • Specify the layout for the mirror (concatenated or striped) and, if striped, the stripe unit size.

      • Add more than one mirror and supply comments.

    3. Click on Assign Disks to place the mirror on a specific disk.

    4. Click on Ok.

A.6.3    Adding a Log to a Mirrored or RAID 5 Volume

When you add a log to a mirrored volume, dirty region logging (DRL) is activated for that volume. DRL uses the log to track the regions of the volume that change due to I/O writes. If a system failure occurs, DRL uses the information in the log to recover only the portions of the volume that need recovery. This speeds up recovery time for mirrored volumes.

You can create additional DRL logs (on different disks) to mirror the DRL information.

When you add a log to a RAID 5 volume, LSM maintains in the log a copy of the data and parity being written to the volume at any given time. The RAID 5 log speeds up the resynchronization time after a system failure. If a system failure occurs, when the system starts up LSM copies the data and parity that was being written at the time of failure from the log to the appropriate areas of the RAID 5 volume.

You can create multiple RAID 5 logs (on different disks) to mirror the log information. Ideally, each RAID 5 volume should have at least two logs.

To add a log to a volume:

  1. In the Object Tree, select Volumes and in the Object Table, select the volume to contain the log.

  2. From the Volumes menu, choose Log then Add.

    The Add Log dialog box (Figure A-17) is displayed.

    Figure A-17:  Add Log Dialog Box

  3. In the Add Log dialog box:

    1. If the correct volume name is not displayed in the Volume Name field, enter the volume name or click on Browse to select the volume.

    2. To place the log on a specific disk, enter the name of the disk in the Disk Name field or click on Browse to select a disk.

    3. Click on Ok.

A.6.4    Mounting a UFS File System on a Volume

You can mount an existing UFS file system on a volume. You can choose to have the /etc/fstab file automatically updated.

To mount a UFS file system on an existing volume:

  1. In the Object Tree, select Volumes and in the Object Table, select the volume on which to mount the UFS file system.

  2. From the Volumes menu, choose File System then Mount.

    The Mount File System dialog box (Figure A-18) is displayed.

    Figure A-18:  Mount File System Dialog Box

  3. In the Mount File System dialog box:

    1. If the correct volume name is not displayed in the Volume Name field, enter the volume name or click on Browse to select the volume.

    2. In the Mount Point field, enter the mount point for the file system. The mount point must be an absolute pathname; that is, it must begin with root (/). If the path specified for the mount point does not exist, it is created.

    3. Select Mount at Boot if you want the /etc/fstab file updated and the file system mounted at system startup.

    4. Click on Mount Details to make the file system read-only or to add extra options. Click on Help in the Mount Details dialog box for more information.

    5. Click on Ok.

A.6.5    Adding a File System to a Volume

You can place a new file system on an existing volume and mount the file system. You can choose to have the /etc/fstab file automatically updated.

To add a file system to an existing volume:

  1. In the Object Tree, select Volumes and in the Object Table, select the volume to contain the file system.

  2. From the Volumes menu, choose File System then New.

    The New File System dialog box (Figure A-19) is displayed.

    Figure A-19:  New File System Dialog Box

  3. In the New File System dialog box:

    1. If the correct volume name is not displayed in the Volume Name field, enter the volume name or click on Browse to select the volume.

    2. In the Mount Point field, enter the mount point for the file system. The mount point must be an absolute pathname; that is, it must begin with root (/). If the path specified for the mount point does not exist, it is created.

    3. Select Mount at Boot if you want the /etc/fstab file updated automatically, and the file system mounted at system startup.

    4. Select the file system type:

      • If you select AdvFS, enter the Domain Name and the Fileset name.

        To add a volume to an existing AdvFS domain, you must have an AdvFS Advanced Utilities license. If you supply an existing domain name and do not have a license, an error message is displayed. You can create a new domain for the volume without the Advanced Utilities license.

      • If you select UFS, you can also select Extra Options in the Newfs Details dialog box. Click on Help in the Newfs Details dialog box for more information. This option is not available in a cluster.

    5. Click on Mount Details to make the file system read-only or to add extra options. Click on Help in the Mount Details dialog box for more information.

    6. Click on Ok.

A.6.6    Checking a UFS File System in a Volume

Checking a file system applies only to UFS file systems; AdvFS does not use the fsck utility. You can check the file system with or without repairing it. Checking the file system might take some time.

If you are running a cluster, UFS file systems are mounted read-only, so the Storage Administrator cannot check the file system.

To check a UFS file system on a volume:

  1. In the Object Tree, select File System and in the Object Table, select the UFS file system to check.

  2. From the File Systems menu, choose Check.

    The Check File System dialog box (Figure A-20) is displayed.

    Figure A-20:  Check File System Dialog Box

  3. In the Check File System dialog box:

    1. If the correct file system name is not displayed in the File System Name field, enter the file system name or click on Browse to select the file system.

    2. Choose the Fsck option:

      • Check with no repair

      • Check and repair

    3. Choose the Mount option:

      • Unmount and check, then mount

      • Unmount and check

    4. Click on Ok.

      When the file system check is complete, the File System Check confirmation window appears indicating that the file system is okay.

    5. Click Close to close the File System Check window.

A.6.7    Unmounting a UFS File System on a Volume

You can unmount a mounted UFS file system on a volume.

To unmount a UFS file system on a volume:

  1. In the Object Tree, select Volumes and in the Object Table, select the volume containing the file system to be unmounted.

  2. From the Volumes menu, choose File System then Unmount.

    The Unmount File System dialog box is displayed.

  3. In the Unmount File System dialog box:

    1. If the correct volume name is not displayed, enter the volume name or click on Browse to select the volume.

    2. Click on Ok.

A.6.8    Mapping and Analyzing Volumes, Disks, and Subdisks

One of the most important management features of the Storage Administrator is the ability to view a map of your volumes, disks, or subdisks. Using the Volume to Disk Mapping window (Figure A-21) to view volumes or their associated disks or subdisks can save you time, especially if you have a large number of volumes and disks.

You can also use the Volume to Disk Mapping window to display information about the performance of volumes, disks, and subdisks.

The statistical values for the performance data are represented by different colors. When the analysis starts or changes, the color behind the object changes. Clicking on any of the green dots in the table highlights the path between the volume and its related disks or subdisks. Statistics can be collected only on volumes. Only disks and subdisks associated with volumes can be analyzed.

You can open Volume to Disk Mapping windows for more than one disk group; however, only one disk group can be analyzed at a time.

To open the Volume to Disk Mapping window:

  1. In the Object Tree, select Disk Groups and in the Object Table, select the disk group to map.

  2. From the Disk Groups men, choose Disk/Volume Map.

    The Volume to Disk Mapping window (Figure A-21) is displayed.

    Figure A-21:  Volume to Disk Mapping Window

  3. In the Volume to Disk Mapping window:

A.6.9    Disabling a Mirror in a Volume

You can disable a mirror to temporarily detach the mirror from its volume. However, this can result in a loss of data redundancy, because the mirroring process is not occurring. A detached mirror is inaccessible for reads and writes but is still associated with its volume.

Once disabled, the mirror remains detached from its volume until you either reattach the mirror or restart the volume. When a volume is restarted, any disabled (detached) mirrors are reattached to the volume automatically.

If a volume has two mirrors and one mirror is disabled, the volume is not redundant while the mirror is disabled.

The last mirror in a volume cannot be disabled.

To disable a mirror in a volume:

  1. In the Object Tree, select Volumes and in the Object Table, select the volume that contains the mirror to be disabled.

  2. From the Volumes menu, choose Mirror then Disable.

    The Disable Mirror dialog box (Figure A-22) is displayed.

    Figure A-22:  Disable Mirror Dialog Box

  3. In the Disable Mirror dialog box:

    1. Select a mirror to disable.

      The mirror name appears in the Select a Mirror to Disable field.

    2. Click on Ok.

    In the Disable Mirror dialog box, click Yes to disable the selected mirror.

A.6.10    Repairing a Mirror in a Volume

You can repair a disabled mirror and reattach it to its volume. This process copies the data from an active mirror on the volume to the mirror being repaired and attaches the repaired mirror to the volume. Once attached, the mirror is accessible for reads and writes. The mirror is recovered so that it has the same contents as other mirrors in the volume.

Alert icons and the Alert Monitor window might indicate when a mirror needs to be repaired.

Depending on the amount of data in the volume, this task might take some time.

To repair a mirror:

  1. In the Object Tree, select Volumes and in the Object Table, select the volume that contains the mirror to be repaired.

  2. From the Volumes menu, choose Mirror then Repair.

    The Repair Mirror dialog box (Figure A-23) is displayed.

    Figure A-23:  Repair Mirror Dialog Box

  3. In the Repair Mirror dialog box:

    1. Select the mirror to be repaired.

    2. Click on Ok.

A.6.11    Creating a Snapshot of Volume Data

You can create a snapshot (temporary mirror) of a volume that you can then use to create a temporary volume for backup. You do not need to stop or take the original volume off line. In a cluster, you cannot take a snapshot of the clusterwide root.

To create or stop a volume snapshot:

  1. In the Object Tree, select Volumes and in the Object Table, select a volume for which to create or stop a snapshot.

  2. From the Volumes menu, choose Snapshot.

    The Volume Snapshot dialog box (Figure A-24) is displayed.

    Figure A-24:  Volume Snapshot Dialog Box

  3. In the Volume Snapshot dialog box:

    1. If the correct volume name is not displayed in the Volume Name field, enter the volume name or click on Browse to select the volume.

    2. Accept the default snapshot name (volume) or enter a snapshot volume name.

    3. Click on Assign Disks to select the disks for the snapshot volume.

  4. To create the snapshot, start, or stop it:

A.6.12    Recovering a Volume

The volume recovery operations depend on the type of volume and include starting disabled volumes, resynchronizing mirrors in mirrored volumes, and resynchronizing parity in RAID 5 volumes. After successful recovery, the volume will be available for use.

Alert icons and the Alert Monitor window might indicate when a volume recovery is needed.

In some cases, recovery might not be possible. If the volume recovery fails, you can attempt to restore the volume from backup.

To recover a failed volume:

  1. In the Object Tree, select Volumes and in the Object Table, select the volume to be recovered.

  2. From the Volumes menu, choose Recover.

  3. In the Recover Volume dialog box, click Yes to recover the volume.

A.6.13    Preparing to Restore a Volume from Backup

If a volume's data is corrupted and you need to restore the volume from backup, you must prepare the volume for restoration. To restore a volume from backup, you can stop the volume, set the volume to an uninitialized state, and restart the volume (without resynchronizing the volume's mirrors). This procedure will not work for an AdvFS file domain.

If the volume contains a mounted UFS file system, you must unmount the file system before you restore the volume from backup. This task does not remount the file system.

To prepare to restore a volume from backup:

  1. In the Object Tree, select Volumes and in the Object Table, select the volume to be restored from backup.

  2. From the Volumes menu, choose Prepare For Restore.

    In the Prepare Volume For Restore dialog box, click Yes to prepare the volume for restoration.

A.6.14    Removing a Mirror from a Volume

Removing a mirror from a volume breaks the link between the mirror and its volume and returns the mirror's disk space to the free space pool for reuse.

If a volume has only two mirrors and one mirror is removed, the volume is no longer redundant. This leaves the volume unprotected against disk failure. The last mirror cannot be removed from a volume, for that is equivalent to removing the volume.

To remove a mirror from a volume:

  1. In the Object Tree, select Volumes and in the Object Table, select the volume that contains the mirror to be removed.

  2. From the Volumes menu, choose Mirror then Remove.

    The Remove Mirror dialog box is displayed.

  3. In the Remove Mirror dialog box, select a mirror to remove and click Ok.

A.6.15    Removing a Log from a Volume

You can remove a DRL log or a RAID 5 log from a volume.

If you remove a volume's only log, logging (either DRL or RAID 5 logging) is no longer in effect for that volume. If logging is disabled, recovery time increases.

To remove a log from a volume:

  1. In the Object Tree, select Volumes and in the Object Table, select the volume that contains the RAID 5 or DRL log to be removed.

  2. From the Volumes menu, choose Log then Remove.

    The Remove Log dialog box (Figure A-25) is displayed.

    Figure A-25:  Remove Log Dialog Box

  3. In the Remove Log dialog box, select the log to remove and click on Ok.

A.6.16    Removing a Volume

Removing a volume destroys all the data in that volume. Remove a volume only if you are sure that you do not need the data in the volume (or the data is backed up elsewhere). When a volume is removed, the space it occupied is returned to the free space pool.

Removing a volume that has a file system on it works only if the file system is UFS.

To remove a volume:

  1. In the Object Tree, select Volumes and in the Object Table, select the volume to remove.

  2. From the Volumes menu, choose Remove.

    The Remove Volume dialog box is displayed.

  3. In the Remove Volume dialog box, click Yes to remove the volume.

A.6.17    Renaming a Volume

When you rename a volume, the new name must be unique within the disk group. If the volume has a file system, renaming the volume automatically updates the /etc/fstab file and allows you to specify a new mount point for the file system. You cannot rename volumes that are part of an AdvFS domain.

To rename a volume:

  1. In the Object Tree, select Volumes and in the Object Table, select the volume to be renamed.

  2. From the Volumes menu, choose Rename.

    The Rename Volume dialog box (Figure A-26) is displayed.

    Figure A-26:  Rename Volume Dialog Box

  3. In the Rename Volume dialog box:

    1. If the correct volume name is not displayed, enter the volume name or click on Browse to select the volume.

    2. Enter the new name for the volume.

    3. Click on Ok.

    If the volume is open or mounted, the Open Volumes dialog box is displayed.

  4. In the Open Volumes dialog box, click Yes to rename the volume.

A.6.18    Resizing a Volume

You can increase or decrease the size of a volume, with the following exceptions:

You can specify either the desired size or the amount of space to add to or subtract from the volume size. When a volume is shrunk, the resulting extra space is returned to the free space pool. To increase the volume size, sufficient disk space must be available. When increasing the size of a volume, LSM assigns the necessary new space from available disks.

To resize a volume:

  1. In the Object Tree, select Volumes and in the Object Table, select the volume to be resized.

  2. From the Volumes menu, choose Resize.

    The Resize Volume dialog box (Figure A-27) is displayed.

    Figure A-27:  Resize Volume Dialog Box

  3. In the Resize Volume dialog box:

    1. If the correct volume name is not displayed, enter the volume name or click on Browse to select the volume.

    2. To use a specific disk for the additional space, click Assign Disks and select the disk you want to use from the Space Allocation-Resize dialog box.

    3. Specify one of the following:

      • To increase the volume size by a specific amount of space, use the Add By field to specify how much space to add.

      • To decrease the volume size by a specific amount of space, use the Subtract By field to specify how much space to remove.

      • To specify the new volume size, enter the size in the Desired Size field.

        To specify a size unit, attach an s (sectors), k (kilobytes), m (megabytes), or g (gigabytes) to the size. The default unit is sectors.

  4. Click on Ok.

A.6.19    Restarting a Volume

Under normal circumstances, volumes are automatically started when the system restarts. You can restart a volume that you stopped manually or that was stopped in some other manner. If you cannot start a volume, the volume remains unusable. If the volume contains an AdvFS file domain, you cannot start it using the following procedure.

If you are not running a cluster, restarting a RAID 5 volume enables the volume and resynchronizes parity, if necessary. Restarting a mirrored volume enables the volume and resynchronizes the mirrors to ensure that they are consistent. When a volume is successfully restarted, the volume is again available for use.

To restart a volume:

  1. In the Object Tree, select Volumes and in the Object Table, select the stopped volume to be started.

  2. From the Volumes menu, choose Start.

    The Start Volume dialog box is displayed.

  3. In the Start Volume dialog box:

    1. If the correct volume name is not displayed, enter the volume name or click on Browse to select the volume.

    2. Click on Ok.

      The volume's state in the Object Table changes to Started.

A.6.20    Stopping a Volume

When you stop a volume, it is not available for use until you restart it. You cannot stop a volume if it is in use or it has a mounted file system. If the volume contains an AdvFS file domain, you cannot stop it using the following procedure.

To stop a volume:

  1. In the Object Tree, select Volumes and in the Object Table, select the volume to be stopped.

  2. From the Volumes menu, choose Stop.

    The Stop Volume dialog box is displayed.

  3. In the Stop Volume dialog box:

    1. If the correct volume name is not displayed, enter the volume name or click on Browse to select the volume.

    2. Click on Ok.

      The volume's state in the Object Table changes to Stopped.

A.7    Performing AdvFS Operations

The following sections describe Advanced File System (AdvFS) tasks that you can complete using the Storage Administrator.

A.7.1    Creating an AdvFS Domain

You can create an AdvFS domain to hold all disks or partitions on your system or create several domains to hold disks specific to particular applications. When you create a domain, you must specify one volume. An AdvFS volume can be created from a complete disk, a disk partition, or an LSM volume.

Existing data on the volume you assign to a new domain is destroyed when the domain is created.

Figure A-28 shows the main Storage Administrator main window with the AdvFS Domains entry fully expanded to include Filesets and Volumes.

Figure A-28:  Storage Administrator Main Window

To create a domain:

  1. In the Object Tree, select AdvFS Domains and from the All Domains menu choose New Domain.

    The New Domain dialog box (Figure A-29) is displayed.

    Figure A-29:  New Domain Dialog Box

  2. In the New Domain dialog box:

    1. Enter the domain name. Characters invalid for domain names are white-space characters (tab, new line, space and so on) and punctuation marks and symbols (/ # : * ?).

    2. Enter the volume name used to create the new domain, or click on Browse Disks, Browse Volumes, or Browse Partitions to select one.

    3. Enter the fileset name. Characters invalid for fileset names are white-space characters (tab, new line, space and so on) and punctuation marks and symbols (/ # : * ?).

    4. Enter the mount point for the fileset. The mount point must be an absolute pathname; that is, it must begin with root (/).

    5. Select Mount at Boot if you want the fileset to be automatically mounted at system startup.

    6. Click on Ok.

A.7.2    Adding a Volume to an AdvFS Domain

An AdvFS volume can be a single disk partition, an entire disk, or an LSM volume.

To see volumes already contained in a domain, open AdvFS Domains in the Main Window by selecting the plus sign, select the domain you want to work on, then select the volume icon.

If there are volumes within the AdvFS domain, they are displayed in the Object Table.

To add a volume to an AdvFS domain:

  1. In the Object Tree, select AdvFS Domains.

  2. Select the domain to contain the volume.

  3. From the Domains menu, choose Add volume.

    The Add Volume dialog box (Figure A-30) is displayed.

    Figure A-30:  Add Volume Dialog Box

  4. In the Add Volume dialog box:

  5. Enter the new name for the volume to be added to the domain.

  6. Click on Ok.

A.7.3    Adding a Fileset to an AdvFS Domain

You can add a fileset to an existing AdvFS domain. Fileset names must be unique within a domain. You can choose to have the /etc/fstab file updated automatically.

You can limit the number of files in a fileset by assigning quotas.

To add a fileset to an existing AdvFS domain:

  1. In the Object Tree, select AdvFS domains and in the Object Table select the domain to which to add the fileset.

  2. From the Domains menu, choose Add Fileset.

    The Add Fileset dialog box (Figure A-31) is displayed.

    Figure A-31:  Add Fileset Dialog Box

  3. In the Add Fileset dialog box:

    1. In the Fileset field, enter the name of the fileset to add to the domain.

    2. In the Mount Point field, enter the mount point for the fileset. The mount point must be an absolute pathname; that is, it must begin with /.

    3. Select the Mount at Boot option if you want to update the /etc/fstab file and automatically mount the fileset at system startup.

    4. Click on Ok.

A.7.4    Defragmenting an AdvFS Domain

Before you can defragment an AdvFS domain, all filesets in the domain must be mounted. If you try to defragment an active domain that includes unmounted filesets, Storage Administrator displays an error message.

Defragment an AdvFS domain only when it is needed for system performance.

To defragment an AdvFS domain:

  1. In the Object Tree, select AdvFS Domains and in the Object Table, select a domain to defragment.

  2. From the Domains menu, choose Defragment.

    The Defragment Domain dialog box (Figure A-32) is displayed.

    Figure A-32:  Defragment Domain Dialog Box

  3. Enter the number of minutes for the defragment utility to run.

    If the utility is still performing an operation when the specified time has elapsed, the procedure continues until the operation is complete.

  4. Click on Ok.

A.7.5    Cloning an AdvFS Fileset

At any time, only one clone can be created for an AdvFS fileset. A RAID 5 volume cannot be cloned.

To clone an AdvFS fileset:

  1. In the Object Tree, click the plus sign to open the AdvFS Domains, then click the plus sign to open the domain containing the fileset to clone.

  2. In the Object Tree, select Filesets.

  3. In the Object Table, select the fileset you want to clone.

  4. From the Filesets menu, choose Clone.

    The Clone Fileset dialog box (Figure A-33) is displayed.

    Figure A-33:  Clone Fileset Dialog Box

  5. Enter a name for the cloned fileset.

  6. Click on Ok.

A.7.6    Changing Fileset Quotas

You can change fileset quota limits. When a quota limit is reached, no more disk space allocations or file creations that would exceed the limit are allowed.

The quota numbers for block limits are displayed in kilobytes. Note that fileset quotas are not kept for the root user.

To change a fileset quota:

  1. In the Object Tree, click the plus sign to open the AdvFS Domains, then click the plus sign to open the domain containing the fileset with limits to change.

  2. In the Object Tree, select Filesets.

  3. Select the fileset with limits to change.

  4. From the Filesets menu, select Quotas.

    The Fileset Quotas dialog box (Figure A-34) is displayed.

    Figure A-34:  Fileset Quotas Dialog Box

  5. In the Fileset Quotas dialog box:

  6. Click on Ok.

A.7.7    Unmounting an AdvFS Fileset

You must unmount an AdvFS fileset to rename the fileset or to resize the underlying LSM volume.

To unmount a fileset:

  1. In the Object Tree, click the plus sign to open the AdvFS Domains, then click the plus sign to open the domain containing the fileset to unmount.

  2. In the Object Tree, select Filesets.

  3. In the Object Table, select the fileset to unmount.

  4. From the Filesets menu, choose Unmount.

  5. Verify that the name of the fileset is correct.

  6. Click on Yes.

A.7.8    Renaming an AdvFS Fileset

You can rename an AdvFS fileset. You must unmount the fileset before you can rename it. When you rename a fileset, the /etc/fstab file is updated.

To rename an AdvFS fileset:

  1. In the Object Tree, click the plus sign to open the AdvFS Domains, then click the plus sign to open the domain containing the fileset to rename.

  2. In the Object Tree, select Filesets.

  3. In the Object Table, select the fileset you want to rename.

    The Rename Fileset dialog box (Figure A-35) is displayed.

    Figure A-35:  Rename Fileset Dialog Box

  4. Enter the new name for the fileset.

  5. Click on Ok.

A.7.9    Mounting an AdvFS Fileset

You can mount an AdvFS fileset that you unmounted to rename or to resize the underlying LSM volume.

To mount an AdvFS fileset:

  1. In the Object Tree, click the plus sign to open the AdvFS Domains, then click the plus sign to open the domain containing the fileset to mount.

  2. In the Object Tree, select Filesets.

  3. In the Object Table, select the fileset to mount.

  4. From the Filesets menu, choose Mount.

    The Mount Fileset dialog box (Figure A-36) is displayed.

    Figure A-36:  Mount Fileset Dialog Box

  5. In the Mount Fileset dialog box:

  6. Click on Ok.

A.7.10    Removing an AdvFS Fileset

To remove an AdvFS fileset:

  1. In the Object Tree, click the plus sign to open the AdvFS Domains, then click the plus sign to open the domain containing the fileset to remove.

  2. In the Object Tree, select Filesets.

  3. In the Object Table, select the fileset you want to remove.

  4. From the Filesets menu, choose Remove.

    The Remove Fileset window is displayed.

  5. Click on Yes to remove the indicated fileset.