VERITAS Enterprise Administrator (VEA 500 Series) Getting Started OEM version July 2006
Disclaimer The information contained in this publication is subject to change without notice. VERITAS Software Corporation 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. VERITAS Software Corporation shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this manual.
Centura Software Corporation Raima and Centura are trademarks of Centura Software Corporation in the United States and other countries. Some software products marketed by Centura Software Corporation and its distributors contain proprietary software components of other software vendors. Copyright © 2000 Centura Software Corporation. All rights reserved. GRAPH EDITOR TOOLKIT GRAPH EDITOR TOOLKIT Copyright © 1992–1999 Tom Sawyer Software, Berkeley, California. All rights reserved.
iv VERITAS Enterprise Administrator (VEA 500 Series) Getting Started
Contents Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix How This Guide Is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
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.
Getting Help Getting Help For technical assistance, visit http://support.veritas.com and select phone or email support. This site also provides access to resources such as TechNotes, product alerts, software downloads, hardware compatibility lists, and the VERITAS customer email notification service. Use the Knowledge Base Search feature to access additional product information, including current and past releases of product documentation.
Documentation Feedback xii 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 A pure Java-based interface is used. Administrators can run VEA as a Java application. ◆ 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.
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 The Window menu gives you access to the Tear off feature. This allows you to copy views displayed by the VEA Client into new windows. You can then view details of several different object types at the same time, and to correlate relationships between them. Window -> Tear off 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.
Accessing Tasks Accessing Tasks Most VEA tasks are performed by selecting objects and/or tasks and then completing the resulting dialog boxes. With VEA, you can access tasks from the menu bar and from a context-sensitive popup menu. 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.
Command Log For a selected task, you can use the popup menu options: Abort Task to cancel the task; Pause Task to temporarily stop a task, Resume Task to continue the task; and Throttle Task to throttle a task. Task Throttling Task Throttling causes an operation to pause for the allowed amount of time whenever a disk I/O is performed, allowing the CPU and disks to perform other tasks. Select the popup menu option Throttle Task to change the task priority.
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 Using the Command Line To invoke VEA from the command line: 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 (Clicking Cancel will end the application.) Selecting an Alternative Profile Select one of the profiles from the list, and enter the password, if necessary. Click OK to log in. 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.
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 Details You can view the details for particular task. Select the task and click on “Details.” A new window opens up to show the task details. 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.
Printing Views Printing Views You can print some of the Views in the right pane by clicking File-->Print. Print functionality is determined by the server, which means that the Print and Page Setup functions appear only when the VEA installed on the server supports printing. This also means that Page Setup may be shown as disabled, even when the Print function is available. The complete View is printed, including any information which may be scrolled off the screen.
Managing User Profiles 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:).
Managing User Profiles Note You must remember this password, for there is no way of retrieving a lost password, and the profile cannot then be deleted at a later stage. (A blank password or a password consisting of spaces alone will not be considered for a password, and the profile will be marked as not having a password.) Changing Your Password Select the profile, and then click Edit to change the password for the profile. This brings up the Edit Profile dialog.
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 We need to do the following: 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.
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 Mnemonics are case insensitive. Keys can be pressed sequentially instead of simultaneously.
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 A dark border initially indicates the default button. Press ENTER at any time to choose the button with a dark border. Use TAB to move the keyboard focus to the next control, and add SHIFT to reverse the direction. When you move the keyboard focus to a command button it temporarily takes the dark border, but when the keyboard focus is not on a command button the dark border returns to the default button. Press SPACEBAR to choose the command button you selected with TAB.
Dialog Boxes List boxes display a column of available choices. If there are more choices than can fit in the open list box, moving the selection through the list will scroll more choices into view. Use TAB or type the appropriate access key to move the focus to the list box. Single selection list boxes allow only one item to be selected from the list at a time. Use the UP ARROW or DOWN ARROW keys to select items. Moving to a second item will automatically deselect all other items.
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.
button A window control that the user clicks to initiate a task or display another object (such as a window or menu). 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.
DDI DDI properties are device driver properties primarily used in Solaris OS. DDL Device Discovery Layer. A facility of VxVM for discovering disk attributes needed for VxVM DMP operation. 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.
DRL A VxVM mechanism that tracks mirror write inconsistency which helps in fast resynchronization of mirrors after system crash. Even though the term log is used, internally DRL is implemented as a map. Dynamic Multipathing See DMP. 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).
LUN Logical Unit Number. Each disk in an array has a LUN. Disk partitions may also be assigned a LUN. 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.
Organization principle for disk group An organization principle is associated with a disk group. These disk groups have storage pools present on them. Volumes created on such disk groups are maintained by ISP. Traditional volumes cannot be created on these disk groups. You have the option of not associating a organization principle to a disk group. plex A copy of a volume and its data. There can be several plexes per volume. The terms mirror and plex are used synonymously.
storage pool - data pool, clone pool Storage pools are associated with disk groups. Storage pools are defined by templates, capabilities and policies. Policies governing a storage pool decide ◆ to grow a storage pool to accommodate additional storage ◆ to use templates not currently associated with it. 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.
volume A virtual disk or entity that is made up of portions of one or more physical disks. Volume Layout Details Window A window that displays a graphical view of a volume and its components. The objects displayed in this window are not automatically updated when the volume properties change. 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.
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 xi 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 t