Documente Academic
Documente Profesional
Documente Cultură
30 March 2010
Document History
Brocade SMI Agent Installation Guide 53-1000054-01 New document. April 2006
Brocade SMI Agent Installation Guide 53-1000054-02 Removed VM directory from CD May 2006
image path.
Brocade SMI Agent Installation Guide 53-1000198-01 Updated to support the 110.5.0 November 2006
release.
Brocade SMI Agent Installation Guide 53-1000198-02 Rebranded the document using March 2007
the new Brocade templates.
Brocade SMI Agent Installation Guide 53-1000445-01 Updated to support the 120.6.0 June 2007
release
Brocade SMI Agent Installation Guide 53-1000445-02 Updated the supported Kernel July 2007
versions for Linux.
Brocade SMI Agent Installation Guide 53-1000612-01 Updated to support the 120.7.0 November 2007
release.
Title Publication number Summary of changes Date
Brocade SMI Agent Installation Guide 53-1000612-02 Updated to support the 120.7.1 March 2008
release.
Brocade SMI Agent Installation Guide 53-1001145-01 Updated to support the 120.7.2 August 2008
release.
Brocade SMI Agent Installation Guide 53-1001198-01 Updated to support the 120.8.0 December 2008
release.
Brocade SMI Agent Installation Guide 53-1001198-02 Minor corrections to the previous February 2009
version.
Brocade SMI Agent Installation Guide 53-1001262-01 Updated to support the 120.9.0 March 2009
release.
Brocade SMI Agent Installation Guide 53-1001262-02 Update description of Proxy April 2009
configuration dialog box.
Brocade SMI Agent Installation Guide 53-1001262-03 Minor corrections to the previous July 2009
version.
Brocade SMI Agent Installation Guide 53-1001534-01 Updated to support the 120.10.0 August 2009
release.
Brocade SMI Agent Installation Guide 53-1001777-01 Updated to support the 120.11.0 March 2010
release.
Index
In this chapter
• How this document is organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
• Supported hardware and software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
• What’s new in this document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
• Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
• Notice to the reader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
• Additional information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
• Getting technical help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii
• Brocade SMI Agent support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
• Document feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Document conventions
This section describes text formatting conventions and important notice formats used in this
document.
Text formatting
The narrative-text formatting conventions that are used are as follows:
bold text 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
italic text Provides emphasis
Identifies variables
Identifies class properties
Identifies paths and Internet addresses
Identifies document titles
NOTE
A note provides a tip, guidance or advice, emphasizes important information, or provides a reference
to related information.
ATTENTION
An Attention statement indicates potential damage to hardware or data.
Key terms
For definitions specific to Brocade and Fibre Channel, see the technical glossaries on MyBrocade.
See “Brocade resources” on page xi for instructions on accessing MyBrocade.
For definitions of SAN-specific terms, visit the Storage Networking Industry Association online
dictionary at:
http://www.snia.org/education/dictionary
Brocade resources
The following SMI-A documentation can be obtained from developer support at Brocade:
• Brocade SMI Agent User’s Guide
• Brocade SMI Agent Developer’s Guide
To get up-to-the-minute information, go to http://my.brocade.com and register at no cost for a user
ID and password.
For practical discussions about SAN design, implementation, and maintenance, you can obtain
Building SANs with Brocade Fabric Switches through:
http://www.amazon.com
For additional Brocade documentation, visit the Brocade Web site:
http://www.brocade.com
Release notes are available on the MyBrocade web site and are also bundled with the Fabric OS
firmware.
*FT00X0054E9*
FT00X0054E9
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 want to hear from you. 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.
Installation Requirements 1
In this chapter
• Platform requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
• Switch requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
• System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
• SMI-A (Fabric OS) and SMI (EOS) coexistence requirements . . . . . . . . . . . . . 3
Platform requirements
Your software environment must meet the following requirements before you install the Brocade
SMI Agent (SMI-A):
• Minimum of 512 MB RAM
• One of the following operating systems:
- Microsoft Windows Server 2003 Std SP2 (x86 32-bit)
- Microsoft Windows Server 2008 Std (x86 32-bit)
- Microsoft Windows Vista Business Edition SP1 (x86 32-bit)
- Solaris 9 (SPARC-platform)
- Solaris 10 (SPARC-platform)
- Linux Red Hat AS 3.0 (x86 32-bit)
- Linux Red Hat AS 4.0 (x86 32-bit)
- Linux SUSE Enterprise Desktop 10 (x86 32-bit)
- AIX 5.3 (PowerPC)
• For Linux, Solaris, and AIX, a graphical interface is required for standard installation, but not for
silent installation.
NOTE
In Windows Vista, if you do not have Administrator privileges, you cannot stop and start the server.
To start and stop the server, you must have Administrator privileges and the ConfigurationTool.bat
file must be invoked using the “Run As Administrator” option.
Sun Microsystems JRE version 1.5.0_11 is bundled with the SMI-A and is automatically installed
when the SMI-A is installed.
VMWare ESX Server 3.5 is supported on the following operating systems:
• Microsoft Windows Server 2003 Std SP2 (x86 32-bit)
• Microsoft Windows Server 2008 Std (x86 32-bit)
• Linux Red Hat AS 4.0 (x86 32-bit)
Other virtualization software is not supported.
Switch requirements
When possible, upgrade your switches to Fabric OS v6.4.x.
The SMI-A supports proxy switches running Fabric OS v6.0.x and higher; however, it is
recommended that the proxy switch is running Fabric OS v6.4.x.
It is not necessary to choose the principal switch as the proxy.
Only fabrics in which all user accounts are equivalent on all switches have been tested. For RBAC,
only fabrics containing all Fabric OS 5.2.0, 5.3.0, or 6.0.x and higher switches and in which all user
accounts are equivalent on all switches have been tested.
System requirements
NOTE
The recommendations in this section are applicable for both the physical and the VMware host.
The memory required for running the SMI-A depends on the following:
• number of switches
• number of ports
• number of devices in a single fabric
• number of fabrics being managed
You should increase the memory as these numbers increase. You should also check the memory
usage of all applications and services running on the host and adjust the memory accordingly. If
the agent is used to manage multiple fabrics, use the total number of switch ports in all fabrics to
determine the memory usage.
Fabric OS v5.2.0 and later support a zoning database size of 1 MB. To support a 1 MB zoning
database, the entire fabric must be upgraded to v5.2.0 or later. If any pre-v5.2.0 switches are part
of the fabric, the maximum zone database size is 256 KB. If the zoning database size exceeds 256
KB, switches not upgraded to Fabric OS v5.2.0 or later are segmented out of the fabric.
You should also increase the memory heap size for the JVM based on the number of switches and
number of switch ports and devices. After you install the SMI Agent, you can increase the heap size
using the following procedure.
NOTE
This document uses <SMIAgent> to refer to the installation folder, although your installation folder
might be different (if you change it from the default).
Installing SMI-A (Fabric OS) and SMI (EOS) on the same host
The following procedures provide the basic installation order for installing the two SMI agents.
Complete instructions for installing the SMI-A (Fabric OS) are provided in Chapter 2, “Installing the
SMI Agent”. See the Brocade SMI Agent for EOS Products Installation Guide for instructions for
installing the SMI (EOS).
Perform one of the following procedures depending on which SMI is to use the default ports and
which version of SMI (EOS) you are running.
SMI-A (Fabric OS) uses the default ports, and SMI (EOS) version is earlier than 2.6
1. Install the SMI (EOS) agent.
2. Change the http and https port numbers using the Server Configuration tool and restart the
SMI (EOS) agent.
3. Install the SMI-A (Fabric OS) using the default ports (5988 and 5989).
SMI-A (Fabric OS) uses the default ports, and SMI (EOS) version is 2.6 or later
1. Install the SMI-A (Fabric OS) agent using the default ports (5988 and 5989).
2. Install the SMI (EOS) agent with non-default ports (for example, http: 6000 and https: 6001).
In this chapter
• Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
• Before installing the SMI Agent on Linux, Solaris, and AIX. . . . . . . . . . . . . . . 5
• Install the Brocade SMI Agent using the wizard . . . . . . . . . . . . . . . . . . . . . . . 6
• Install the Brocade SMI Agent in silent mode . . . . . . . . . . . . . . . . . . . . . . . . 26
• Post-installation considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
• Enable multi-homed support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
• Uninstall the Brocade SMI Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Introduction
This chapter describes the steps for installing and uninstalling the Brocade SMI Agent (SMI-A) on
Windows, Linux, Solaris, and AIX. You can install the SMI-A either using a wizard or in silent mode,
with no user intervention.
When SMI-A installation is complete, the following shortcuts are automatically added to the Start
menu:
• Brocade SMI Agent Configuration Tool
• Start CIMOM
• Stop CIMOM
• Start SMI Agent Service (Available only if the SMI-A is installed as a service)
• Stop SMI Agent Service (Available only if the SMI-A is installed as a service)
• Uninstall Brocade SMI Agent
NOTE
If you are installing both the SMI-A (Fabric OS) and the SMI (EOS) on the same host, see “SMI-A
(Fabric OS) and SMI (EOS) coexistence requirements” on page 3 for additional requirements and
instructions.
NOTE
To enable security on Linux, Solaris, and AIX, you must start the installation process by logging
in as root. To enable security on Windows, you must start the installation process by logging in
as a user with administrator privileges.
If the installation wizard does not launch, you might be installing in silent mode. Silent mode is
triggered when you run the installation file using the -f option. Check for the presence of the
SilentInstallation.properties file and, if you do not want to install in silent mode, either move
that file to another folder, or rename the file. For information about silent mode installation,
see “Install the Brocade SMI Agent in silent mode” on page 26.
3. Accept the license agreement and click Next.
The System Configuration window appears.
4. Ensure that you have the required disk space for the installation, and click Next.
The Introduction window appears.
FIGURE 3 Introduction
6. Click Next to accept the default installation location, or enter a different location and click
Next.
If you plan to migrate configuration files from a previous version, each version should be
installed in a different folder.
NOTE
Do not specify spaces in the path or folder name.
7. Windows, Solaris, Linux only: If the installer detects an existing SMI Agent installation, you are
prompted whether you want to import the existing configuration. (The installer cannot detect
an existing installation on the AIX platform.) This prompt does not appear if the previous SMI
Agent installation was terminated.
If you do not want to import the existing configuration files, click Cancel, and go to step 9;
otherwise, click OK to copy the configuration files from the existing installation directory to the
new installation directory.
When you click OK, the Importing Configuration window appears. This window displays the
paths of the configuration files. Select the configuration that you want to import and click Next.
NOTE
SMI-A 120.11.0 supports importing configurations from 120.10.0 and from 120.9.0.
NOTE
If the import fails, you are notified of the failure at the end of this installation procedure.
The HTTP Port Configuration window appears. This window displays the default port number
for non-secured CIMOM communication.
10. Use the default HTTPS port number, or enter a new port number.
The range of valid port numbers is from 1 to 65535; however, it is recommended that you use
a value between 1024 and 65535.
11. Click Install.
After the installation finishes, the Fabric Manager Server Configuration window appears.
NOTE
Full installation is not complete at this time. Do not cancel or abort the installation wizard.
For all platforms except AIX: If you imported an existing configuration, this window does not
display. Skip to step 13.
This window allows you to specify the connection information for an existing Brocade Fabric
Manager server. Not all users have a Fabric Manager server installed and running in their
environment. The information that you enter here allows the SMI-A to report on historical port
statistics by retrieving the data from the Fabric Manager database server. If your management
application does not make use of historical port statistics, you do not need to enter any
connection information on this screen.
Driver This 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.
URL The database URL should be in the form:
jdbc:subprotocol:subname:host:port/dbname
For example, if the Fabric Manager database server is installed on the same
host as the SMI-A, the URL is: jdbc:sybase:Tds:localhost:2638/fabman
Otherwise, replace localhost with the Fabric Manager database server host IP
address.
User Name The database user on whose behalf the connection is being made. The
default DSN user name is: dba
Password The user’s password. The default DSN password is: sql
This information is stored in the configuration file SMIAgentConfig.xml located at
<SMIAgent>\agent\server\jserver\bin. You can use the SMI Agent Configuration tool to
change these settings after installation.
12. Enter database schema information, and click Next.
The Enabling Mutual Authentication for Client window appears.
13. Choose whether to enable mutual authentication (trust by certificate) between client
management applications and the Brocade SMI Agent by selecting one of the following
options, and then click Next:
• Yes: Enables mutual authentication.
Only allow management applications that have the Brocade-provided security certificate to
connect to the SMI Agent. Requires that the Brocade-provided security certificate
(server.cer) is imported into the truststore of the management application before a
connection is established. The management application must have a mechanism that
provides the client certificate (client.cer) during the initial handshake.
• No: (Default) No mutual authentication by certificate.
Trust by certificate is not used; however, basic encryption and local or domain
authentication can still be established by enabling security in step 19.
The Enabling Mutual Authentication for Indications window appears.
14. Choose whether to enable mutual authentication (trust by certificate) between client
management application event system and the Brocade SMI Agent by selecting one of the
following options, and then click Next:
• Yes: Enables mutual authentication.
Allow only management applications that have the Brocade-provided security certificate to
register their event system with the SMI Agent. Requires that the Brocade-provided
security certificate (serverind.cer) is imported into the truststore of the management
application before a connection is established. The management application must have a
mechanism that provides the client certificate (clientind.cer) during the initial
handshake.
• No: (Default) No mutual authentication by certificate.
The SMI-A uses SSL to send CIM-XML indications to a WBEM client listener, but does not
attempt to verify the identity of the WBEM client listener.
NOTE
The SMI Agent uses this connection to send asynchronous event notifications, similar to SNMP,
to the management application event system.
The Importing client certificate for Mutual Authentication for Clients window appears.
This window allows you to import a security certificate into the SMI Agent server truststore.
If mutual authentication for clients is enabled, this certificate will be used. If mutual
authentication for clients is not enabled, you can provide a security certificate now, which will
be used if you enable mutual authentication for clients later.
NOTE
You can import only certificates generated using Java Keytool or OpenSSL.
If mutual authentication for clients is enabled and if you do not provide a security certificate,
then the Brocade-provided client certificate (client.cer) will be used to authenticate clients.
15. Enter the path of the client certificate and the alias name of the certificate, and click Next.
The Importing client certificate for Mutual Authentication for Indication window appears.
This window allows you to import a security certificate into the SMI Agent server truststore.
If mutual authentication for indications is enabled, this certificate will be used. If mutual
authentication for indications is not enabled, you can provide a security certificate now, which
will be used if you enable mutual authentication for indications later.
NOTE
You can import only certificates generated using Java Keytool or OpenSSL.
If mutual authentication for indications is enabled and if you do not provide a security
certificate, then the Brocade-provided security certificate (clientind.cer) will be used for
authentication.
16. Enter the path of the client certificate and the alias name of the certificate, and click Next.
The Exporting Server certificate for Mutual Authentication for Clients window appears.
This window allows you specify a file name and directory in which to export the SMI Agent
server certificate (server.cer) used for mutual authentication for clients.
If mutual authentication for clients is enabled and if you do not export the SMI Agent server
certificate, then the client keystore, truststore, and server certificates will be used for
authentication.
If mutual authentication for clients is not enabled, you can provide the server certificate
information now, which will be used if you enable mutual authentication for clients later.
17. Enter the directory and the file name, and click Next.
The Exporting Server certificate for Mutual Authentication for Indication window appears.
This window allows you specify a file name and directory in which to export the SMI Agent
server certificate (serverind.cer) used for mutual authentication for indications.
If mutual authentication for indications is enabled and if you do not export the SMI Agent
server certificate, then the client keystore, truststore, and server certificates will be used for
authentication.
If mutual authentication for indications is not enabled, you can provide the server certificate
information now, which will be used if you enable mutual authentication for indications later.
18. Enter the directory and the file name, and click Next.
The Enabling Security window appears.
19. Enable or disable authentication for the SMI Agent by selecting one of the following options,
and then click Next:
• Yes: Enables authentication.
SMI Agent validates the user name and password. Note that for Linux or Solaris systems,
the SMI Agent can only validate the user’s credentials against the local database.
NOTE
To enable security on an AIX platform, add the following lines to the /etc/pam.conf file, if
not already added:
wsi-wbem-server auth required /usr/lib/security/pam_aix
wsi-wbem-server session required /usr/lib/security/pam_aix
wsi-wbem-server password required /usr/lib/security/pam_aix
wsi-wbem-server account required /usr/lib/security/pam_aix
20. (Windows with security enabled only) Select whether to validate users against the domain user
database, and then click Next:
• Yes: Enables domain authentication.
SMI Agent validates the user name and password against the domain user database.
• No: (Default) Disables domain authentication.
SMI Agent validates the user against the Windows local user accounts on the SMI-A
system.
One of following windows appears depending on your operating system and the setting you
have selected:
• If you selected No, the Eventing and ARR TCP Port Configuration window appears
(Figure 18); skip to step 22.
• If you selected Yes, the Enter Valid Domain Name window appears (Figure 17). Continue
with step 21.
Domain authentication is not available on Linux, AIX, and Solaris platforms.
21. (Windows with domain security enabled only) Enter name of the domain that the SMI Agent will
use to authenticate user credentials, and click Next.
The Eventing and ARR TCP Port Configuration window appears.
For all platforms except AIX: If you imported an existing configuration, this window does not
display. Skip to step 23.
The ARR port is the port through which the switches in the fabric send data (large payload
responses) back to the SMI-A.
The eventing port is the port through which the switch connects to the SMI-A to deliver events.
If a firewall exists between the SMI-A and the fabric, these ports must be open in the firewall.
The ARR and eventing port ranges are from 0 to 65535.
When you choose values for the ARR and eventing ports, make sure they are not one of the
assigned TCP ports. The Installation wizard does not check for this. You can see a list of
assigned TCP ports at:
http://www.iana.org/assignments/port-numbers
ARR and eventing ports are optional. If you do not configure them, or if you configure them with
a value of 0, the SMI Agent dynamically allocates a port during server startup.
22. To allow the SMI Agent to allocate ports dynamically when started, enter 0 for each port
number or leave this form blank, and click Next; to assign a specific port or range of ports,
enter port numbers or range, and click Next.
NOTE
Ports cannot be the same or in use. The SMI Agent does not verify whether the ports are
available.
NOTE
To view console messages the SMI Agent must be running from a console session, not as a
service. Selecting yes to enable console messages when SMI Agent is running as a service
does not affect the system.
Figure 20 on page 23 shows the Windows default log file name and location.
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.
e. Click Next.
The Proxy Connections Configuration window appears.
For all platforms except AIX: If you imported an existing configuration, this window does not
display. Skip to step 26.
24. Configure the fabrics that you want the SMI Agent to proxy. For each fabric, click Add and fill
out the values in the Proxy Configuration window.
Proxy switch IP IP address of the proxy switch in IPv6 or IPv4 format (for example:
100.200.100.200)
User name Username to be used to log in to the switch (for example: admin)
Password Password to be used to log into the switch (for example: password)
Protocol Protocol: RPC, Secure RPC, or Any. RPC is used for a non-secure connection
and Secure RPC is used for a secure connection. Any means that first a
secure channel is tried and if it fails, then a non-secure channel is tried.
No. of RPC Handles Number of RPC connections to be used to connect to the switch. The
possible range of values is 1 to 20. The default value is 1.
NOTE
Fabric OS limits the number of RPC handles allowed per switch; therefore increasing the RPC
handles decreases the number of connections per switch.
25. After all the fabrics are configured in the Proxy Connections Configuration window, click Next.
The Important Information window appears.
27. Select Yes to start the SMI Agent as a service, and click Next.
NOTE
If you choose not to run the SMI Agent as a service, the agent does not stop or restart
automatically. You must manually start and stop the SMI Agent using the start_server script.
The Installation Completed window appears. This window displays a message if any errors
occurred during installation; check the log file for details.
ATTENTION
In silent mode, the terms of the end user license agreement cannot be displayed for acceptance.
Silent installation means that, by default, you accept the same license agreement displayed during
normal installation.
On Solaris: CD_Image/Solaris
On AIX: CD_Image/AIX
3. Run the installation file:
On Windows: CD_Image\Windows\install.exe -f "filename"
On Linux: CD_Image/Linux/sh install.bin -f "filename"
On Solaris: CD_Image/Solaris/sh install.bin -f "filename"
On AIX: CD_Image/AIX/sh install.bin -f "filename"
where filename is the absolute path of the properties file.
If the properties file name is the default name, SilentInstallation.properties, then you can run
the installation file without the -f option, as follows:
On Windows: CD_Image\Windows\install.exe
On Linux: CD_Image/Linux/install.bin
On Solaris: CD_Image/Solaris/install.bin
On AIX: CD_Image/AIX/install.bin
The SMI-A is installed to the location specified in the USER_INSTALL_DIR parameter of the
properties file.
The status of the installation, along with any error messages, is reported in the installation log file,
which is in the location specified in the INSTALLER_LOG_FILE parameter of the properties file. The
status of the installation is SUCCESS only if all of the installation operations succeeded; otherwise,
the overall installation status is FAILED. Refer to Chapter 3, “Silent Installation Status Messages,”
for details about the status messages.
Post-installation considerations
The Brocade SMI Agent supports SLP to allow applications to discover the existence, location, and
configuration of WBEM services in enterprise networks. If you want Service Location Protocol (SLP)
support, you must install and start the SLP daemon prior to starting the SMI-A. See the Brocade
SMI Agent User’s Guide for instructions on installing and starting the SLP daemon.
After you install the SMI-A, you can change many of the configuration settings using the Brocade
SMI Agent Configuration Tool. For example, you can:
• reconfigure the ports used by the SMI-A
• enable and disable logging and configure different levels of logging
• add and remove fabrics
See the Brocade SMI Agent User’s Guide for instructions on using this tool.
For example,
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE agent_config SYSTEM "SMIAgentConfig.dtd">
<agent_config>
<dbserver driver="" is_password_encrypted="" password="" url=""
username=""/>
<port_config arr="5400" eventing="123"/>
<secureport_config arr="876" eventing="1"/>
<host address="10.201.64.173"/>
</agent_config>
When you install the SMI-A in silent mode, status messages are written to the installation log file,
the name and location of which is specified in the properties file.
The format of each status message is:
SMIAgent;120.11.0;Operation=opname;Status=status;StatusCode=code;StatusMessage=msg
;
where opname is the name of the operation, status is either Passed or Failed, code is the numeric
status code, and msg is the status message.
Table 3 lists the possible operation names and, for each operation, the possible status, status
codes, and status messages.
This chapter contains questions most frequently sent to the SMI Agent Developer Support email
address.
• Besides Windows Domain authentication, does the SMI Agent support local user
authentication?
• What are the Eventing and ARR TCP Ports? Do they relate to indications?
• What encryption method is used to encrypt the password field in provider.xml?
• How do I report a problem and what information should I provide?
• 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?
• Can the SMI Agent proxy for two fabrics that are in different subnets?
• Should I designate multiple proxies into a fabric? What are the best practices concerning this?
• In using Windows domain authentication, do I need to include the domain name along with the
username for authentication?
• What are some situations that might require restarting the SMI Agent?
• How do I start and stop the SMI Agent?
• How do I tell what version of SMI-A I am running?
See the “Frequently Asked Questions” chapter in the Brocade SMI Agent User’s Guide for
additional questions and answers.
Besides Windows Domain authentication, does the SMI Agent support local user authentication?
SMIAgent 110.4.0 and higher support authenticating the user against the system on which it is
installed. By default when you configure security, the user’s credentials (username and password)
are validated against the ones present on the local system. 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.
What are the Eventing and ARR TCP Ports? Do they relate to indications?
These ports are used by the agent to receive events and ARP responses from the fabric. The client
is not required to fill in these ports; the operating system selects the ports dynamically. One
probable use case for specifying these ports is if there is a firewall between the fabric and the host.
In this case, you can specify a fixed port to be opened by the administrator for eventing or ARR.
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. If the switches in the fabric do not all have the same Fabric OS version,
then you should designate the switch with the highest supported Fabric OS version as the proxy. It
is not necessary to choose the principal switch as the proxy.
Can the SMI Agent proxy for two fabrics that are in different subnets?
Yes.
Should I designate multiple proxies into a fabric? What are the best practices concerning this?
You can have only one connection at a time into the fabric. The only advantage in designating
multiple proxies is that if the first proxy fails to connect, the SMI-A tries the next proxy until it finds
one that works.
In using Windows domain authentication, do I need to include the domain name along with the
username for authentication?
No. You should provide only the username, as shown:
UserPrincipal up = new UserPrincipal("username");
PasswordCredential pc = new PasswordCredential("password");
What are some situations that might require restarting the SMI Agent?
Restarting of the SMIAgent is required when:
• configuration parameters, such as the debug level or log file name, are changed.
• host IP, HTTP, or HTTPS port is changed.
• firmware download configuration entry in SMIAgentConfig.xml is changed.
How do I start and stop the SMI Agent?
See the Brocade SMI Agent User’s Guide for instructions on starting and stopping the SMI Agent.
D P
Distributed Management Task Force (DMTF), xi platform support, 1
E R
enabling requirements for installation, 1
multi-homed support, 30 return codes for silent installation, 33
error codes for silent installation, 33
S
F
silent installation
Fibre Channel Association, xi error codes, 33
frequently asked questions (FAQs), 37 on Windows, 26
SMI (EOS) installation requirements, 3
SMI-A
H installing as a service, 5
installing on Windows, 6
heap size, increasing, 3 uninstalling, 31
help, SMI agent support, xiii Storage Management Initiative (SMI), xi
Storage Management Initiative Specification (SMI-S), xi
Storage Networking Industry Association (SNIA), xi
supported platforms, 1
I
increasing heap size, 3
installation requirements, 1 U
installing SMI-A as a service, 5
installing SMI-A on Windows, 6 uninstalling SMI-A, 31
installing SMI-A with SMI (EOS), 3
W
M Web Based Enterprise Management (WBEM), xi
memory requirements, 2
multi-homed support, enabling, 30