EMC Symmetrix Management Console and Symmetrix Performance
Transcription
EMC Symmetrix Management Console and Symmetrix Performance
EMC® Symmetrix® Management Console V7.2 and EMC Symmetrix Performance Analyzer V2.1 Installation Guide P/N 300-011-734 REV A01 EMC Corporation Corporate Headquarters: Hopkinton, MA 01748-9103 1-508-435-1000 www.EMC.com Copyright © 2005 - 2010 EMC Corporation. All rights reserved. Published December, 2010 EMC believes the information in this publication is accurate as of its publication date. The information is subject to change without notice. THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS IS.” EMC CORPORATION MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Use, copying, and distribution of any EMC software described in this publication requires an applicable software license. For the most up-to-date regulatory document for your product line, go to the Technical Documentation and Advisories section on EMC Powerlink. All other trademarks used herein are the property of their respective owners. 2 EMC SMC and SPA Installation Guide Contents Preface............................................................................................................................... 7 Chapter 1 Introduction Symmetrix Management Console overview................................. 12 Symmetrix Performance Analyzer overview ............................... 13 Before you begin ............................................................................... 14 SMC prerequisites ..................................................................... 14 SPA prerequisites....................................................................... 14 Initial Setup User ....................................................................... 15 Local and remote installation options .....................................15 SMC on the Symmetrix service processor...............................17 SMC Virtual Appliance..............................................................17 Chapter 2 Installation Installing SMC/SPA ......................................................................... 20 Step1: Access the software.........................................................20 Step 2: Install the software.........................................................21 Completing the installation ............................................................. 24 Configuring language and regional settings ..........................24 Licensing SMC ........................................................................... 24 Licensing SPA............................................................................. 24 Starting and stopping the SPA database (for SPA installations only) .......................................................................27 Starting and stopping the SMAS service (for both SMC and SPA installations) ................................................................28 Upgrading SMC/SPA ...................................................................... 29 Upgrading your software ..........................................................29 Adding SPA (optional) ..............................................................30 EMC SMC and SPA Installation Guide 3 Contents Uninstalling SMC/SPA ................................................................... 31 Before you begin ........................................................................ 31 Uninstalling from Windows ..................................................... 31 Uninstalling from Linux and SunOS ....................................... 32 Chapter 3 Deploying the SMC Virtual Appliance Introduction....................................................................................... 34 Before you begin ............................................................................... 35 Deploying the virtual appliance directly to the ESX Server....... 36 Step 1: Import the virtual appliance ........................................ 36 Step 2: Select gatekeepers .......................................................... 37 Step 3: Power on and configure the Virtual Appliance ........ 37 Deploying the virtual appliance through a vCenter Server ....... 40 Step 1: Import and configure the virtual appliance............... 40 Step 2: Select gatekeepers .......................................................... 41 Step 3: Power on the virtual appliance.................................... 42 Launching SMC or the Configuration Manager .......................... 43 Updating the SMC Virtual Appliance ........................................... 44 Updating from a zip file ............................................................ 44 Updating from an ISO image.................................................... 44 Deleting the SMC Virtual Appliance ............................................. 46 Chapter 4 Using Symmetrix Management Console Opening Symmetrix Management Console.................................. 48 Understanding the SMC interface.................................................. 49 Managing SMC views ...................................................................... 50 Understanding the Dashboard view ....................................... 50 Understanding the Properties view......................................... 51 Understanding the Config Session view................................. 52 Understanding the Tasks view................................................. 53 Understanding the Service Session view ................................ 54 Understanding the Alerts view ................................................ 55 Understanding the Command History view.......................... 56 Understanding the Replication Monitor view ....................... 57 Understanding the Quality of Service Monitor view............ 58 Changing the default SMC view .............................................. 59 SMC menu bar................................................................................... 60 File menu .................................................................................... 60 Control menu ............................................................................. 61 Help menu options.................................................................... 71 SMC dialog boxes ............................................................................. 72 4 EMC SMC and SPA Installation Guide Contents Chapter 5 Using Symmetrix Performance Analyzer Opening Symmetrix Performance Analyzer................................. 74 SPA Overview.................................................................................... 75 Dashboards view.........................................................................77 Real Time view ............................................................................78 Diagnostic view...........................................................................79 Snapshot View.............................................................................80 Trend view .................................................................................. 81 Appendix A Security features Authentication ................................................................................... 84 Authorization..................................................................................... 85 Appendix B Third-Party Copyright notices GNU LESSER GENERAL PUBLIC LICENSE ............................... 90 MySQL .............................................................................................. 101 EMC SMC and SPA Installation Guide 5 Contents 6 EMC SMC and SPA Installation Guide Preface As part of its effort to continuously improve and enhance the performance and capabilities of the EMC product line, EMC periodically releases new versions of both the EMC Enginuity Operating Environment and EMC Symmetrix Management Console software. Therefore, some functions described in this document may not be supported by all versions of Enginuity or EMC Symmetrix Management Console software currently in use. For the most up-to-date information on product features, refer to your product release notes. If an EMC Symmetrix Management Console or EMC Symmetrix Performance Analyzer feature does not function properly or does not function as described in this document, please contact the EMC Customer Support Center for assistance. Audience This document is intended for use by storage administrators who are installing and using Symmetrix Management Console and Symmetrix Performance Analyzer. Readers of this document are expected to be familiar with the following topics: Related documentation ◆ SYMCLI commands ◆ Solutions Enabler options, environment variables, daemons, and events Related documents include: ◆ EMC Symmetrix Management Console Release Notes ◆ EMC Symmetrix Management Console Online Help ◆ EMC Symmetrix Performance Analyzer Release Notes EMC SMC and SPA Installation Guide 7 Preface Conventions used in this document ◆ EMC Symmetrix Performance Analyzer Online Help ◆ EMC Solutions Enabler Release Notes ◆ EMC Solutions Enabler Symmetrix CLI Command Reference ◆ EMC Solutions Enabler Symmetrix Array Management CLI Product Guide ◆ EMC Solutions Enabler Symmetrix Array Controls CLI Product Guide ◆ EMC Solutions Enabler Symmetrix TimeFinder Family CLI Product Guide ◆ EMC Solutions Enabler Symmetrix SRDF Family CLI Product Guide ◆ EMC Solutions Enabler Symmetrix Migration CLI Product Guide ◆ EMC Solutions Enabler Symmetrix SRM CLI Product Guide EMC uses the following conventions for special notices. Note: A note presents information that is important, but not hazard-related. ! CAUTION A caution contains information essential to avoid data loss or damage to the system or equipment. The caution may apply to hardware or software. Typographical conventions EMC uses the following type style conventions in this document: Normal Used in running (nonprocedural) text for: • Names of interface elements (such as names of windows, dialog boxes, buttons, fields, and menus) • Names of resources, attributes, pools, Boolean expressions, buttons, DQL statements, keywords, clauses, environment variables, filenames, functions, utilities • URLs, pathnames, filenames, directory names, computer names, links, groups, service keys, file systems, notifications Bold: Used in running (nonprocedural) text for: • Names of commands, daemons, options, programs, processes, services, applications, utilities, kernels, notifications, system call, man pages Used in procedures for: • Names of interface elements (such as names of windows, dialog boxes, buttons, fields, and menus) • What user specifically selects, clicks, presses, or types 8 EMC SMC and SPA Installation Guide Preface Where to get help Italic: Used in all text (including procedures) for: • Full titles of publications referenced in text • Emphasis (for example a new term) • Variables Courier: Used for: • System output, such as an error message or script • URLs, complete paths, filenames, prompts, and syntax when shown outside of running text Courier bold: Used for: • Specific user input (such as commands) Courier italic: Used in procedures for: • Variables on command line • User input variables <> Angle brackets enclose parameter or variable values supplied by the user [] Square brackets enclose optional values | Vertical bar indicates alternate selections - the bar means “or” {} Braces indicate content that you must specify (that is, x or y or z) ... Ellipses indicate nonessential information omitted from the example EMC support, product, and licensing information can be obtained as follows. Product information — For documentation, release notes, software updates, or for information about EMC products, licensing, and service, go to the EMC Powerlink website (registration required) at: http://Powerlink.EMC.com Technical support — For technical support, go to EMC Customer Service on Powerlink. To open a service request through Powerlink, you must have a valid support agreement. Please contact your EMC sales representative for details about obtaining a valid support agreement or to answer any questions about your account. Your comments Your suggestions will help us continue to improve the accuracy, organization, and overall quality of the user publications. Please send your opinion of this document to: [email protected] EMC SMC and SPA Installation Guide 9 Preface 10 EMC SMC and SPA Installation Guide 1 Invisible Body Tag Introduction This chapter introduces Symmetrix Management Console and Symmetrix Performance Analyzer: ◆ ◆ ◆ Symmetrix Management Console overview.................................. 12 Symmetrix Performance Analyzer overview................................. 13 Before you begin ................................................................................ 14 Introduction 11 Introduction Symmetrix Management Console overview Symmetrix® Management Console (SMC) is a simple, intuitive, browser-based user interface for the configuration and management of Symmetrix arrays. It was developed to concurrently support all the features of Enginuity™ Version 5671 and higher. SMC presents the functionality of the Solutions Enabler SYMCLI (command line interface) in a browser interface. You can use SMC to: 12 ◆ Manage Symmetrix access controls, user accounts, and roles ◆ Discover Symmetrix arrays ◆ Perform configuration operations (create devices, map and mask devices, set Symmetrix attributes, set device attributes, set port flags, create SAVE device pools) ◆ Manage devices (change device configuration, set device status, reserve devices, duplicate devices, create/dissolve metadevices) ◆ Manage Fully Automated Storage Tiering (FAST), Virtual Provisioning™, and Auto-provisioning Groups ◆ Perform and monitor replication operations (TimeFinder®/Mirror, TimeFinder/Snap, TimeFinder/Clone, SRDF®, Open Replicator) ◆ Monitor alerts ◆ Monitor an application’s performance ◆ Dynamically provision storage in virtual computing environments (Storage Pool Management) EMC SMC and SPA Installation Guide Introduction Symmetrix Performance Analyzer overview EMC® Symmetrix® Performance Analyzer (SPA) is an intuitive, browser-based tool used to perform historical trending and analysis of Symmetrix array performance data. SPA was developed to work with the Symmetrix Management Console (SMC). The SPA interface can open in its own web window from the SMC menu, or on its own. SPA adds an optional layer of data collection, analysis, and presentation tools to the SMC implementation. You can use SPA to: ◆ Set performance thresholds and alerts ◆ View high frequency metrics in realtime ◆ Perform root cause analysis ◆ View graphs detailing system performance ◆ Drill-down through data to investigate issues ◆ Monitor performance and capacity over time ◆ Execute queries and export that data to a file ◆ Create your own dashboard view SPA also provides a “fast lane” to display possible performance road blocks with one click, and includes export and print capability for all data graphs. Symmetrix Performance Analyzer overview 13 Introduction Before you begin Before you begin installing the SMC/SPA, you should review the information in this section. SMC prerequisites SMC V7.2 has the following prerequisites: ◆ Solutions Enabler V7.2 (minimum) must be installed. Note: The installation wizard will fail if the proper level of Solutions Enabler is not installed on the host. ◆ SMC can be installed on the same system as the SYMAPI server, or on a system connected to the SYMAPI server. Refer to Figure 1 on page 16 and Figure 2 on page 16, respectively. ◆ Java runtime environment must be enabled on the client browser. ◆ If you are changing your SYMAPI connection type (local/remote), you must uninstall SMC before reinstalling it. For example, if you change from a local connection to client/server. Note: For additional environment requirements and product updates, refer to the EMC Symmetrix Management Console Release Notes. SPA prerequisites SPA V2.1 has the following prerequisites: ◆ If upgrading from an earlier version to V2.1, backup the SPA database using the SPA DB Backup utility. The utility is available on Powerlink. For instructions on using the utility, refer to its README file. ◆ Solaris/Linux installations: When performing a new SPA installation on Solaris or Linux, the mysql user and mysql group must be present before beginning the SPA installation. An example of the MySql instructions follows: shell> groupadd mysql shell> useradd -g mysql mysql 14 EMC SMC and SPA Installation Guide Introduction Initial Setup User While installing the software, you will be prompted to specify an Initial Setup User. You can either specify the user ID you currently use to access the Symmetrix array (if User Authorization is enabled), or you can use the default user ID smc. If you plan on using the default ID, there must be no user IDs listed in the User Authorization database. If there are user IDs in the database (regardless of whether user authorization is enabled), then you must use SYMCLI to add the default user ID (smc) to the database. The initial setup user's role is to install and set up the SMC environment (create users and add roles). It is intended to be a temporary role as it will only allow you to access and perform administrative tasks on Symmetrix arrays that do not have defined user roles (authorization rules). Once an Administrator or SecurityAdmin is assigned to a Symmetrix array, the initial setup user will no longer be able to access or even see the array from the SMC console. Therefore, it is recommended that users not operate in this role for too long. Note: “Security features” on page 83 contains more information on users and roles. Local and remote installation options SMC and SPA can be installed in local or remote configurations. In a local configuration, install the SMC/SPA software and license keys on a host running Solutions Enabler attached to Symmetrix arrays (Figure 1 on page 16). In a remote configuration, install the SMC/SPA software and license keys on a system (SMC Server) connected to the SYMAPI server (Figure 2 on page 16). Before you begin 15 Introduction SMC/SPA RDF SMC/SPA Hosts Figure 1 SMC/SPA license keys Local installation: SMC/SPA SYMAPI Server RDF SMC/SPA Server SMC/SPA Hosts Figure 2 16 SMC/SPA license keys Node name Net port Remote installation: SMC/SPA on system connected to a remote SYMAPI server EMC SMC and SPA Installation Guide Introduction SMC on the Symmetrix service processor SMC is available on the Symmetrix service processor as part of EMC’s management integration. Before deploying SMC in this manner, you should be aware of the following: ◆ The service processor is shared with EMC Customer service for normal service operations. ◆ There is no host access to the service processor, thereby limiting your ability to do backups of your management environment. This will prevent you from backing up SMC and Solutions Enabler configuration files and/or device groups. ◆ Additionally, you will need to involve Customer Service to start/stop Solutions Enabler services or the SMC service. ◆ You must involve Customer Service to review Solutions Enabler logs. ◆ The following features are not supported when running SMC on the Symmetrix service processor: • Storage Pool Management (SPM) • Windows authentication • RDF consistency groups • Group name services (GNS) SMC on the service processor is disabled by default. To enable it, contact EMC Customer Service. Note: SPA is not available on the Symmetrix service processor. SMC Virtual Appliance SMC is also available as a virtual appliance for ESX V3.5 (and higher) Servers in a VMware environment. For more information and instructions on deploying the appliance, refer to “Deploying the SMC Virtual Appliance” on page 33. Before you begin 17 Introduction 18 EMC SMC and SPA Installation Guide 2 Invisible Body Tag Installation This chapter explains how to install Symmetrix Management Console and Symmetrix Performance Analyzer: ◆ ◆ ◆ ◆ Installing SMC/SPA .......................................................................... Completing the installation .............................................................. Upgrading SMC/SPA ....................................................................... Uninstalling SMC/SPA..................................................................... Installation 20 24 29 31 19 Installation Installing SMC/SPA This section describes how to access and install the SMC/SPA software. Step1: Access the software SMC/SPA is distributed in the following forms: ◆ On the SMC/SPA installation DVD, which includes kits for all supported platforms. ◆ As a platform-specific kit download from the Powerlink website at: http://Powerlink.EMC.com In both cases, the kits are named accordingly: ◆ ◆ ◆ ◆ From an install DVD For Windows 32-bit: SMAS_V7.2.0.x_WINDOWS_X86_32.exe For Windows 64-bit: SMAS_V7.2.0.x_WINDOWS_X86_64.exe For SunOS: SMAS_V7.2.0.x_SUNOS_SPARC_32.bin For Linux: SMAS_V7.2.0.x_LINUX_X86_32.bin To access the software from an installation DVD: 1. Save all files and exit all applications. 2. Insert the DVD into the DVD drive. From Powerlink To access the software from Powerlink: 1. Save all files and exit all applications. 2. On Powerlink, select Support > Software Downloads and Licensing > Downloads S > Symmetrix Management Console and click the platform-specific installation kit. 3. Save the kit to a directory on the host’s drive. 4. Continue with “Step 2: Install the software” on page 21. 20 EMC SMC and SPA Installation Guide Installation Step 2: Install the software You can install SMC/SPA using an installation wizard, as described in “Step 2A: Installing SMC/SPA using the wizard” on page 21, or from the command line, as described in “Step 2B: Installing SMC/SPA from the command line” on page 22). Note: To install SMC/SPA using the wizard in Solaris and Linux, the display manager must be enabled; otherwise, the installer will default to console mode. Step 2A: Installing SMC/SPA using the wizard To install SMC/SPA using the wizard: 1. Change directory to the location of the kit and run the appropriate executable for your operating system. 2. In the Introduction page, review the recommendations and click Next. 3. In the Choose Install Folder page, click Next to accept the default directory, or click Choose to select another directory. 4. In the Choose Install Set page, click SMC to install SMC or SPA to install SPA, and then click Next. Note: When selecting the SPA option, if SMC 7.2 is not already installed, the installation program will automatically install it. 5. In the SYMAPI Connection Type page: a. Specify an initial setup user name (default is smc). You can either accept the default or use your Windows username if you have authorization enabled on the SMC server host. “Initial Setup User” on page 15 explains the role of the intial setup user. b. Specify a Connection Type for the intial login based on the following: Local — On a host with Solutions Enabler installed and attached to Symmetrix arrays. Remote — On a remote server connected to a SYMAPI server; you must specify the SYMAPI server Node Name and Net Port. The default net port for SYMAPI is 2707. Installing SMC/SPA 21 Installation Note: “Local and remote installation options” on page 15 provides more information on each of the connection types. c. Click Next. 6. In the Ports Configuration page, specify the ports to use/enable when connecting to the SMC server. The default ports of the SMC server and SPA database (if installing SPA) are displayed. If you want to use the default ports, verify that they are available, and click Next to accept and enable them. Otherwise, you can specify/enable different ports, and click Next. Note: Starting with SMC V7.0, the HTTPS port must be enabled. 7. In the Pre-Installation Summary page, verify the summary information, and click Install to continue the installation. 8. In the Install Complete page, click Done. Step 2B: Installing SMC/SPA from the command line To install SMC/SPA from the command line: 1. Save all files and exit all applications. 2. Insert the DVD into the DVD drive. 3. Change directory to the location of the kit. 4. Run the following command: KitName -i console Where KitName is one of the following operating system-specific kit names: • • • • For Windows 32 -bit: SMASV7.2.0.x_WINDOWS_X86_32.exe For Windows 64-bit: SMASV7.2.0.x_WINDOWS_X86_64.exe For SunOS: SMAS_V7.2.0.x_SUNOS_SPARC_32.bin For Linux: SMAS_V7.2.0.x_LINUX_X86_32.bin 5. In the Introduction panel, review the recommendations and press Enter. 6. In the Choose Install Folder panel, press Enter to accept the default directory, or specify a different directory and press Enter. 22 EMC SMC and SPA Installation Guide Installation 7. In the Choose Install Set panel, press Enter to install the SMC Install Set or type 2 and press Enter to install both SMC and SPA. 8. In the SYMAPI Connection Type page: a. Specify an initial setup user name (default is smc). You can either accept the default or use your Windows username if you have authorization enabled on the SMC server host. “Initial Setup User” on page 15 explains the role of the intial setup user. b. Specify a Connection Type for the intial login based on the following: Local — On a host with Solutions Enabler installed and attached to Symmetrix arrays. Remote — On a remote server connected to a SYMAPI server; you must specify the SYMAPI server Node Name and Net Port. The default net port for SYMAPI is 2707. Note: “Local and remote installation options” on page 15 provides more information on each of the connection types. 9. In the Ports Configuration panel, specify the ports to use/enable when connecting to the SMC server. The default ports of the SMC web server are displayed. If you want to use the default ports, verify that they are available and press Enter to accept and enable them. Otherwise, you can specify/enable different ports, and press Enter. 10. In the Pre-Installation Summary panel, verify the summary information, and then press Enter to continue the installation. 11. In the Install Complete panel, press Enter. 12. Refer to “Completing the installation” on page 24 for instructions on completing the installation. Installing SMC/SPA 23 Installation Completing the installation This section describes the tasks to perform post installation. Configuring language and regional settings For users outside the United States, you must configure your Windows regional and language settings to English (United States) if you plan on using the graph feature of the QoS and Replication Monitors. To configure your settings: 1. Stop the EMC SMAS service (if it is running).“Starting and stopping the SMAS service (for both SMC and SPA installations)” on page 28 provides instructions. 2. In the Windows Control panel, double-click Regional and Language Options. 3. On the Regional Options tab, set the Standards and formats to English (United States). 4. On the Advanced tab, set the Language for non-Unicode programs to English (United States) and select Apply all setting to the current user account and to the default user profile. 5. Restart the service. Licensing SMC When logging into SMC for the first time, the Web Console Login Window (Figure 3 on page 48) will prompt you for a host-based license key (if SMC is not currently licensed). Licensing SPA SPA 2.1 uses host-based eLicensing to enter and query its licenses. Starting with 2.1, there is only a single SPA license. Note: SPA 2.0 utilizes host-based Electronic License Management, therefore you will be provided with a License Authorization Code letter for your SPA software. Use this license code to register the SPA software electronically on the EMC Powerlink® website at: http://Powerlink.EMC.com 24 EMC SMC and SPA Installation Guide Installation You must install a SPA license file on each SPA host (Windows, Solaris, and Linux x86 processor) using either the following symlmf command or SMC’s License Manager feature: symlmf add -type LicenseType -dir PathToDirName | -file PathToFileName Where: -type LicenseType — Specifies the type of licenses to be processed. This can either be se which specifies the traditional Solutions Enabler license or emclm which specifies the new EMC license. SPA licenses use the emclm type. -dir PathToDirName — Specifies a path to a directory that contains license files with the .lic extension. -file PathToFileName — Specifies a path to a file that contains licenses. Note: Installing licenses in the SMC help explains how to license SPA using the License Manager. Entering SPA licenses in client/server mode Note: The Remote Operations chapter in the EMC Solutions Enabler Installation Guide explains how to set up client/server for SYMCLI. Follow these steps to license SPA in a client/server configuration: Server side The server has SYMAPI, SYMCLI, and the required gatekeepers. 1. Add the SYMCLI server key with the symlmf command. 2. Verify that the storsrvd process is running. Client side 1. Edit the netconfg file with the server name. 2. Set the following environment variables: SYMCLI_CONNECT=SYMAPI_SERVER SYMCLI_CONNECT_TYPE=REMOTE 3. Add the SPA license keys with the symlmf command, as follows: symlmf -type emclm add -file PathToFileName.lic Completing the installation 25 Installation 4. Enter the following command to verify that the host displays in the output: symlmf -type emclm list This verifies that the SPA license is included in the symapi_clp_license.dat file on the server system. Licensing examples The following is an example of the symlmf add -dir command which will add licenses from any files with the .lic extension in the directory specified to the license database: symlmf add -type emclm -dir /tmp/licenses The following is an example of the symlmf add -file command which will add licenses from the file specified to the license database: symlmf add -type emclm -file /tmp/api57_072809.lic During the processing of each license one of the following messages displays indicating its processing status: License FeatureName, SymmID, HostID, IssueDate: Status The Status can be either: Processed successful Not Processed - unknown Symm ID Not Processed - invalid signature Not Processed - invalid Host ID Not Processed - Expired Not Processed - Licensing error: <error code> The <error code> is the error returned by the ELM API which is used to process the licenses. When all the processing is complete a summary displays of the total licenses that have been successfully and unsuccessfully processed as shown below: Total licenses Processed : nn Total licenses Not Processed : nn Displaying SPA licenses To display the SPA licenses, use the following form: symlmf list -type emclm [-v] [-host] [-macaddr] Where: -host — Indicates that only licenses specified for this host should be listed. 26 EMC SMC and SPA Installation Guide Installation -macaddr — Indicates that macaddresses should be listed instead of host names. -v —Indicates that the list command should provide a verbose list. Example Feature Name ---------------------SPA_BASE SPA_BASE SPA_BASE SPA_BASE SPA_DIAG The following is sample output for a symlmf list command: SymmID -----------000012481632 001248163264 001248163264 123456789012 - Host ID ----------------00-22-AA-90-9D-5D 00-21-9B-60-9D-5D 00-22-AA-90-9D-5D 00-21-9B-60-9D-5D - Days Until Expr ----90 Capacity Type Units ---- -----R-TB 1000 R-TB 500 - Legend: Capacity: R-TB = Raw capacity in TB C-TB = Configured capacity in TB = No capacity limit Starting and stopping the SPA database (for SPA installations only) Linux To start/stop the SPA database (MySQL) in Linux and SunOS, change to this directory: install_location/emc/SMAS/jboss/server/default-em/ data/msq and use the following commands: Windows Action Command Start (Always start the SPA DB before starting the SMAS service.) ./smas_mysql_unix_helper.sh -S Stop (Always stop the SMAS service before stopping the SPA DB.) ./smas_mysql_unix_helper.sh -k To start/stop the EMC_smasdb service in Windows, use the Control Panel (Administrative Tools, Services). Completing the installation 27 Installation Starting and stopping the SMAS service (for both SMC and SPA installations) Starting with SMC V7.2 and SPA V2.1, the applications share a common service, the EMC Symmetrix Management Application Server (SMAS). Therefore, you should take the necessary precautions before starting/stopping the service, as you will be affecting both SMC and SPA. Linux and SunOS To start/stop the SMAS service in Linux and SunOS, change to this directory: /etc/init.d and use the following commands: Action Command Start server (Always start the SPA DB before starting the SMAS service.) ./smas start Stop server (Always stop the SMAS ./smas stop service before stopping the SPA DB.) Windows 28 To start/stop the EMC Symmetrix Management Application Server in Windows, use the Services panel (Control Panel, Administrative Tools, Services). EMC SMC and SPA Installation Guide Installation Upgrading SMC/SPA The installation program will automatically detect which of the applications (SMC, or SMC and SPA) are currently installed on the host and upgrade them according to your previous settings (ports, connection type, etc.). To upgrade SMC to V7.2 and install SPA for the first time, you must complete both procedures, “Upgrading your software” below, and “Adding SPA (optional)” on page 30. To upgrade SMC to V7.2 and SPA to V2.1, or to just upgrade SMC to V7.2, complete “Upgrading your software” below. ! IMPORTANT Before updating an earlier version of SPA to V2.1, you must backup your SPA database using the SPA Database Backup Utility available on Powerlink. For instructions on using the utility, refer to its README file. Upgrading your software To upgrade SMC, or SMC and SPA: 1. Access the software, as described in “Step1: Access the software” on page 20. 2. Change directory to the location of the kit and run the appropriate executable for your operating system. 3. In the instance detected message, click Yes. 4. In the Introduction Upgrade Feature page, click Next. 5. In the Pre-Installation Summary page, click Next. 6. Once you have finished upgrading to SMC V7.2, if you were using link and launch client registrations to launch SMC from ControlCenter or vSphere VSI clients, you must re-register your host with SMC. Adding Link & Launch client registrations in the SMC help provides instructions. Upgrading SMC/SPA 29 Installation Adding SPA (optional) To add SPA V2.1 to a host running SMC V7.2: 1. Access the software, as described in “Step1: Access the software” on page 20. 2. Change directory to the location of the kit and run the appropriate executable for your operating system. 3. In the SMAS Instance detected dialog box, click Add New Feature. 4. In the Introduction Add Feature page, click Next. 5. In the Ports Configuration page, specify the port to use/enable when connecting to the SPA database. The default port is displayed. 6. In the Pre-Installation Summary page, click Install. 30 EMC SMC and SPA Installation Guide Installation Uninstalling SMC/SPA This section describes how to uninstall SMC/SPA. Before you begin Before you begin uninstalling SMC/SPA, review the following: ◆ ! Uninstalling SPA will remove the SPA database. The SPA online help provides instructions on backing up/restoring the SPA database should you want to reuse it at a later time. CAUTION Uninstalling SMC will terminate all client sessions to the SMC server and any SYMAPI operations in progress. Uninstalling from Windows You can uninstall SMC/SPA from a Windows host using either the Windows Add/Remove Programs dialog box, the command line, or Windows Explorer. Using the Windows Add/Remove Programs dialog box To uninstall SMC/SPA from the Windows Add/Remove Programs dialog box: 1. From the Windows Start menu, select Settings, Control Panel, Add/Remove Programs. 2. In the Add/Remove Programs dialog, select EMC_SMAS and click Change/Remove. 3. In the Configure EMC_SMAS wizard, click Uninstall Product to uninstall both SMC and SPA; or click Remove Features to remove one of the products. Click Next. 4. Complete the remaining steps in the wizard. Uninstalling SMC/SPA 31 Installation Using the command line To uninstall SMC/SPA using the command line: 1. Change directory location to: SMC_SPA_HOME\\SMC\SMAS\_EMC_SMAS_installation 2. Type the following to launch the uninstall wizard: Uninstall_EMC_SMAS_Installation 3. Complete the steps in the wizard. Note: A few files will remain after the uninstall operation. To remove them you can delete the SMAS folder. Using Windows Explorer To uninstall SMC/SPA using Windows Explorer: 1. Double-click the following to launch the uninstall wizard: SMC_SPA_HOME\\SMC\SMAS\_EMC_SMAS_installation\ Uninstall_EMC_SMAS_Installation 2. Complete the steps in the wizard. Note: A few files will remain after the uninstall operation. To remove them you can delete the SMAS folder. Uninstalling from Linux and SunOS You can uninstall SMC/SPA from a Linux or SunOS host using the command line: 1. Change directory location to: SMC_SPA_HOME\\SMC\SMAS\_EMC_SMAS_installation 2. Type the following to launch the uninstall wizard: ./Uninstall_EMC_SMAS_Installation -i console 3. Complete the steps in the wizard. Note: A few files will remain after the uninstall operation. To remove them you can delete the SMAS folder. 32 EMC SMC and SPA Installation Guide 3 Invisible Body Tag Deploying the SMC Virtual Appliance This chapter describes how to deploy the Solutions Enabler Virtual Appliance for SMC in a VMware infrastructure environment: ◆ ◆ ◆ ◆ ◆ ◆ ◆ Introduction ........................................................................................ Before you begin ................................................................................ Deploying the virtual appliance directly to the ESX Server ........ Deploying the virtual appliance through a vCenter Server ........ Launching SMC or the Configuration Manager............................ Updating the SMC Virtual Appliance............................................. Deleting the SMC Virtual Appliance .............................................. Deploying the SMC Virtual Appliance 34 35 36 40 43 44 46 33 Deploying the SMC Virtual Appliance Introduction The Solutions Enabler Virtual Appliance for SMC (from here on referred to as the SMC Virtual Appliance) is a VMware ESX Server virtual machine that provides all the components you need to manage your Symmetrix environment using the storsrvd daemon and Solutions Enabler network client access. These include: ◆ ◆ ◆ ◆ EMC Symmetrix Management Console V7.2.0 EMC Solutions Enabler V7.2 (solely intended as a SYMAPI server for Solutions Enabler client access) Linux OS (SUSE 10 SP2 JeOS) SMI- S Provider V4.1.10 In addition, the SMC Virtual Appliance also includes a browser-based configuration tool, called the Solutions Enabler Virtual Appliance Configuration Manager. This tool enables you to perform the following configuration tasks not available in SMC or from the Virtual Appliance directly: ◆ ◆ ◆ ◆ ◆ ◆ ◆ Launch SMC Start and stop selected Solutions Enabler and SMC daemons Import and export Solutions Enabler and SMC persistent data and view log files Configure the Solutions Enabler nethost file (required for client access) Modify options and daemon options Add host-based license keys Run a limited set of Solutions Enabler CLI commands Note: For information on using the Configuration Manager, refer to its online help. Note: Root login is not supported on the SUSE 10 Virtual Machine. Local login is restricted to the seconfig account with restricted access. 34 EMC SMC and SPA Installation Guide Deploying the SMC Virtual Appliance Before you begin Before you begin to deploy the SMC Virtual Appliance, be sure to complete the tasks listed in this section. ❑ Verify that you are installing the latest version of the appliance by checking Powerlink for updates. ❑ Verify that the client is running: • VMware Infrastructure Client V2.5 (or above) or vSphere Client • Either of the following browsers with cookies an javascript enabled: – Internet Explorer 6.0 through 8.0 – Firefox 3.5 Browsers should have Flash Player 10.1 plug-in installed. If your browser has an outdated version of Flash Player, you will be prompted to download the latest version when you start the web console. ❑ Verify that the VMware ESX Server meets the following minimum requirements: • Version 3.5 or higher • 4 GB of disk space • 2 GB of memory • 2 CPUs Before you begin 35 Deploying the SMC Virtual Appliance Deploying the virtual appliance directly to the ESX Server This section describes how to deploy the SMC Virtual Appliance directly to the ESX Server. Step 1: Import the virtual appliance To import the virtual appliance: 1. Download the zip file containing the installation program from Powerlink and extract it to a temporary directory. 2. Start the vSphere Client and log in to the ESX Server on which you will be deploying the appliance. 3. Click Ignore in the security warning message. 4. Depending on the ESX Sever version, do the following: • For ESX Server V3.5: a. On the Getting Started tab, click Import a virtual machine to launch the Import Virtual Appliance Wizard. b. On the Import Location page, select Import from file and specify the path to the OVF file. This file is located at the top level of the temporary directory you created earlier. Select the OVF file with the suffix *vapp_OVF09.ovf. • For ESX Server V4.0 or higher, do the following: a. From the File menu, select Deploy OVF Template. b. Browse to the OVF file, located at the top level of the temporary directory you created earlier. Select the OVF file with the suffix *vapp_OVF10.ovf. 5. Click Next. 6. On the Details page, verify the details about the appliance and click Next. 7. On the End User License Agreement page, select Accept all license agreements and click Next. 8. On the Name and Location page, specify a name for the appliance and click Next. 9. On the Disk Format page, select the format in which to store the virtual machine’s virtual disks and click Next. 36 EMC SMC and SPA Installation Guide Deploying the SMC Virtual Appliance 10. On the Ready to Complete page, verify the information and click Finish. 11. In the Completed Successfully message, click Close. 12. Continue with “Step 2: Select gatekeepers” below. Step 2: Select gatekeepers Present uniquely defined gatekeeper by way of raw device mappings (RDM). For instructions, refer to the appropriate VMware documentation. Solution Enabler manages Symmetrix arrays through gatekeeper devices mapped to the virtual appliance as RDM pass-through devices. The management is done through EMC proprietary commands using SCSI 3B/3C write/read commands. For every call, a WRITE command is issued to send the request, and then a READ command to get the results. Continue with “Step 3: Power on and configure the Virtual Appliance” below. Step 3: Power on and configure the Virtual Appliance To power on and configure the Virtual Appliance: 1. On the Summary page of the Virtual Infrastructure Client, click Power On. 2. Click the Console tab and watch as the appliance starts up. 3. Read and accept the license by typing yes at the following prompt and pressing Enter: Do you agree with the terms of the end user license agreement? yes/no [no]: 4. At the following prompt, type y and press Enter to configure static IP address: Do you want to configure static IP address? [y]/n: • A [y]es response produces the following series of prompts that will enable you to configure your network: – IP Address [ ]: Type the address assigned to the appliance and press Enter. Deploying the virtual appliance directly to the ESX Server 37 Deploying the SMC Virtual Appliance – Netmask [ ]: Type the mask of the network on which the appliance will be running and press Enter. – Gateway [ ]: Type the gateway address to the network on which the appliance will be running and press Enter. – Is a proxy server necessary to reach the internet? y/n [n]: A [y]es response enables you to specify the IP address of the proxy server and the port. • A [n]o response continues the configuration. The network is configured at this point. 5. At the following prompt, specify whether you want to set the time zone: Do you want to set the time zone? y/[n] : • A [n]o response continues the configuration. If you select this option, you can use the appliance console to specify the time zone at a later time. • A [y]es response produces the following series of prompts that will enable you to set the time zone: – Please select a continent or ocean Type the number that corresponds to the time zone location and press Enter. – Please select a country Type the number that corresponds to the country-specific time zone you want to set and press Enter. – Please select one of the following time zone regions Type the number that corresponds to regional time zone you want to set and press Enter. – Is the above information OK? 6. Verify that the time zone information is correct. If it is, type y at the following prompt; otherwise, type n to step through it again. 38 EMC SMC and SPA Installation Guide Deploying the SMC Virtual Appliance 7. At the following prompt, specify whether you want to enter the host-based Solutions Enabler license keys: Do you want to register Solutions Enabler license keys y/[n]? : Note: The Virtual Appliance only supports loading Solutions Enabler host-based licenses. For more information, refer to the Licensing your software in the Solutions Enabler Installation Guide. • A no response continues the configuration. If you select this option, you must use the Configuration Manager to enter the license keys at a later time. For instructions, refer to the Configuration Manager’s online help. • A yes response prompts you for a license key. In which case you should type the license key and press Enter. When prompted to enter another license key, type yes to enter another key, or no to continue with the installation. 8. At the following prompt, specify whether you want to enter the host ESX Server information: Do you want to set the host ESX Server y/[n]? : • A n response continues the configuration. If you select this option, you can use the Configuration Manager to enter the host ESX Server details at a later time. For instructions, refer to the Configuration Manager’s online help. • A y response prompts you for the ESX Server hostname. In which case you should type the fully qualified hostname of the ESX Server and press Enter. 9. When prompted to enter the root password, type the root password of the ESX Server and confirm it by typing it again. 10. A Welcome dialog box opens. You have now finished installing the SMC Virtual Appliance. 11. Continue with “Launching SMC or the Configuration Manager” on page 43. Deploying the virtual appliance directly to the ESX Server 39 Deploying the SMC Virtual Appliance Deploying the virtual appliance through a vCenter Server This section describes how to deploy the SMC Virtual Appliance through a vCenter Server 4.0 and higher. Step 1: Import and configure the virtual appliance To import and configure the virtual appliance: 1. Download the zip file containing the installation program from Powerlink and extract it to a temporary directory. 2. Start the vSphere Client and log in to the vCenter Infrastructure Server through which you will be deploying the virtual appliance. 3. Click Ignore in the security warning message. 4. From the navigation tree, select the ESX Server on which you will be deploying the virtual appliance. 5. From the File menu, select Deploy OVF Template. 6. Browse to the OVF file, located at the top level of the temporary directory you created earlier. Select the OVF file with the suffix *vapp_OVF10.ovf. 7. Click Next. 8. On the Details page, verify the details about the appliance and click Next. 9. On the End User License Agreement page, select Accept all license agreements and click Next. 10. On the Name and Location page, specify a name for the appliance and click Next. If you want to add gatekeeper devices automatically during the first boot of the appliance, you should name the appliance with the same fully qualified hostname as the DNS Server. When setup this way, two gatekeeper devices per Symmetrix array will be added the first time the appliance boots up. In addition, you will be prompted for the ESX Server login credentials. 11. Select the host/cluster to run the virtual appliance. 12. If the resource pool is available, select it; otherwise, go to step 14. 40 EMC SMC and SPA Installation Guide Deploying the SMC Virtual Appliance 13. If more than one datastore is attached to the ESX Server, select the datastore for your appliance; otherwise, go to step 14. 14. Customize the software solution for this deployment by doing the following: a. Provide valid values for the following OVF properties: – IP Address – Netmask – Gateway – DNS Server 1 – DNS Server 2 b. Optionally, provide/select valid values for the following OVF properties: – Time zone: Select the appropriate time zone. – SE License: Enter multiple Solutions Enabler host-based license keys separated by a colon (:). For example: SELicense1:SELicense2:SELicense3 – Proxy Server: Enter the IP address of the proxy server and port. For example: ProxyServer-IP:Port – ESX Server Name: Enter the fully qualified ESX Server hostname. – ESX Server Password: Enter the ESX Server password in base64 encryption format. 15. On the Ready to Complete page, verify the information and click Finish. 16. In the Completed Successfully message, click Close. 17. Continue with Step 2: Select gatekeepers below. Step 2: Select gatekeepers 1. Select gatekeepers as described in “Step 2: Select gatekeepers” on page 37. You can configure the virtual appliance to add two gatekeeper devices per Symmetrix array when it firsts boots up. For instructions, refer to step 10 in “Step 1: Import and configure the virtual appliance” on page 40. Deploying the virtual appliance through a vCenter Server 41 Deploying the SMC Virtual Appliance 2. Continue with “Step 3: Power on the virtual appliance” on page 42. Step 3: Power on the virtual appliance To power on and configure the virtual appliance: 1. On the Summary page of the Virtual Infrastructure Client, click Power On. 2. Click the Console tab and watch as the appliance starts up. A Welcome dialog box opens. You have now finished installing the SMC Virtual Appliance. Continue with “Launching SMC or the Configuration Manager” on page 43. 42 EMC SMC and SPA Installation Guide Deploying the SMC Virtual Appliance Launching SMC or the Configuration Manager Once you have finished installing the appliance, you can either launch SMC, the Configuration Manager, and/or connect to the API server through the Solutions Enabler client. Launching SMC To launch SMC: 1. Type the following URL in a browser: https://appliance_IP:8443 2. On the login window, type smc for both the ID and Password, and then click Sign In. Launching the Virtual Appliance Configuration Manager To launch the Virtual Appliance Configuration Manager: 1. Type the following URL in a browser: https://appliance_IP:5480 2. On the log in panel, type seconfig for both the User and Password, and then click Sign In. Note: It is recommended that you change the password from the Configuration Manager on first login. The Virtual Appliance Configuration Manager displays. For information on using the Configuration Manager, refer to its online help. Connect to the API server For instructions on connecting to the API server, refer to the EMC Solutions Enabler Installation Guide. Launching SMC or the Configuration Manager 43 Deploying the SMC Virtual Appliance Updating the SMC Virtual Appliance Periodically, EMC will release security patches and hot-fixes for the Solutions Enabler Virtual Appliance. These patches and fixes are available on Powerlink in two forms: zip files and ISO images. Updating from a zip file To update an existing Virtual Appliance from a zip file: 1. Login to the web console of the exiting appliance. 2. Click Export Persistent Data to download a zip file containing Solutions Enabler persistent data to your desktop. 3. Extract the zip file to your machine. Note the location of the file encrypt_se_export_persistent_data_time-stamp.zip.gpg. You will need this file later to complete this procedure. 4. Power off the old appliance. 5. Import and deploy the new appliance in your ESX server. For instructions, refer to “Deploying the virtual appliance directly to the ESX Server” on page 36 or “Deploying the virtual appliance through a vCenter Server” on page 40, depending on your environment. 6. Login to the new appliance’s web console. 7. Click Import Persistent Data and browse to the location of the gpg file you extracted earlier in this procedure. 8. Click Import. 9. When the message Import successful appears, close the dialog. The update is complete. Updating from an ISO image To update an existing Virtual Appliance from an ISO image: 1. Upload the ISO image into the ESX Server using the VI client: a. Login to the ESX Server using the VI client. b. Select the ESX Server on the left panel. c. Select the Configuration tab on the right panel. 44 EMC SMC and SPA Installation Guide Deploying the SMC Virtual Appliance d. Select Hardware, Storage to list the datastores connected to the ESX Server. e. Right-click the datastore and select Browse Datastore. The Datastore Browser window displays. f. Upload the appliance update ISO file. g. Exit the dialog. 2. Mount the ISO image on the virtual appliance CD drive: a. Right-click the virtual appliance and select Edit Settings. b. On the Hardware tab, select CD/DVD Drive 1. c. In the right panel, select Datastore ISO File, and click Browse to locate the ISO image in the datastore. d. Select Device Status, Connected. e. Click OK to exit the dialog box. 3. Update the appliance: a. On the Console tab, go to the virtual appliance console. b. Use the Move Up/Down keys and select Appliance Update. c. Press Enter to the update. d. The update will take approximately 10 minutes, after which the screen will return to the main console. Updating the SMC Virtual Appliance 45 Deploying the SMC Virtual Appliance Deleting the SMC Virtual Appliance To delete the SMC Virtual Appliance: 1. Optional: If you plan to restore SMC and Solutions Enabler persistent data, you should back up the persistent data in the SMC Virtual Appliance Configuration Manager. 2. In the VMware management interface, power down the appliance. 3. Right-click on the appliance and select Delete From Disk. 4. Click Yes in the confirmation message. 46 EMC SMC and SPA Installation Guide 4 Invisible Body Tag Using Symmetrix Management Console This chapter introduces Symmetrix Management Console and explains where to find objects in the menus and navigation tree. ◆ ◆ ◆ ◆ ◆ Opening Symmetrix Management Console ................................... Understanding the SMC interface ................................................... Managing SMC views ....................................................................... SMC menu bar.................................................................................... SMC dialog boxes............................................................................... Using Symmetrix Management Console 48 49 50 60 72 47 Using Symmetrix Management Console Opening Symmetrix Management Console Open your web broswer, and point to the hostname (SMC server) and the port you entered (or accepted) during the installation: http://host:http_port or for a secure connection: https://host:https_port If you accepted the installation defaults, enter one of the following: http://localhost:7070 or https://localhost:8443 The EMC Symmetrix Management Web Console login window (Figure 3) appears. Figure 3 Web Console login window Type a Username and Password. If you accepted the default Initial Setup User, type smc (lowercase) for the Username and Password; otherwise, type the username you provided, and its associated password For example, your Windows username and password. Note: If you are logging into SMC for the first time, you may be prompted to also specify your SMC host-based License Number. The SMC Web Console appears. 48 EMC SMC and SPA Installation Guide Using Symmetrix Management Console Understanding the SMC interface Figure 4 describes the components of the SMC Web Console interface. Menu bar View bar The rest of this section details each of these views. Navigation tree View details The navigation tree is the roadmap to your storage array and devices. It contains folders and objects. Each folder contains a collection of objects, such as devices, directors, device groups, and so on. Use the navigation tree to find objects for monitoring and control operations. View details displays information based on which type of view is selected (see View Bar). The Properties view (shown here) displays details about the selected object in the navigation tree. When you select a folder in the navigation tree, you can select multiple items in the Properties view for a control operation. Figure 4 Components of the SMC interface Understanding the SMC interface 49 Using Symmetrix Management Console Managing SMC views This section introduces each of the SMC views (Dashboard, Properties, Config Session, Tasks, Service Session, Alerts, Command History, Replication Monitor, and QoS Monitor), and explains how to change the default SMC view. Understanding the Dashboard view The Dashboard view (Figure 5) provides a quick look at the Symmetrix arrays visible to the SMC server. To view detailed information on a particular array in this view, click it to display its Properties view. To view the navigation tree, click the vertical bar on the left side of the view and drag it to the right, or click Properties view. By default, SMC displays this view on login. For instructions on the changing this default behavior, refer to “Changing the default SMC view” on page 59. Figure 5 50 SMC — Dashboard view EMC SMC and SPA Installation Guide Using Symmetrix Management Console Understanding the Properties view Selecting an object from the navigation tree displays details about that object in the Properties view (Figure 6). This is the default view. Selecting objects Information tabs Select an object folder in the Navigation Tree and a table displays in the Properties view. Select an object in the table, and the screen splits, displaying the details about that object on the bottom. Split bar Move this bar up or down to change how much information you view on the top and bottom of the split view. Figure 6 Click the tabs to display related information. Property details Details about the selected object display on the bottom of the split screen. SMC — Properties view Managing SMC views 51 Using Symmetrix Management Console Understanding the Config Session view The Config Session view (Figure 7) lists the pending and committed configuration tasks for a Symmetrix array and provides controls for verifying and committing the tasks. Task list tabs Task list My Active Tasks: Manage your active configuration tasks. Displays the configuration task and status. My Inactive Tasks: Manage your inactive and completed tasks. My Scheduled Tasks: Manage your scheduled tasks. All Active Tasks: Lists the active tasks for all users.(view only) All Inactive Tasks: Lists the inactive tasks for all users (view only). All Scheduled Tasks: Lists the scheudled tasks for all users (view only). Config session log Control buttons Displays realtime processing messages. Schedule All: Schedule execution of all tasks. Deactivate: Move selected tasks from Active to Inactive list. Preview All: Verify all your tasks on the Active list. Commit All: Commit all your tasks on the Active list. Abort All: Abort preview or commit in progress. Activate: Move selected tasks from Inactive list to Active list. Clear: Delete selected tasks from the system permanely. Figure 7 52 SMC — Config Session view EMC SMC and SPA Installation Guide Using Symmetrix Management Console Understanding the Tasks view The Tasks view (Figure 8) provides quick access to common SMC tasks. This view is customizable, in that you can minimize any number of the task panels (Operations, Monitoring, Administration) within the view. In addition, you can also specify this as your default SMC view. For instructions, refer to “Changing the default SMC view” on page 59. In both cases, SMC will retain your setting for the next time you login. Figure 8 SMC — Tasks view Managing SMC views 53 Using Symmetrix Management Console Understanding the Service Session view The Service Session view (Figure 9) contains a list of service sessions being performed by SMC. Service Session list Displays the current service sessions for the selected Symmetrix array. Service Session log Control buttons Displays realtime processing messages. Figure 9 54 SMC — Service Session view EMC SMC and SPA Installation Guide Run: Run the selected session. Abort: Abort the selected session. Clear: Delete the selected session. Using Symmetrix Management Console Understanding the Alerts view The Alerts view (Figure 10) displays a list of alerts for all Symmetrix arrays or the selected Symmetrix array. Right-click an alert to view additional details on it, to acknowledge it, or to clear it. Alert list State: Indicates wether the alert is active or acknowledged. Severity: The alert’s severity, as defined by SYMAPI. Object: The object to which the alert is related. Message: A description of the alert. Created: Timestamp for when the alert happened. Last Modified: Timestamp. Acknowledged By: A user name. Category: SYMAPI category. Code: SYMAPI error code. Figure 10 SMC — Alerts view Managing SMC views 55 Using Symmetrix Management Console Understanding the Command History view The Command History view (Figure 11) maintains a list of actions taken by all users on the SMC installation. The Command History displays for all arrays or the selected Symmetrix array. Note: The Command History information is view only. Command history list Time: Date and time of the task. User: SMC user who performed the task. Task: Name of the task performed. Managed Object: The ID of the object affected by the task. Status: Current status of the task (config session). Description: Summary of the task. Figure 11 56 SMC — Command History view EMC SMC and SPA Installation Guide Using Symmetrix Management Console Understanding the Replication Monitor view The Replication Monitor view (Figure 12) provides progress and status for thresholds that are set for replication operations. Replication Monitor view Dashboard: Lists groups and shows the status of the Replication State and Device State with colors. Replication Monitor tabs General: Provides details about the replication operation. Performance: Provides I/O performance details. Graph: Provides selections for viewing utilization and workloads over a period of time. Threshold Event: Lists any events for the replication operation. Figure 12 SMC — Replication Monitor view Managing SMC views 57 Using Symmetrix Management Console Understanding the Quality of Service Monitor view The QoS Monitor view (Figure 13) provides performance information for the array, a device group, a storage group, or a cache partition. QoS Monitor view Dashboard: QoS monitoring allows you to view an application's performance in the categories of the system, the device group, and the cache partition. QoS Monitor tabs General: Provides performance details for the selected object. Graph: Provides selections for viewing configured metrics over a period of time. Threshold Event: Lists any QoS events. Figure 13 58 SMC — QoS Monitor view EMC SMC and SPA Installation Guide Using Symmetrix Management Console Changing the default SMC view By default, SMC opens displays the Dashboard view. However, you can change the default view to either the Properties or the Tasks view. To change the default view: 1. Change to the Tasks view. 2. In the Administration panel, under Templates and Preferences, click Set View Preferences to open the Set View Preferences dialog box. 3. Select the Default View (Dashboard, Properties or Tasks). 4. Click OK. Managing SMC views 59 Using Symmetrix Management Console SMC menu bar Storage configuration and management operations are performed by selecting an object (in the navigation tree or Properties view) and opening a dialog box from the menu bar. There are four pull-down menus in the menu bar: File, Control, and Help. File menu The File menu contains controls that are not often used. Table 1 describes the File menu items. Table 1 60 File menu Menu item Description Export Opens a dialog box from which you can select the contents of the navigation tree or the view to export to a file or an image. Refresh View Refreshes the view (from the selected object down) with the current contents of the Symmetrix database. Symmetrix Discover Opens a dialog box from which you can discover the Symmetrix arrays. Logout Terminates the user session (the server stays up). EMC SMC and SPA Installation Guide Using Symmetrix Management Console Control menu Most of the operations performed in SMC are done by selecting an object, such as an array or a device, in the navigation tree or the Properties view, and then opening a control dialog box by either right-clicking the object or clicking the Control menu in the menu bar. In addition, you can also perform an operation on multiple objects at the same time by either selecting a folder (e.g., Ungrouped) in the navigation tree or using the Shift key to select multiple objects (e.g., devices) in a view, and then right-clicking to open the Control menu. Note: When accessing the Control menu from the folder level, the menu options will remain the same; however, they will be enabled/disabled based on the selected object. Table 2 maps the Control menu, dialog box names, and specifies the object you must select to open the control dialog box. After selecting an object you can open the dialog with the right-click menu, or select Control from the menu bar. Table 2 Menu item/ Submenu Control menu (1 of 10) Dialog box name To open the dialog, right-click Symmetrix Admin (sub-menu) Service Enginuity Upgrade Preparation Perform Disk Replacement Perform Health Check Symmetrix ID Symmetrix ID Symmetrix ID View Symmetrix Audit Log Symmetrix ID Symmetrix Lock Maintenance Symmetrix ID Set Symmetrix Attributes Symmetrix ID Add Hot Spare Symmetrix ID Remove Hot Spare Data disk Reservation Admin Symmetrix ID Symmetrix Environment Data Symmetrix ID (running Enginuity Version 5771 and later) Access Controls Symmetrix ID SMC menu bar 61 Using Symmetrix Management Console Table 2 Control menu (2 of 10) Menu item/ Submenu Dialog box name To open the dialog, right-click Device Masking and Mapping Map Devices Symmetrix ID Device(s) Device group ID Any device folder (e.g., Unmapped, Mapped, etc. Fibre and Gig-E ports Unmap Devices Symmetrix ID Device group Device group ID Port Masking Local Symmetrix ID Device group folder Individual device group Fibre, Gig-E, SCSI ports Delete Masking Entry HBA iSCSI Set CHAP Authentication Delete CHAP Authentication Enable CHAP Authentication iSCSI initiator Port or Host initiator Port or Host initiator Set Radius Authenticaiton Delete Radius Authenticaiton Enable/Disable Host initiator Port or Host initiator Port or Host initiator Set Initiator Attributes HBA iSCSI Set Host Alias Flags Host alias Create Host Alias Symmetrix ID Modify Host Alias Alias Rename Initiator Alias HBA iSCSI Replace Initiator HBA iSCSI Masking Information Maintenance Local Symmetrix ID Individual HBA record (submenu) Initiator Authentication, CHAP Authentication (submenu) Initiator Authentication, Radius Authentication 62 EMC SMC and SPA Installation Guide Using Symmetrix Management Console Table 2 Control menu (3 of 10) Menu item/ Submenu Dialog box name To open the dialog, right-click Device Masking and Mapping (Continued) Masking Backup Records Symmetrix ID (submenu) Storage Group Maintenance Create Storage Group Modify Storage Group Expand Storage Group Rename Storage Group Delete Storage Group (submenu) Create Port Group Port Group Maintenance Modify Port Group Rename Port Group Delete Port Group Symmetrix ID Storage group name Storage group name Storage group name Storage group name Symmetrix ID Port group name Port group name Port group name (submenu) Create Initiator Group Initiator Group Maintenance Modify Initiator Group Rename Initiator Group Delete Initiator Group Symmetrix ID Initiator group name Initiator group name Initiator group name (submenu) Create Masking View Masking View Maintenance Rename Masking View Delete Masking View Symmetrix ID Masking view name Masking view name Port and Director Configuration Set Port Attributes (submenu) Add IPSec Policy IPSec Configuration Modify IPSec Policy Delete IPSec Policy Port Port Port Port Online (submenu) CHAP Authentication Set CHAP Authentication Delete CHAP Authentication Enable Port (submenu) Set Radius Authenticaiton Radius Authentication Delete Radius Authenticaiton Enable/Disable Host initiator Port or Host initiator Port or Host initiator iSCSI initiator Port or Host initiator Port or Host initiator SMC menu bar 63 Using Symmetrix Management Console Table 2 Menu item/ Submenu Dialog box name To open the dialog, right-click Device Configuration Device Lock Maintenance Symmetrix ID Device Device/Composite group Create Device Symmetrix ID Duplicate Device Device Change Device Configuration Device Set Device Attributes Device Set Device Identifiers Device Set Device Status Device Director Device/Composite group Delete Device Symmetrix ID Device Start Allocate/Free Thin Device Bound thin device Stop Allocate/Free Thin Device Bound thin device Form FBA Meta Symmetrix ID Add/Remove Meta Members Device Dissolve Meta Device Convert Meta Device Rename Disk Group Disk group FBA Meta Device Configuration Disk Group Configuration 64 Control menu (4 of 10) EMC SMC and SPA Installation Guide Using Symmetrix Management Console Table 2 Control menu (5 of 10) Menu item/ Submenu Dialog box name To open the dialog, right-click z/OS Configuration Map Devices Device Port CU Image Folder Unmap Devices Port CU Image Copy Mapping Port CU Image Assign Alias Addresses CU Image Remove Alias Addresses CU Image Assign Alias Range CU Image Remove Alias Range CU Image Assign Alias Count CU Image Remove Alias Count CU Image Create CKD Meta Symmetrix ID Create Group Device Group folder Create/Modify Group of group DGs Composite Group folder Add/Remove Devices Device group Rename Group Device group DG/CG Management (submenu) Delete Group RDF Group Name Set RDF Group Name Edit RDF Group Name Delete RDF Group Name Copy Devices to CG Device group RDF group RDF group RDF group Device group SMC menu bar 65 Using Symmetrix Management Console Table 2 Control menu (6 of 10) Menu item/ Submenu Dialog box name To open the dialog, right-click Device Pool Management Enable Device Device Disable Device (submenu) DATA Device Management Activate Device Deactivate Device Start Draining Device Stop Draining Device 66 Device DATA device DATA device DATA device DATA device Create Device Pool Symmetrix ID Add/Remove Pool Members Pool member Enable All Pool Members Device pool Disable All Pool Members Device pool Delete Device Pool Device pool Expand Device Pool Device pool Bind/Unbind Thin Devices Thin pool Rebind Thin Devices Bound thin device Start Write Balancing Thin pool Stop Write Balancing Thin pool EMC SMC and SPA Installation Guide Using Symmetrix Management Console Table 2 Control menu (7 of 10) Menu item/ Submenu Dialog box name To open the dialog, right-click Replication TimeFinder/Mirror Device group TimeFinder/Clone Device group TimeFinder/Snap Device group SRDF Control Device group SRDF Settings Device group (submenu) Create SRDF Group SRDF Configuration Remove SRDF Group Modify SRDF Group Delete SRDF Pair Move SRDF Pair Set SRDF/A Group Attributes Swap SRDF Group Convert SRDF Devices from Static to Dynamic Add SRDF Mirror Delete SRDF Mirror (submenu) Create Copy Session Open Replicator Session Control Set Ceiling Remote Port Symmetrix ID RA group RA group Symmetrix ID RA group RA group Symmetrix ID/Device SRDF device(s) SRDF device(s) SRDF device(s) Symmetrix ID Symmetrix ID Symmetrix ID Symmetrix ID Consistency Protection Composite group/RDF group QoS Device Migration Terminate Migration Session Migration session name Tier Management Create Tier Symmetrix ID/Tier folder Modify Tier Tier name Rename Tier Tier name Delete Tier Tier name SMC menu bar 67 Using Symmetrix Management Console Table 2 Menu item/ Submenu Control menu (8 of 10) Dialog box name To open the dialog, right-click FAST (submenu) FAST Policy Management Create Policy Modify Policy Policy name Rename Policy Policy name Delete Policy Policy name Associate FAST Policy Storage group Associate Storage Group Policy name Storage Group Association Policy name Edit Priority Policy name Configure Cross Disk Group Rule Symmetrix ID Rename Cross Disk Group Rule Symmetrix ID Delete Cross Disk Group Rule Symmetrix ID (submenu) Enable/Disable FAST FAST Control Parameters Settings 68 Symmetrix ID/FAST Policies folder Symmetrix ID Symmetrix ID Swap/Move List Symmetrix ID Swap/Move History Symmetrix ID FAST Log Symmetrix ID Approve Swap/Move Symmetrix ID Pin Devices Devices, Composite Group, or Storage Group Unpin Devices Devices, Composite Group, or Storage Group EMC SMC and SPA Installation Guide Using Symmetrix Management Console Table 2 Control menu (9 of 10) Menu item/ Submenu Dialog box name To open the dialog, right-click Optimizer Start/Stop/Lock/Unlock Symmetrix ID Enable/Disable Symmetrix ID (submenu) Settings SwapMove Approve Swap Manual Swap Manual Move Rollback Swap/Move List Swap/Move History Priority Control and Cache Partition Performance Analyzer SRDF Migration Management Symmetrix ID Symmetrix ID Symmetrix ID Symmetrix ID Symmetrix ID Symmetrix ID Symmetrix ID Log Symmetrix ID Create Dynamic Cache Partition Symmetrix ID Modify Dynamic Cache Partition Cache partition Rename Dynamic Cache Partition Cache partition Remove Dynamic Cache Partition Cache partition Dynamic Cache Partition Setting Symmetrix ID Assign Dynamic Cache Partition Device(s) Device group RDF group Enable Symmetrix Priority Control Symmetrix ID Assign Symmetrix Priority Device(s) Device group Symmetrix ID Trend Symmetrix ID Device group Snapshot Symmetrix ID Device group Replace Migration session Terminate Migration session SMC menu bar 69 Using Symmetrix Management Console Table 2 Menu item/ Submenu Dialog box name To open the dialog, right-click Virtualization Domain Management Create Virtualization Domain Virtualization Domains folder Modify Virtualization Domain Virtualization domain Delete Virtualization Domain Virtualization domain Add Thin Pool Virtualization domain Modify Thin Pool Thin pool Remove Thin Pool Thin pool Add Pre-Created LUN Policy Thin pool Modify Pre-Created LUN Policy Policy Remove Pre-Created LUN Policy Policy Adopt LUNs Thin pool Details Alert Clear Alert Alert Acknowledge Alert Alert Alerts 70 Control menu (10 of 10) EMC SMC and SPA Installation Guide Using Symmetrix Management Console Help menu options Table 3 Table 3 describes the Help menu items. Help menu Menu item Description Content, Index, Search Opens the SMC online help. Symmetrix Session Informationa Displays information about the current Symmetrix session. Web Server Session Informationa Displays information about the current web server session. Who is Logged On Displays information about logged on users. About EMC Symmetrix Management Console Displays version and copyright information about the SMC software. a. In previous releases of SMC, this option was located in the File menu. SMC menu bar 71 Using Symmetrix Management Console SMC dialog boxes Storage management and configuration operations are set within control dialog boxes. When a dialog has OK, the operation or task is completed immediately. When a dialog has the button Add to Config Session List, the task is moved to the Config Session view for processing. Opens the Filter dialog from which you specify criteria to narrow the devices displayed in the Available Devices list. To select multiple items in a continous range, hold the Shift key while clicking the first and last items in the range. To select multiple items in non continous ranges, hold the CTRL key while clicking the individual items. Click OK to perform the action and close the dialog box. Click Add to Config Session List to send the action to the Config Session view for processing. 72 EMC SMC and SPA Installation Guide Click Cancel to close the dialog box without performing the action. 5 Invisible Body Tag Using Symmetrix Performance Analyzer This chapter introduces Symmetrix Performance Analyzer, describes each of the four views, and explains how to configure SPA using the Administration menu. ◆ ◆ Opening Symmetrix Performance Analyzer.................................. 74 SPA Overview .................................................................................... 75 Using Symmetrix Performance Analyzer 73 Using Symmetrix Performance Analyzer Opening Symmetrix Performance Analyzer The SPA installation is layered over the SMC software, therefore the most common gateway to SPA is through SMC, however, SPA can also be opened independently of SMC. From SMC From a web browser Right-click an object from the SMC navigation tree, such as a Symmetrix array, and select Performance Analyzer, and then Snapshot, or Trend. Open the web browser and enter: http://localhost:7070/spa or http://localhost:8443/spa The EMC Symmetrix Performance Analyzer login window (Figure 14) appears. Figure 14 Symmetrix Performance Analyzer login window Type your SMC Username and Password. When using SPA, you have the same access controls and privileges as you have in SMC. 74 EMC SMC and SPA Installation Guide Using Symmetrix Performance Analyzer SPA Overview SPA provides these views for analyzing Symmetrix array data. ◆ Dashboards — The Dashboards view provides supplied views of the Symmetrix arrays, and allows you to define and manage your own dashboard. A dashboard can contain charts or a Symmetrix heat map. ◆ Real Time — The Real Time view provides high frequency data collection and displays the selected metrics as they become available. This view also allows for data saves for a 1-hour time window. ◆ Diagnostic — The Diagnostic view analyzes high- and low-level metrics. It provides an intuitive root cause analysis engine that provides access to all available metrics and includes composite comparison charts of related metrics. It also has device-level views, and typically focuses on a short time, such as a couple of hours. ◆ Snapshot — The Snapshot view displays a calculation of the collected data over time and shows the relationship between the physical (array, disk, director) and logical (device group, application) components of the array. ◆ Trend — The Trend view can best show the consumption of resources over time. The Trend view also supports linear projection lines, which can be used with user-defined thresholds as the basis for capacity planning. In addition, there are several dialogs that you can configure before using SPA, as follows: Table 4 SPA Administration dialog box descriptions Administration dialog box Description Data Collection Registration Register the Symmetrix arrays for data collection. Set Global Policy Set the data saving requirements, such as polling times. Thresholds and Alerts The performance thresholds that you set become the defaults in the Alert Configuration dialog box. Create both in one dialog. Alert Management Create, modify, and delete alerts for threshold breaches. Real Time Trace Management Schedule a real time data trace. SPA Overview 75 Using Symmetrix Performance Analyzer Table 4 76 SPA Administration dialog box descriptions Administration dialog box Description Query Management Query the SPA database ad hoc or on a schedule and export the results. Metric Management Customize the key performance indicators for your environment. Filter any nonessential metrics from the SPA view. User Preferences Set the default time range for the Snapshot and Trend views only. The time range can be adjusted in each SPA view. User Defined Dashboards Define your own SPA dashboard; add charts or a Symmetrix array heat map. Modify existing dashboards. Database Management Backup and restore the SPA database. EMC SMC and SPA Installation Guide Using Symmetrix Performance Analyzer Dashboards view The Dashboards view (Figure 15) provides a quick overall look at the storage environment. SPA provides a few dashboards, and new dashboards can be user-defined and organized in folders. Dashboards Dashboards display in the navigation tree. Use the right-click or Administration menu to add, modify, or organize your dashboards. Figure 15 Heat Map This dashboard displays a heat map of one entire Symmetrix; front-end directors and ports, cache, back-end directors and ports and the disk distribution. SPA — Dashboards view SPA Overview 77 Using Symmetrix Performance Analyzer Real Time view Use the Real Time view (Figure 16) to analyze an hour of high-frequency data (2 - 5 second data points). Format Format: Represents a range of counts that SPA collects. in Real Time, the data displays in very high frequency (2 seconds). The Format option allows tables to show minimum and maximum data that is averaged out in 5 or 10 minutes intervals. Explore Chart display The Explore (tab) view provides additional performance metrics you can use to create your own combinations of metrics in a chart. Explore charts/graphs can be saved, printed, and deleted. Figure 16 78 Time Range Time Range: Displays a drop-down list of saved captures. Capture: Saves the previous hour’s data in a file. Selected Time Range: Allows a scroll through an hour time range. SPA — Real Time view EMC SMC and SPA Installation Guide User-defined charts display in this area. When needed, a scroll bar allows easy viewing for multiple charts. GEN-001244 Using Symmetrix Performance Analyzer Diagnostic view Use the Diagnostic view (Figure 17) to perform root cause analysis (5 minute data points). Navigation Tables Time Range Tabbed tables: Provides numerical performance information for the selected tab. Double-click an object in the row to select it and open a new tab. Dashboard Time Range: Displays a user-selectable box for the start time and end time. Explore The Dashboard shows the distribution of the workload among all instances in the table above. Use the magnifier icon to open the chart in a larger window. Use the chart icon to toggle the active chart between bar chart and line graph. The Explore (tab) view provides additional performance metrics you can use to create your own combinations of metrics in a chart. Explore charts/graphs can be saved, printed, and deleted. GEN-001243 Figure 17 SPA — Diagnostic view SPA Overview 79 Using Symmetrix Performance Analyzer Snapshot View Use the Snapshot view (Figure 18) to evaluate performance over time (15 minute data points). Time Range Quickly change the time range on the view. Set the default time range in the Administration menu. View Bar Dashboards: Create your own SPA view. Snapshot: Displays default charts for time selected. Trend: Displays performance trends for planning. Diagnostic: Displays metrics for root cause analysis. Real Time: Displays high frequency data points for analysis. Navigation Tree The navigation tree is the roadmap to your storage array and devices. It contains folders and objects. The navigation tree is used in Snapshot and Trend views; tabular navigation is used in Real Time and Diagnostic views. Figure 18 80 SPA — Snapshot view EMC SMC and SPA Installation Guide Performance Details The graphs in this view display performance data organized by physical hardware (top), logical software (middle), and time (bottom). GEN-001245 Using Symmetrix Performance Analyzer Trend view Use the Trend view (Figure 19) for trending and capacity planning. Trend View Displays performance data for capacity planning and trending. Navigation Tree The navigation tree contains folders and objects. Each folder contains a collection of objects, such as disks, directors, device groups, and pools. Use the navigation tree to find objects in Snapshot and Trend views. Time Range Time Range: Displays a user-selectable box for the start time and end time. Trend Chart Icons Left icon: Toggle chart from bar chart to line chart. Middle icon: Open linear projection; set forecast points and show thresholds. Right icon: Open chart in larger, separate window. GEN-001246 Figure 19 SPA — Trend view SPA Overview 81 Using Symmetrix Performance Analyzer 82 EMC SMC and SPA Installation Guide A Security features This appendix provides a brief overview of the security features used to secure access to SMC, SPA, and Symmetrix arrays. The SMC help system contains specific configuration procedures required to enable these features. References to those procedures are provided where appropriate. ◆ ◆ Authentication .................................................................................... 84 Authorization ..................................................................................... 85 Security features 83 Security features Authentication SMC/SPA supports the following types of authentication: ◆ Windows (local and domain based): Users login with Windows domain\username and password (if they have a Windows account on the SMC server). ◆ LDAP: Users login with their LDAP-SSL username and password (if they have a user account stored on a LDAP-SSL server). To use this method, an SMC Administrator or SecurityAdmin must set up LDAP-SSL authentication in SMC. Configuring authentication in the SMC online help contains instructions. ◆ Local SMC users: Users login with their SMC username and password (if they have a local SMC user account). To use this method, an SMC Initial Setup User, Administrator, or SecurityAdmin must create a local SMC user account for the user. Local user accounts are stored locally on the SMC server host and work in much the same way as the other methods to validate user credentials. Adding local SMC user accounts in the SMC online help contains instructions. 84 EMC SMC and SPA Installation Guide Security features Authorization User authorization is a tool for restricting the management operations users can perform on a Symmetrix array. By default, authorization on a Symmetrix array is enabled for SMC users, regardless of whether it has been enabled on the Symmetrix array. When configuring user authorization, an Administrator or SecurityAdmin maps individual users or groups of users to specific roles, which determine the operations the users can perform. Roles are typically set for an entire Symmetrix array. However, when adding roles for use with the Storage Pool Management (SPM) feature, they are set for the component level (thin pool and storage group). Understanding Storage Pool Management in the SMC online help contains more information on SPM. User roles The following introduces the available roles. Roles and their associated permissions in the SMC online help provides more details on the permissions associated with each role. ◆ None — Provides no permissions. ◆ Monitor — Performs read-only (passive) operations on a Symmetrix array excluding the ability to read the audit log or Access Control definitions. ◆ StorageAdmin — Performs all management (active or control) operations on a Symmetrix array in addition to all Monitor operations. This role does not allow users to perform security operations. ◆ Administrator — Performs all operations on a Symmetrix array, including security operations in addition to all StorageAdmin and Monitor operations. ◆ SecurityAdmin — Performs security operations on a Symmetrix array in addition to all Monitor operations. ◆ Auditor — Grants the ability to view, but not modify, security settings for a Symmetrix array (including reading the audit log, symacl list, and symauth) in addition to all Monitor operations. This is the minimum role required to view the Symmetrix audit log. Authorization 85 Security features In addition to the above user roles, SMC includes two administrative roles: ◆ SMC Initial Setup User — Defined during installation, this temporary role provides administrator-like permissions for the purpose of adding local users and roles to SMC. For more information on the Initial Setup User, see the online help. ◆ StorageAdmin - Virtualization Domain — Exists for the sole purpose of setting up an Storage Pool Management environment. Individual and group roles Users gain access to a Symmetrix array or component either directly through a role assignment and/or indirectly through membership in a user group that has a role assignment. User groups enable administrators to assign roles to multiple users simultaneously. User groups are created on the SMC server according to its operating system and assigned roles with SMC. If a user has two different role assignments (one as an individual and one as a member of a group), the permissions assigned to the user will be combined. For example, if a user is assigned a Monitor role and a StorageAdmin role through a group, the user will be granted Monitor and StorageAdmin rights. User IDs Users and user groups are mapped to their respective roles by IDs. These IDs consist of a three-part string in the form: Type:Domain\Name Where: Type Specifies the type of security authority used to authenticate the user or group. Possible types are: L Indicates a user or group authenticated by LDAP. In this case, Domain specifies the server name. For example: L:danube\Finance Indicates that user group Finance logged in through LDAP server Danube. 86 EMC SMC and SPA Installation Guide Security features C Indicates a user or group authenticated by the SMC server. For example: C:Boston\Legal Indicates that user group Legal logged in through SMC sever Boston. H Indicates a user or group authenticated by logging into a local account on a Windows host. In this case, Domain specifies the hostname. For example: H:jupiter\mason Indicates that user mason logged in on host jupiter. D Indicates a user or group authenticated by a Windows domain. In this case, Domain specifies the domain or realm name. For example: D:sales\putman Indicates user putman logged in through a Windows domain sales. V Name Indicates a user or group authenticated by a virtualization domain. In this case, Domain specifies virtualization domain name. Specifies the username relative to that authority. It cannot be longer than 32 characters and spaces are allowed if delimited with quotes. Usernames can be for individual users or user groups. Within role definitions, IDs can be either fully qualified (as above), partially qualified, unqualified. When the Domain portion of the ID string is an asterisk (*), the asterisk is treated as a wildcard, meaning any host or domain. For example: D:ENG\jones Fully qualified path with a domain and username. D:*\jones Partially qualified that matches username jones with any domain. Authorization 87 Security features H:HOST\jones Fully qualified path with a hostname and username. H:*\jones Partially qualified that matches username jones within any host. jones Unqualified username that matches any jones in any domain on any host. In the event that a user is matched by more than one mapping, the user authorization mechanism uses the more specific mapping. If an exact match (e.g., D:sales\putman) is found, that is used; if a partial match (e.g., D:*\putman) is found, that is used; if an unqualified match (e.g., putman) is found, that is used; otherwise, the user is assigned a role of None. 88 EMC SMC and SPA Installation Guide A Third-Party Copyright notices This appendix contains third-party copyright notices. ◆ ◆ GNU LESSER GENERAL PUBLIC LICENSE................................ 90 MySQL............................................................................................... 101 Third-Party Copyright notices 89 Third-Party Copyright notices GNU LESSER GENERAL PUBLIC LICENSE Version 2.1, February 1999 Copyright (C) 1991, 1999 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. [This is the first released version of the Lesser GPL. It also counts as the successor of the GNU Library Public License, version 2, hence the version number 2.1.] Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public Licenses are intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This license, the Lesser General Public License, applies to some specially designated software packages--typically libraries--of the Free Software Foundation and other authors who decide to use it. You can use it too, but we suggest you first think carefully about whether this license or the ordinary General Public License is the better strategy to use in any particular case, based on the explanations below. When we speak of free software, we are referring to freedom of use, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish); that you receive source code or can get it if you want it; that you can change the software and use pieces of it in new free programs; and that you are informed that you can do these things. To protect your rights, we need to make restrictions that forbid distributors to deny you these rights or to ask you to surrender these rights. These restrictions translate to certain responsibilities for you if you distribute copies of the library or if you modify it. For example, if you distribute copies of the library, whether gratis or for a fee, you must give the recipients all the rights that we gave you. You must make sure that they, too, receive or can get the source code. If you link other code with the library, you must provide complete object files to the recipients, so that they can relink them with the 90 EMC SMC and SPA Installation Guide Third-Party Copyright notices library after making changes to the library and recompiling it. And you must show them these terms so they know their rights. We protect your rights with a two-step method: (1) we copyright the library, and (2) we offer you this license, which gives you legal permission to copy, distribute and/or modify the library. To protect each distributor, we want to make it very clear that there is no warranty for the free library. Also, if the library is modified by someone else and passed on, the recipients should know that what they have is not the original version, so that the original author's reputation will not be affected by problems that might be introduced by others. Finally, software patents pose a constant threat to the existence of any free program. We wish to make sure that a company cannot effectively restrict the users of a free program by obtaining a restrictive license from a patent holder. Therefore, we insist that any patent license obtained for a version of the library must be consistent with the full freedom of use specified in this license. Most GNU software, including some libraries, is covered by the ordinary GNU General Public License. This license, the GNU Lesser General Public License, applies to certain designated libraries, and is quite different from the ordinary General Public License. We use this license for certain libraries in order to permit linking those libraries into non-free programs. When a program is linked with a library, whether statically or using a shared library, the combination of the two is legally speaking a combined work, a derivative of the original library. The ordinary General Public License therefore permits such linking only if the entire combination fits its criteria of freedom. The Lesser General Public License permits more lax criteria for linking other code with the library. We call this license the "Lesser" General Public License because it does Less to protect the user's freedom than the ordinary General Public License. It also provides other free software developers Less of an advantage over competing non-free programs. These disadvantages are the reason we use the ordinary General Public License for many libraries. However, the Lesser license provides advantages in certain special circumstances. For example, on rare occasions, there may be a special need to encourage the widest possible use of a certain library, so that it becomes a de-facto standard. To achieve this, non-free programs GNU LESSER GENERAL PUBLIC LICENSE 91 Third-Party Copyright notices must be allowed to use the library. A more frequent case is that a free library does the same job as widely used non-free libraries. In this case, there is little to gain by limiting the free library to free software only, so we use the Lesser General Public License. In other cases, permission to use a particular library in non-free programs enables a greater number of people to use a large body of free software. For example, permission to use the GNU C Library in non-free programs enables many more people to use the whole GNU operating system, as well as its variant, the GNU/Linux operating system. Although the Lesser General Public License is Less protective of the users' freedom, it does ensure that the user of a program that is linked with the Library has the freedom and the wherewithal to run that program using a modified version of the Library. The precise terms and conditions for copying, distribution and modification follow. Pay close attention to the difference between a "work based on the library" and a "work that uses the library". The former contains code derived from the library, whereas the latter must be combined with the library in order to run. GNU LESSER GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License Agreement applies to any software library or other program which contains a notice placed by the copyright holder or other authorized party saying it may be distributed under the terms of this Lesser General Public License (also called "this License"). Each licensee is addressed as "you". A "library" means a collection of software functions and/or data prepared so as to be conveniently linked with application programs (which use some of those functions and data) to form executables. The "Library", below, refers to any such software library or work which has been distributed under these terms. A "work based on the Library" means either the Library or any derivative work under copyright law: that is to say, a work containing the Library or a portion of it, either verbatim or with modifications and/or translated straightforwardly into another language. (Hereinafter, translation is included without limitation in the term "modification".) "Source code" for a work means the preferred form of the work for making modifications to it. For a library, complete source code 92 EMC SMC and SPA Installation Guide Third-Party Copyright notices means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the library. Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running a program using the Library is not restricted, and output from such a program is covered only if its contents constitute a work based on the Library (independent of the use of the Library in a tool for writing it). Whether that is true depends on what the Library does and what the program that uses the Library does. 1. You may copy and distribute verbatim copies of the Library's complete source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and distribute a copy of this License along with the Library. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Library or any portion of it, thus forming a work based on the Library, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a. The modified work must itself be a software library. b. You must cause the files modified to carry prominent notices stating that you changed the files and the date of any change. c. You must cause the whole of the work to be licensed at no charge to all third parties under the terms of this License. d. If a facility in the modified Library refers to a function or a table of data to be supplied by an application program that uses the facility, other than as an argument passed when the facility is invoked, then you must make a good faith effort to ensure that, in the event an application does not supply such function or table, the facility still operates, and performs whatever part of its purpose remains meaningful. GNU LESSER GENERAL PUBLIC LICENSE 93 Third-Party Copyright notices (For example, a function in a library to compute square roots has a purpose that is entirely well-defined independent of the application. Therefore, Subsection 2d requires that any application-supplied function or table used by this function must be optional: if the application does not supply it, the square root function must still compute square roots.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Library, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Library, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Library. In addition, mere aggregation of another work not based on the Library with the Library (or with a work based on the Library) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may opt to apply the terms of the ordinary GNU General Public License instead of this License to a given copy of the Library. To do this, you must alter all the notices that refer to this License, so that they refer to the ordinary GNU General Public License, version 2, instead of to this License. (If a newer version than version 2 of the ordinary GNU General Public License has appeared, then you can specify that version instead if you wish.) Do not make any other change in these notices. Once this change is made in a given copy, it is irreversible for that copy, so the ordinary GNU General Public License applies to all subsequent copies and derivative works made from that copy. This option is useful when you wish to copy part of the code of the Library into a program that is not a library. 94 EMC SMC and SPA Installation Guide Third-Party Copyright notices 4. You may copy and distribute the Library (or a portion or derivative of it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange. If distribution of object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place satisfies the requirement to distribute the source code, even though third parties are not compelled to copy the source along with the object code. 5. A program that contains no derivative of any portion of the Library, but is designed to work with the Library by being compiled or linked with it, is called a "work that uses the Library". Such a work, in isolation, is not a derivative work of the Library, and therefore falls outside the scope of this License. However, linking a "work that uses the Library" with the Library creates an executable that is a derivative of the Library (because it contains portions of the Library), rather than a "work that uses the library". The executable is therefore covered by this License. Section 6 states terms for distribution of such executables. When a "work that uses the Library" uses material from a header file that is part of the Library, the object code for the work may be a derivative work of the Library even though the source code is not. Whether this is true is especially significant if the work can be linked without the Library, or if the work is itself a library. The threshold for this to be true is not precisely defined by law. If such an object file uses only numerical parameters, data structure layouts and accessors, and small macros and small inline functions (ten lines or less in length), then the use of the object file is unrestricted, regardless of whether it is legally a derivative work. (Executables containing this object code plus portions of the Library will still fall under Section 6.) Otherwise, if the work is a derivative of the Library, you may distribute the object code for the work under the terms of Section 6. Any executables containing that work also fall under Section 6, whether or not they are linked directly with the Library itself. GNU LESSER GENERAL PUBLIC LICENSE 95 Third-Party Copyright notices 6. As an exception to the Sections above, you may also combine or link a "work that uses the Library" with the Library to produce a work containing portions of the Library, and distribute that work nder terms of your choice, provided that the terms permit modification of the work for the customer's own use and reverse engineering for debugging such modifications. You must give prominent notice with each copy of the work that the Library is used in it and that the Library and its use are covered by this License. You must supply a copy of this License. If the work during execution displays copyright notices, you must include the copyright notice for the Library among them, as well as a reference directing the user to the copy of this License. Also, you must do one of these things: a. Accompany the work with the complete corresponding machine-readable source code for the Library including whatever changes were used in the work (which must be distributed under Sections 1 and 2 above); and, if the work is an executable linked with the Library, with the complete machine-readable "work that uses the Library", as object code and/or source code, so that the user can modify the Library and then relink to produce a modified executable containing the modified Library. (It is understood that the user who changes the contents of definitions files in the Library will not necessarily be able to recompile the application to use the modified definitions.) b. Use a suitable shared library mechanism for linking with the Library. A suitable mechanism is one that (1) uses at run time a copy of the library already present on the user's computer system, rather than copying library functions into the executable, and (2) will operate properly with a modified version of the library, if the user installs one, as long as the modified version is interface-compatible with the version that the work was made with. c. Accompany the work with a written offer, valid for at least three years, to give the same user the materials specified in Subsection 6a, above, for a charge no more than the cost of performing this distribution. d. If distribution of the work is made by offering access to copy from a designated place, offer equivalent access to copy the above specified materials from the same place. 96 EMC SMC and SPA Installation Guide Third-Party Copyright notices e. Verify that the user has already received a copy of these materials or that you have already sent this user a copy. For an executable, the required form of the "work that uses the Library" must include any data and utility programs needed for reproducing the executable from it. However, as a special exception, the materials to be distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. It may happen that this requirement contradicts the license restrictions of other proprietary libraries that do not normally accompany the operating system. Such a contradiction means you cannot use both them and the Library together in an executable that you distribute. 7. You may place library facilities that are a work based on the Library side-by-side in a single library together with other library facilities not covered by this License, and distribute such a combined library, provided that the separate distribution of the work based on the Library and of the other library facilities is otherwise permitted, and provided that you do these two things: a. Accompany the combined library with a copy of the same work based on the Library, uncombined with any other library facilities. This must be distributed under the terms of the Sections above. b. Give prominent notice with the combined library of the fact that part of it is a work based on the Library, and explaining where to find the accompanying uncombined form of the same work. 8. You may not copy, modify, sublicense, link with, or distribute the Library except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense, link with, or distribute the Library is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 9. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Library or its derivative works. These GNU LESSER GENERAL PUBLIC LICENSE 97 Third-Party Copyright notices actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Library (or any work based on the Library), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Library or works based on it. 10. Each time you redistribute the Library (or any work based on the Library), the recipient automatically receives a license from the original licensor to copy, distribute, link with or modify the Library subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties with this License. 11. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Library at all. For example, if a patent license would not permit royalty-free redistribution of the Library by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Library. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply, and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that ystem; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. 98 EMC SMC and SPA Installation Guide Third-Party Copyright notices This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 12. If the distribution and/or use of the Library is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Library under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 13. The Free Software Foundation may publish revised and/or new versions of the Lesser General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Library specifies a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Library does not specify a license version number, you may choose any version ever published by the Free Software Foundation. 14. If you wish to incorporate parts of the Library into other free programs whose distribution conditions are incompatible with these, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND GNU LESSER GENERAL PUBLIC LICENSE 99 Third-Party Copyright notices PERFORMANCE OF THE LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. 100 EMC SMC and SPA Installation Guide Third-Party Copyright notices MySQL MySQL is a registered trademark of MySQL AB in the United States, the European Union and other countries. MySQL 101 Third-Party Copyright notices 102 EMC SMC and SPA Installation Guide