Page 5 - Contents
Brocade SMI Agent User’s Guide v 53-1001778-01 Contents About This Document In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix How this document is organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix Supported hardware and so...
Page 9 - In this chapter
Brocade SMI Agent User’s Guide ix 53-1001778-01 About This Document In this chapter • How this document is organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix • Supported hardware and software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x • What’...
Page 10 - Supported hardware and software
x Brocade SMI Agent User’s Guide 53-1001778-01 Supported hardware and software In those instances in which procedures or parts of procedures documented here apply to some switches but not to others, this guide identifies exactly which switches are supported and which are not. Although many different...
Page 11 - What’s new in this document; Text formatting
Brocade SMI Agent User’s Guide xi 53-1001778-01 • Brocade 8000 Application Appliance • Brocade 8470 switch • Brocade VA-40FC switch • Brocade 12000 director (only on Fabric OS 5.0.x) • Brocade 24000 director (single domain only) • Brocade 48000 director • Brocade Encryption Switch • Brocade Multipro...
Page 12 - Key terms; Notice to the reader
xii Brocade SMI Agent User’s Guide 53-1001778-01 italic text Provides emphasisIdentifies variablesIdentifies class propertiesIdentifies paths and Internet addressesIdentifies document titles code text Identifies CLI outputIdentifies command syntax examples For readability, command names in the narra...
Page 13 - Additional information; Brocade resources; Other industry resources
Brocade SMI Agent User’s Guide xiii 53-1001778-01 Additional information This section lists additional Brocade and industry-specific documentation that you might find helpful. Brocade resources The following SMI-A documentation can be obtained from developer support at Brocade: • Brocade SMI Agent I...
Page 14 - Getting technical help
xiv Brocade SMI Agent User’s Guide 53-1001778-01 For information about the Fibre Channel industry, visit the Fibre Channel Industry Association Web site: http://www.fibrechannel.org Getting technical help Contact your switch support supplier for hardware, firmware, and software support, including pr...
Page 15 - Brocade SMI Agent support
Brocade SMI Agent User’s Guide xv 53-1001778-01 • Brocade 8470 —On the top of the chassis • Brocade 12000, 24000, and 48000 —Inside the chassis next to the power supply bays • Brocade DCX —On the bottom right on the port side of the chassis • Brocade DCX-4S—On the bottom right on the port side of th...
Page 16 - Document feedback
xvi Brocade SMI Agent User’s Guide 53-1001778-01 Document feedback Quality is our first concern at Brocade and we have made every effort to ensure the accuracy and completeness of this document. However, if you find an error or an omission, or you think that a topic needs further development, we wan...
Page 17 - Chapter; Overview
Brocade SMI Agent User’s Guide 1 53-1001778-01 Chapter 1 Overview In this chapter • Common Information Model (CIM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 • Brocade SMI-S Initiative . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 • ...
Page 18 - Brocade SMI-S Initiative; Brocade SMI Agent; C I M; Storage; SMI; Events
2 Brocade SMI Agent User’s Guide 53-1001778-01 Brocade SMI-S Initiative 1 Brocade SMI-S Initiative Storage Management Initiative (SMI) is a broad-based initiative sponsored by the Storage Networking Industry Association (SNIA) that is standardizing all aspects of storage management for multivendor s...
Page 22 - Starting the SMI-A as a service; Stop the Brocade SMI Agent
6 Brocade SMI Agent User’s Guide 53-1001778-01 Stop the Brocade SMI Agent 2 On Windows: <SMIAgent> \agent\server\jserver\bin\start_server.bat On Windows, you can also click Start > Programs > SMIAgent > Start CIMOM. The SMI-A is now ready to use. Starting the SMI-A as a service 1. Typ...
Page 23 - Stopping the SMI-A as a service
Brocade SMI Agent User’s Guide 7 53-1001778-01 Service Location Protocol (SLP) support 2 Stopping the SMI-A when mutual authentication for clients is enabled 1. Modify the stop_server script to specify the CLASSPATH for the WbemClient.properties file. (See “Client configuration to use client certifi...
Page 24 - slptool commands
8 Brocade SMI Agent User’s Guide 53-1001778-01 Service Location Protocol (SLP) support 2 • slptool script that starts up the slptool platform-specific program • slptool program that can be used to verify that SLP is operating properly. A different slptool exists for Solaris, Linux, AIX, and Windows....
Page 26 - SLP on Windows; Installing SLP on Windows; Starting SLP on Windows
10 Brocade SMI Agent User’s Guide 53-1001778-01 Service Location Protocol (SLP) support 2 # <SMIAgent> /agent/bin/slptool findattrs service:wbem:http://192.168.0.100:5988 # <SMIAgent> /agent/bin/slptool findattrs service:wbem:https://192.168.0.100:5989 SLP on Windows This section describ...
Page 27 - Disable HTTP for security reasons; Connection monitoring
Brocade SMI Agent User’s Guide 11 53-1001778-01 Disable HTTP for security reasons 2 Verifying that the SLP service is correctly installed and operating 1. Start the SLP service and SMI-A. 2. Open a command prompt via Start > Programs > Accessories > Command Prompt. 3. Change to the director...
Page 28 - Enable multi-homed support
12 Brocade SMI Agent User’s Guide 53-1001778-01 Enable multi-homed support 2 Enable multi-homed support The Brocade SMI Agent supports multi-homed hosts; that is, hosts configured with multiple IPs. This means that you can configure which IP address the SMI Agent should use for Event and ARR registr...
Page 29 - Brocade SMI Agent Configuration
Brocade SMI Agent User’s Guide 13 53-1001778-01 Chapter 3 Brocade SMI Agent Configuration In this chapter • About the Brocade SMI Agent Configuration Tool . . . . . . . . . . . . . . . . . . . . . 13 • Launch the Brocade SMI-A Configuration Tool . . . . . . . . . . . . . . . . . . . . . . . 15 • Pro...
Page 31 - Launch the Brocade SMI-A Configuration Tool; Launching the Brocade SMI Agent Configuration Tool (Windows)
Brocade SMI Agent User’s Guide 15 53-1001778-01 Launch the Brocade SMI-A Configuration Tool 3 Launch the Brocade SMI-A Configuration Tool Because this is a graphical tool, for Linux, Solaris, and AIX, you must be on a console with an XWindows Manager or, if you are working remotely, export the displ...
Page 32 - Proxy connections; Reloading provider.xml on fabric segmentation; Adding proxy connections
16 Brocade SMI Agent User’s Guide 53-1001778-01 Proxy connections 3 Proxy connections The SMI-A installation wizard automatically configures the provider.xml file with the fabric information that is added during the installation process. This section describes how you can add or remove proxy entries...
Page 33 - Removing proxy connections; Login failure status information
Brocade SMI Agent User’s Guide 17 53-1001778-01 Proxy connections 3 The configuration values for the new fabric are displayed in the content pane. The value in the Status column is Not Connected, which means that the proxy entry is configured but the SMI-A is not connected to the fabric. FIGURE 5 Pr...
Page 34 - Access control
18 Brocade SMI Agent User’s Guide 53-1001778-01 Access control 3 Access control An SMI client uses a two-level login: one login to the SMI-A and another login to the proxy switch to gain access to a fabric. The SMI-A has a limitation of one connection per fabric, so all SMI clients share the same co...
Page 35 - Mapping an SMI-A user to a switch user
Brocade SMI Agent User’s Guide 19 53-1001778-01 Access control 3 Mapping an SMI-A user to a switch user 1. Launch the Brocade SMI Agent Configuration Tool. 2. Click User Mapping in the menu tree (see Figure 6 on page 19). FIGURE 6 User mapping 3. Click the Stop Server to stop the SMI-A, if it is run...
Page 36 - Setting up default SMI-A user mapping
20 Brocade SMI Agent User’s Guide 53-1001778-01 Access control 3 The value in the Status column changes from Not Persisted to Persisted, which means the values are persisted to the provider.xml configuration file. Setting up default SMI-A user mapping You can set up a default mapping that applies to...
Page 37 - SMI Agent security
Brocade SMI Agent User’s Guide 21 53-1001778-01 SMI Agent security 3 FIGURE 9 User Mapping Configuration dialog box 6. Click Apply. The value in the Status column changes from Not Persisted to Persisted. Limitations of SMI-A user-to-switch user mapping • Indications are not filtered based on the SMI...
Page 38 - Mutual authentication setup; Configuring mutual authentication for clients
22 Brocade SMI Agent User’s Guide 53-1001778-01 SMI Agent security 3 Mutual authentication setup Before you enable mutual authentication for clients and indications, you need to do the following so the Configuration Tool will know the location of the certificate files: • Configure the WbemClient.pro...
Page 39 - Configuring mutual authentication for indications
Brocade SMI Agent User’s Guide 23 53-1001778-01 SMI Agent security 3 b. Configure the WBEM client to use client certificates to communicate with the SMI-A. (See “Client configuration to use client certificates” on page 48.) The changes take effect when you restart the server. Click Start Server to r...
Page 40 - Configuring HTTP access
24 Brocade SMI Agent User’s Guide 53-1001778-01 SMI Agent security 3 FIGURE 10 Mutual authentication for indications Configuring HTTP access When HTTP access is disabled, only HTTPS access is available to the clients. The SMI-A server must be stopped to enable HTTP access, and must be running to dis...
Page 41 - Importing client certificates
Brocade SMI Agent User’s Guide 25 53-1001778-01 SMI Agent security 3 FIGURE 11 HTTP access Importing client certificates If you enable mutual authentication for clients or mutual authentication for indications, you can import a client certificate into the SMI Agent server truststore. This certificat...
Page 42 - Exporting server certificates
26 Brocade SMI Agent User’s Guide 53-1001778-01 SMI Agent security 3 FIGURE 12 Importing client certificates 3. Enter information for the client certificate to be used for mutual authentication for clients. a. Type the path of the client certificate in the Certificate File Name field, or click Selec...
Page 44 - Configuring user authentication
28 Brocade SMI Agent User’s Guide 53-1001778-01 SMI Agent security 3 FIGURE 14 Viewing and deleting client certificates in server truststore 3. Click Client Authentication or Indication Authentication to view the corresponding list of certificates. 4. Select the certificate in the left side of the p...
Page 46 - Encoding proxy connection details
30 Brocade SMI Agent User’s Guide 53-1001778-01 SMI Agent security 3 Encoding proxy connection details For additional security you can encode the contents of the provider.xml file. 1. Launch the Brocade SMI Agent Configuration Tool. 2. Click Encode Proxy Details in the menu tree (see Figure 16 ). Th...
Page 47 - SMI Agent service configuration and removal; Configuring or removing the SMI Agent as a service
Brocade SMI Agent User’s Guide 31 53-1001778-01 SMI Agent service configuration and removal 3 SMI Agent service configuration and removal You must have Administrator privileges (Windows) or root/admin privileges (Linux, Solaris, and AIX) to configure or remove the SMI Agent as a service. This option...
Page 48 - Port configuration; Configure HTTP and HTTPS ports; Configuring the HTTP and HTTPS ports
32 Brocade SMI Agent User’s Guide 53-1001778-01 Port configuration 3 Port configuration This section describes how to configure the HTTP, HTTPS, ARR, and Eventing ports. • “Configure HTTP and HTTPS ports” on page 32 • “Configure ARR and eventing ports” on page 33 Configure HTTP and HTTPS ports The S...
Page 49 - Configure ARR and eventing ports; Configuring the ARR and eventing ports
Brocade SMI Agent User’s Guide 33 53-1001778-01 Port configuration 3 FIGURE 18 Configure HTTP and HTTPS ports Configure ARR and eventing ports You can configure both the secure and non-secure ARR and eventing ports using the procedure in this section. The ARR port is the port through which the switc...
Page 50 - Fabric Manager database server configuration
34 Brocade SMI Agent User’s Guide 53-1001778-01 Fabric Manager database server configuration 3 4. Click Apply. The changes take effect when you restart the server. Click Start Server to restart the server. FIGURE 19 Configure ARR and eventing ports Fabric Manager database server configuration Config...
Page 51 - Firmware download software locations configuration; Configuring software locations for firmware download
Brocade SMI Agent User’s Guide 35 53-1001778-01 Firmware download software locations configuration 3 3. To change the settings, type new values in the URL, User Name, and Password fields: URL URL to locate the database. If the Fabric Manager server is installed on the same host as the SMI-A, the URL...
Page 53 - Debugging and logging options configuration; Debugging options for CIMOM; Configuring debugging options for CIMOM
Brocade SMI Agent User’s Guide 37 53-1001778-01 Debugging and logging options configuration 3 Debugging and logging options configuration This section explains how to use the Brocade SMI Agent Configuration Tool to configure debugging and logging options for the CIMOM and Provider. This information ...
Page 54 - Debugging options for the provider
38 Brocade SMI Agent User’s Guide 53-1001778-01 Debugging and logging options configuration 3 4. Click Apply. The changes take effect when you restart the server. Click Start Server to restart the server. FIGURE 23 Configure debugging options for CIMOM Debugging options for the provider This section...
Page 55 - Configuring debugging options for the provider
Brocade SMI Agent User’s Guide 39 53-1001778-01 Debugging and logging options configuration 3 Configuring debugging options for the provider 1. Launch the Brocade SMI Agent Configuration Tool. 2. Click Debug in the menu tree (see Figure 24 on page 40). The content pane displays the current debugging...
Page 56 - Logging options for the provider; Configuring logging options for provider
40 Brocade SMI Agent User’s Guide 53-1001778-01 Debugging and logging options configuration 3 4 - Info Exceptions that are of no interest to the user. For example, an exception logged when the SMI-A first attempts a secure login to a non-secure switch if the user specifies “ProtocolToUse” as “Any.” ...
Page 57 - Log file examples
Brocade SMI Agent User’s Guide 41 53-1001778-01 Debugging and logging options configuration 3 4. To enable file logging: a. Check the Enable File logging check box. b. Type the full path to the log file, or click Select File to browse for the file location. c. Type the size of the log file (in kilob...
Page 58 - Capture provider cache information; Capturing information from the provider cache
42 Brocade SMI Agent User’s Guide 53-1001778-01 Debugging and logging options configuration 3 <?xml version="1.0" encoding="windows=1252" standalone="no"?><!DOCTYPE log SYSTEM "logger.dtd"><log><record>.. -------------> Contents from the fir...
Page 59 - Support information collection; Collect support information
Brocade SMI Agent User’s Guide 43 53-1001778-01 Support information collection 3 FIGURE 26 Configure provider cache Support information collection This section explains how to collect support information in case of any product-related issues. • “Collect support information” on page 43 • “XML dump” o...
Page 60 - Collecting support information; XML dump; Running an XML dump
44 Brocade SMI Agent User’s Guide 53-1001778-01 Support information collection 3 Collecting support information 1. Launch the Brocade SMI Agent Configuration Tool. 2. Click Collect Information in the menu tree (see Figure 27 ). The content pane displays the current path for the zip file. 3. To chang...
Page 61 - CIMOM server configuration; Configuring the CIMOM server
Brocade SMI Agent User’s Guide 45 53-1001778-01 CIMOM server configuration 3 FIGURE 28 Run XML dump CIMOM server configuration If the server is running on a system using multiple IP addresses, the server binds to an IP address arbitrarily chosen by the underlying operating system. Using the followin...
Page 62 - Configuring log file options
46 Brocade SMI Agent User’s Guide 53-1001778-01 CIMOM server configuration 3 FIGURE 29 Configure the CIMOM server Configuring log file options You cannot configure log file options with the SMI Agent Configuration Tool. The following procedure describes how to change the log file options by modifyin...
Page 63 - Mutual Authentication for Clients and Indications; Mutual authentication for clients
Brocade SMI Agent User’s Guide 47 53-1001778-01 Chapter 4 Mutual Authentication for Clients and Indications In this chapter • Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 • Mutual authentication for clients . . . . . . . . . . ...
Page 64 - Enabling mutual authentication for clients; Mutual authentication for indications; Enabling mutual authentication for indications; Client configuration to use client certificates
48 Brocade SMI Agent User’s Guide 53-1001778-01 Mutual authentication for indications 4 Enabling mutual authentication for clients 1. Configure the SMI-A to support mutual authentication for clients. This can be done either during installation using the installation wizard, or after installation, as...
Page 67 - Troubleshooting
Brocade SMI Agent User’s Guide 51 53-1001778-01 Troubleshooting 4 wbem.indications.keyStorePassword=SSLindication 2. Modify the CLASSPATH environment variable to reference this file. The CLASSPATH should contain only the path to the directory where the file is present and not the path to the file it...
Page 69 - Frequently Asked Questions
Brocade SMI Agent User’s Guide 53 53-1001778-01 Chapter 5 Frequently Asked Questions In this chapter • General questions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 • Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ...
Page 73 - Appendix; Licenses and Attributions
Brocade SMI Agent User’s Guide 57 53-1001778-01 Appendix A Licenses and Attributions In this chapter • Open source software used in SMI-A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 • Sun Industry Standards Source License . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5...
Page 74 - Sun Industry Standards Source License
58 Brocade SMI Agent User’s Guide 53-1001778-01 Sun Industry Standards Source License A • Remotetea (ONC RPC), version 1.0.1 ( GNU Library General Public License ) • util.concurrent package, release 1.3.4 ( Public Domain ) • SUN J2SDK, version 1.4.2_x ( Sun Binary Code License Agreement ) Sun Indust...
Page 78 - IBM Common Public License
62 Brocade SMI Agent User’s Guide 53-1001778-01 IBM Common Public License A The Initial Developer of the Original Code is: Sun Microsystems, Inc. Portions created by: Sun Microsystems, Inc. are Copyright © 2001 Sun Microsystems, Inc. All Rights Reserved. Contributor(s): _____________________________...
Page 81 - OpenSLP License
Brocade SMI Agent User’s Guide 65 53-1001778-01 OpenSLP License A If Recipient institutes patent litigation against a Contributor with respect to a patent applicable to software (including a cross-claim or counterclaim in a lawsuit), then any patent licenses granted by that Contributor to such Recip...
Page 82 - Bouncy Castle
66 Brocade SMI Agent User’s Guide 53-1001778-01 Bouncy Castle A THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DI...
Page 83 - Public Domain
Brocade SMI Agent User’s Guide 67 53-1001778-01 Public Domain A Public Domain Originally written by Doug Lea and released into the public domain. This may be used for any purposes whatsoever without acknowledgment. Thanks for the assistance and support of Sun Microsystems Labs, and everyone contribu...
Page 89 - Index
Brocade SMI Agent User’s Guide 73 53-1001778-01 Index A access control , 18 ARR ports, configuring , 33 B Brocade SMI Agent. See SMI-A C CIM defined , 1 client certificates , 48 , 50 common schema , 1 Configuration Tool about , 13 launching , 15 configuring ARR ports , 33 debugging options , 37 even...
