Emulex® OneCommand® Manager for VMware vCenter 6.7 and Later User Guide Release 12.
Broadcom, the pulse logo, Connecting everything, Avago Technologies, Avago, the A logo, Brocade, ClearLink, Emulex, OneCommand, and SLI are among the trademarks of Broadcom and/or its affiliates in the United States, certain other countries, and/or the EU. Copyright © 2011–2019 Broadcom. All Rights Reserved. The term “Broadcom” refers to Broadcom Inc. and/or its subsidiaries. For more information, please visit www.broadcom.com.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide Table of Contents Chapter 1: Introduction ...................................................................................................................... 5 1.1 Compatibility .............................................................................................................................................................5 1.2 Abbreviations ...................................................................................
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide Chapter 7: Generating and Installing Secured Certificates .......................................................... 31 7.1 SSL Certificate.........................................................................................................................................................31 7.1.1 Generating an SSL Certificate ..............................................................................................................
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide Chapter 1: Introduction Emulex® OneCommand® Manager for VMware vCenter 6.7 and Later is a management utility for Emulex host bus adapters (HBAs) that provides status monitoring and online maintenance capability for Emulex adapters in VMware vCenter 6.7 environments. Emulex OneCommand Manager for VMware vCenter 6.7 and Later performs the following functions: NOTE: Discovers adapters on ESXi servers registered to a VMware vCenter 6.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide 1.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide Chapter 2: Installing, Enabling, and Upgrading OneCommand Manager for VMware vCenter 6.7 and Later OneCommand Manager for VMware vCenter 6.7 and Later provides real-time management as a plug-in through VMware vCenter. NOTE: System performance is directly influenced by the speed and efficiency of the underlying network infrastructure. 2.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide Figure 1: Installation options Window 5. Ensure that OCM for VMware vCenter is selected. 6. Program files install by default to C:\Program Files\Emulex. To change this location, click Browse and navigate to where you want the program files to reside. 7. Click Install. The Operation in progress dialog appears. When the process is complete, the OCM for VMware vCenter configuration window appears (Figure 2).
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide NOTE: The Windows firewall setting must allow incoming connections on the HTTP and HTTPS ports that you configure here. If the port numbers are already in use, a popup appears next to the port number (Figure 3). Figure 3: OCM for VMware vCenter configuration Window with Port in use Popup 8. Click Next. The Operation in progress dialog appears.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide – Username – The user name with required privileges. – Password – The user password. 11. Click Register to register OneCommand Manager for VMware vCenter 6.7 and Later with a new vCenter Server. NOTE: You can unregister an existing OneCommand Manager for VMware vCenter 6.7 and Later by clicking Unregister.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide Figure 5: VMware vCenter Client Window 4. From the vCenter client window Menu, select Administration. 5. From the window’s left panel, select Client Plug-ins (Figure 6).
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide Figure 6: vCenter Client Plug-In Window 6. In the Plug-in Manager window, note the status of OneCommand Manager for VMware vCenter 6.7 and Later (Emulex OneCommand). If the OneCommand Manager for VMware vCenter 6.7 and Later installation is complete, the status of Emulex OneCommand is enabled by default. 2.4 Enabling ESXi Management This section describes enabling OneCommand Manager for VMware vCenter 6.7 and Later.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide All other users, including the root user, of the ESXi host cannot perform any actions including reading data. If a user without the required privileges attempts to perform an action in OneCommand Manager for VMware vCenter 6.7 and Later, an error message is displayed. NOTE: To configure user roles and assign privileges, refer to the VMware vCenter Server Guide on the VMware website. 2.4.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide 3. Select the Emulex OneCommand Manager for VMware vCenter radio button. 4. Select Enable or Disable. 2.5 Registering and Unregistering OneCommand Manager for VMware vCenter 6.7 and Later OneCommand Manager for VMware vCenter 6.7 and Later can be registered with more than one vCenter Server. To register or unregister OneCommand Manager for VMware vCenter 6.7 and Later with a new vCenter Server, perform these steps: 1.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide 2.6 Uninstalling OneCommand Manager for VMware vCenter 6.7 and Later Before you uninstall OneCommand Manager for VMware vCenter 6.7 and Later, you must unregister it from the vCenter Server. For more information, see Section 2.5, Registering and Unregistering OneCommand Manager for VMware vCenter 6.7 and Later. CAUTION! When you uninstall OneCommand Manager for VMware vCenter 6.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide Figure 8: Reinstallation Configuration Dialog If OneCommand Manager for VMware vCenter 6.7 and Later was installed earlier with port numbers other than the defaults provided, those configured ports are shown. If the port numbers are already in use, a popup appears next to the port number. NOTE: The Windows firewall setting must allow incoming connections on the HTTP and HTTPS ports that you configure here. 7.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide Chapter 3: Using OneCommand Manager for VMware vCenter 6.7 and Later OneCommand Manager for VMware vCenter 6.7 and Later is available at the host level. 3.1 Viewing the OneCommand Manager for VMware vCenter 6.7 and Later After you are logged on to the VMware vCenter Server, the OneCommand Manager for VMware vCenter 6.7 and Later is under the Configure tab for a particular host that you select in the client.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide 3.2.1 Emulex Device Management Area The Emulex Device Management area is a discovery-tree with icons that represent discovered hosts, adapters, and ports. 3.2.2 OneCommand Tabs In a host view, the OneCommand tabs display configuration, statistical, and status information for network elements. 3.2.3 Information Pane The information pane displays information based upon the OneCommand tab that is selected. 3.2.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide Chapter 4: Viewing Host, Adapter, and Port Information This chapter explains how to view host, adapter, and port information and how to reset a port. 4.1 Viewing Host Information To view host information for a single host, select a host in the console tree-view and select the Emulex OneCommand tab. The selected host’s information appears (Figure 10).
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide 4.2 Viewing Adapter and Port Information This section describes the available adapter and port information, and the procedure for resetting a port. 4.2.1 Viewing Adapter Information When you select an adapter from the Emulex Device Management tree-view, the Adapter Information tab displays general attributes associated with the selected adapter. To view information for an adapter, perform these steps: 1.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide After the system overheating issue is resolved and the adapter has cooled down, reboot the system or, if the system supports hot swapping, cycle the power of the adapter slot. 4.2.2 Viewing Port Details When you select an port from the Emulex Device Management tree-view, the Port Details tab contains general attributes associated with the selected port. To view details for an port, perform these steps: 1.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide – – – – – – – – – – – Port FCID – The FC ID of the selected adapter port. PCI Function – The PCI function number of the selected port. PCI Bus Number – The PCI bus number. Driver Version – The version of the driver installed for the adapter. Driver Name – The executable file image name for the driver as it appears in the Emulex driver download package.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide Figure 13: Port Statistics Tab The following Port Statistics tab fields are displayed: Tx Frames – The FC frames transmitted by this adapter port. Tx Words – The FC words transmitted by this adapter port. Tx KB Count – The FC kilobytes transmitted by this adapter port. Tx Sequences – The FC sequences transmitted by this adapter port. LIP Count – The number of LIP events that have occurred for the port.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide Rx Words – The number of FC words received by this adapter port. Rx KB Count – The received kilobyte count by this adapter port. Rx Sequences – The number of FC sequences received by this adapter port. NOS Count – The number of NOS events that have occurred on the switched fabric (not supported for an arbitrated loop). Dumped Frames – The number of frames that were lost due to a lack of host buffers available.
Emulex OneCommand Manager for VMware vCenter 6.7 and LaterUser Guide Chapter 5: Updating Firmware OneCommand Manager for VMware vCenter 6.7 and Later enables you to update firmware for a single adapter. NOTE: If a secure version of firmware (version 11.0 or later) is installed on an LPe16000-series adapter and you want to update to an earlier unsecured version of firmware, you must remove the secure firmware jumper block before performing the update.
Emulex OneCommand Manager for VMware vCenter 6.7 and LaterUser Guide Figure 16: Firmware Tab (Non-LPe12000-Series Adapters) 4. Click Update Firmware. The Firmware Download dialog is displayed (Figure 17). Figure 17: Firmware Download Dialog 5. Click Browse and navigate to the unzipped, extracted image file that you want to download. 6. On the browse window, select the file and click OK. 7. Click Start Update. Upon completion, the firmware download status is displayed on the dialog.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide Chapter 6: Diagnostic Dumps This section describes creating and viewing diagnostic dumps for Emulex adapters. NOTE: Do not perform any active management operations on the ESXi host when creating diagnostic dumps. 6.1 Creating Diagnostic Dumps Diagnostic dump enables you to create and manage a diagnostic dump for a selected adapter.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide NOTE: If the location is not specified, a prefix of /vmfs/volumes is added to the location. 5. To specify up to 20 files to retain using the Dump Files Retention counter, enter the number of files and click Update. 6. Click Start Dump to initiate a diagnostic dump on the selected port. Click Delete Existing Dump Files to remove existing dump files for the selected port. Click Show Dump Files to display the retained dump files.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide Figure 20: Datastores View of Client 3. Double-click the datastore to view its files, select the dump file, and click Download (Figure 21).
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide Figure 21: Datastore Browser The file is downloaded to the location that you select. You can view the dump file in any text editor.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide Chapter 7: Generating and Installing Secured Certificates OCMNG is a Web application, based on a client-server model, that runs on the Apache Tomcat Web Server. Data is exchanged between the client (browser) and the server (on a remote machine), which requires a secure user logon to manage Emulex adapters on different and multiple hosts. 7.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide 7.1.2 Generating a Self-Signed Certificate A self-signed certificate is a certificate that is signed by itself (the server hosting OneCommand Manager for VMware vCenter 6.7 and Later) rather than a trusted CA. This self-signed certificate includes a public or private key that is distributed by the SSL to verify the identity of the server.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide 7.2 Generating a CSR A Certificate Signing Request (CSR) is a block of encrypted text that is generated on the server on which the certificate is used. A CSR contains information to be included in the SSL certificate, such as the organization name, common name (domain name), locality, country, and other X.509 attributes. It also contains the public key that is included in the certificate.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide 7.2.3 Getting an SSL Certificate The CSR can be submitted to the trusted CA (as chosen by you). The CA validates the CSR and issues a new SSL certificate. 7.2.4 Installing the SSL into the Web Server When you receive the SSL certificate from the CA, you must install the SSL certificate on the server to accept the secure connections. NOTE: The CSR must be generated on the same machine that the server is running on.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide 7.2.4.2 Configuring a Web Server NOTE: These configuration changes are not required if the default keystore name and password are used. If they are different, you must change the configuration as needed. 1. Copy the keystore file or SSC to a directory (preferably, the conf folder) of the Web server. 2. Open the file ${CATALINA_HOME}/conf/server.xml in a text editor. 3. Uncomment the SSL Connector Configuration. 4.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide Chapter 8: Troubleshooting This section includes information about certificate or insecure-content warnings that might be displayed on the console. This section also describes unexpected circumstances and some proposed solutions. 8.1 Security OneCommand Manager for VMware vCenter 6.7 and Later can be installed on different machines. As a result, certificate or insecure-content warnings can occur.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide 8.1.2 Installing a Security Certificate in Internet Explorer 11 or Later Browsers A permanent solution to the security warnings is to install the correct security certificate. To install a security certificate in Internet Explorer 11 or later browsers, perform these steps: 1. Open Internet Explorer in Administrative mode. 2. Load the plug-in URL, and accept the certificate warning.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide Figure 24: Certificate Dialog 5. Click Install Certificate. The Certificate Import Wizard is displayed (Figure 25). Figure 25: Certificate Import Wizard 6. Follow the wizard instructions and install the certificate to the Trusted Root Certification Authorities location.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide 8.1.3 Installing a Security Certificate in Edge Browsers To install a security certificate in Edge browsers, perform these steps: 1. Enter the plug-in url in a new tab in the Edge browser. (This is the IP and port where you installed the plug-in exe.) For example: https://10.123.183.15:443/elxvcplugin You should see a Certificate error message in the address bar. 2. Click Certificate Error and select View Certificate.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide 8.2 Issues and Resolutions Your system might operate in an unexpected manner in several circumstances. The following table explains some of these circumstances and offers one or more solutions for each issue. Table 1: Troubleshooting Issues and Resolutions Issue Resolution The Emulex OneCommand tab is not visible in From the menu, select Administration. Under client Plug-Ins, check the status of the the console.
Emulex OneCommand Manager for VMware vCenter 6.7 and Later User Guide Appendix A: License Notices A.1 VI Java SDK Copyright (c) 2012 Steve Jin. All Rights Reserved. Copyright (c) 2008 VMware, Inc. All Rights Reserved. Copyright (c) 2009 Altor Networks. All Rights Reserved. Copyright (c) 2009 NetApp. All Rights Reserved.
