Brocade, Fabric OS, File Lifecycle Manager, MyView, and StorageX are registered trademarks and the Brocade B-wing symbol, DCX, and SAN Health are trademarks of Brocade Communications Systems, Inc., in the United States and/or in other countries. All other brands, products, or service names are or may be trademarks or service marks of, and are used to identify, products or services of their respective owners.
Page 3
Brocade SMI Agent User’s Guide 53-1001263-02 Brocade SMI Agent User’s Guide 53-1001263-03 Brocade SMI Agent User’s Guide 53-1001535-01 Brocade SMI Agent User’s Guide 53-1001778-01 Brocade SMI Agent User’s Guide 53-1001778-01 Summary of changes Date Updated to support Fabric OS 6.2.0 December 2008 and SMI-A 120.8.0...
• Appendix A, “Licenses and Attributions,” Brocade SMI Agent User’s Guide 53-1001778-01 provides an overview of the CIM, the Brocade SMI-S initiative, and the explains how to start and stop the Brocade SMI Agent. describes how to use the Brocade SMI Agent provides answers to the most frequently asked includes the licenses for open source software.
Although many different software and hardware configurations are tested and supported by Brocade Communications Systems, Inc. for SMI-A 120.11.0, documenting all possible configurations and scenarios is beyond the scope of this document. The following hardware platforms are supported by this release of Brocade SMI Agent 120.11.0: •...
Text formatting The narrative-text formatting conventions that are used are as follows: bold text Brocade SMI Agent User’s Guide 53-1001778-01 Identifies command and method names Identifies the names of user-manipulated GUI elements Identifies keywords and operands Identifies text to enter at the GUI or CLI...
Identifies paths and Internet addresses Identifies document titles Identifies CLI output Identifies command syntax examples “Brocade resources” on page xiii for instructions on accessing Brocade Connect. Referenced Trademarks and Products Linux Windows, Windows NT, Internet Explorer SUSE Brocade SMI Agent User’s Guide 53-1001778-01...
For additional resource information, visit the Technical Committee T11 Web site. This Web site provides interface standards for high-performance and mass storage applications for Fibre Channel, storage management, and other applications: http://www.t11.org Brocade SMI Agent User’s Guide 53-1001778-01 Referenced Trademarks and Products Sun, Solaris Red Hat, Red Hat Network VMware http://my.brocade.com...
Brocade 4018—On the top of the blade • Brocade 4020 and 4024—On the bottom of the switch module • Brocade 5000—On the switch ID pull-out tab located on the bottom of the port side of the switch Brocade SMI Agent User’s Guide 53-1001778-01...
Thread dump, if the SMI Agent is hanging or if memory consumption goes up You can use the SMI Agent Configuration Tool, which is described in this document, to collect the required support information to be sent. Brocade SMI Agent User’s Guide 53-1001778-01...
Forward your feedback to: documentation@brocade.com Provide the title and version number of the document and as much detail as possible about your comment, including the topic heading and page number and your suggestions for improvement. Brocade SMI Agent User’s Guide 53-1001778-01...
Web-Based Enterprise Management (WBEM) is a set of management and internet standard technologies to unify management of an enterprise. It includes CIM, CIM Schemas, CIM operations over HTTP, and CIM-XML encoding. Brocade SMI Agent User’s Guide 53-1001778-01 Chapter...
The SMI-A does not require any modification or upgrade to deployed fabrics when it is deployed. All the support required in Brocade switches is already in place. high-level architecture of the SMI-A. Figure 2 on page 3 shows the Brocade SMI Agent User’s Guide 53-1001778-01...
Page 19
Port performance and error statistics • HBA and device information via FDMI • Configuration download to switches • Firmware download to switches Brocade SMI Agent User’s Guide 53-1001778-01 CIM Client CIM Client Brocade SMI Agent CIM Object Manager (CIMOM) Brocade Provider...
Page 20
• Provider logging of exceptions, operations, and performance metrics for diagnostic purposes • Secure SAN fabrics • Secure RPC communication • CIM queries, using WBEM Query Language (WQL) • DMTF CIM Schema v2.19 (final) Brocade SMI Agent User’s Guide 53-1001778-01...
(if you changed it from the default). Starting the SMI-A 1. Type the following at the command line: On Linux, Solaris, and AIX: sh <SMIAgent>/agent/server/jserver/bin/start_server.sh Brocade SMI Agent User’s Guide 53-1001778-01 “SMI Agent service configuration and removal” Chapter on page 31.
On Linux, Solaris, or AIX, become the root user: for example, % su root. Run the following: sh <SMIAgent>/agent/server/jserver/bin/stop_server.sh -s http://localhost:portnum/interop The protocol, host, and port information are required only when the defaults are changed. “Stopping the SMI-A when mutual enabled”. on page 7. “Service Brocade SMI Agent User’s Guide 53-1001778-01...
• slpd program that acts as a Service Agent (SA). A different slpd binary executable exists for Solaris, Linux, AIX, and Windows. Brocade SMI Agent User’s Guide 53-1001778-01 Service Location Protocol (SLP) support on page 48 if the WbemClient.properties...
HTTPS protocol. NOTE Change the IP Address:Port to those displayed by slptool findsrvs service:wbem. SLP on Linux, Solaris, and AIX On Linux, Solaris, and AIX, you do not need to install the SLP service. Brocade SMI Agent User’s Guide 53-1001778-01...
Page 25
4. Verify that the SLP service is properly advertising the WBEM SLP template over its configured client protocol adapters. NOTE Change the IP Address:Port to those displayed by slptool findsrvs service:wbem: Brocade SMI Agent User’s Guide 53-1001778-01 Service Location Protocol (SLP) support...
Applications that do not dynamically register themselves with SLP using SLPAPIs can instead be statically registered by modifying the following file: <SMIAgent>\agent\cfg\slp.reg For more information about these files, read the comments contained in them or read: http://www.openslp.org/doc/html/UsersGuide/index.html “Installing SLP on Windows”. Brocade SMI Agent User’s Guide 53-1001778-01...
Brocade_ConnectionMonitoringService and through instances of Brocade_ConnectionMonitor. These values are not configurable through the SMI-A installer or configuration tool. Brocade SMI Agent User’s Guide 53-1001778-01 Disable HTTP for security reasons “Configuring HTTP access” on page 24).
2. Restart the Brocade SMI Agent. Configuring IP address for SMI Agent client to server communication in multi-homed systems 1. Edit the jserver.properties file found at …server/jserver/bin with the following entry: HostIPAddress=xxx.xxx.xxx.xxx 2. Restart the Brocade SMI Agent. Brocade SMI Agent User’s Guide 53-1001778-01...
• Content pane The content pane displays information relevant to the command that is selected in the menu tree and provides options to configure the functionalities provided by the command. Brocade SMI Agent User’s Guide 53-1001778-01 Chapter Figure 3...
Page 30
Cancels the changes you have made in the content pane, without closing the window. Already applied changes cannot be undone. Closes the window and exits the application. You are prompted to apply any unsaved changes. Action buttons Content pane Brocade SMI Agent User’s Guide 53-1001778-01...
2. Click Proxies in the menu tree (see 3. Click Add. 4. Fill out the Proxy Configuration dialog box (see Figure 4 on page 15). Figure 4 on page 15). Figure 5) and click OK. Brocade SMI Agent User’s Guide 53-1001778-01...
15). You can see the full message as a tool tip or by expanding the Status column. Table 1 lists the status messages and corresponding descriptions, as well as the return code from the LoginAsUser extrinsic method. Brocade SMI Agent User’s Guide 53-1001778-01 Proxy Configuration dialog box Figure 4 on page 15). Proxy connections...
VF) membership. Login failed due to insufficient user role. Invalid Password Login failed due to invalid username/password. Not Enough RPC Handles Login failed due to insufficient number of RPC handles (20 max). Brocade SMI Agent User’s Guide 53-1001778-01...
The SMIA SwitchUser field is mandatory. The Default User Password field is mandatory if Radius Server Authentication is enabled; otherwise, it is optional. If you enter a password, it must be valid, even if it is optional. Figure Brocade SMI Agent User’s Guide 53-1001778-01...
• “Exporting server certificates” • “Viewing or deleting client certificates from SMI-A server truststore” • “Configuring user authentication” Brocade SMI Agent User’s Guide 53-1001778-01 next on page 22 on page 23 on page 24 on page 25 on page 26...
If you do not disable HTTP access, then any client can communicate with the SMI-A using HTTP access. Figure 3 on page 24.) Clients should preferably use HTTPS for all on page 14). Brocade SMI Agent User’s Guide 53-1001778-01...
Configure the WBEM client to use client certificates to communicate with the SMI-A. (See “Client configuration to use client certificates” The changes take effect when you restart the server. Click Start Server to restart the server. Brocade SMI Agent User’s Guide 53-1001778-01 SMI Agent security on page 48.) Figure 10 on page 24.) Clients should preferably use HTTPS for all...
To enable HTTP access, ensure that the SMI-A server is stopped. Click the Stop Server button. To disable HTTP access, ensure that the SMI-A server is running. Click the Start Server button. 5. Click Apply. Figure 11). Brocade SMI Agent User’s Guide 53-1001778-01...
This option is disabled if you do not have the appropriate privilege. 1. Launch the Brocade SMI Agent Configuration Tool. 2. Click Import in the menu tree (see Brocade SMI Agent User’s Guide 53-1001778-01 SMI Agent security ) will be used to authenticate clients. client.cer Figure 12).
This option is disabled if you do not have the appropriate privilege. 1. Launch the Brocade SMI Agent Configuration Tool. 2. Click Export in the menu tree (see Figure 13). Brocade SMI Agent User’s Guide 53-1001778-01...
This option is disabled if you do not have the appropriate privilege. 1. Launch the Brocade SMI Agent Configuration Tool. 2. Click View/Delete in the menu tree (see Brocade SMI Agent User’s Guide 53-1001778-01 SMI Agent security Figure 14).
3. To change the user authentication setting, click the button of the available option. If user authentication is already enabled, the Disable User Authentication option is available. If user authentication is already disabled, the Enable User Authentication option is available. Figure 15 on page 29). Brocade SMI Agent User’s Guide 53-1001778-01...
Page 45
If Windows Domain Authentication is not enabled, then provide the local user credentials. If Windows Domain Authentication is enabled, then provide the domain user credentials. FIGURE 15 User authentication Brocade SMI Agent User’s Guide 53-1001778-01 myUserName myDomain\myUserName SMI Agent security...
If you disabled encoding, the proxy connection entries are removed from the provider.ser binary file and copied to the provider.xml file. New proxy entries are also written to the provider.xml file. FIGURE 16 Encode proxy details Figure 16). Brocade SMI Agent User’s Guide 53-1001778-01...
If you selected to remove the SMI Agent as a service, the SMI Agent is stopped (if it is running as a service) and uninstalled. FIGURE 17 Configure or remove SMI Agent as a service Brocade SMI Agent User’s Guide 53-1001778-01 SMI Agent service configuration and removal Figure 17).
Make sure the ports are not in use before you assign them; otherwise, the results will be unpredictable. 4. Click Apply. The changes take effect when you restart the server. Click Start Server to restart the server. on page 32 on page 33 Figure 18 on page 33). Brocade SMI Agent User’s Guide 53-1001778-01...
3. To change the settings, type new values in the fields. The value must be between 0 and 65535, inclusive. If the value is 0, the SMI Agent dynamically allocates a port during server startup. Brocade SMI Agent User’s Guide 53-1001778-01 Port configuration Figure 19 on page 34).
2. Click Connection Parameters in the menu tree (see The content pane displays the current connection parameters. The Driver field is already populated with the default driver that is bundled in the agent: com.sybase.jdbc2.jdbc.SybDriver. Do not change this driver information. Figure 20). Brocade SMI Agent User’s Guide 53-1001778-01...
2. Click Software Locations in the menu tree (see The content pane displays the current software locations. Brocade SMI Agent User’s Guide 53-1001778-01 Firmware download software locations configuration URL to locate the database. If the Fabric Manager server is installed on the...
Page 52
Type the host name or host IP address (in IPv4 or IPv6 format). Type either the absolute or relative path to the software file. Select either FOS or SAS from the drop-down list. Software Location dialog box Brocade SMI Agent User’s Guide 53-1001778-01...
• FINEST • Selecting NO LOG disables logging. Selecting any value other than NO LOG enables logging. Brocade SMI Agent User’s Guide 53-1001778-01 Debugging and logging options configuration on page 37 on page 38 on page 40 on page 42 <SMIAgent>\agent\server\jserver\bin...
You can set the following debug options: • Exception • Operation • Event • Configuration • Switch Data • Switch XML Data • Threadlock Switch Data and Switch XML Data are used internally for communication with the switch. <SMIAgent>\agent\server\jserver\bin\debug.properties Brocade SMI Agent User’s Guide 53-1001778-01...
Page 55
1 - Fatal 2 - Error 3 - Warning Exceptions that need user attention, but do not directly affect SMI-A Brocade SMI Agent User’s Guide 53-1001778-01 Debugging and logging options configuration Figure 24 on page 40). No exceptions are logged.
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.” Figure 25). Brocade SMI Agent User’s Guide 53-1001778-01...
Page 57
The next example shows the contents of the log file on the subsequent startup. The text in bold is the contents from the second time the SMI-A was started. Brocade SMI Agent User’s Guide 53-1001778-01 Debugging and logging options configuration...
5. Click Log Deadlock Information to log the current status of threads that are in a deadlock situation. This is the equivalent of the extrinsic method Brocade_Agent.LogCacheData. 6. Click Dump now. -------------> Contents from the first time run -------------> Contents from the second time run Figure 26). Brocade SMI Agent User’s Guide 53-1001778-01...
The zip file contains the following files: • provider.xml • jserver.properties • SMIAgentconfig.xml • cimom.properties • SystemInfo.txt • CIMOM and provider log files, if any Brocade SMI Agent User’s Guide 53-1001778-01 on page 43 on page 44 <SMIAgent>\agent\SupportInfo Support information collection...
3. To change the XML file path, type a new path or click Select Folder to browse for the location. 4. Click Start Server to ensure that the SMI Agent server is running. 5. Click Apply. Figure 27). Figure 28 on page 45). Brocade SMI Agent User’s Guide 53-1001778-01...
Clear the Bind to Address box to indicate that the server should bind to an IP address that is arbitrarily chosen by the underlying operating system. 5. Click Apply. Brocade SMI Agent User’s Guide 53-1001778-01 CIMOM server configuration Figure 29 on page 46).
NOTE Sometimes log file will exceed the size specified because of a limitation in Java logging. After the server is stopped, the size of the log file will be reduced to the size specified. Brocade SMI Agent User’s Guide 53-1001778-01...
TrustStore that contains a certificate for an entry in the client KeyStore. Additionally, when mutual authentication for clients is enabled, the client must have a TrustStore that contains the certificate for an entry in the SMI-A KeyStore. Brocade SMI Agent User’s Guide 53-1001778-01 Chapter...
On Linux, Solaris, and AIX:<SMIAgent>/agent/client On Windows: This folder has the following files: • .client.keystore • .client.truststore • client.cer • .client.ind.keystore on page 22. on page 48.) on page 23. next.) <SMIAgent>\agent\client “Configuring HTTP “Configuring HTTP Brocade SMI Agent User’s Guide 53-1001778-01...
Pass the required system properties as jvm parameters on the command line, using the -D option as follows. Mutual authentication for clients: java -classpath <SMIAgent>/agent/lib/wbem.jar -Djavax.net.ssl.keyStore=<SMIAgent>/agent/client/.client.keystore -Djavax.net.ssl.keyStorePassword=SSLclient -Djavax.net.ssl.trustStore=<SMIAgent>/agent/client/.client.truststore -Djavax.net.ssl.trustStorePassword=trustSSLclient clientprogram Brocade SMI Agent User’s Guide 53-1001778-01 Client configuration to use client certificates...
Do not include truststore information in the file. For example, if the SMI-A is installed under D:\smiagent, the contents of the WbemClient.properties file should be as follows. wbem.indications.keyStore=D:/smiagent/agent/client/.client.ind.keystore “Client configuration to use client certificates” Brocade SMI Agent User’s Guide on page 48, 53-1001778-01...
If the WBM client is configured with no keystore or truststore information, the following error is issued on the client side: XMLERROR: enumerateInstances,java.net.ConnectException: java.net.SocketException - Software caused connection abort: recv failed at javax.wbem.client.adapter.http.CIMClientXML.enumerateInstances(Unknown Source) at javax.wbem.client.CIMClient.enumerateInstances(Unknown Source) at javax.wbem.client.CIMClient.enumerateInstances(Unknown Source) Brocade SMI Agent User’s Guide 53-1001778-01 Troubleshooting...
Page 68
In this scenario, the following error is issued on the client side: XMLERROR: enumerateInstances,java.net.ConnectException: javax.net.ssl.SSLHandshakeException - Received fatal alert: bad_certificate at javax.wbem.client.adapter.http.CIMClientXML.enumerateInstances(Unknown Source) at javax.wbem.client.CIMClient.enumerateInstances(Unknown Source) at javax.wbem.client.CIMClient.enumerateInstances(Unknown Source) Brocade SMI Agent User’s Guide 53-1001778-01...
To ensure this happens, follow these steps: 1. During SMI-A installation, enable security and select “No” for Windows domain authentication. 2. Create a local user on the Windows system where the agent is installed. Brocade SMI Agent User’s Guide 53-1001778-01 Chapter...
Page 70
Does the Brocade SMI Agent need to point to every switch in a fabric or just one switch in each fabric to collect the data? Just one switch per fabric. <SMIAgent>\agent\bin\PasswordEncryptor.bat “Document feedback” Brocade SMI Agent User’s Guide 53-1001778-01...
Page 71
How do I tell what version of SMI-A I am running? The title bar in the Brocade SMI Agent Configuration Tool displays the version of the SMI-A, for versions 120.7.0 and later. See Brocade SMI Agent User’s Guide 53-1001778-01 on page 12. Figure 3 on page 14 for an example.
Only one switch entry per fabric is sufficient in the provider.xml file. Type the following command: kill -3 pid where pid is the process ID of the Brocade SMI Agent. Press CTRL key + backslash (\) key. Press CTRL key + BREAK key. Brocade SMI Agent User’s Guide 53-1001778-01...
• Cryptography Security Library, version 1.19 The SMI Agent uses only the RSA algorithm. For more information on The Legion Of The Bouncy Castle, see Brocade SMI Agent User’s Guide 53-1001778-01 (Sun Industry Standards Source License) (Bouncy http://www.bouncycastle.org Appendix...
(b) ownership of more than fifty percent (50%) of the outstanding shares or beneficial ownership of such entity. 2.0 SOURCE CODE LICENSE (GNU Library General Public (Public Domain) (Sun Binary Code License Agreement) License) Brocade SMI Agent User’s Guide 53-1001778-01...
Page 75
Initial Developer for any liability incurred by the Initial Developer as a result of warranty, support, indemnity or liability terms You offer. 3.3 Distribution of Executable Versions. Brocade SMI Agent User’s Guide 53-1001778-01 Sun Industry Standards Source License...
Page 76
THE INITIAL DEVELOPER) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE. NO USE OF ANY ORIGINAL CODE IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS DISCLAIMER. Brocade SMI Agent User’s Guide 53-1001778-01...
Page 77
Software distributed under the License is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing rights and limitations under the License. The Original Code is WBEM Services. Brocade SMI Agent User’s Guide 53-1001778-01 Sun Industry Standards Source License...
"Licensed Patents " mean patent claims licensable by a Contributor which are necessarily infringed by the use or sale of its Contribution alone or when combined with the Program. "Program" means the Contributions distributed in accordance with this Agreement. Brocade SMI Agent User’s Guide 53-1001778-01...
Page 79
Agreement; and b) a copy of this Agreement must be included with each copy of the Program. Contributors may not remove or alter any copyright notices contained within the Program. Brocade SMI Agent User’s Guide 53-1001778-01 IBM Common Public License...
Page 80
Agreement, and without further action by the parties hereto, such provision shall be reformed to the minimum extent necessary to make such provision valid and enforceable. Brocade SMI Agent User’s Guide 53-1001778-01...
Neither the name of Caldera Systems nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. Brocade SMI Agent User’s Guide 53-1001778-01 OpenSLP License...
You should have received a copy of the GNU Library General Public License along with this program (see the file COPYING.LIB for more details); if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. Brocade SMI Agent User’s Guide 53-1001778-01...
Software is furnished (if any) will be free of defects in materials and workmanship under normal use. Except for the foregoing, Software is provided "AS IS". Your exclusive remedy and Sun's entire liability under this limited Brocade SMI Agent User’s Guide 53-1001778-01 Public Domain...
Page 84
You agree to comply strictly with all such laws and regulations and acknowledge that you have the responsibility to obtain such licenses to export, re-export, or import as may be required after delivery to you. Brocade SMI Agent User’s Guide 53-1001778-01...
Page 86
Sun by third parties, and shall pay all damages awarded by a court of competent jurisdiction, or such settlement amount negotiated by you, arising out of or in connection with your use, reproduction or distribution of the Software and/or the Brocade SMI Agent User’s Guide 53-1001778-01...
Page 87
5 and 6 of the Binary Code License Agreement shall apply to all Software in this distribution. For inquiries please contact: Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. (LFI#129530/Form ID#011801) Brocade SMI Agent User’s Guide 53-1001778-01 Sun Binary Code License Agreement...
Page 89
SMI-A as a service SMI-A server core schema debugging options, configuring decoding proxy connection entries default user mapping Brocade SMI Agent User’s Guide 53-1001778-01 disabling HTTP HTTP access user authentication Distributed Management Task Force (DMTF) enabling HTTP access multi-homed support...
Page 90
Storage Management Initiative (SMI) Storage Management Initiative Specification (SMI-S) Storage Networking Industry Association (SNIA) support information, collecting user authentication, enabling and disabling user mapping Web Based Enterprise Management (WBEM) XML dump, generating xiii xiii xiii xiii Brocade SMI Agent User’s Guide 53-1001778-01...