VERITAS Enterprise Administrator (VEA 500 Series) Getting Started HP-UX 11i v2 Manufacturing Part Number: 5991-1844 September 2005 Edition 1 Printed in the United States © Copyright 2005 - 2006 Hewlett-Packard Development Company L.P.
Legal Notices Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation and Technical Data for Commercial Items are licensed to the U.S. Government under vendor’s standard commercial license. The information contained herein is subject to change without notice.
Contents Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 How This Guide Is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Viewing Objects and Object Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Selecting Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Navigational View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Details View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Viewing Different Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Using the Control Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 Viewing the Event Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 Previous and Next Alert Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 3. Accessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Keyboard Shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Accelerators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Mnemonics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Preface This guide gives basic information about on using the VERITAS Enterprise Administrator (VEA) Series 500 product to configure and run storage applications such as VERITAS Volume Manager. How This Guide Is Organized This guide is organized as follows: ◆ Chapter 1, “Introducing the VEA Console” on page 1, provides an introduction to VEA components. ◆ Chapter 2, “Using the VEA” on page 9, explains how to use VEA.
Conventions Conventions The following table describes the typographic conventions used in this guide. Typeface Usage Examples Courier Computer output, file contents, files, directories, software elements such as command options, function names, and parameters Read tunables from the /etc/vx/tunefstab file. New terms, book titles, emphasis, variables to be replaced by a name or value See the User’s Guide for details. Courier bold User input; the “#” symbol indicates a command prompt.
Technical Support Technical Support For license information (U.S. and Canadian Customers) contact: ◆ Phone: 650-960-5111 ◆ Email: hplicense@mayfield.hp.com For license information (Europe) contact: ◆ Phone: +33.(0)4.76.14.15.29 ◆ Email: codeword_europe@hp-france-gen1.om.hp.com For latest information on available patches visit: ◆ http://itrc.hp.com For technical support visit: ◆ http://welcome.hp.com/country/us/en/support.
HP Encourages Your Comments 10 VERITAS Enterprise Administrator (VEA 500 Series) Getting Started
1 Introducing the VEA Console The VERITAS Enterprise Administrator (VEA) Console displays data about application objects and connectivity in graphical form and provides a user interface for the many tools and functions. Before using the VERITAS Volume Manager VEA GUI, you should familiarize yourself with the following introductory topics: ◆ VEA Features ◆ Main Window VEA Features You use the VEA to administer disks, volumes, and file systems on local or remote machines.
Main Window ◆ Scalability ◆ VEA can handle systems containing large numbers of disks. Administrators can view all of the objects on the system, or focus on a specific object or set of objects. ◆ Security Please refer to the VEA online help for information on communication between the client and server across a firewall. ◆ Multiple VEA Support The VEA client can provide simultaneous access to multiple host machines.
Main Window Main Window and Tabular View The toolbar can be separated from and reattached to the main window (this is known as docking). The grid can be replicated in a separate window.
Main Window ◆ Groups ◆ Hosts – Any host machines connected to the current VEA client session. ◆ Hubs ◆ Storage, including enclosures and unenclosed storage ◆ Unidentified Adapters Grid The right pane contains a grid, which is a tabular display of objects and their properties. The grid displays objects that belong to the group icon that is currently selected in the object tree (left pane). The splitter is the vertical bar that separates the object tree from the grid.
Multiple Selections Then select the view to be displayed in a new window from the drop-down menu. ◆ Help The Help menu provides access to online help for VEA. Toolbar The toolbar provides quick access for performing some of the program’s most common tasks. The toolbar handle is the thin bar next to the toolbar. You can use the toolbar handle to separate the toolbar from the main window or move the toolbar to the bottom, side, or top of the main window.
Viewing Task History Viewing Task History VEA logs all task requests. You can view the task history (including tasks in progress) using the Task History window, or the Command Log file. The Task History window displays a history of tasks performed in the current session (and any other sessions running on the machine). Each task is listed with properties such as task name, task status, and start time. To display the Task History window, click on Tasks at the bottom of the main window.
Command Log Select the popup menu option Throttle Task to change the task priority. You can change the priority for a single task, or select Throttle All Tasks to apply the priority to all Volume Manager Tasks. Click Ok to complete your selection. Clearing Finished Tasks Tasks are persistent in the Tasks console. To remove completed tasks from the window, select Clear All Finished Tasks from the popup menu.
Command Log 8 VERITAS Enterprise Administrator (VEA 500 Series) Getting Started
2 Using the VEA The VERITAS Enterprise Administrator (VEA) enables you to access all hosts on your network. It also provides task and setup functions that allow you to tailor your VEA environment prior to performing storage management procedures on those hosts.
Starting VEA Before you can use VEA, you need to: 1. Install VxVM on the machine to be administered. 2. Install the VEA server and client on the machine to be administered. 3. If users other than root need to access VEA, set up security to specify which users can run VEA. 4. If you plan to run the VEA client from a machine other than the machine to be administered, install the VEA client on the machine where the client will run. 5. Start the VEA server on the machine to be administered. 6.
Starting VEA 1. Go to the directory where the VEA client is installed; for example, Object Bus\bin. 2. Start the VEA client by running the batch file vea.bat from this location. When starting the VEA client from the command line, the following options are available -v : Shows the version of client console. -c : Specifies the configuration file for advanced settings. -host : Specifies the host to connect to.
Viewing Objects and Object Properties You can also select Tools > Manage Profiles to bring up the Manage Profiles dialog (refer to Managing User Profiles). If No Profiles Exist If no profiles exist when you start VEA, the following message appears: No profiles exist on this system. A new default profile has been created. If you want to create additional profiles, you may create using the “Tools” -> “Manage Profiles...” menu item Click OK to continue.
Viewing Objects and Object Properties The following functions are provided for simplifying viewing objects in the tree and Tabular View: ◆ To expand or collapse the hierarchy under a particular object group 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 listed in the object tree: Click on the object group. All objects that belong to the selected object group appear in Tabular View.
Viewing Objects and Object Properties Navigational View Navigational view supports object browsing and operations on those objects in a tree structure. The following nodes typically appear in this view: ◆ System nodes: representing the connected and disconnected computer systems, these are distinguished by icons. ◆ Network nodes: listing the systems that are currently running on the given domain. ◆ History nodes: listing the most recently connected servers.
Viewing Objects and Object Properties Details View Chapter 2, Using the VEA 15
Viewing Objects and Object Properties Status View The Status View occupies the bottom part of the VEA client window. It has a Console View and a Task View. Console View The Console View displays the active events and alerts for the connected hosts. Click on Console to display the events that have been received by the client during the user session. The events for all hosts over the lifetime of the session is displayed. Note Events on the server side are recorded on the server.
Performing Tasks A property set is a collection of properties. It can contain an array of properties or even another property set as its element. A property set with one or more property sets contained within it is called a recursive property set. VEA uses Tabular View to display the properties of an object. Each object is represented by a row in the table and the properties are the column cells in it.
Performing Tasks To perform a task on an object with the Actions menu, select the object and choose the appropriate task from the Actions menu. If this launches a dialog box or wizard, complete the dialog box (or wizard). Running Tasks From a Popup Menu Once you have connected to a host, you can use a context-sensitive popup menu to launch a task on the selected object, as shown in “Context-Sensitive Popup Menu.” A popup menu provides access to tasks or options appropriate for the selected object.
Setting Layout Preferences Setting Layout Preferences To set layout preferences, select Tools > Preferences then select the Appearance tab. The Preferences Appearance Window appears. When you have made your changes: ◆ Press Apply to apply the changes. ◆ Press Reset to revert back the changes. ◆ Press OK to apply and close the Preference Appearance Window. ◆ Press Cancel to discard the changes and close the Preference Appearance Window.
Setting General Preferences Customizing the Background and Foreground Select Background (or Foreground) under Items. Choose your color settings and click OK. The new settings are displayed. Customizing the Menu Select View under Items. Choose your color setting and click OK. Select your font settings. Customizing the Selection Color Select Appearance then Selection under Items. Choose your color setting and click OK. Customizing the System Font Select System Font under Items. Choose your font settings.
Setting General Preferences General Tab Deleting Temporary Files on Exit You can delete all temporary files when you leave VEA by selecting the checkbox Delete temporary files on exit. If you want to delete the temporary files immediately, click the button Delete Now.
Connecting and Disconnecting a Host Adjusting the History Settings To adjust the history settings, go to the General Tab and type the number of servers (hosts) for which information can be stored in the history file. The maximum limit for the number of hosts for which information can be stored is 99. Press Apply to apply the changes, Reset to revert back the changes, OK to apply and close the Preference Appearance Window, Cancel to discard and close the Preference window.
Connecting and Disconnecting a Host Complete the Connection dialog box as follows: Hostname: Enter the name of the machine to be administered. (For VxVM, both VxVM and the VEA service must be running on this machine.) Username: Enter your login name. Only users with appropriate privileges can access VEA on the specified machine. (The service is already running on the host.) Password: Enter your password for the machine to be administered.
Connecting and Disconnecting a Host If the user does not have administrator privileges, then the connection takes place using the Native Logon mechanism. Disconnecting from a Host The Disconnect procedure disconnects a host machine from the current VEA session. When a host machine is disconnected, VEA cannot administer that machine until a new connection is made. 1. Right-click the computer icon to be disconnected. 2. Select Disconnect from the file menu on the menu bar. 3.
Exiting the VEA Client Adding Favorite Hosts The Favorite Hosts node contains a list of hosts that will be connected to by default at the startup of VEA if the username/password is saved for them. If the username /password is not saved for a particular host, then this information will be prompted for at the time of connection Add Host in the Favorites Folder Use the following procedure to add a host to the Favorites folder: 1. Right click on any of the connected host nodes 2.
Using the Control Panel For example, if you connect from a VEA client, displaying French text, to VERITAS Volume Manager running on a remote Solaris system also displaying French, you will see French text in the VEA client window. If you now connect the same VEA client (displaying French text) to SAN Appliance running on a remote Linux system, displaying English text then, if the SAN Appliance is available in French, the VEA client displays everything in French.
Viewing the Event Log Event Log Previous and Next Alert Sets The Previous and Next set of alerts buttons are situated below the Details View. You can display the next set of alerts by clicking the “Next set of Alerts” button. The current set of alerts is then replaced with the next set of alerts. If there are no more alerts in the event log, the current set continues to be shown. You can display the previous set of alerts by clicking the “Previous set of Alerts” button.
Configuring the Event Log Alert Details Event Log Settings The settings for the Event Log are accessed by double-clicking on the Event Log Settings icon in the Control Panel view.
Configuring the Event Log 1. Select the “control panel” node in the tree view. The details view appears, listing all the configuration applications. 2. Launch the “Event Log Settings” configuration application by double clicking on it. Event Log Settings Note Whenever you change the event log policy, the old files are deleted and a new event log file is created. So it is advisable to take a backup or save the old log file, before changing the policy.
Viewing the Task Log Overwriting After a Number of files Select “Overwrite the log file(s) after” to define the number of files after which the oldest file is overwritten. When a log file reaches its maximum size, a new file is created until the specified number of files is reached. You can specify from one to ten files (default is 5 files). Overwriting After a Number of Days Select “Overwrite the log file(s) older than” to define the number of days after which the oldest file is overwritten.
Configuring the Task Log Task Log Settings The settings for the Task Log are accessed by double-clicking on the Task Log icon in the Control Panel view. Configuring the Task Log You can configure the server task log from the client: 1. Select the “control panel” node in the tree view. The details view appears, listing all the configuration applications. 2. Launch the “Task Log” configuration application by double clicking on it.
Managing User Profiles The complete View is printed, including any information which may be scrolled off the screen. If there is more than one tab for the displayed View, then only information relevant to the displayed tab is printed. Managing User Profiles The user profile feature enables individual users running VEA on the same machine to maintain their own preferences, connection history and favorites information. To use the user profile feature, select Tools > Manage Profiles.
Managing User Profiles Selecting a Startup Profile A default startup profile (Default) is created by VEA when it is invoked by the first time. The Default profile is particularly useful when VEA is being used in a single user environment, in which case, you can use the Default profile rather than creating additional profiles. You cannot delete or modify the Default profile, and it is not password protected. You also have the option of selecting your own startup profile (in Startup using:).
Firewall Support Firewall Support In VEA, the client connects to the server using a specific port number: 2148. In order to connect to the server through a firewall, a port on the firewall is mapped to the 2148 port of the VEA server. When the client wishes to connect to the server through the firewall, it needs to specify the host and port in the following format. Firewallhost:port where: Firewallhost is the name or IP address of the firewall.
Firewall Support 1. Allow for an alias of port 2148 on server A to be a particular port on the firewall machine. 2. Let Pf be the port on the firewall machine F which is an alias for port 2148 on server A. 3. Connect using the GUI to port Pf on F. You are actually managing server A Note VEA uses Anonymous Deffie Hellman key exchange and is therefore vulnerable to the man-in-the-middle attack. Therefore it is recommended that SSH or some kind of tunneling software be used if going across the internet.
Firewall Support 36 VERITAS Enterprise Administrator (VEA 500 Series) Getting Started
3 Accessibility Accessibility is enhanced by the use of: ◆ Keyboard Shortcuts ◆ Dialog Boxes Keyboard Shortcuts Keyboard shortcuts are possible using accelerators and mnemonics. Accelerators Accelerators are key combinations that provide shortcut access to GUI functions. They allow you to use a computer from the keyboard, rather than using the mouse.
Keyboard Shortcuts Keyboard Mapping Conventions Exceptions and additions to the Microsoft Keyboard Conventions are listed in: ◆ VEA Exceptions to Microsoft Keyboard Conventions ◆ VEA Additions to Microsoft Keyboard Conventions ◆ VEA Help Additions to Microsoft Keyboard Conventions VEA Exceptions to Microsoft Keyboard Conventions The table, “VEA Exceptions to Microsoft Keyboard Conventions,” summarizes the keyboard differences between the VERITAS implementation of mnemonics and accelerators, and the M
Keyboard Shortcuts VEA Additions to Microsoft Keyboard Conventions The table, “VEA Additions to Microsoft Keyboard Conventions,” summarizes the keyboard additions to the Microsoft keyboard conventions in the VERITAS implementation of mnemonics and accelerators: VEA Additions to Microsoft Keyboard Conventions Convention Mnemonic Accelerator Actions A Alt A. Use this accelerator in place of Shift+F10 with a selected item to bring up the context menu with the Actions menu.
Dialog Boxes VEA Help Additions to Microsoft Keyboard Conventions The table, “VEA/Applications Help Additions to Microsoft Keyboard Conventions,” summarizes the keyboard additions to the Microsoft keyboard conventions in the VERITAS implementation of mnemonics and accelerators: VEA/Applications Help Additions to Microsoft Keyboard Conventions Convention Mnemonic Accelerator Find in Topic… F Ctrl + F Find Next N F3 Find Previous P None Hide Navigation Tabs H None Index I None Print P Non
Dialog Boxes the default button. Press SPACEBAR to choose the command button you selected with TAB. Use ESC to immediately choose the Cancel button if there is one. Typing the access key for a command button will immediately carry out the command. Check boxes Use TAB to move between boxes and SPACE to change the check box to the next state. Typing the access key for a check box also will move the focus to the box and change is state.
Dialog Boxes Drop-down list boxes by default show only the selected item. There is a small button to the right of the control that shows a downward-pointing arrow. You can click the arrow to display more items from the list. You also can show or hide the list using ALT+DOWN ARROW, ALT+UP ARROW, or F4. In all other respects it behaves like a normal single-selection list box. Extended selection list boxes support selecting single items, blocks of items, or combinations of the two.
Glossary Action menu A context-sensitive menu that changes its menu options to match the type of object that is selected. By default, the Action menu is greyed out. When an object is selected, the Action menu provides access to tasks appropriate for the selected object. 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.
capability You can create volumes having specific capabilities. A capability is a simple name used to indicate what the capability means. Storage is allocated according to your request. For example, you can ask for a volume to be Performant and Reliable. These are capabilities have parameters such as, number of striped columns or number of mirrors. CFS Cluster file system. A VxFS file system mounted on a selected volume in cluster (shared) mode. check box A control button used to select optional settings.
Device Discovery Layer See DDL Dirty Region Logging See DRL. device name The physical disk device name (or disk access name). dialog box A window in which the user submits information to VxVM. Dialog boxes can contain selectable buttons and/or fields that accept information. disk group A set of disks that are under VxVM control and share a common configuration.
enclosure A disk array. FastResync A VxVM feature for fast resynchronizing of stale mirrors at the time of reattach which were earlier split off as a result of snapshot or detach operation. gap A disk region that does not contain VERITAS Volume Manager objects (subdisks). graphical view A window that displays a graphical view of objects. In VxVM, the graphical views include the Object View window and the Volume Layout Details window. grid A tabular display of objects and their properties.
main window The main VERITAS Volume Manager window. This window contains a tree and grid that display volumes, disks, and other objects on the system. The main window also has a menu bar, a toolbar, and an optional Command Launcher. menu A list of options or tasks. A menu item is selected by pointing to the item and clicking the mouse. 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.
plex A copy of a volume and its data. There can be several plexes per volume. The terms mirror and plex are used synonymously. popup menu A context-sensitive menu that only appears when you click on a specific object or area. properties window A window that displays detailed information about a selected object. radio buttons A set of buttons used to select optional settings. Only one radio button in the set can be selected at any given time. These buttons toggle on or off.
There are two types of storage pools: data pools and clone pools. Data pools are created first. All other storage pools that are created within a disk group are clone pools. subdisk A set of contiguous disk blocks that form a logical disk segment. Subdisks are associated with plexes (mirrors) to form volumes. task properties window A window that displays detailed information about a task listed in the Task Request Monitor window.
Volume to Disk Mapping Window A window that displays a tabular view of volumes and their underlying disks. This window can also display details such as the subdisks and gaps on each disk. volume set The volume set feature provides support for the multi-device file system enhancement of VERITAS File System (VxFS). A volume set allows several volumes to be treated as a single object with one logical I/O interface. VxFS VERITAS File System. VxVM VERITAS Volume Manager.
Index A H accelerators 37 accessibility 37 accessing tasks 17 add a host 25 alerts icons 5 C help 5 Help menu 5 History 24 hosts accessing multiple hosts 2 defined 4 K client 9 command log 7 commands, viewing 6 control panel 26 D keyboard mapping 37 keys editing 37 L DCOM authentication 23 details view 14 dialog boxes accessibility 37 disconnecting from a remote computer 24 displaying commands 6 object properties 12 objects 12 E editing keys 37 errors.
multiple event log files 30 multiple host support 2 multiple task log files 31 status area 5 status view 16 system setup 9 N Native Logon 23 navigational view 14 T task log 30 task log file overwriting 31 tasks accessing 17 displaying 6 from menus 17, 18 properties 7 request monitor window 6 running 17 throttling 7 viewing 6 tear off 5 Technical assistance 9 Toolbar 5 tree object 3 O object properties 16 object tree 3 objects displaying 12 selecting 13 sorting 13 viewing 12 Options menu 4 overwriting th