VERITAS Volume Manager 3.1 Storage Administrator Administrator’s Guide for HP-UX 11i and HP-UX 11i Version 1.5 June, 2001 Manufacturing Part Number: B7961-90020 E0601 United States © Copyright 1983-2000 Hewlett-Packard Company. All rights reserved..
Legal Notices The information in this document is subject to change without notice. Hewlett-Packard makes no warranty of any kind with regard to this manual, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be held liable for errors contained herein or direct, indirect, special, incidental or consequential damages in connection with the furnishing, performance, or use of this material.
California. This software is based in part on the Fourth Berkeley Software Distribution under license from the Regents of the University of California. Copyright 2000 VERITAS Software Corporation Copyright 1988 Carnegie Mellon University Copyright 1990-1995 Cornell University Copyright 1986 Digital Equipment Corporation. Copyright 1997 Isogon Corporation Copyright 1985, 1986, 1988 Massachusetts Institute of Technology. Copyright 1991-1997 Mentat, Inc.
Publication History The manual publication date and part number indicate its current edition. The publication date will change when a new edition is released. The manual part number will change when extensive changes are made. To ensure that you receive the new editions, you should subscribe to the appropriate product support service. See your HP sales representative for details.
1. Introduction to the Storage Administrator Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . The Volume Manager Storage Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Storage Administrator Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . The Main Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Running Tasks From the Command Launcher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using Dialog Boxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Specifying Objects in Dialog Boxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Viewing Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . The Task Request Monitor Window. . . . . . . . . .
To disconnect a disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Replacing a Disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . To replace a disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Unrelocating a Disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Activating a Disk Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 To activate a disk group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 4. Volume Tasks Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Volume Task Roadmap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
To recover a failed volume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Repairing a Mirror . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . To repair a mirror . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Disabling a Mirror . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Viewing File System Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating a QuickLog Log on a Volume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . To designate a volume as a QuickLog log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Enabling the QuickLog Log for a File System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . To enable a QuickLog log for a file system . . . . . . . . . . . . . . . .
6. Troubleshooting Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Alerts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Disk Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Disk State: Imported . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Preface 13
Introduction This guide describes how to use the VERITAS Volume Manager Storage Administrator. The Volume Manager Storage Administrator (VMSA) is the Graphical User Interface (GUI) for the VERITAS Volume Manager.
Audience This guide is intended for system administrators responsible for configuring and maintaining systems using the VERITAS Volume Manager.
Organization This guide is organized as follows: • Chapter 1, “Introduction to the Storage Administrator,” describes the main components of the Volume Manager Storage Administrator. • Chapter 2, “Getting Started,” describes how to set up and start using the Storage Administrator. • Chapter 3, “Disk Tasks,” describes how to set up and use disks with the Storage Administrator. • Chapter 4, “Volume Tasks,” describes how to create and use volumes and related objects with the Storage Administrator.
Related Documents The following documents provide related information: • VERITAS Volume Manager 3.1 Administrator’s Guide • VERITAS Volume Manager 3.1 Reference Guide • VERITAS Volume Manager 3.1 for HP-UX Release Notes • VERITAS Volume Manager 3.
Conventions We use the following typographical conventions. audit (5) An HP-UX manpage. audit is the name and 5 is the section in the HP-UX Reference. On the web and on the Instant Information CD, it may be a hot link to the manpage itself. From the HP-UX command line, you can enter “man audit” or “man 5 audit” to view the manpage. See man (1). Book Title The title of a book. On the web and on the Instant Information CD, it may be a hot link to the book itself. KeyCap The name of a keyboard key.
Term Double-click Right-click Press and Hold Point Select Drag Definition Click the mouse button twice (quickly). Press and release the right mouse button. Press and continue to hold down the mouse button. Move the tip of the pointer onto an item on the screen. Click the mouse button while the pointer is directly over the item to be selected. Slide the mouse while pressing a mouse button.
Introduction to the Storage Administrator 1 Introduction to the Storage Administrator Chapter 1 21
Introduction to the Storage Administrator Introduction Introduction This chapter provides a brief introduction to the VERITAS Volume Manager Storage Administrator. This chapter describes the main components of the Storage Administrator and contains a summary of common tasks.
Introduction to the Storage Administrator The Volume Manager Storage Administrator The Volume Manager Storage Administrator The VERITAS Volume Manager Storage Administrator is the graphical user interface for the Volume Manager. You can use the Storage Administrator to administer disks, volumes, and file systems on local or remote machines. The Storage Administrator is a Java based interface that consists of a server and a client.
Introduction to the Storage Administrator The Volume Manager Storage Administrator application. • Scalability The Storage Administrator can handle systems containing a large number of disks. Administrators can view all of the objects on the system or focus on a specific object or set of objects. • Security The Storage Administrator can only be run by users with appropriate privileges. Administrators can restrict the use of the Storage Administrator to a specific set of users.
Introduction to the Storage Administrator The Main Window The Main Window The Volume Manager Storage Administrator’s main window (see Figure 1-1, Main Window,) consists of: • a hierarchical tree of objects • a grid that lists objects and their properties • a menu bar • a toolbar • a status area • a Command Launcher (hidden by default) The toolbar and Command Launcher can be separated from and reattached to the main window (this is known as docking). The grid can be replicated in a separate window.
Introduction to the Storage Administrator The Main Window Figure 1-1 Main Window The Object Tree and Grid The Storage Administrator’s main window is divided into two main panes: • Left Pane (Object Tree) The left pane contains the object tree, which is a dynamic hierarchical display of Volume Manager objects and other objects on the system.
Introduction to the Storage Administrator The Main Window same type. Each object group has a group icon and a group name. The following object groups typically appear as nodes in the object tree: — Hosts – Any host machines connected to the current Storage Administrator client session. — Controllers – All controllers on the system. — Disk Groups – All disk groups on the system. — Disks – All disks on the system. — Enclosures – All enclosures (disk arrays) on the system.
Introduction to the Storage Administrator The Main Window The Menu Bar The menu bar at the top of the main window contains the following menus: • File The File menu provides access to the New menu, which creates volumes, disk groups, and file systems. The File menu also establishes new host connections, prints the contents of the main window, closes the main window, provides access to an object Properties window, or exits the Storage Administrator.
Introduction to the Storage Administrator The Main Window • Volume Manager Storage Administrator The Volume Manager Storage Administrator (VMSA) button launches an additional Storage Administrator main window. • Task The Task button launches the Task Request Monitor window. The Task Request Monitor window displays a list of tasks performed in the current session. Each task is listed with the user who performed the task, the task status, and the start and finish times for the task.
Introduction to the Storage Administrator The Main Window The Print button launches the Print dialog box for a selected object. This dialog box is used to print details about a specific object. • Customize The Customize (Custm) button launches the Customize window, which is used to set user preferences. The Customize window allows you to customize the appearance of the components of the Storage Administrator.
Introduction to the Storage Administrator The Main Window pressing and holding the mouse button to drag the splitter to the desired position. You can sort the items listed in the Command Launcher by object type, command, or task description by clicking on the appropriate column heading. You can reverse the sort order by clicking on the column heading again.
Introduction to the Storage Administrator Storage Administrator Icons Storage Administrator Icons The following table shows icons that appear in the Storage Administrator.
Introduction to the Storage Administrator Storage Administrator Icons Icon Description shared disk group volume root/boot volume plex mirror log subdisk controller enclosure (disk array) subpath (Dynamic Multipathing) file system cluster cluster node (host) Chapter 1 33
Introduction to the Storage Administrator Storage Administrator Icons Icon Description QuickLog file system QuickLog volume Object View Icons: concatenated layout striped layout RAID-5 layout concatenated pro layout striped pro layout mirrored layout mixed layout Toolbar Icons: Storage Administrator window Task Request Monitor window 34 Chapter 1
Introduction to the Storage Administrator Storage Administrator Icons Icon Description Alert Monitor window Search window Grid Copy window New Volume dialog box Host connection dialog box Object Properties window Print dialog box Customize window expand disks collapse disks Chapter 1 35
Introduction to the Storage Administrator Storage Administrator Icons Icon Description expand volumes collapse volumes projection Task Status Icons: task in progress successful task failed task paused task cancelled task exited task Performance Monitoring Icons: slowest response time slow response time 36 Chapter 1
Introduction to the Storage Administrator Storage Administrator Icons Icon Description default Miscellaneous Icons: alert error message information question warning Command Launcher task customization change check mark Chapter 1 37
Introduction to the Storage Administrator Task Roadmap Task Roadmap This section provides a summary of common Volume Manager Storage Administrator tasks. The tasks are grouped into setup tasks, ongoing maintenance tasks, and repair or recovery tasks. The procedures for these and other tasks are included in later chapters.
Introduction to the Storage Administrator Task Roadmap • Create shared disk groups. These tasks are described in Chapter 5, Host and Cluster Tasks. Maintenance Tasks After you have set up your disks and volumes, you may need to perform some or all of the following maintenance tasks. To monitor objects • Use the main window’s tree (left pane) and grid (right pane) to view disks, volumes, file systems, and other objects on the system.
Introduction to the Storage Administrator Task Roadmap • Create snapshot copies of volumes and then back up the volumes. • Reorganize the space occupied by volumes (by moving subdisks to other disks). These tasks are described in Chapter 4, Volume Tasks. To maintain file systems • Place additional file systems on volumes. • Increase the size of file systems as users and applications require more space. • Create snapshot copies of vxfs file systems and then back up the file systems.
Introduction to the Storage Administrator Task Roadmap To repair/recover file systems • Perform a file system consistency check on any file systems that may be damaged. These tasks are described in Chapter 4, Volume Tasks.
Introduction to the Storage Administrator Task Roadmap 42 Chapter 1
Getting Started 2 Getting Started Chapter 2 43
Getting Started Introduction Introduction This chapter describes how to set up and start using the Volume Manager Storage Administrator. This chapter focuses on how to use the main components of the Storage Administrator.
Getting Started Introduction • “Setting User Preferences” — “The Customize Window” • “Searching for Objects or Free Space” • “Responding to Alerts” • “Printing” • “Exiting the Storage Administrator” Chapter 2 45
Getting Started Installation and Setup Installation and Setup The Volume Manager Storage Administrator consists of a server (vmsa_server) and a client (vmsa). You must install and run the Storage Administrator server on a UNIX machine running the Volume Manager. You can install and run the Storage Administrator client on any machine that supports the Java Runtime Environment. NOTE Windows systems are not supported as Storage Administrator clients. On HP-UX 11i Version 1.
Getting Started Installation and Setup Step 4. If you plan to run the Storage Administrator client from a machine other than the machine to be administered, install the Storage Administrator client on the machine where the client will run. NOTE This step is not necessary on an HP-UX 11i Version 1.5 system, because all HP-UX 11i Version 1.5 systems include VxVM and vmsa. Step 5. Start the Storage Administrator server on the machine to be administered. Step 6. Start the Storage Administrator client.
Getting Started Customizing Security (Optional) Customizing Security (Optional) The VERITAS Volume Manager Storage Administrator can only be run by users with appropriate privileges. By default, only root can run the Storage Administrator. However, you can set up your system to allow other users to run Storage Administrator. Step 1. On the machine to be administered, add a group named vrtsadm to the group file, /etc/group, or NIS (Network Information Name Service) group table.
Getting Started Starting the Storage Administrator Server Starting the Storage Administrator Server To use the VERITAS Volume Manager Storage Administrator, the Storage Administrator server must be running on the HP-UX machine to be administered. Only one instance of the Storage Administrator server can be running at a time. The Storage Administrator server can be run either in normal mode or in auto-start mode.
Getting Started Starting the Storage Administrator Server ./vmsa_server & A file named server.log will be created in the /var/opt/vmsa/logs directory. If the server starts successfully, this file should contain the following (after a few seconds): rebound //host:2410/vrts.remote.vrtsServer Step 4. Confirm that the Storage Administrator is running: vmsa_server -q See vmsa_server (1M) for more information about the Storage Administrator server.
Getting Started Starting the Storage Administrator Server autostart off For more information about auto-start mode, see autostart (1M).
Getting Started Starting the Storage Administrator Client Starting the Storage Administrator Client The VERITAS Volume Manager Storage Administrator client software, the vmsa GUI, can be run from the machine to be administered (the server machine), or from a remote machine (the client machine). The VERITAS Volume Manager daemon, vxconfigd, and the Storage Administrator server, vmsa_server, must be running on the machine to be administered.
Getting Started Running the Storage Administrator in Read-Only Mode Running the Storage Administrator in Read-Only Mode The Storage Administrator can be run in a read-only mode that is useful for monitoring, training, or browsing purposes. Read-only mode allows you to view objects on the system through the Storage Administrator, but prevents administrative actions from taking effect.
Getting Started Running the Storage Administrator in Read-Only Mode vrts.server.readonly=false NOTE You must stop and restart the server for this change to take effect. • Start the client in read-only mode: vmsa -r • Connect to a host machine as a user who only has permission to run the Storage Administrator in read-only mode on that host. This enables read-only mode on the specified host machine.
Getting Started Stopping the Storage Administrator Server Stopping the Storage Administrator Server If you need to stop the Storage Administrator server for some reason, use the following command: vmsa_server -k You can restart the Storage Administrator server manually, as described in “Starting the Storage Administrator Server” above, or it will restart when the system is rebooted. See vmsa_server (1M) for more information about the Storage Administrator server.
Getting Started Selecting Objects Selecting Objects You can select objects in most Storage Administrator windows in the following ways: • To select a single object, click on the object. • To select multiple objects, hold down the Control key while selecting the objects. The objects that you select in this way 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.
Getting Started Viewing Objects and Object Properties Viewing Objects and Object Properties The Storage Administrator provides the following views of objects and their properties: • Tree and Grid View The main window’s tree and grid view displays volumes, disks, file systems, and other objects on the system. The grid also displays a limited set of properties for listed objects.
Getting Started Viewing Objects and Object Properties also closes the window or exits the Storage Administrator. The Options menu accesses user preferences and sets the Storage Administrator to read-only mode. The Window menu and the toolbar buttons launch other Storage Administrator windows. The context-sensitive Selected and popup menus access tasks or properties for a selected object. To access the popup menu for an object, right-click on the object.
Getting Started Viewing Objects and Object Properties node in the tree, click on the plus sign (+) or minus sign (-) icon next to that node. • To display the objects in an object group, click on the appropriate object group in the object tree. All objects that belong to the selected object group appear in the grid. Examples: To display all volumes, click on Volumes in the object tree. All volumes on the system appear in the grid. Each volume is listed with a set of properties.
Getting Started Viewing Objects and Object Properties Main Grid. A copy of the grid appears in a separate window. The new grid window continues to display and update the objects that were shown when you created the grid copy. You can create multiple copies of the grid and use these grid windows to display different sets of objects. For example, you can display volumes in one grid window and disks in another. • To print the contents of the grid, choose File > Print Grid and complete the Print dialog box.
Getting Started Viewing Objects and Object Properties — Layout mode shows a disk’s regions and layout. This mode displays the subdisks and free space on a disk. — Detailed mode shows detailed information about a disk and its subdisks and free space. This mode displays properties of the disk and its regions. You can move the horizontal splitter to adjust the relative heights of both panes.
Getting Started Viewing Objects and Object Properties The Collapse Volume button hides details for all volumes in the Object View. This button displays objects in layout mode or basic mode, depending on the previous mode. • Expand Disk The Expand Disk button shows more detailed information about all disks in the Object View. This button displays objects in layout mode or detailed mode, depending on the previous mode. • Collapse Disk The Collapse Disk button hides details for all disks in the Object View.
Getting Started Viewing Objects and Object Properties Dissociated Object View window (Window > Show Dissociated). Figure 2-2, Object View Window, shows how volumes and disks appear in the Object View. Figure 2-2 Object View Window Figure 2-3, Volume in Object View, show how the components of a volume appear in the Object View.
Getting Started Viewing Objects and Object Properties Figure 2-3 Volume in Object View You can view objects in the Object View window in the following ways: • To display the Object View window, select a disk group (in the main window grid) and then choose Disk Groups (Selected menu) > Object View. • To show the layouts and components of all volumes in the Object View window (layout mode), choose Options > Volumes > Layout.
Getting Started Viewing Objects and Object Properties choose Options > Disks > Collapse All. • To show or hide details about a particular disk in the Object View, click on the disk icon on the left side of the disk. This expands or collapses the disk. • To perform a task on an object in the Object View window, select the object and choose a task from the Selected or popup menu. To access the popup menu for an object, right-click on the object.
Getting Started Viewing Objects and Object Properties Figure 2-4 Volume Layout Details Window You can view objects in the Volume Layout Details window in the following ways: • To display the Volume Layout Details window for a volume, click on the volume (in the main window grid) and then choose Volumes (Selected menu) > Show Layout. • To update (refresh) the graphical view to show any recent changes to the current volume, choose File > Update.
Getting Started Viewing Objects and Object Properties The Volume to Disk Mapping Window The Volume to Disk Mapping window displays a tabular view of volumes and their underlying disks. Volumes are listed in the top row of the table and disks are listed in the left column of the table. Each circle icon in the table indicates that part of the corresponding volume is located on the corresponding disk. This window can also display details such as the subdisks and gaps (free space) on each disk.
Getting Started Viewing Objects and Object Properties Figure 2-5 Volume to Disk Mapping Window You can view volumes and their associated disks in the following ways: • To display the Volume to Disk Mapping window for all volumes in a disk group, click on the disk group (in the main window grid) and then choose Disk Groups (Selected menu) > Disk/Volume Map. • To display all of the subdisks and gaps on a particular disk, click the arrow to the left of the disk name.
Getting Started Viewing Objects and Object Properties • To print the properties of a particular object, select the object and then choose File > Print and complete the Print dialog box. The Object Properties Window The object Properties window contains detailed information about the selected object. The Properties window contains a set of tabbed pages, each of which contains information about the object and related objects. The tab labels and page contents vary, depending on the type of object selected.
Getting Started Viewing Objects and Object Properties You can view object properties in the following ways: • To view the properties of an object, click on the object (in the main window grid) and then choose Properties from the Selected or popup menu. You can also access the Properties window by double-clicking on the object. Example: To display volume properties, either click on a volume and then choose Volumes > Properties or double-click on a volume.
Getting Started Accessing Tasks Accessing Tasks Most Volume Manager Storage Administrator tasks are performed by selecting objects and/or tasks and then completing the resulting dialog boxes. With the Storage Administrator, you can access tasks from the following: • the menu bar • a context-sensitive popup menu • the Command Launcher This section describes how to run tasks from menus and the Command Launcher.
Getting Started Accessing Tasks To change a volume’s name, select the volume in the grid. Choose Volumes > Rename from the Selected menu. Type the volume’s new name in the Rename Volume dialog box, then click OK. Running Tasks From a Popup Menu A context-sensitive popup menu launches tasks on the selected object. A popup menu provides access to tasks or options appropriate for the selected object. Popup menus are available in the main window and most other windows.
Getting Started Accessing Tasks The Command Launcher can be displayed as part of the main window (docked) or as a separate window. The Command Launcher can also be hidden. When the Command Launcher is attached to the main window, tasks are context sensitive. However, tasks are not context sensitive when the Command Launcher is separated from the main window. The File menu attaches (docks) the Command Launcher to the main window and closes the Command Launcher window.
Getting Started Accessing Tasks Complete the Add Disk dialog box. • To sort the items listed in the Command Launcher by object type, command, or task description, click on the appropriate column heading. To reverse the sort order in a column, click on the column heading again. • To separate or attach (dock) the Command Launcher and the main window, choose Options > Customize and click Dock Command Launcher in the Customize window’s Main Window tab.
Getting Started Using Dialog Boxes Using Dialog Boxes Administrators typically use dialog boxes to submit tasks or other requests to the Storage Administrator. Dialog boxes can contain selectable buttons and/or fields that accept information. Some dialog box fields contain default values that can be changed. Items that are not applicable are greyed out.
Getting Started Using Dialog Boxes Figure 2-10 Browse Dialog Box In some cases, you can specify multiple objects (separated by white space) in a single field. To select multiple objects from a browse dialog box, hold down the Control key and click on each object. 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.
Getting Started Using Dialog Boxes Specifying Object Sizes in Dialog Boxes When you type the size of an object in an input field, you can specify sectors, kilobytes, megabytes, or gigabytes by appending an s, k, m, or g to the size. If you do not specify a size unit, the size defaults to sectors.
Getting Started Viewing Commands Viewing Commands The Storage Administrator logs all task requests. You can view the Storage Administrator task history (including tasks in progress) in either of these locations: • The Task Request Monitor Window • The Command Log File The Task Request Monitor Window The Task Request Monitor window displays a history of tasks performed in the current session (and any other sessions running on the machine).
Getting Started Viewing Commands • To cancel a selected task, choose Tasks > Abort. To temporarily stop a task, choose Tasks > Pause. To continue a task, choose Tasks > Resume. To view task properties and the low-level command(s) used to perform a task, select the task and choose Properties from the Tasks or popup menu. You can also access task properties by double-clicking on the task. • To sort the tasks by task type, click on the Task column heading.
Getting Started Viewing Commands Figure 2-12 Task Properties Window The Command Log The command log file contains a history of Volume Manager Storage Administrator tasks performed in the current session and previous sessions. The command log file contains a description of each task, along with properties such as the user who performed the task, the task status, the start/finish times, and the low-level commands used to perform the task.
Getting Started Viewing Commands The following example shows some sample command log file entries: Create Volume Description: Create Volume User: root Started: November 18, 1999 4:36:11 PM PDT Finished: November 18, 1999 4:36:12 PM PDT State: Successful Executed Commands: /usr/sbin/vxassist -g rootdg make vol15 3m layout=nostripe Create Volume FAILED! Description: Create Volume User: root Started: November 18, 1999 4:36:56 PM PDT Finished: November 18, 1999 4:36:56 PM PDT State: Failed Executed Commands: /u
Getting Started Setting User Preferences Setting User Preferences You can change the way items appear in Storage Administrator windows. This section describes how to use the Customize window to customize the way the Storage Administrator appears. The Customize Window The Customize window displays current user preferences for the components of the Storage Administrator and allows you to change these settings.
Getting Started Setting User Preferences Figure 2-13 Customize Window You can use the Customize window as follows: • To display the Customize window, choose Options > Customize (from the main window) or click on the Customize button in the toolbar. • To change preference settings, make the appropriate selections in the Customize window, then click OK. This changes the settings for all tabs in the Customize window. To reset the settings to the previous settings, click Reset (before you click OK).
Getting Started Setting User Preferences disappears when you click OK, Apply, or Reset. The customization change icon also appears in the status area of the main window. • To save your preference settings and apply them to future Storage Administrator sessions, choose Options > Save Customization. You can also save your preference settings by clicking the customization change icon in the status area.
Getting Started Setting User Preferences General Set the following general preferences: Set Text Field Input to Replace Mode Show Task Options Show Confirmation Dialogs Set user input to replace mode. This highlights any existing text in a field and replaces that text with the new text. Show/hide optional settings in task dialog boxes. Show/hide confirmation dialogs for tasks that may have serious consequences (such as data loss).
Getting Started Setting User Preferences Main Window Set the following preferences for the main window: Show Status Bar Show/hide the status bar area (at the bottom of the main window). The status bar displays alert icons when failures or errors occur. Show Command Launcher Show/hide the Command Launcher. The Command Launcher contains a list of selectable tasks. Dock Command Launcher Attach/detach the Command Launcher and the main window.
Getting Started Setting User Preferences Selection Foreground ColorSet the color for foreground text in selected items. Focus Highlight Color Set the color for the item that has input focus. Link Color Set the color for links (such as the links to tasks in the Command Launcher). Projection Color Set the color for the lines that show object relationships in the Volume Layout Details window. • To access the Color Selector, click Change.
Getting Started Setting User Preferences Brightness sliders to the appropriate positions.
Getting Started Setting User Preferences Selector Tree/Grid Width Selector Grid Width Visible Selector Rows Set the width (in pixels) of the tree and grid in browse dialog boxes that contain a tree and a grid. Set the width (in pixels) of the grid in browse dialog boxes that contain a grid only. Set the number of rows displayed in the tree and grid in browse dialog boxes. Toolbar Set the following preferences for the toolbar: Show Toolbar Position Presentation Show/hide the toolbar.
Getting Started Setting User Preferences Hosts Set the following preferences for accessing and displaying host machines: Connect Default Host Auto-Expand Automatically connect to the specified host(s) at Storage Administrator startup. Use this host machine as the default host. In the main window’s object tree, expand the specified host node and display the hierarchy under that host. • To specify a host machine, click Add and type the host machine name in the Hosts column of the grid.
Getting Started Searching for Objects or Free Space Searching for Objects or Free Space The Search window searches the specified host machine(s) for objects that match the specified search criteria. Any objects that match the search criteria are listed in the grid in the lower half of the search window, along with their properties. Objects displayed in the search window are monitored and removed from the window if they no longer meet the current search criteria.
Getting Started Searching for Objects or Free Space Figure 2-14 Object Search Window You can use the Search window as follows: • To display the Search window, choose Window > Search (from the main window) or click on the Search button in the toolbar. • To begin a search, enter your search criteria and then click Search. Make sure that the Host(s) field contains the name of the host machine(s) where the search will be performed.
Getting Started Searching for Objects or Free Space • To view the properties of an object listed in the search results grid, select the object and choose Properties from the Selected or popup menu. You can also access object properties by double-clicking on the object. • To open a window that contains a copy of the current search results grid, choose Window > Copy Search Grid. To open another Search window, choose Window > Search.
Getting Started Responding to Alerts Responding to Alerts When an object fails or experiences an error, an alert icon appears in the status area of the main window and/or on the object’s icon (see Figure 2-15, Alerts for a Volume,). If an alert icon appears, you should review the contents of the Alert Monitor window. The Alert Monitor window lists information about objects that have failed or experienced other errors (see Figure 2-16, Alert Monitor Window,).
Getting Started Responding to Alerts Figure 2-15 Alerts for a Volume Figure 2-16 Alert Monitor Window You can use the Alert Monitor window as follows: Chapter 2 95
Getting Started Responding to Alerts • To display the Alert Monitor window, choose Window > Alerts (from the main window) or click on the Alert button in the toolbar. You can also access the Alert Monitor window by clicking on the alert icon in the status area. • To sort alerts by object or description, click on the appropriate column heading. To reverse the sort order, click on the column heading again.
Getting Started Printing Printing You can print the contents of some Storage Administrator windows. In some cases, you can print information about a specific object instead of the contents of the window. • To print the contents of a Storage Administrator window, choose File > Print Grid and complete the Print dialog box. • To print details about a specific object displayed in the window, select the object, choose File > Print, and then complete the Print dialog box.
Getting Started Exiting the Storage Administrator Exiting the Storage Administrator • To exit the Volume Manager Storage Administrator client, choose File > Exit.
Disk Tasks 3 Disk Tasks Chapter 3 99
Disk Tasks Introduction Introduction This chapter describes how to set up and use disks and disk groups with the Volume Manager Storage Administrator. The Disk Task Roadmap at the beginning of this chapter contains a summary of common disk and disk group tasks.
Disk Tasks Introduction • “Upgrading a Disk Group” • “Renaming a Disk Group” • “Deporting a Disk Group” • “Importing a Disk Group” • “Recovering Volumes in a Disk Group” • “Clearing Relocation Information for a Disk Group” • “Destroying a Disk Group” • “Moving a Disk Group” • “Activating a Disk Group” Chapter 3 101
Disk Tasks Disk Task Roadmap Disk Task Roadmap The following table provides a summary of common Volume Manager Storage Administrator disk and disk group tasks. To do this...
Disk Tasks Disk Task Roadmap To do this... Move a disk group to another system Destroy a disk group (permanently) Chapter 3 Use this procedure...
Disk Tasks Adding a Disk to the Volume Manager Adding a Disk to the Volume Manager New disks must be set up on the system, placed under Volume Manager control, and added to a disk group before they can be used for volumes. The add disk(s) task performs these tasks to prepare new disks for Volume Manager use. You can also use this task to add a disk to a disk group. When you place a disk under Volume Manager control, the disk is initialized. Initialization destroys any existing data on the disk.
Disk Tasks Adding a Disk to the Volume Manager Add Disk(s) to: Specify where the disk(s) should be placed: • To add the disk(s) to an existing disk group, select Existing Disk Group. Type the disk group name in the Disk Group Name field or click Browse to select a disk group. • To add the disk(s) to a new disk group, select New Disk Group. Type the name of the new disk group in the Disk Group Name field. The new disk group will be created for the new disk.
Disk Tasks Adding a Disk to the Volume Manager Step 2. Choose Disks > Add (Selected menu) or Disk Add (Command Launcher). Step 3. Complete the Add Disk(s) dialog box as follows: Disk Device(s): If the correct disk (device) name is not already displayed in this field, type the disk’s name or click Browse to select the disk. Add Disk(s) to: Specify where the disk(s) should be placed: • To add the disk(s) to an existing disk group, select Existing Disk Group.
Disk Tasks Adding a Disk to the Volume Manager click OK. Notes: • This task requires a disk device name and the location for the new disk (that is, a disk group or the free space pool). • This task sets up disks for Volume Manager use. Disks must be under Volume Manager control and in a disk group before they can be used to create volumes. • Disks in the free disk pool need to be added to a disk group before they can be used to create volumes.
Disk Tasks Scanning Disks Scanning Disks This procedure checks for new disks and runs the appropriate commands to set up any new disks. You can use this task to make sure that the Volume Manager recognizes any new hardware. To scan disks Step 1. Select the host machine to be scanned for new disks. Step 2. Choose Hosts > Scan Disks (Selected menu) or Disk Scan (Command Launcher). Step 3.
Disk Tasks Designating a Disk as a Hot-Relocation Spare Designating a Disk as a Hot-Relocation Spare This procedure adds a disk to the pool of spare disks available to the hot-relocation feature. If an I/O failure occurs, hot-relocation automatically relocates any redundant (mirrored or RAID-5) subdisks to spare disks and restores the affected Volume Manager objects and data. The system administrator is notified of the failure and relocation details via electronic mail.
Disk Tasks Reserving a Disk Reserving a Disk This procedure designates a disk as a reserved disk. A reserved disk is not considered part of the free space pool. If you perform a task that requires disk space and you do not specify a disk, the Storage Administrator allocates space from disks other than the reserved disk. To reserve a disk Step 1. Follow the instructions in “Adding a Disk to the Volume Manager” to place the disk under Volume Manager control and in a disk group. Step 2.
Disk Tasks Renaming a Disk Renaming a Disk This procedure changes the Volume Manager name assigned to a disk. The Volume Manager disk name is the name given to the disk by the administrator or the Volume Manager. This procedure does not change the physical disk name (device name). To rename a disk Step 1. Select the disk to be renamed. Step 2. Choose Disks > Rename (Selected menu) or Disk Rename (Command Launcher). Step 3.
Disk Tasks Offlining a Disk Offlining a Disk This procedure prevents the Volume Manager from accessing a disk. A disk must be removed from its disk group before it can be taken offline (see “Removing a Disk”). An offline disk remains unavailable until you restore access to the disk (see “Onlining a Disk”). To take a disk offline Step 1. Select the disk to be taken offline. Step 2. Choose Disks > Offline (Selected menu) or Disk Offline (Command Launcher). Step 3.
Disk Tasks Onlining a Disk Onlining a Disk This procedure restores access to a disk that has been taken offline. The disk is placed in the free disk pool and is accessible to the Volume Manager again. After bringing a disk back online, the disk must be added to a disk group before it can be used for volumes (see “Adding a Disk to the Volume Manager”). To bring a disk online Step 1. Select the disk to be brought online. Step 2. Choose Disks > Online (Selected menu) or Disk Online (Command Launcher).
Disk Tasks Mirroring a Disk Mirroring a Disk This procedure mirrors (copies) all concatenated volumes on a disk onto another disk. You can use this procedure to mirror any disk that contains concatenated volumes. To mirror all concatenated volumes on a disk Step 1. Select the disk that contains the concatenated volumes to be mirrored onto another disk. Step 2. Choose Disks > Mirror (Selected menu) or Disk Mirror (Command Launcher). Step 3.
Disk Tasks Evacuating a Disk Evacuating a Disk This procedure moves the contents of the volumes on a disk to another disk. If a disk begins to fail, you can attempt to protect/preserve the volumes on that disk by evacuating the disk. You can also evacuate a disk if you plan to remove the disk or use the disk elsewhere. To evacuate a disk Step 1. Select the disk that contains the objects and data to be moved to another disk. Step 2.
Disk Tasks Disconnecting a Disk Disconnecting a Disk This procedure disconnects a Volume Manager disk from its underlying physical disk. You can disconnect a disk in preparation for the replacement of a physical disk. After disconnecting a disk, you can use the Replace Disk task to reconnect the disk (see “Replacing a Disk”). To disconnect a disk Step 1. Select the disk to be disconnected. Step 2. Choose Hosts > Disconnect Disk (Selected menu) or Disk Disconnect (Command Launcher). Step 3.
Disk Tasks Replacing a Disk Replacing a Disk This procedure replaces an existing disk with a new physical disk, moves any volumes to the new disk, and attempts to recover any redundant (mirrored or RAID-5) volumes on the disk. Non-redundant volumes cannot be recovered and should be restored from backup, if possible. If the disk being replaced is a boot disk, this procedure also sets up the new disk as a boot disk. You may need to replace a disk if the disk fails and/or needs to be removed and repaired.
Disk Tasks Replacing a Disk click OK. Notes: • This task requires the name of the disk to be replaced and the replacement disk name. • The disk to be replaced must be disconnected or removed from its disk group. If the disk has not failed, you need to remove the disk from its disk group and put it in the free disk pool before you replace the disk. • The new disk can be a disk in the free disk pool or an uninitialized disk.
Disk Tasks Unrelocating a Disk Unrelocating a Disk This procedure moves relocated subdisks back to their original disk. When a disk fails, the hot-relocation feature attempts to move subdisks from the failed disk to other disks. The Unrelocate Disk task can be used to return the relocated subdisks to their original disk locations after the original disk is repaired or replaced. To move relocated subdisks back to a disk Step 1. Select the disk that contained the subdisks before hot-relocation. Step 2.
Disk Tasks Unrelocating a Disk click OK. Notes: • This task requires the name of the original disk (even if an alternate disk is specified). • When a disk fails, the hot-relocation feature attempts to move subdisks from the failed disk to other disks. The Unrelocate Disk task can be used to return the relocated subdisks to their original disk locations after the original disk is repaired or replaced.
Disk Tasks Recovering Volumes on a Disk Recovering Volumes on a Disk This procedure performs any necessary volume recovery operations on the volumes on a given disk. The recovery operations depend on the types of volumes on the disk and include starting disabled volumes, resynchronizing mirrors in mirrored volumes, and resynchronizing parity in RAID-5 volumes. After successful recovery, the volumes should be available for use again.
Disk Tasks Removing a Disk Removing a Disk This procedure removes a disk from its disk group and either places the disk in the free disk pool or removes the disk from Volume Manager control. If the disk is returned to the free space pool, the disk must be added to a disk group before it can be used for volumes (see “Adding a Disk to the Volume Manager”). If the disk to be removed contains volumes, you must evacuate the disk before you remove the disk.
Disk Tasks Removing a Disk click OK. Notes: • This task requires a disk name. You also need to specify whether the disk should be placed in the free disk pool or removed from Volume Manager control. • If the disk contains a volume that has only one mirror and either has a mounted file system or is used as a swap area, you must evacuate the disk before you remove it. • When a disk is removed from a disk group or Volume Manager control, the disk cannot be accessed. • A disk that is in use (i.e.
Disk Tasks Forcing Initialization of a Disk Forcing Initialization of a Disk CAUTION Forcing the (re)initialization of a disk can result in data loss. This procedure forces the initialization of a disk. This procedure can be used to reinitialize a disk. This task is intended for use in troubleshooting disks that have already been placed under Volume Manager control. To initialize a disk for Volume Manager use, use the Add Disks task instead (see “Adding a Disk to the Volume Manager””).
Disk Tasks Viewing Disk Properties Viewing Disk Properties The Disk Properties window contains detailed information about the selected disk. The Properties window contains a set of tabbed pages, each of which contains information about the disk and related objects. You can display a different page by clicking on the appropriate tab label. • To view the properties of a disk, select the disk and then choose Properties from the Disks or popup menu.
Disk Tasks Disabling a Controller Disabling a Controller This procedure disables I/O to a controller. This procedure also prevents the Dynamic Multipathing feature from accessing the paths associated with a controller. You can disable access to a controller in preparation for hardware maintenance. To enable a controller Step 1. Select the controller to be disabled. Step 2. Choose Controller Disable (Command Launcher). Step 3.
Disk Tasks Enabling a Controller Enabling a Controller This procedure enables I/O to a controller. If the Dynamic Multipathing feature is enabled, this procedure also restores access to the paths associated with a controller. To enable a controller Step 1. Select the controller to be enabled. Step 2. Choose Controller Enable (Command Launcher). Step 3.
Disk Tasks Renaming an Enclosure Renaming an Enclosure This procedure changes the name of an enclosure (disk array). To rename an enclosure Step 1. Select the enclosure to be renamed. Step 2. Choose Enclosures > Rename (Selected menu) or Enclosure Rename (Command Launcher). Step 3. Complete the Rename Enclosure dialog box as follows: Enclosure Name: If the correct enclosure name is not already displayed in this field, type the name or click Browse to select the enclosure.
Disk Tasks Creating a Disk Group Creating a Disk Group This procedure creates an additional disk group. Disks must be placed in disk groups before they can be used by the Volume Manager. The default disk group (rootdg) is usually created during Volume Manager installation and always exists on a system running the Volume Manager. You can create additional disk groups to organize your disks into logical sets of disks. When you place a disk under Volume Manager control, the disk is initialized.
Disk Tasks Creating a Disk Group Options Click Show Options to access the optional settings for this task. • To create a shared disk group, select Create Shared. This option is only applicable in a cluster environment. • To specify the Volume Manager disk name for the disk, type a disk name in the Disk Name(s) field. If no Volume Manager disk name is specified, the Volume Manager assigns a default name to the disk.
Disk Tasks Upgrading a Disk Group Upgrading a Disk Group This procedure upgrades a disk group to the disk group version that is compatible with the current Volume Manager release. Some new features and tasks only work on disk groups with the current disk group version, so you must upgrade existing disk groups before you perform these tasks. However, after you upgrade a disk group, you cannot access that disk group from machines running earlier releases of the Volume Manager.
Disk Tasks Renaming a Disk Group Renaming a Disk Group This procedure changes the name of an existing disk group. You might rename a disk group to provide a more appropriate name or avoid a name conflict with a disk group to be imported. To rename a disk group Step 1. Select the disk group to be renamed. Step 2. Choose Disks Groups > Rename (Selected menu) or Disk Group Rename (Command Launcher). Step 3.
Disk Tasks Deporting a Disk Group Deporting a Disk Group This procedure makes a disk group and its volumes inaccessible. Once deported, a disk group cannot be used until it is imported. You can deport a disk group to make the disk group temporarily unavailable. While a disk group is deported, you cannot remove and reuse any of its disks. To remove disks, you must import the disk group and then either destroy the disk group (to remove all of its disks) or remove selected disks from the disk group.
Disk Tasks Deporting a Disk Group click OK. Notes: • This task requires a disk group name. • A deported disk group cannot be accessed. To access a deported disk group, the disk group must be imported. • The rootdg disk group cannot be deported. • A disk group cannot be deported if any volumes in that disk group are in use (open). • When a disk group is deported, the host ID stored on all disks in the disk group is cleared and the disk group is not reimported automatically when the system is rebooted.
Disk Tasks Importing a Disk Group Importing a Disk Group This procedure makes 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 and this disk group name must remain unused. In addition, at least one disk formerly assigned to the deported disk group must remain unused. To import a disk group Step 1. Select the appropriate host machine node. Step 2.
Disk Tasks Importing a Disk Group Options Click Show Options to access the optional settings for this task. • 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(s) in the disk group. • To force the disk group import when the host cannot access all disks in the disk group, select Force Import.
Disk Tasks Importing a Disk Group click OK. Notes: • This task requires a disk group name. • Only deported disk groups can be imported. • A deported disk group cannot be imported if another disk group with the same name has been created since the disk group was deported. • A disk group import may fail 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 option.
Disk Tasks Recovering Volumes in a Disk Group Recovering Volumes in a Disk Group This procedure performs any necessary volume recovery operations on the 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. After successful recovery, the volumes should be available for use again.
Disk Tasks Clearing Relocation Information for a Disk Group Clearing Relocation Information for a Disk Group This procedure clears hot-relocation alerts and removes relocation data from a disk group. To clear relocation information for a disk group Step 1. Select the disk group containing hot-relocation information to be cleared. Step 2. Choose Disk Groups > Clear Relocation Information (Selected menu) or Disk Group Clear Relocation Info (Command Launcher). Step 3.
Disk Tasks Destroying a Disk Group Destroying a Disk Group CAUTION Destroying a disk group can result in data loss. This procedure permanently removes a disk group from Volume Manager control. This also reinitializes all of the disks in the disk group as empty disks and places them in the free disk pool for reuse. You should only destroy a disk group if you are sure that you no longer need the volumes and data in the disk group.
Disk Tasks Moving a Disk Group Moving a Disk Group This procedure moves a disk group (and the Volume Manager objects in that disk group) from one system to another. This relocates the disk group’s configuration to the new system. To move a disk group from one machine to another Step 1. Unmount and stop all volumes in the disk group to be moved. (See Chapter 4, Volume Tasks, for information on how to unmount and stop volumes.) Step 2.
Disk Tasks Activating a Disk Group Activating a Disk Group This procedure sets the activation mode for a disk group. The disk group activation mode controls read and write access to volumes in the specified disk group. To activate a disk group Step 1. Select the disk group to be activated. Step 2. Choose Disk Groups > Activation (menu) or Disk Group Activate/Deactivate (Command Launcher). Step 3.
Volume Tasks 4 Volume Tasks Chapter 4 143
Volume Tasks Introduction Introduction This chapter describes how to create and use volumes with the Volume Manager Storage Administrator. It also includes information on how to use file systems with volumes. The Volume Task Roadmap and File System Task Roadmap at the beginning of this chapter contain summaries of common volume and file system tasks.
Volume Tasks Introduction • “Splitting a Subdisk” • “Joining Subdisks” • “Removing a Subdisk” • “Viewing Volume Properties” The following file system tasks are discussed in this chapter: • “Adding a File System to a Volume” • “Mounting a File System on a Volume” • “Unmounting a File System on a Volume” • “Resizing a File System” • “Creating a Snapshot Copy of a File System” • “Checking a File System on a Volume” • “Viewing File System Properties” The following VERITAS QuickLog tasks are discussed in this ch
Volume Tasks Volume Task Roadmap Volume Task Roadmap The following table provides a summary of common Volume Manager Storage Administrator volume tasks. To do this... Use this procedure...
Volume Tasks Volume Task Roadmap To do this... Remove a DRL log from a volume Remove a RAID-5 log from a volume Remove a volume Chapter 4 Use this procedure...
Volume Tasks File System Task Roadmap File System Task Roadmap The following table provides a summary of common Volume Manager Storage Administrator file system tasks. Note that some of these tasks are only available for the VERITAS File System™ (referred to as VxFS or vxfs). To do this...
Volume Tasks Creating a Volume Creating a Volume The Volume Manager uses logical volumes to organize and manage disk space. A volume is made up of portions of one or more physical disks, so it does not have the physical limitations of a physical disk. A volume can provide greater capacity and better availability and performance than a single physical disk.
Volume Tasks Creating a Volume Note that RAID-5 volumes cannot be mirrored. • Mirrored Volume Volumes with concatenated or striped layouts can be mirrored to increase data availability. All of the data in a mirrored volume is duplicated on at least one other physical disk. If one of the disks fails, the data can still be accessed from one of the remaining disks. The plexes in a mirrored volume typically have the same layout, but a volume can consist of plexes with different layouts.
Volume Tasks Creating a Volume each volume layout. Table 4-1 Layout Concatenated Layout Comparison Advantages Disadvantages • The volume can consist of disk • There is a risk of data loss if the regions that are not adjacent. volume is not mirrored. • The volume can span multiple • Spanning a volume across disks. A spanned volume can multiple disks increases the have a greater capacity than a chance that a disk failure will single disk. result in the failure of the volume.
Volume Tasks Creating a Volume Table 4-1 Layout Mirrored Concatenated Pro Layout Comparison Advantages Disadvantages • Mirroring provides protection • A mirrored volume requires extra against disk failure and disk space. Each mirror requires reduces the risk of data loss. enough disk space to contain a complete copy of the volume. • Mirroring provides data redundancy by maintaining multiple complete copies of a volume’s data on different disks. • Mirroring provides improved read performance.
Volume Tasks Creating a Volume Table 4-1 Layout Comparison Layout Striped Pro Advantages Disadvantages • The volume is layered and • A striped pro volume requires at mirrored. This provides least four disks. improved data redundancy and • Layered volumes consist of more reduces the impact of disk Volume Manager objects than failures. non-layered volumes and are • Recovery time is quicker than likely to fill up the disk group’s with regular striped volumes configuration database sooner. that are mirrored.
Volume Tasks Creating a Volume Size: Layout: Options Type the volume size. The default size unit is sectors. To specify a size unit, attach an s (sectors), k (kilobytes), m (megabytes), or g (gigabytes) to the size. To determine the largest possible size for the volume, click Maxsize. Choose Concatenated or Concatenated Pro for the volume layout. • To mirror the volume, select Mirrored. In the Total Number of Mirrors field, type the total number of mirrors for the volume.
Volume Tasks Creating a Volume click OK. Notes: • This task requires a disk group name, volume name, volume size, and volume layout. • The volume size should be less than or equal to the available free space on the disk(s). • If no disks are assigned, the Volume Manager uses available space on disks in the selected disk group. • The data in a concatenated volume is not protected against disk failure unless the volume is mirrored. At least one additional disk is required to mirror a concatenated volume.
Volume Tasks Creating a Volume Size: Layout: Type the volume size. The default size unit is sectors. To specify a size unit, attach an s (sectors), k (kilobytes), m (megabytes), or g (gigabytes) to the size. To determine the largest possible size for the volume, click Maxsize. Choose Striped or Striped Pro for the volume layout. In the Number of Columns field, specify the number of columns (disks) across which the volume should be striped. A striped volume requires at least two disks.
Volume Tasks Creating a Volume click OK. Notes: • This task requires a disk group name, volume name, volume size, and volume layout. • A striped volume requires at least two disks. • The volume size should be less than or equal to the available free space on the disk(s). • If no disks are assigned, the Volume Manager uses available space on disks in the selected disk group. • The data in a striped volume is not protected against disk failure unless the volume is mirrored.
Volume Tasks Creating a Volume Size: Layout: Type the volume size in the Size field. The default size unit is sectors. To specify a size unit, attach an s (sectors), k (kilobytes), m (megabytes), or g (gigabytes) to the size. To determine the largest possible size for the volume, click Maxsize. Choose RAID-5 for the volume layout. In the Number of Columns field, specify the number of columns (disks) across which the volume should be striped.
Volume Tasks Creating a Volume click OK. Notes: • This task requires a disk group name, volume name, volume size, and volume layout. • A RAID-5 volume requires at least three disks. If logging is enabled, a RAID-5 volume requires at least four disks. • RAID-5 volumes cannot be mirrored. • The volume size should be less than or equal to the available free space on the disk(s). • For a RAID-5 volume, the size specified in the Size field is the usable space in the volume.
Volume Tasks Creating a Volume Size: Layout: Type the volume size in the Size field. The default size unit is sectors. To specify a size unit, attach an s (sectors), k (kilobytes), m (megabytes), or g (gigabytes) to the size. To determine the largest possible size for the volume, click Maxsize. Choose Concatenated, Striped, Concatenated Pro, or Striped Pro for the volume layout.
Volume Tasks Creating a Volume Options • To place the volume on a specific disk(s), click Assign Disks and select the disks you want to use from the Space Allocation dialog box. • To place a file system on the volume, click Add File System and specify the file system type and mount point in the Add File System dialog box. • To enable Dirty Region Logging (DRL) for the volume, select Enable Logging. The Volume Manager adds an appropriate number of logs to the volume.
Volume Tasks Resizing a Volume Resizing a Volume This procedure changes the size of a volume. If users require more space on a volume, you can use this procedure to increase the size of the volume. If a volume contains unused space that you need to use elsewhere, you can use this procedure to shrink the volume. If the volume contains a file system, this procedure also resizes the file system. To resize a volume Step 1. Select the volume to be resized. Step 2.
Volume Tasks Resizing a Volume click OK. Notes: • This task requires a volume name and either the desired size or the amount of space to add to or subtract from the volume size. • A volume containing file system other than vxfs cannot be shrunk. • Shrinking a volume with an unmounted file system can result in data loss, so a volume containing an unmounted file system cannot be shrunk. • When a volume is shrunk, the resulting extra space is returned to the free space pool.
Volume Tasks Renaming a Volume Renaming a Volume This procedure changes the name of a volume. If the volume has a file system, this procedure also makes the necessary changes to the file system table file and allows you to specify a new mount point for the file system. To rename a volume Step 1. Select the volume to be renamed. Step 2. Choose Volumes > Rename (Selected menu) or Volume Rename (Command Launcher). Step 3.
Volume Tasks Changing a Volume’s Layout Changing a Volume’s Layout This procedure changes the layout of a volume without interrupting access to data. You can use this task to change the redundancy or performance characteristics of an existing volume. You can view the progress of the relayout task through the Relayout Status Monitor window. You can also use the Relayout Status Monitor window to pause, abort, continue, or reverse the relayout task.
Volume Tasks Changing a Volume’s Layout Layout: Choose the new volume layout: • Concatenated Change the volume to a simple, concatenated volume. • Striped Change the volume to a striped volume. • RAID-5 Change the volume to a RAID-5 volume. • Concatenated Pro Change the volume to a layered concatenated volume. • Striped Pro Change the volume to a layered striped volume.
Volume Tasks Changing a Volume’s Layout Options Click Show Options to access the optional settings for this task. • To retain the original volume size when the volume layout changes, click Retain Volume Size at Completion. • To specify the size of the pieces of data that are copied to temporary space during the volume relayout, type the size in the Temp Space Size field.
Volume Tasks Changing a Volume’s Layout Notes: • This task requires a volume name and a different volume layout. • Volumes remain accessible during online relayout. • This task may take a long time, depending on the volume size and other factors. The Relayout Status Monitor shows the progress of the layout change and allows you to abort, pause, or reverse the task. • If no disk space is specified, the Volume Manager uses available space on disks in the current disk group.
Volume Tasks Adding a Mirror to a Volume Adding a Mirror to a Volume This procedure creates a mirror (copy) of a volume on a disk that is not already being used by the volume. If one of the disks fails, the volume’s data can be accessed from the surviving disk(s). A volume can have multiple mirrors. To add a mirror to an existing volume Step 1. Select the volume to be mirrored. Step 2. Choose Volumes > Mirror > Add (Selected menu) or Volume Add Mirror (Command Launcher). Step 3.
Volume Tasks Adding a Mirror to a Volume take some time. Notes: • This task requires a volume name. • Once mirrored, the data in the volume is redundant. If a disk fails, the data will remain available on the surviving mirror (on another disk). • The new mirror cannot be created on a disk that already contains a copy of the volume. Each mirror must reside on a separate disk. • Sufficient disk space must be available to accommodate the additional mirror(s).
Volume Tasks Adding a Log to a Volume Adding a Log to a Volume This procedure adds the appropriate type of log to a mirrored or RAID-5 volume. To add a DRL log to a mirrored volume This procedure adds a Dirty Region Logging (DRL) log to a mirrored volume. DRL uses this 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.
Volume Tasks Adding a Log to a Volume resynchronization time for RAID-5 volumes after a system failure. A RAID-5 log maintains a copy of the data and parity being written to the volume at any given time. If a system failure occurs, the Volume Manager can “replay” the RAID-5 log to resynchronize the volume. This 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.
Volume Tasks Stopping a Volume Stopping a Volume This procedure disables a volume. When a volume is stopped, it is not available for use until it is restarted (refer to “Starting a Volume”). Stopping a volume is a safe way of temporarily preventing access to a volume. To stop a volume Step 1. Select the volume to be stopped. Step 2. Choose Volumes > Stop (Selected menu) or Volume Stop (Command Launcher). Step 3.
Volume Tasks Starting a Volume Starting a Volume This procedure attempts to enable (start) a stopped volume. When a volume is successfully restarted, the volume is available for use again. This procedure also performs any appropriate resynchronization operations on the volume. Under normal circumstances, volumes are automatically started when the system reboots. You can use this procedure to restart a volume that you stopped manually or to attempt to restart a volume that was stopped in some other manner.
Volume Tasks Creating a Snapshot Copy of a Volume Creating a Snapshot Copy of a Volume This procedure prepares a volume for backup by creating a new volume that is a snapshot copy of an existing volume. This is done by attaching a new mirror to the existing volume, copying the volume’s data to the new mirror, detaching the new mirror, and then creating a new (snapshot) volume from the new mirror. The snapshot volume is an exact copy of the original volume.
Volume Tasks Creating a Snapshot Copy of a Volume some time. When the snapshot mirror is complete, the following message appears at the bottom of the dialog box: Click Snapshot to create the snapshot volume. Step 5. When the snapshot mirror is ready, click Snapshot to complete the snapshot. This creates a snapshot copy of the original volume. If you decide not to make a snapshot volume, you can remove the snapshot mirror after the snapstart phase. To remove the snapshot mirror, click Remove Snapshot Mirror.
Volume Tasks Merging a Snapshot Volume Merging a Snapshot Volume This procedure merges a snapshot copy of a volume with the original volume. The snapshot plex is detached from the snapshot volume and attached to the original volume. The snapshot volume is removed. This task resynchronizes the data in the volume so that the plexes are consistent. By default, the data in the original plex is used for the merged volume. To merge a snapshot volume with its original volume Step 1.
Volume Tasks Dissociating a Snapshot Volume Dissociating a Snapshot Volume This procedure permanently breaks the association between a snapshot and its original volume. The snapshot volume becomes an independent volume. To dissociate a snapshot volume from its original volume Step 1. Select the snapshot volume to be dissociated from its original volume. Step 2. Choose Volumes > Snapclear (Selected menu) or Volume Snapclear (Command Launcher). Step 3.
Volume Tasks Preparing to Restore a Volume From Backup Preparing to Restore a Volume From Backup This procedure stops the volume, sets the volume to an uninitialized state, and restarts the volume (without resynchronizing the volume’s mirrors). The volume can then be reloaded from backup. This procedure is intended for raw image backups and is not appropriate for file system backups. This procedure is useful for disaster recovery.
Volume Tasks Recovering a Volume Recovering a Volume This procedure performs any necessary volume recovery operations on a volume. The 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 should be available for use again. Alert icons and the Alert Monitor window may provide clues to let you know that volume recovery is needed.
Volume Tasks Repairing a Mirror Repairing a Mirror This procedure repairs a disabled mirror by reattaching the mirror to its volume. This involves copying data from an active mirror on the volume to the mirror being attached. Once attached, the mirror is accessible for reads and writes again. Alert icons and the Alert Monitor window may provide clues to let you know that a mirror needs to be repaired. To repair a mirror Step 1. Select the volume that contains the mirror to be repaired. Step 2.
Volume Tasks Disabling a Mirror Disabling a Mirror NOTE Disabling a mirror can result in loss of data redundancy. This procedure disables a mirror by temporarily detaching the mirror from its volume. 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 (see “Repairing a Mirror”) or restart the volume. To disable a mirror in a volume Step 1.
Volume Tasks Removing a Mirror From a Volume Removing a Mirror From a Volume NOTE Removing a mirror can result in loss of data redundancy. This procedure removes a mirror from its volume. This breaks the link between the mirror and its volume and returns the mirror’s disk space to the free space pool for reuse. You can remove an extra mirror from a volume to make the underlying disk space available for use elsewhere. However, this may leave the volume unmirrored and unprotected against disk failure.
Volume Tasks Removing a Mirror From a Volume When you have provided all necessary information in the dialog box, click OK. Notes: • This task requires a volume name. This task also requires the number of mirrors to remove, a disk name, or a mirror name. • If a volume only has two mirrors and one mirror is removed, the volume is no longer redundant. • The last mirror (plex) cannot be removed from a volume. • When a mirror is removed, the space occupied by that mirror is returned to the free space pool.
Volume Tasks Removing a Log From a Volume Removing a Log From a Volume This procedure removes a log from a mirrored or RAID-5 volume. For a mirrored volume, this removes a DRL log from the volume. For a RAID-5 volume, this removes a RAID-5 log from the volume. To remove a log from a volume Step 1. Select the volume that contains the RAID-5 or DRL log to be removed. Step 2. Choose Volumes > Log > Remove (Selected menu) or Log Remove (Command Launcher). Step 3.
Volume Tasks Removing a Volume Removing a Volume CAUTION Removing a volume can result in data loss. This procedure permanently removes a volume and all of its data. You should only remove a volume if you are sure that you do not need the data in the volume (or the data is backed up elsewhere). You can remove a volume to make the underlying disk space available for use elsewhere. To remove a volume Step 1. Select the volume to be removed. Step 2.
Volume Tasks Associating a Plex Associating a Plex This procedure associates (attaches) a plex to a volume. This involves copying data from an active mirror on the volume to the new plex (mirror). To associate a plex Step 1. Choose Plex Associate (Command Launcher). Step 2. Complete the Associate Plex dialog box as follows: Plex Name: Type the plex name or click Browse to select the plex. Volume Name: Type the name of the volume to be associated with the plex or click Browse to select a volume.
Volume Tasks Dissociating a Plex Dissociating a Plex This procedure dissociates a plex from its volume. This disconnects the plex from its volume and reduces the volume’s data redundancy. To dissociate a plex Step 1. Choose Plex Dissociate (Command Launcher). Step 2. Complete the Dissociate Plex dialog box as follows: Plex Name: Type the plex name or click Browse to select the plex. When you have provided all necessary information in the dialog box, click OK. Notes: • This task requires a plex name.
Volume Tasks Moving a Subdisk Moving a Subdisk This procedure moves the contents of a volume’s subdisk from one disk to another. This is useful for moving portions of a volume to a different disk for improved performance. You can use the Object View window (Disk Groups > Object View) or the Volume to Disk Mapping window (Disk Groups > Disk/Volume Map) to view the subdisks and gaps on disks in a disk group.
Volume Tasks Moving a Subdisk click OK. Notes: • This task requires a subdisk name and a disk name. • Subdisks are typically moved to reorganize disk space. • The disk space occupied by the original subdisk is returned to the free space pool. • A subdisk in a mirrored, striped, or RAID-5 volume should not be moved to a disk that already contains a copy or part of that volume.
Volume Tasks Splitting a Subdisk Splitting a Subdisk This procedure divides a subdisk into two or more smaller subdisks. Once split, the smaller subdisks can be moved elsewhere or rejoined later. This is useful for reorganizing volumes and/or improving performance. You can use the Object View window (Disk Groups > Object View) or the Volume to Disk Mapping window (Disk Groups > Disk/Volume Map) to view the subdisks in a disk group.
Volume Tasks Splitting a Subdisk click OK. Notes: • This task requires a subdisk name and the number of subdisks that will result from the split. • The name of the first subdisk remains the same as the selected subdisk. Other subdisks are automatically named by the Volume Manager. • The new, smaller subdisks occupy the same regions of the disk that the original subdisk occupied. • The original subdisk must contain a sufficient number of sectors for the specified split to work.
Volume Tasks Joining Subdisks Joining Subdisks This procedure joins two or more subdisks together to form a single, larger subdisk. Subdisks can only be joined together if they belong to the same volume and occupy adjacent regions of the same disk and mirror. You can use the Object View window (Disk Groups > Object View) or the Volume to Disk Mapping window (Disk Groups > Disk/Volume Map) to view the subdisks in a disk group.
Volume Tasks Removing a Subdisk Removing a Subdisk This procedure removes a subdisk from a disk. This task applies to subdisks that are not associated with volumes. This provides a way to return the disk space occupied by unused subdisks to the free space pool. You can use the Disk Properties window (Disks > Properties) to view subdisks that are not associated with volumes. To remove a subdisk Step 1. Select the disk with the subdisk to be removed. Step 2. Choose Disks > Properties (Selected menu).
Volume Tasks Viewing Volume Properties Viewing Volume Properties The Volume Properties window contains detailed information about the selected volume. The Properties window contains a set of tabbed pages, each of which contains information about the volume and related objects. You can display a different page by clicking on the appropriate tab label. • To view the properties of a volume, select the volume and then choose Properties from the Volumes or popup menu.
Volume Tasks Adding a File System to a Volume Adding a File System to a Volume This procedure places a file system on an existing volume and mounts the file system. This also updates the file system table file, if necessary. To add a file system to an existing volume Step 1. Select the volume to contain the file system. Step 2. Choose Volumes > File System > New (Selected menu) or Volume Add File System (Command Launcher). Step 3.
Volume Tasks Adding a File System to a Volume click OK. Notes: • This task requires a volume name and a file system type. If Mount at Boot is selected, a file system mount point is also required. • When the file system is mounted, the file system table file is automatically updated. • If the path specified for the mount point does not already exist, it is created. • The mount point must be an absolute pathname (that is, it must begin with /).
Volume Tasks Mounting a File System on a Volume Mounting a File System on a Volume This procedure mounts a file system that already exists on a volume and updates the file system table file, if necessary. To mount a file system on an existing volume Step 1. Select the volume that contains the file system to be mounted. Step 2. Choose Volumes > File System > Mount (Selected menu) or Volume Mount (Command Launcher). Step 3.
Volume Tasks Unmounting a File System on a Volume Unmounting a File System on a Volume This procedure unmounts a file system. To unmount a file system on a volume Step 1. Select the volume containing the file system to be unmounted. Step 2. Choose Volumes > File System > Unmount (Selected menu) or Volume Unmount (Command Launcher). Step 3.
Volume Tasks Resizing a File System Resizing a File System This procedure changes the size of a file system and the underlying volume. If users require more space, you can use this procedure to increase the size of the file system. If a vxfs file system is too large and you need the space elsewhere, you can use this procedure to shrink the file system. To resize a file system on a volume Step 1. Select the file system to be resized. Step 2.
Volume Tasks Resizing a File System When you have provided all necessary information in the dialog box, click OK. Notes: • This task requires a file system name and either the desired size or the amount of space to add to or subtract from the file system size. • When the file system is resized, the underlying volume is also resized. • Only vxfs file systems can be shrunk. • The file system to be resized must be on a volume.
Volume Tasks Creating a Snapshot Copy of a File System Creating a Snapshot Copy of a File System This procedure prepares a vxfs file system for online backup by creating a snapshot copy of the file system. This is done by creating a new volume, mounting a snapshot file system on the new volume, and copying the contents of the original file system to the snapshot file system. The snapshot file system is a consistent copy of the original file system at the time the snapshot was made.
Volume Tasks Creating a Snapshot Copy of a File System click OK. Notes: • This task requires a file system name, a snapshot mount point, and a snapshot size. • The file system snapshot task is only available for vxfs file systems. • The snapshot file system is an exact copy of the original file system at the time the snapshot was created. • After you create the snapshot copy of the file system, remember to back it up to tape or some other media. Remove the snapshot file system when it is no longer needed.
Volume Tasks Checking a File System on a Volume Checking a File System on a Volume This procedure checks an unmounted file system on a volume for consistency (using the fsck command). This procedure can also attempt to repair the file system, if necessary. To check a file system on a volume Step 1. Select the volume containing the file system to be checked. Step 2. Choose Volumes > File System > Check (Selected menu) or File System Check (Command Launcher). Step 3.
Volume Tasks Viewing File System Properties Viewing File System Properties The File System Properties window contains detailed information about the selected file system. The Properties window contains a set of tabbed pages, each of which contains information about the file system and related objects. You can display a different page by clicking on the appropriate tab label. • To view the properties of a file system, select the file system and then choose Properties from the File Systems or popup menu.
Volume Tasks Creating a QuickLog Log on a Volume Creating a QuickLog Log on a Volume This procedure designates a volume as a vxfs file system QuickLog log. After setting up a volume as a QuickLog log, you can enable the QuickLog log device for a file system. To designate a volume as a QuickLog log Step 1. Select the volume to be used for the file system QuickLog log. Step 2. Choose Volumes > QuickLog > Make Log (Selected menu) or Volume Make FS Log (Command Launcher). Step 3.
Volume Tasks Enabling the QuickLog Log for a File System Enabling the QuickLog Log for a File System This procedure enables the QuickLog log device for a vxfs file system and remounts the file system. Before you enable a QuickLog log, you need to designate a volume as a QuickLog log (see “Creating a QuickLog Log on a Volume”). To enable a QuickLog log for a file system Step 1. Select the file system to be remounted with a QuickLog log device enabled. Step 2.
Volume Tasks Disabling the QuickLog Log for a File System Disabling the QuickLog Log for a File System This procedure disables QuickLog logging for a file system and remounts the file system. To disable a QuickLog log for a file system Step 1. Select the file system with the QuickLog log device to be disabled. Step 2. Choose File System > QuickLog > Disable (Selected menu) or File System Disable QuickLog (Command Launcher). Step 3.
Volume Tasks Removing a QuickLog Log Removing a QuickLog Log This procedure detaches a QuickLog log device from a volume. Before you remove a QuickLog log, you must disable the log (see “Disabling the QuickLog Log for a File System”). To remove a QuickLog log from a volume Step 1. Select the volume with the QuickLog log device to be detached. Step 2. Choose Volumes > QuickLog > Remove Log (Selected menu) or Volume Remove FS Log (Command Launcher). Step 3.
Volume Tasks Removing a QuickLog Log 210 Chapter 4
Host and Cluster Tasks 5 Host and Cluster Tasks Chapter 5 211
Host and Cluster Tasks Introduction Introduction This chapter describes how to access and use host machines and clusters with the Volume Manager Storage Administrator. The Host and Cluster Task Roadmap at the beginning of this chapter contains a summary of common host and cluster tasks. The Storage Administrator can access and display multiple host machines simultaneously.
Host and Cluster Tasks Host and Cluster Task Roadmap Host and Cluster Task Roadmap The following table provides a summary of common Volume Manager Storage Administrator host and cluster tasks. To do this... Use this procedure...
Host and Cluster Tasks Connecting to a Host Connecting to a Host This procedure establishes a connection to a host machine from the current Storage Administrator session. A Storage Administrator client session can provide simultaneous access to multiple host machines. To connect to a host Step 1. Choose File > Connect (menu) or Host Connect (Command Launcher). Step 2.
Host and Cluster Tasks Disconnecting a Host Disconnecting a Host This procedure disconnects a host machine from the current Storage Administrator session. When a host machine is disconnected, the Storage Administrator cannot administer that machine. To restore access to a disconnected host machine, you must reconnect to the host. To disconnect a host Step 1. Select the host machine to be disconnected from the Storage Administrator session. Step 2.
Host and Cluster Tasks Setting Up Automatic Host Connections Setting Up Automatic Host Connections This procedure causes the Storage Administrator to automatically connect to specified hosts at startup. You can specify which hosts should connect to the Storage Administrator client at startup and how to display those hosts in the main window’s object tree. To set up automatic host connections Step 1. Choose Options > Customize from the main window menu bar. Step 2.
Host and Cluster Tasks Working with Clusters Working with Clusters The VERITAS Volume Manager includes an optional cluster feature that enables the Volume Manager to be used in a cluster environment. To activate the cluster feature, you must obtain a license for the Volume Manager cluster functionality. After adding a Volume Manager cluster license to the machine, you must restart the Storage Administrator server to enable cluster support in the Storage Administrator.
Host and Cluster Tasks Working with Clusters the cluster hierarchy. The grid displays the names and properties of the nodes in the cluster. The Type column indicates which node is the master. The Cluster Properties window also indicates which node is the master. To access this window, select a cluster and choose Properties from the Selected or popup window.
Host and Cluster Tasks Starting a Cluster Starting a Cluster This procedure starts a cluster. If the cluster is not already started, you must use this task to start the cluster before you can access the shared objects in the cluster. This procedure automatically starts all nodes in the cluster. To start a cluster Step 1. Select the Clusters icon at the top of the cluster portion of the object tree. Step 2. Choose All Clusters > Start Cluster (Selected menu) or Cluster Start (Command Launcher). Step 3.
Host and Cluster Tasks Stopping a Cluster Stopping a Cluster This procedure stops a cluster and makes the shared objects in the cluster inaccessible from the current Storage Administrator session. To stop a cluster Step 1. Select the cluster to be stopped. Step 2. Choose Clusters > Stop Cluster (Selected menu) or Cluster Stop (Command Launcher). Step 3. Complete the Stop Cluster dialog box as follows (if applicable): Cluster: Type the name of the cluster or click Browse to select a cluster.
Host and Cluster Tasks Starting a Node Starting a Node This procedure activates a node (host) in a cluster. This causes the node to join the cluster. A node must be started before it can access shared objects in the cluster. If a node has been stopped for some reason, you can use this task to restart the node. To start node in a cluster Step 1. Select the node (host) to be started. Step 2. Choose Cluster Nodes > Start Node (Selected menu) or Cluster Start Node (Command Launcher). Step 3.
Host and Cluster Tasks Stopping a Node Stopping a Node This procedure stops a node (host) in a cluster and makes that node inaccessible to the cluster. A stopped node cannot access shared objects in the cluster. If the stopped node is the master node, another node in the cluster automatically becomes the new master. To stop a node in a cluster Step 1. Select the node (host) to be stopped. Step 2. Choose Cluster Nodes > Stop Node (Selected Menu) or Cluster Stop Node (Command Launcher). Step 3.
Host and Cluster Tasks Creating a Shared Disk Group Creating a Shared Disk Group This procedure creates a shared disk group for use in a cluster environment. Disks must be placed in disk groups before they can be used by the Volume Manager. The default disk group (rootdg) is usually created during Volume Manager installation and always exists on a system running the Volume Manager. You can create additional disk groups to organize your disks into logical sets of disks.
Host and Cluster Tasks Creating a Shared Disk Group Options Click Show Options to access the optional settings for this task. • To specify the Volume Manager disk name for the disk, type a disk name in the Disk Name(s) field. If no Volume Manager disk name is specified, the Volume Manager assigns a default name to the disk. • To apply a comment or attribute to disks that are placed in the disk group, type the information in the Comment field.
Host and Cluster Tasks Importing a Shared Disk Group Importing a Shared Disk Group This procedure makes a deported (inaccessible) disk group and its volumes accessible in a cluster environment. To import a deported disk group as shared, you must know the disk group’s former name and this disk group name must remain unused. In addition, at least one disk formerly assigned to the deported disk group must remain unused. To import a disk group Step 1. Select the host machine that is the master node. Step 2.
Host and Cluster Tasks Importing a Shared Disk Group Options Click Show Options to access the optional settings for this task. • 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(s) in the disk group. • To force the disk group import when the host cannot access all disks in the disk group, select Force Import.
Host and Cluster Tasks Activating a Shared Disk Group Activating a Shared Disk Group This procedure sets the activation mode for a shared disk group in a cluster environment. The disk group activation mode controls read and write access to volumes in the specified disk group. For shared disk groups, the activation modes are applied on a per-node basis. The disk group activation mode applies to the node (host) where you accessed this task. To activate a disk group Step 1.
Host and Cluster Tasks Activating a Shared Disk Group • To give the current node read access for volumes in the shared disk group, select Shared Read. The current node cannot have write access to the disk group, but other nodes in the cluster may have write access. When you have provided all necessary information in the dialog box, click OK. Step 4. To set the disk group activation mode on other nodes in the cluster, access this task from the appropriate host machines and repeat this procedure.
Host and Cluster Tasks Upgrading a Cluster Upgrading a Cluster This procedure upgrades a cluster and its nodes while the cluster remains accessible. This is accomplished by upgrading one node in the cluster at a time so that at least one node remains online at all times. When all of the nodes in the cluster are upgraded, the cluster protocol version is upgraded to support the new version of the software. To upgrade a cluster Step 1.
Host and Cluster Tasks Upgrading a Cluster click OK. Notes: • This task is only applicable in a cluster environment. • This task upgrades the cluster to a new protocol version while the cluster remains accessible. • All nodes in the cluster must be upgraded to the new version of the software before the cluster is upgraded. To avoid shutting down the cluster, you must stop, upgrade, and restart one node in the cluster at a time. • Once the cluster is upgraded, it cannot be downgraded to the previous version.
Troubleshooting 6 Troubleshooting Chapter 6 231
Troubleshooting Introduction Introduction This chapter provides information about Storage Administrator alerts, object states, and other troubleshooting topics. This chapter also contains suggestions on how to fix some common problems. If you are unable to resolve a problem by following the instructions in this chapter, contact Customer Support for additional information.
Troubleshooting Alerts Alerts When an object fails or experiences an error, an alert icon appears on the object and the object’s state usually changes to an unhealthy state. The unhealthy object also appears in the Alert Monitor window, which summarizes the problem and indicates whether any associated objects have problems. When an object enters an unhealthy state and has an alert, you should review the contents of the Alert Monitor window and then try to correct the problem.
Troubleshooting Disk Troubleshooting Disk Troubleshooting The disk state indicates the current condition of a disk. The disk state appears in the state column of the grid and in the Disk Properties window. When a disk is unhealthy, an alert icon appears on the disk and the disk is listed in the Alert Monitor window.
Troubleshooting Disk Troubleshooting Disk State: Not Setup The disk is not under Volume Manager control. • To make the disk available for Volume Manager use, place the disk under Volume Manager control and add the disk to a disk group. Disk State: Import Failed The disk was previously under Volume Manager control, but the Volume Manager cannot access the disk and/or configuration information for the disk. The disk is not available for use. This may happen after you upgrade the Volume Manager.
Troubleshooting Disk Troubleshooting Disk State: Deported The disk belongs to a disk group that is currently deported. The disk is not available for use in the deported disk group and cannot be added to a new disk group. • To return the disk to a usable state, import the disk’s disk group. • To move the disk to another disk group, import the current disk group, remove the disk, and add the disk to a new disk group.
Troubleshooting Disk Troubleshooting on the disk. Any volume copies or regions located on the disk will not be accessible after you reinitialize the disk. Disk State: Locked The disk belongs to a disk group that is currently imported by another machine or was last imported by another machine and was not deported cleanly. The disk is not currently usable on the local machine.
Troubleshooting Disk Troubleshooting hardware. • It may be necessary to reattach the disk to its disk group with the Replace Disk task or the following command: /etc/vx/bin/vxreattach [device_name] After a successful reattach, volume recovery may be necessary.
Troubleshooting Volume Troubleshooting Volume Troubleshooting The volume state indicates the current condition of a volume. The volume state appears in the state column of the grid and in the Volume Properties window. When a volume is unhealthy, an alert icon appears on the volume and the volume is listed in the Alert Monitor window.
Troubleshooting Volume Troubleshooting may be disconnected. • Make sure that the physical disks are turned on, plugged in, and attached to the computer. Repair any disk, controller, or cable problems. Scan the disks on the system (Hosts > Scan Disks) to make sure that the Volume Manager recognizes any newly attached hardware. To return the RAID-5 volume to a healthy state, recover the volume.
Troubleshooting General Troubleshooting General Troubleshooting This section contains suggestions on how to correct some general problems that may occur when you try to use the Storage Administrator. Client/Server Problems This section describes some Storage Administrator client and server problems and provides suggestions on how to correct these problems. For more information about the client and server, refer to the vmsa(1M) and vmsa_server(1M) manual pages.
Troubleshooting General Troubleshooting • Make sure the server is running (vmsa_server -q) and the client and server are properly configured. If necessary, restart the Storage Administrator server. Possible client/server versions mismatch. The Storage Administrator client and server versions may be incompatible. • Check the client and server versions: vmsa -V vmsa_server -V If necessary, upgrade the client or server. Server connection lost. The Storage Administrator server has been stopped.
Glossary alert An indication that an error or failure has occurred on an object on the system. When an object fails or experiences an error, an alert icon appears. alert icon An icon that indicates that an error or failure has occurred on an object on the system. Alert icons usually appear in the status area of the main window and on the affected object’s group icon. Alert Monitor A window that provides information about objects that have failed or experienced errors.
disk group A set of disks that are under Volume Manager control and share a common configuration. A disk group configuration is a set of records containing detailed information on existing Volume Manager objects (such as disk and volume attributes) and their relationships. Each disk group has an administrator-assigned name. The root disk group (rootdg) is a special private disk group that always exists. Volumes can only be created on disks that belong to disk groups.
menu bar A bar that contains a set of menus for the current window. The menu bar is typically placed across the top of a window. mirror A copy of a volume and its data. There can be several mirrors per volume. The terms mirror and plex are used synonymously. node In the Storage Administrator tree, a node is an element attached to the tree. In a cluster environment, a node is a host machine in a cluster. object group A group of objects of the same type. Each object group has a group icon and a group name.
Selected menu A context-sensitive menu that changes its menu options to match the type of object that is selected. By default, the Selected menu is greyed out. When an object is selected, the Selected menu provides access to tasks appropriate for the selected object. splitter A bar that separates two panes of a window (such as the object tree and the grid). A splitter can be used to adjust the sizes of the panes.
Index A accessing tasks, 71 activating disk groups, 142 activating shared disk groups, 227 adding disks, 104 adding file systems, 196 alert monitor, 94 alerts, 30, 94, 232 detecting, 94 icons, 95 monitoring, 94 247
on disks, 234 on volumes, 239 Alerts button, 29 associating plexes, 187 B backup file system, 202 boot disk mirroring, 114 browse dialog boxes, 75 buttons in dialog boxes, 75 toolbar, 28 C changing volume layouts, 165 checking file systems, 204 client, 46 cluster nodes starting, 221 stopping, 222 clusters, 27, 38 activating shared disk groups, 227 creating shared disk groups, 223 importing disk groups, 225 starting, 219 starting a node, 221 stopping, 220 stopping a node, 222 upgrading, 229 color preference
D deporting disk groups, 133 destroying disk groups, 140 dialog boxes, 75 browse, 75 buttons, 75 input size units, 77 selecting objects, 75 dirty region logging, 171 disabling controllers, 126 disabling mirrors, 182 disconnecting disks, 116 disconnecting hosts, 215 disk arrays renaming, 128 disk group name changing, 132 disk group tasks, 100 roadmap, 102 disk group versions, 131 disk groups activating, 142, 227 adding disks, 104, 105 clearing hot-relocation information, 139 creating, 129, 223 deporting, 133
disconnecting, 116 evacuating, 115, 213 forced initialization, 124 free disk pool, 27 hot-relocation spares, 109 initializing, 124 maintenance tasks, 39 mirroring, 114 moving contents, 115, 213 new, 104 offline, 112 online, 113 placing under Volume Manager control, 104 preventing access, 112 properties, 69, 125 recovering, 121 reinitializing, 124 removing, 122 renaming, 111 replacing, 117 reserving, 110 restoring access, 113 scanning, 108 task roadmap, 102 troubleshooting, 124, 234 uninitialized, 27 unreloc
file system tasks, 144 roadmap, 148 file systems and volumes, 196, 198 backup, 202 checking, 204 creating, 196 maintenance tasks, 40 repair tasks, 41 repairing, 204 resizing, 200 setup tasks, 38 snapshot copies, 202 task roadmap, 148 unmounting, 199 FMR, 175 fonts preference settings, 86 free disk pool, 27 free space, 67, 91, 125 G graphical view, 57, 60, 65 preference settings, 89 grid, 27, 57 preference settings, 88 Grid button, 29 H help, 28 Help menu, 28 Host button, 29 host machines, 27, 38 connecting,
errors, 95 importing disk groups, 135 importing shared disk groups, 225 initializing disks, 124 input size units, 77 installation, 38 J joining subdisks, 193 L layered volumes, 150 logging, 171 disabling, 185 logs adding to volumes, 171 command log, 80 disabling, 185 DRL, 171 QuickLog, 206, 207 RAID-5, 171 removing, 185 task log, 80 M main window, 25 preference settings, 86 main window status area, 30 maintenance tasks, 39 menu bar, 28 accessing tasks, 71 menus, 28, 71 context-sensitive, 28, 72 File, 28, 71
removing, 183 repairing, 181 mixed layout volumes, 150 monitoring performance, 67 monitoring alerts, 30, 94 monitoring tasks, 78 mounting file systems, 198 moving disk groups, 141 moving subdisks, 62, 189 multiple host support, 24 N New button, 29 O object properties displaying, 69, 125, 195, 205 in grid, 57 object properties window, 57, 69 object states, 232 object tree, 26 object view window, 57, 60 preference settings, 87, 89 objects displaying, 57 searching, 91 selecting, 56, 75 sorting, 59 viewing, 57
Options menu, 28 setting, 28, 82 toolbar, 89 tree and grid, 88 volume layout details window, 89 window size, 88 preferences window, 82 Print button, 29 printing, 29, 97 projection, 62 projection window, 62 properties, 69, 125, 195, 205 disk, 125 in grid, 57 volumes, 195, 205 Properties button, 29 properties window, 57, 69, 125, 195, 205 Q QuickLog logs, 206, 207 R RAID-5 logging, 171 RAID-5 volumes, 149, 157 read-only mode, 24 recovering disks, 121 recovering volumes, 121, 138, 180 recovery, 40 disk, 121 vo
running tasks, 71 S scanning disks, 108 Search button, 29 search window, 91 searching, 91 security, 24, 46 Selected menu, 28, 71 selecting objects, 56, 75 server, 46 setup tasks, 38 shared disk groups, 223, 225 size units input, 77 snapshot copies of file systems, 202 snapshot copies of volumes, 175 snapshots, 175, 202 dissociating, 178 merging, 177 sorting objects, 59 spare disks, 109 splitter, 27 splitting subdisks, 191 starting cluster nodes, 221 starting clusters, 219 starting the Storage Administrator,
T Task button, 29 task history, 78 task launcher, 30 task log, 80 task monitor, 78 task request monitor, 78 tasks accessing, 71 Command Launcher, 30 disk, 100 disk group, 100 disk maintenance, 39 disk setup, 38 displaying, 78 file system, 144 file system maintenance, 40 from Command Launcher, 72 from menus, 71, 72 list, 38 maintenance, 39 mirror, 144 monitoring, 78 properties, 79 recovery, 40 repair, 40 roadmap, 38 running, 71 setup, 38 subdisk, 144 underlying commands, 79 viewing, 78 volume, 144 volume mai
tree, 26, 57 preference settings, 88 troubleshooting, 232 disk states, 234 volume states, 239 U uninitialized disks, 27 unmounting file systems, 199 unrelocating disks, 119 upgrading clusters, 229 user preferences, 82 V viewing commands, 78 viewing objects, 57 graphical view, 65 properties, 69, 125, 195, 205 tree/grid, 57 vmsa, 46 vmsa_server, 46 volume layout details window, 57, 65 preference settings, 89 volume layouts, 149, 165 Volume Manager Storage Administrator, 23 volume name changing, 164 volume siz
graphical view, 57, 65 joining subdisks, 193 layered, 150 layout, 57 maintenance tasks, 39 merging snapshots, 177 mirrored, 150, 159 mixed layout, 150 mounting file systems, 198 moving subdisks, 189 preparing to restore, 179 properties, 69, 195, 205 RAID-5, 149, 157 reattaching mirrors, 181 recovering, 121, 138, 180 recovery tasks, 40 relayout, 165 removing, 186 removing logs, 185 removing mirrors, 183 renaming, 164 repair tasks, 40 repairing mirrors, 181 resizing, 162 setup tasks, 38 snapshot copies, 175 s
volume to disk mapping window, 57, 67 259
