Emulex® OneCommand® Manager Application User Guide Release 12.
Broadcom, the pulse logo, Connecting everything, Avago Technologies, Avago, the A logo, Brocade, ClearLink, Emulex, ExpressLane, LightPulse, and OneCommand are among the trademarks of Broadcom and/or its affiliates in the United States, certain other countries, and/or the EU. Copyright © 2003–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 Application User Guide Table of Contents Chapter 1: Introduction ...................................................................................................................... 7 1.1 Abbreviations ............................................................................................................................................................8 Chapter 2: Installing and Uninstalling OneCommand Manager Application Components ......... 9 2.
Emulex OneCommand Manager Application User Guide 6.3 Grouping Hosts .......................................................................................................................................................37 6.3.1 Managing Host Groups ...................................................................................................................................38 6.3.2 Creating a Host Group ....................................................................................................
Emulex OneCommand Manager Application User Guide 7.17 Configuring the Driver Parameters .....................................................................................................................78 7.17.1 Activation Requirements ...............................................................................................................................78 7.17.2 Host Driver Parameters Tab ............................................................................................................
Emulex OneCommand Manager Application User Guide Chapter 11: Troubleshooting ......................................................................................................... 125 11.1 General Situations ..............................................................................................................................................125 11.2 Emulex Driver for Linux and OneCommand Manager Application Situations ..............................................126 11.
Emulex OneCommand Manager Application User Guide Chapter 1: Introduction The Emulex® OneCommand® Manager application is a comprehensive management utility for Emulex adapters that provides a powerful, centralized adapter management suite. Adapter management includes discovery, reporting, and management of local and remote adapters from a single console anywhere in the network and across operating system platforms.
Emulex OneCommand Manager Application User Guide 1.
Emulex OneCommand Manager Application User Guide Chapter 2: Installing and Uninstalling OneCommand Manager Application Components This chapter describes installing and uninstalling the OneCommand Manager application. 2.1 Installing the OneCommand Manager Application 2.1.1 In Windows The OneCommand Manager application can be installed two ways: An attended installation using the GUI. An unattended installation using the command line. 2.1.1.
Emulex OneCommand Manager Application User Guide The OneCommand Manager Management Mode dialog enables you to select Secure Management to assign the desired user privileges, or you can choose one of the other management modes. See Section 4.2, Using OneCommand Manager Secure Management, or Section 4.3, Changing Management and Read-Only Mode, for more information. Choose the management type you want 5. Select or clear the Enable TCP/IP Management check box to enable or disable remote management over TCP/IP.
Emulex OneCommand Manager Application User Guide The following are the possible achange values: 0 – Do not allow the management mode to change. 1 – Allow the management mode to change. You can also set the following optional parameters: – MHost – This optional switch allows a non-management-host user to select a Management Host with which to register. If this switch is not specified, the default value of 0 is used, and the capability is disabled.
Emulex OneCommand Manager Application User Guide 5. Untar the file. – For RHEL 7 and RHEL 8, type the following command: tar zxvf elxocm-rhel7-rhel8--.tgz – For SLES 12 and SLES 15, type the following command: tar zxvf elxocm-sles12-sles15--.tgz 6. Change to the elxocm directory created in Step 3.
Emulex OneCommand Manager Application User Guide 10. If you answered 2, 3, or 4 in Step 9, you must decide whether you want the OneCommand Manager application to operate in read-only mode. Read-only mode prevents users from performing some operations, such as resetting adapters, updating an adapter's firmware, or changing adapter driver properties and bindings. It affects only the local OneCommand Manager application interface. These operations can still be performed using remote management.
Emulex OneCommand Manager Application User Guide NOTE: Prior to installation, OneCommand groups must be configured on the LDAP network or the local host machine for Secure Management operation. See Section 4.2.1, OneCommand Manager Secure Management Configuration Requirements, for configuration instructions. 4. Run the installation script to begin installation by typing the following command. .
Emulex OneCommand Manager Application User Guide 2.1.4 In VMware For VMware hosts, you can manage adapters using the OneCommand Manager application on Windows, but you must install and use the appropriate Emulex CIM Provider. The Emulex CIM Provider is available as an offline bundle in ESXi platforms. Use the offline bundle to update software on VMware platforms. For more information about the ESXi Patch Management activities, refer to the VMware website.
Emulex OneCommand Manager Application User Guide Chapter 3: Starting and Stopping the OneCommand Manager Application This chapter describes how to start and stop the OneCommand Manager application. NOTE: For VMware systems, if you are running only a CIM client, you do not need to stop it. 3.1 In Windows To start the OneCommand Manager application, from the Windows desktop, select Start > All Programs > Emulex > OCManager. If Secure Management is enabled, you are prompted for your user name and password.
Emulex OneCommand Manager Application User Guide NOTE: Broadcom The -n parameter stops only the OneCommand Manager application and the associated elxdiscoveryd daemon. When the stop_ocmanager script is run without the -n parameter, the script stops the OneCommand Manager application and all associated daemons.
Emulex OneCommand Manager Application User Guide Chapter 4: Using the OneCommand Manager Application To properly view the OneCommand Manager application, make sure that your system meets the following display requirements: For Windows, Linux, and Solaris systems, the display resolution must be set to 1024 × 768 or higher. For Windows systems, use the default font size. The display must run in 256-color mode or higher. OneCommand Manager application icons use 256 colors.
Emulex OneCommand Manager Application User Guide NOTE: The element that you select in the discovery-tree determines whether a menu item or toolbar button is active. For example, if you select the local host or other system host, the Reset Port item on the Adapter menu is unavailable. The Reset Port toolbar button is unavailable as well. The capabilities displayed by your local interface match those of the remote server.
Emulex OneCommand Manager Application User Guide Fabric View button Displays the fabrics in the SAN with their fabric IDs. Displays the ports under each switch. If targets are present, displays each WWPN. Multiple adapters can refer to the same target. If LUNs are present, displays each LUN number. If the fabric ID is all zeros, no fabric is attached. Virtual Ports View button Displays virtual ports in the SAN. Local HBAs Only button Displays only local adapters.
Emulex OneCommand Manager Application User Guide 4.1.3 Discovery-Tree The discovery-tree (Figure 4) has icons that represent discovered hosts, adapters, ports, virtual ports, fabrics, targets, and LUNs. Figure 4: Discovery-Tree 4.1.3.1 Discovery-Tree Icons Discovery-tree icons represent the following: The local host. Other hosts connected to the system. A green Adapter icon with black descriptive text represents an online adapter.
Emulex OneCommand Manager Application User Guide The Port icon represents an adapter port. A Port icon with a red X indicates the link is down. NOTE: Multiport adapters are represented in the discovery-tree with separate port icons for each port, with the port number displayed next to the icon. The ASIC Node icon, only displayed for dual ASIC adapters, represents each ASIC on the adapter. Each ASIC is managed independently.
Emulex OneCommand Manager Application User Guide 4.2 Using OneCommand Manager Secure Management OneCommand Manager Secure Management gives system administrators the ability to further enhance the active management security of their networks. Using Secure Management, administrators can define each user's privileges for managing both local and remote adapters. When running in Secure Management mode, users must log on with their user name and password to run the OneCommand Manager application.
Emulex OneCommand Manager Application User Guide a. Allowed if the username and password are the same on both domains. b. To inform you of an unsecured server that you might want to secure. Table 4: Passive Commands: Machines on Any Domain Remote Server (Secure) Client Remote Server (Not Secure) Secure Allowed Allowed Not Secure Allowed Allowed 4.2.
Emulex OneCommand Manager Application User Guide If the IP port number is changed, the utility restarts the OneCommand Manager application discovery server and management agent to use the new settings. If the servers cannot be stopped and restarted, you are prompted to reboot the host for the new TCP/IP management settings to take effect. CAUTION! The IP port number must be the same for all hosts that are to be managed.
Emulex OneCommand Manager Application User Guide 4.4 Using CIM (Windows Only) VMware uses CIM as the only standard mechanism for device management. The OneCommand Manager application uses the standard CIM interfaces to manage the adapters in the Visor environment and supports CIM-based devices and HBA management. To manage the adapters on a VMware host using the OneCommand Manager application, you must install the Emulex CIM Provider on the VMware host.
Emulex OneCommand Manager Application User Guide Chapter 5: Configuring Discovery This chapter describes how to configure discovery to find Emulex adapters on remote hosts. 5.1 Discovery Using the TCP/IP Access Protocol You can discover adapters on IPv4 and IPv6 TCP/IP hosts and on hosts configured to support the CIM interface that have the OneCommand Manager application installed (Figure 5).
Emulex OneCommand Manager Application User Guide 5.1.1 Hosts File The TCP/IP discovery function of the OneCommand Manager application discovery server relies on a file called the hosts file. This plain-text file contains a list of hosts that the utility attempts to discover. The discovery server does not attempt to discover hosts over TCP/IP through any other mechanisms (such as ping sweeps and broadcasts).
Emulex OneCommand Manager Application User Guide 5.1.1.2 Copying the File A hosts file on one host can be copied and used on another host. This is useful when there are multiple hosts on the same network running the OneCommand Manager application. For example, after the remote hosts are added to the hosts file on one host, you can copy it to other hosts so you do not need to create another hosts file.
Emulex OneCommand Manager Application User Guide Figure 7: Add Remote TCP/IP Host Dialog with CIM Credentials 4. Edit the default CIM settings if necessary and click Add Host. A message appears indicating that the new host was successfully added. 5.1.3 Adding a Range of Hosts (IPv4 Only) NOTE: This option is not available in Strictly Local or Local Plus Management modes. You can find the TCP/IP-accessed manageable hosts by searching a range of IPv4 addresses.
Emulex OneCommand Manager Application User Guide Figure 8: Add Range of TCP/IP Hosts Dialog To add a range of remote hosts, perform these steps: 1. From the Discovery menu, select TCP/IP > Add Range of Hosts. The Add Range of TCP/IP Hosts dialog appears (Figure 8). 2. Enter the complete start and end address range (IPv4 only) and click Add. The added address range appears in the dialog. Add any additional ranges that you want to search. 3. Click Start Discovery.
Emulex OneCommand Manager Application User Guide To remove hosts, perform these steps: 1. From the Discovery menu, select TCP/IP > Remove Host(s). The Remove Hosts dialog shows a list of discovered hosts. Any host that is not currently discovered appears in red. Click Show Undiscovered Hosts Only to display only currently undiscovered hosts. 2. From the Remove Hosts dialog, select the hosts that you want to remove. You can select all the displayed hosts by clicking Select All. 3.
Emulex OneCommand Manager Application User Guide 2. Define the discovery properties that you want. 3. Set the default CIM credentials in the CIM credentials area that are used to connect to all the ESXi hosts that are managed through the CIM interface. – Protocol – The HTTP or HTTPS protocol can be used to connect to the VMware hosts. – Port Number – The default port numbers used for HTTP and HTTPS are 5988 and 5989, respectively. The port number changes automatically according to the protocol selected.
Emulex OneCommand Manager Application User Guide Figure 10: Discovery Information (Host View Selected) The following Discovery Information fields are displayed: Hosts – The total number of discovered host computers containing manageable Emulex adapters. This number includes servers, workstations, personal computers, multiprocessor systems, and clustered computer complexes. Adapters – The total number of discovered adapters.
Emulex OneCommand Manager Application User Guide Chapter 6: Managing Hosts This chapter describes viewing host information, managing host groups, and searching for hosts. 6.1 Viewing Host Information Two tabs show host information: the Host Information tab (Figure 11) and the Host Driver Parameters tab (Figure 46). The Host Information tab is read-only. The Host Driver Parameters tab enables you to view and define adapter driver settings for a specific host. See Section 7.17.
Emulex OneCommand Manager Application User Guide The Host Information tab (Figure 11) displays the following fields: Operating System – Details about the installed operating system. Management IP Address – The host's IP address; for example, 138.239.82.131. Local Host is displayed if you selected the host from which you are running the OneCommand Manager application. Remote Manager Server Version – The version of the OneCommand Manager application server that is running on the host.
Emulex OneCommand Manager Application User Guide Figure 12: Host Group Information Tab The following Host Group Information fields are displayed: Group Name – The name of the selected group. Number Hosts – The total number of hosts assigned to the group. Number of Adapters – The total number of discovered adapters in the group. Number of Physical Ports – The total number of ports in the group. 6.
Emulex OneCommand Manager Application User Guide You can also perform batch operations, such as firmware download and driver parameter updates on a selected set of groups. See Section 8.2, Updating Firmware for Multiple Adapters, for more information. NOTE: Grouping hosts is not supported on VMware. To display all hosts without grouping, perform one of the following tasks: – From the View menu, clear Show Groups. – From the toolbar, clear the Show Host Groups button.
Emulex OneCommand Manager Application User Guide Figure 13: Host Group Management Dialog The following Host Group Management fields are displayed: Available Hosts – The list of hosts that can be added to a host group. You can select a host and right-click to see its group assignments. Show ungrouped hosts – If selected, displays only hosts that are currently assigned to a host group. Hosts in Selected Group – The list of hosts assigned to the currently selected host group.
Emulex OneCommand Manager Application User Guide Figure 14: Create New Host Group Dialog 3. Enter the name of the group you want to create and click OK. The new group appears in the Groups list on the Host Group Management dialog. 6.3.3 Deleting a Host Group To delete a host group, perform these steps: 1. From the View menu, select Manage Groups. The Host Group Management dialog appears (Figure 13). 2. From the Groups list, select the group that you want to delete.
Emulex OneCommand Manager Application User Guide 6.3.5 Removing a Host from a Host Group To remove a host from a host group, perform these steps: 1. From the View menu, select Manage Groups. The Host Group Management dialog appears (Figure 13). 2. From the Groups list, select the group containing the host you want to remove. 3. From the Hosts in Selected Group list, select the host you want to remove and click the Left Arrow.
Emulex OneCommand Manager Application User Guide 6.4 Searching for Hosts in the Discovery-Tree The OneCommand Manager application enables you to search the discovery-tree (Figure 4) for a particular host by the host’s name. If the specified host name is found, the discovery-tree scrolls up or down to bring the desired host name into view. This capability is especially useful when you are searching for a host in a large installation with hundreds or thousands of hosts.
Emulex OneCommand Manager Application User Guide Chapter 7: Managing Adapters and Ports This chapter describes the various adapter and port management functions, you can perform using the OneCommand Manager application. 7.1 Viewing Adapter Information When you select an adapter from the discovery-tree (Figure 4), the Adapter Information tab (Figure 16) contains general attributes associated with the selected adapter. To view adapter information, perform these steps: 1.
Emulex OneCommand Manager Application User Guide Adapter Temperature – If the adapter's temperature is not available, Not Supported is displayed. If supported by the adapter, this field displays the following adapter temperature-related status messages: – Normal: The adapter’s temperature is within normal operational range. – Warning: The adapter’s temperature is beyond normal operational range. If the temperature continues to increase, the adapter shuts down.
Emulex OneCommand Manager Application User Guide Figure 17: Adapter Information Tab (Two-Port Adapter with Two-Lane Trunking Enabled) To set trunking, perform these steps: 1. In the discovery-tree (Figure 4), select the supported adapter port whose trunking you want to set. 2. Select the Adapter Information tab (Figure 17). 3. Select Disabled, 2-lane, or 4-lane.
Emulex OneCommand Manager Application User Guide 7.2 Viewing Port Information When you select a port from the discovery-tree, the Port Information tab (Figure 19) contains general attributes associated with the selected adapter. NOTE: Some information cannot be retrieved when the port is offline. To view port information, perform these steps: 1. Select the Host or Fabric view. 2. Select a port in the discovery-tree. 3. Select the Port Information tab (Figure 19).
Emulex OneCommand Manager Application User Guide – Fabric Name or Host Name – The Fabric Name field is displayed in the Host view. This is a 64-bit worldwide unique identifier assigned to the fabric. The Host Name field is displayed in the Fabric view and is the name of the host containing the adapter. – Boot Version – The version of boot code installed on the selected adapter port. If the boot code is disabled, the field displays Disabled.
Emulex OneCommand Manager Application User Guide 3. From the Port Information tab, click Enable Port or Disable Port. The following popup appears. 4. Click Yes to enable or disable the port. 7.3 Viewing Firmware Parameters To view firmware parameters, select the Firmware Parameters tab (Figure 20). Figure 20: Firmware Parameters Tab The following Firmware Parameters tab fields are displayed: Configured Link Speed – This field displays the link speeds that are supported on the port.
Emulex OneCommand Manager Application User Guide FA-PWWN – This field displays the FA-PWWN status of the port. FA-PWWN allows a switch to assign a virtual WWPN to the initiator. Disabled is the default setting. (Not supported on LPe12000-series adapters.) Dynamic D-Port – This field displays the Dynamic D_Port status of the port. Enabled is the default setting. (Not supported on LPe12000-series adapters.) FEC – This field displays the FEC status of the port. Enabled is the default setting.
Emulex OneCommand Manager Application User Guide 4. Click OK. 5. From the toolbar, click the Reset Port button. In some situations, the currently configured link speed is not in the supported speed list for the port. This situation can occur if a new SFP is installed that supports a different set of link speeds than the previously installed SFP.
Emulex OneCommand Manager Application User Guide Figure 22: Change Firmware Parameter Popup 5. From the toolbar, click the Reset Port button. 6. Restart the OneCommand Manager application. NOTE: The following popup appears if the FA-PWWN change was unsuccessful (Figure 23). Figure 23: Change Firmware Parameter Popup 7.3.3 Disabling and Enabling Dynamic D_Port Tests Dynamic D_Port is enabled on the HBA by default. See Section 10.5, Running D_Port Tests for more information about Dynamic D_Port.
Emulex OneCommand Manager Application User Guide 6. Restart the OneCommand Manager application. 7.4 Viewing Firmware Information Use the Firmware tab (Figure 24) to download firmware and create diagnostic dumps. (Not supported on LPe12000-series HBAs; see Section 7.11, Viewing Maintenance Information.) To view firmware information, perform these steps: 1. Select the Host view. 2. Select an adapter in the discovery-tree (Figure 4). 3. Select the Firmware tab (Figure 24).
Emulex OneCommand Manager Application User Guide 7.5 Viewing and Clearing Statistics When you select a port from the discovery-tree, the Statistics tab (Figure 25) provides cumulative totals for various error events and statistics on the port. If supported by the adapter, you can also clear all the values displayed in the tab. NOTE: Some statistics are cleared when the adapter is reset. To view statistics, perform these steps: 1. Select the Host or Fabric view. 2. Select a port in the discovery-tree. 3.
Emulex OneCommand Manager Application User Guide Tx KB Count – FC kilobytes transmitted by this FC function. Tx Sequences – FC sequences transmitted by this FC function. LIP Count – The number of LIP events that have occurred for the FC function. This field is not supported if the topology is not arbitrated loop. Loop initialization consists of the following: – Temporarily suspending loop operations.
Emulex OneCommand Manager Application User Guide 7.6 Viewing Virtual Port Information The Discovery Information tab (Figure 26) displays information about virtual ports and their associated targets and LUNs. To view virtual port information, perform these steps: 1. Perform one of the following tasks: – From the View menu, select Group Adapters by Virtual Port. – From the toolbar, click the Group Adapters by Virtual Port button. The Discovery Information tab appears (Figure 26).
Emulex OneCommand Manager Application User Guide 7.7 Creating and Deleting Virtual Ports This section describes how to create and delete virtual ports. 7.7.1 Creating Virtual Ports Using the Virtual Ports tab (Figure 27), you can automatically generate the WWPN for the virtual port based on the WWPN for the physical port, or you can manually type the WWPN. NOTE: The OneCommand Manager application cannot create or delete virtual ports on VMware ESXi server systems.
Emulex OneCommand Manager Application User Guide Figure 27: Virtual Ports Tab 3. Perform one of the following tasks: – Select Auto-generate world-wide port name. The OneCommand Manager application creates the unique WWPN for the new virtual port based on the WWPN of the FC function. This option allows you to automatically create up to 255 unique virtual ports for each physical port. It also has the advantage that the new WWPN is unique.
Emulex OneCommand Manager Application User Guide 5. Click Create Virtual Port. A popup notifies you that the virtual port was created. The popup also displays the new virtual port's WWPN. Each virtual port has its own WWPN, but its WWNN is the same as the physical port's WWNN. NOTE: If you entered a WWPN that is already in use, you are prompted to enter another WWPN. 6. Click OK.
Emulex OneCommand Manager Application User Guide Figure 28: Virtual Port Tab 3. Click Remove Virtual Port. The Delete Virtual Port Warning popup appears (Figure 29).
Emulex OneCommand Manager Application User Guide NOTE: The link on the physical port must be up to delete a virtual port. The Remove Virtual Port button on the Virtual Port tab is disabled if the link is down. 4. Select It is OK to delete the virtual port and click OK. You are notified that the virtual port is no longer available and that it was removed from the discovery-tree (Figure 4). 5. Click OK. 7.
Emulex OneCommand Manager Application User Guide 7.9 Viewing Port Transceiver Information When you select a port from the discovery-tree (Figure 4), the Transceiver Data tab (Figure 31) enables you to view transceiver information, such as vendor name, serial number, and part number. If the adapter does not support some or all of the transceiver data, the fields display N/A. To view transceiver information, perform these steps: 1. Select the Host or Fabric view. 2.
Emulex OneCommand Manager Application User Guide – Speed – The speed, or speeds, at which the selected port can run. – OUI – The vendor’s OUI, also known as the IEEE Company Identifier for the vendor. – Date – The vendor’s date code in MM/DD/YY format. – Serial Number – The serial number provided by the vendor. – Part Number – The part number provided by the SFP vendor. – Revision – The vendor revision level. Diagnostic Data area: – Temperature – The internally measured module temperature.
Emulex OneCommand Manager Application User Guide Figure 32: VPD Tab The following VPD fields are displayed: Product Name – Product information about the selected FC function. PN (Part Number) – The adapter's part number. SN (Serial Number) – The adapter's serial number. MN (Manufacture ID) – The manufacturer’s identification number. Vx – Vendor unique data. V indicates a vendor-specific field. An adapter can have none, one, or more of these fields defined.
Emulex OneCommand Manager Application User Guide 7.11 Viewing Maintenance Information NOTE: This option is not available in read-only mode. Use the Maintenance tab (Figure 33) to view firmware information and update adapter firmware. You can also configure boot from SAN and change WWPN and WWNN information for the selected adapter port. To view firmware information, perform these steps: 1. Select the Host or Fabric view. 2. Select a port in the discovery-tree. 3. Select the Maintenance tab (Figure 33).
Emulex OneCommand Manager Application User Guide NOTE: Enabling adapter boot only causes the port to load the boot code and run it during system startup. It does not mean that the port boots from SAN. To boot from SAN, the boot type must be enabled. Enable this in the Boot from SAN configuration window for each boot type. (See Section 7.17.5, Configuring Boot from SAN.) WWN Management area: NOTE: The WWN Management area is disabled when FA-PWWN is enabled on an adapter port.
Emulex OneCommand Manager Application User Guide Figure 34: Target Information Tab The following Target Information tab fields are displayed: Mapping Information area: – FC ID – The FC ID for the target; assigned automatically in the firmware. – SCSI Bus Number – The SCSI bus number to which the target is mapped. – SCSI Target Number – The target's identifier on the SCSI bus. – Node WWN – A unique 64-bit number, in hexadecimal, for the target (N_PORT or NL_PORT).
Emulex OneCommand Manager Application User Guide This script prevents you from having to reboot. If the host machine is rebooted after the LUN is added to the target array, you do not need to run the script. To view the LUN information, perform these steps: 1. Select the Host, Fabric, or Virtual Port view. 2. From the discovery-tree, select a LUN. The LUN Information tab appears (Figure 35).
Emulex OneCommand Manager Application User Guide – Capacity – The capacity of the LUN, in MB. – Block Size – The length of a logical unit block, in bytes. LUN Masking Information area: – Current Mask Status – Possible states are Masked or Unmasked. See Section 7.15, Masking and Unmasking LUNs (Windows), for more information on LUN masking. 7.14 Viewing Target Mapping The Target Mapping tab (Figure 36) enables you to view current target mapping and to set up persistent binding.
Emulex OneCommand Manager Application User Guide The following Target Mapping tab fields are displayed: Current Settings area: NOTE: For Linux and VMware ESXi, this area is N/A. – Active Bind Type – WWPN, WWNN, or a D_ID. – Automapping – The current state of SCSI device automapping: Enabled (default) or Disabled. Current Mappings area: – Lists current mapping information for the selected FC function. Shows the WWPN, WWNN, D_ID, and SCSI ID of the currently mapped device.
Emulex OneCommand Manager Application User Guide 7.14.1.1 Changing Automapping Settings To change automapping settings, perform these steps: 1. Select the Host or Fabric view. 2. In the discovery-tree, select the FC function you want to set up with persistent binding. 3. Select the Target Mapping tab (Figure 36). All targets are displayed. 4. If you want to make changes, click Change Settings. The Mapped Target Settings dialog appears. You can enable or disable auto-mapping and change the active bind type.
Emulex OneCommand Manager Application User Guide 7.14.1.3 Binding a Target That Does Not Appear in the Persistent Binding Table NOTE: It is possible to specify a SCSI bus and target that have already been used on behalf of a different FC target. Attempting to bind a target already in the Persistent Binding table on the Target Mapping tab results in the following error message: Target already in target list.
Emulex OneCommand Manager Application User Guide Figure 39: LUN Masking Tab 7.15.1 LUN Masking Conventions and Guidelines LUN icons in the discovery-tree (Figure 4) reflect the live mask state used by the driver. Green LUN icons indicate unmasked LUNs. Gray LUN icons indicate masked LUNs. Red text indicates that a LUN mask has been changed, but not applied (saved). The following LUN Masking tab information is displayed: LUN – The FC LUN number.
Emulex OneCommand Manager Application User Guide 3. Select the LUN Masking tab (Figure 39). This tab contains a list of the same set of LUNs that appear below the FC target in the discovery-tree (Figure 4). 4. In the LUN list of the LUN Masking tab, select one or more LUNs. The Mask Selected LUN(s), Unmask Selected LUN(s), Unmask All LUNs, Restore, and Apply buttons become active as appropriate. For example, if the LUN is currently unmasked, only the Mask Selected LUN(s) button is active. 5.
Emulex OneCommand Manager Application User Guide To change an FC function’s WWPN or WWNN, perform these steps: 1. Perform one of the following tasks: – From the View menu, select Group Adapters by Host Name. – From the toolbar, click the Group Adapters by Host Name button. – From the Host Grouping menu, select Group Adapter by Fabric Names. 2. In the discovery-tree, select the FC function that you want to change. 3. Select the Maintenance tab (Figure 40). Figure 40: Maintenance Tab 4. Click Change WWN.
Emulex OneCommand Manager Application User Guide Figure 41: Warning About Changing WWN 5. Click Yes. The OneCommand Manager Change WWN Configuration dialog appears (Figure 42). Figure 42: OneCommand Manager Change WWN Configuration Dialog 6. Perform one of the following tasks: – Enter a new WWPN and WWNN. – Click Get Factory Default WWNs to load the settings that were assigned to the FC function when the adapter was manufactured to the New WWPN and New WWNN fields.
Emulex OneCommand Manager Application User Guide NOTE: If the adapter or firmware does not support volatile WWNs, the Write changes to volatile memory for temporary use check box is dimmed. 8. Click OK. After checking for a duplicate WWPN, the new WWPN and new WWNN values are saved for volatile or non-volatile use. The new WWPN and WWNN appear in the Pending Changes section in the WWN Management area of the Maintenance tab until the system is rebooted. 9. Reboot the system for the changes to take effect.
Emulex OneCommand Manager Application User Guide 7.16.1 Changing Port Names NOTE: This option is not available in read-only mode. The OneCommand Manager application allows you to change the adapter port names in the discovery-tree. For example, you might want to identify a particular FC function with the role it supports, such as a tape drive, scanner, or some other device. Use any characters you want for names, and names can be up to 255 characters in length.
Emulex OneCommand Manager Application User Guide Figure 43: Reset Adapter Popup 3. Click Yes to perform the reset. The reset can require several seconds to complete. During the reset, the status bar shows Reset in progress. When the reset is finished, the status bar shows Reset Completed. 7.17 Configuring the Driver Parameters NOTE: This option is not available in read-only mode.
Emulex OneCommand Manager Application User Guide For information on changing parameters for a single adapter, see Section 7.17.3, Setting the Driver Parameters. For information on changing parameters for the host, see Section 7.17.3.5, Setting the Driver Parameters for All FC Functions in a Host. NOTE: Setting a parameter for a specific port overrides all host parameters for the port.
Emulex OneCommand Manager Application User Guide 7.17.3 Setting the Driver Parameters The Driver Parameters tab for FC functions and hosts enables you to modify driver parameters for a specific FC function or all FC functions in a host. For example, if you select a host in the discovery-tree (Figure 4), you can globally change the parameters for all FC functions in that host. If you select an FC function in the discovery-tree, you can change parameters for only that FC function.
Emulex OneCommand Manager Application User Guide Figure 45: Driver Parameters Tab (Adapter Selected) 4. Click the parameter that you want to change. A description of the parameter appears on the right side of the tab. 5. Enter a new value in the Value field in the same hexadecimal or decimal format as the current value or select a value from the list. If the current value is in hexadecimal format, it is prefaced by 0x (for example, 0x2d). You can enter a new hexadecimal value without the 0x.
Emulex OneCommand Manager Application User Guide 7.17.3.3 Resetting All Default Values To reset all parameter values to their default (factory) values, click Defaults in the Driver Parameters tab (Figure 45). 7.17.3.4 Setting an Adapter Parameter Value to the Host Adapter Parameter Value To set an adapter parameter value to the corresponding host parameter value, perform these steps: 1. Select the Host or Fabric view. 2. In the discovery-tree (Figure 4), select the adapter port. 3.
Emulex OneCommand Manager Application User Guide Figure 46: Host Driver Parameters Tab – Host Selected 5. Enter a new value in the Value field in decimal or hexadecimal format, depending on how the current value is presented. If the value is in hexadecimal format, it is prefaced by 0x (for example, 0x2d). 6. To make a change temporary (the parameter reverts to its last permanent setting when the system is rebooted), select Make changes temporary. This option is available only for dynamic parameters. 7.
Emulex OneCommand Manager Application User Guide 4. Reload the driver. Type the following command: modprobe lpfc 5. Start the elxhbamgr service (remote service). Type the following command: ./start_ocmanager The OneCommand Manager application discovery service starts automatically when you start the application. NOTE: For changes to persist after a reboot, you must create a new ramdisk image. Refer to the Emulex Drivers for Linux User Guide for more information. 7.17.
Emulex OneCommand Manager Application User Guide Figure 47: Save Driver Parameters Dialog 8. Choose whether to save all parameters or only those parameters whose current values differ from their corresponding default values. A list of the saved parameters and their current values appear in the Saved Parameters list. 9. Click Save. 7.17.4.1 Assigning Batch Mode Parameters To assign batch mode parameters to adapters, perform these steps: 1. From the Batch menu, select Update Driver Parameters.
Emulex OneCommand Manager Application User Guide Figure 48: Batch Driver Parameter Update Dialog 3. The Batch Driver Parameter Update dialog appears (Figure 48). Select the file that you want to use and click OK. A dialog notifies you that the OneCommand Manager application is searching for compatible adapters. After compatible FC functions are found, the Driver Parameter File field of the Batch Driver Parameter Update dialog displays the selected file's path.
Emulex OneCommand Manager Application User Guide 7.17.5 Configuring Boot from SAN You can use the OneCommand Manager application to configure a system to boot from an attached LUN. Boot from SAN allows servers on a storage network to boot their operating systems directly from a SAN storage device, typically identified by its WWPN and a LUN located on the device. By extending the server system BIOS, boot from SAN functionality is provided by the BootBIOS contained on an Emulex adapter in the server.
Emulex OneCommand Manager Application User Guide You must know the boot code type that the system supports; the OneCommand Manager application cannot detect this information. You can configure any boot type, but if the system does not support that type, it cannot boot from SAN. One of the following adapter drivers must be installed: – Windows: Storport Miniport driver – Linux: Emulex driver – Solaris: inbox driver – VMware: Emulex driver To configure boot from SAN, perform these steps: 1.
Emulex OneCommand Manager Application User Guide 4. Verify that the Adapter field contains the WWPN of the FC function, and ensure that you configure the correct adapter FC function. 5. From the Boot Type menu, select X86, EFI, or OpenBoot. NOTE: x86 and OpenBoot share the same configuration memory space. You cannot configure an adapter for both x86 and OpenBoot at the same time.
Emulex OneCommand Manager Application User Guide Figure 50: EFIBoot Boot from SAN Configuration Dialog: FABL Enabled 9. For x86 and EFIBoot, select one or more boot devices. For OpenBoot, select only one boot device. 10. Perform one of the following tasks on the Boot from SAN Configuration dialog (Figure 49): – Select Target WWPN, type the desired WWPN, and click OK. – Select Target D_ID, type desired D_ID, and click OK. – Select Target LUN, type the desired LUN, and click OK.
Emulex OneCommand Manager Application User Guide Figure 51: Select Boot Device Window (for x86 or EFIBoot) 11. On the Boot from SAN Configuration dialog (Figure 49), click Apply to save your changes but leave the dialog open, or click OK to apply the changes and close the dialog. NOTE: Click Close to close the Boot from SAN Configuration dialog without saving your changes. A message prompts you to discard your changes. 12. If you changed x86 or EFI boot settings, the following popup appears. Click OK.
Emulex OneCommand Manager Application User Guide 7.18.1 x86 Boot Advanced Adapter Settings Dialog Use the x86 Boot Advanced Adapter Settings dialog (Figure 52) to configure advanced settings for the selected x86 adapter. All selections are cleared by default. All changes require a reboot to activate. NOTE: When x86 settings are changed, the same changes are also made to EFI. Conversely, when EFI settings are changed, the changes are also made to x86.
Emulex OneCommand Manager Application User Guide Enable auto boot sector – Automatically defines the boot sector of the target disk for the migration boot process, which applies only to HPE MSA1000 arrays. If no partition exists on the target, the default boot sector format is 63 sectors. Auto Scan – With auto scan enabled, the first device issues a name server inquiry. The boot device is the first D_ID, LUN 0, or non-LUN 0 device returned, depending on the option you select.
Emulex OneCommand Manager Application User Guide EFIBoot Advanced Adapter Settings field definitions follow: Boot Target Scan – This option is available only if none of the eight boot entries are configured to boot by using D_ID or WWPN. – NVRAM Targets (default) – Discovers only LUNs that are saved to the adapter’s NVRAM. – Discovered Targets – Discovers all devices that are attached to the port. Discovery can take a long time on large SANs. – None.
Emulex OneCommand Manager Application User Guide 7.19 Using FC-SP DHCHAP Authentication Use the DHCHAP tab to view and configure FC-SP DHCHAP authentication between an adapter and a switch. FC-SP-2 DHCHAP authentication is disabled by default. NOTE: Boot from SAN is not supported when DHCHAP authentication is enabled. DHCHAP is supported only on Windows, Linux, and VMware operating systems. DHCHAP is available only for physical ports, not for virtual ports.
Emulex OneCommand Manager Application User Guide Figure 55: DHCHAP Tab (LPe31000-series Adapter Depicted) The following DHCHAP tab fields and buttons are displayed: Adapter-Level Configuration area (not supported on LPe12000-series adapters): – Click Delete Authentication For All Ports to permanently delete the entire authentication configuration for all the ports on the adapter.
Emulex OneCommand Manager Application User Guide – Re-authenticate – If this setting is enabled, the FC driver can periodically initiate authentication. – Re-auth Interval – The value, in minutes, that the FC driver uses to periodically re-initiate authentication. Valid interval ranges are 10 to 3600 minutes. The default is 300 minutes.
Emulex OneCommand Manager Application User Guide 7.19.2 Viewing Saved Authentication Configuration Entities The Entity List displays a list of entity pairs that have a saved authentication configuration. The list might include entity pairs for authentication configurations that are no longer valid or configurable. For example, the list would contain an entity pair whose configuration become obsolete and invalid after a port WWN change.
Emulex OneCommand Manager Application User Guide 7.19.3 Setting or Changing Secrets You can change or set the local or remote secret (password). The local secret is typically used by the driver when the adapter initiates authentication to the switch. The remote secret is used by the driver if the switch attempts to authenticate with the adapter. Bi-directional authentication requires the remote secret. To set or change secrets, perform these steps: 1.
Emulex OneCommand Manager Application User Guide 7.19.4 Changing the Authentication Configuration NOTE: You can configure DHCHAP only on the local host. To view or change the authentication configuration, perform these steps: 1. In the discovery-tree (Figure 4), select the adapter port whose configuration you want to view or change. 2. Select the DHCHAP tab (Figure 55).
Emulex OneCommand Manager Application User Guide Figure 58: OneCommand Manager Application Running on the Base Host after Discovering the Guest Host Broadcom OCM-APP-LPE-UG124-100 101
Emulex OneCommand Manager Application User Guide Chapter 8: Updating Adapter Firmware The OneCommand Manager application enables you to update firmware for a single adapter or simultaneously across multiple adapters. CAUTION! Updating firmware or boot code on an LPe12000-series adapter that is being used to boot from SAN can cause unpredictable behavior. After the update is completed, an adapter reset is issued, which can cause a loss of connectivity to the SAN and possible loss of data.
Emulex OneCommand Manager Application User Guide If the adapter is already connected to a boot device, check that the system is in a state in which this type of maintenance can be performed: – I/O activity on the bus has been stopped. – Cluster software, or any other software that relies on the adapter to be available, is stopped or paused. NOTE: For vendor-branded adapters, refer to the vendor’s website or contact the vendor’s technical support for the firmware files.
Emulex OneCommand Manager Application User Guide A status bar shows the progress of the download. The adapter in the discovery-tree (Figure 4) is displayed in black text when the update is complete. NOTE: The adapter in the discovery-tree might change to blue during the download, but this is normal. 7. Click Close. The Firmware tab displays the updated firmware information for the selected adapter. You are notified by a popup if a reset is necessary to activate the firmware. 8.
Emulex OneCommand Manager Application User Guide Figure 60: Batch Firmware Download Dialog: Selecting Adapters to Update 3. The Firmware File Selection dialog appears. Select the file that you want to use and click OK. A dialog notifies you that the OneCommand Manager application is searching for compatible adapters. After compatible adapters are found, the Firmware File field of the main Batch Firmware Download dialog displays the selected image file's path.
Emulex OneCommand Manager Application User Guide Figure 61: Batch Firmware Download Dialog: Download Complete A popup notifies you if a reset is necessary to activate the firmware. 5. Click OK to close the popup. To save a copy of the activity log when downloading is finished, click Save Log File. To refresh the Batch Firmware Download dialog information when downloading is finished, click Reset Display.
Emulex OneCommand Manager Application User Guide Chapter 9: Exporting SAN Information 9.1 Creating a SAN Report The OneCommand Manager application enables you to create reports about discovered SAN elements. Reports are generated in .xml and .csv format and include all the SAN information that is displayed through the various OneCommand Manager application tabs. NOTE: Creating a SAN report can take several minutes for a large SAN. To create a SAN report, perform these steps: 1.
Emulex OneCommand Manager Application User Guide Chapter 10: Diagnostics This chapter describes the diagnostic tests that can be run on Emulex adapters. Use the Diagnostics tab to perform the following tasks: View PCI registers and Flash Contents information. Run the following tests on Emulex adapters installed in the system: – PCI loopback – Internal loopback – External loopback – POST – Echo (end-to-end) – Quick Test These tests are not available in read-only mode.
Emulex OneCommand Manager Application User Guide Figure 62: Diagnostics Tab 10.1 Viewing Flash Contents, Overlay Details, PCI Registers, and Wakeup Information The Diagnostics tab shows PCI register dump information and flash memory contents. The information is read-only and is outlined in the following section (Figure 63).
Emulex OneCommand Manager Application User Guide Figure 63: PCI and Flash Information on the Diagnostics Tab 10.1.1 Viewing Flash Contents By selecting Show Wakeup Image Only in the Flash Contents area, the flash overlays that are not loaded when the system is booted are not displayed. The default setting is not selected. 10.1.2 Viewing Overlay Details If you double-click a flash overlay, a popup displays details about that overlay (Figure 64).
Emulex OneCommand Manager Application User Guide 10.2 Running a Quick Test The Diagnostics tab enables you to run a quick diagnostics test on a selected port. The quick test consists of 50 PCI loopback test cycles and 50 internal loopback test cycles. This test is not available in read-only mode or on Emulex adapters in ESXi hosts. To use quick test, perform these steps: 1. From the discovery-tree (Figure 4), select the port on which you want to run the quick test. 2.
Emulex OneCommand Manager Application User Guide NOTE: The beaconing buttons are disabled if the selected adapter does not support beaconing. To enable beaconing, perform these steps: 1. From the discovery-tree (Figure 4), select the port whose LEDs you want to set. 2. Select the Diagnostics tab (Figure 63) and click Beacon On. The beacon Status changes to On. On supported adapters, you can also enter an optional Duration time, in seconds, for the LEDs to blink. Enter the duration time and click Save.
Emulex OneCommand Manager Application User Guide To run a D_Port test, perform these steps: 1. From the discovery-tree (Figure 4), select the port on which you want to run the D_Port test. 2. Select the Diagnostics tab (Figure 63) and click D_Port Tests. The D_Port Tests dialog appears (Figure 66). 3. Click Start Tests. The start time is displayed.
Emulex OneCommand Manager Application User Guide 10.6 Using FC Trace Route The OneCommand Manager application allows you to trace the communication route for FC packets transmitted between an FC initiator port and an FC target port. Communication route information, such as the switch name, domain ID, ingress and egress port name, and ingress and egress physical port number, is accumulated for all switch ports through which packets are routed.
Emulex OneCommand Manager Application User Guide Figure 68: FC Trace Route Dialog 3. The Target Port list displays the WWPNs of all targets that are seen by the initiator port. Select a target port and Click Start. The FC Trace Route dialog displays trace route information for selected initiator and target ports (Figure 69). NOTE: If an error occurs when processing the FC trace route request, a message is displayed at the bottom of the dialog. Click Stop to stop the trace route request.
Emulex OneCommand Manager Application User Guide Ingress Port Name – The port WWN of the physical port through which an FC packet enters a specific switch. Ingress Port Num – The physical port number of the port through which an FC packet enters a specific switch. Egress Port Name – The port WWN of the physical port through which an FC packet exits a specific switch. Egress Port Num – The physical port number of the port through which an FC packet exits a specific switch. 10.
Emulex OneCommand Manager Application User Guide 6. Click Start Dump. Dump files are created. The file location depends upon your operating system: – – – – Windows – In the Dump directory under the OneCommand Manager Installation Directory Util\Dump\. Solaris – In the /opt/ELXocm/Dump directory. Linux – In the /var/log/emulex/ocmanager/Dump directory. VMware – In the dump directory that you created under /vmfs/volumes. Two files are created: – .dmp – .
Emulex OneCommand Manager Application User Guide For hosts being managed through the CIM interface, the Set Dump Directory button enables you to set the dump directory for ESXi host dumps (VMware only). 3. Specify how many files that you want to retain by selecting a number from the Dumps Retained list and clicking Apply. 4. Click Delete Existing Dump Files to remove existing dump files for the selected adapter from your system. Figure 72: Diagnostic Dump Dialog 5. Click Start Dump.
Emulex OneCommand Manager Application User Guide Figure 73: Diagnostic Dump File Transfer Dialog 7. Select the files you want to copy (multiple selections are available), and click Start Copy. The remote dump files are copied to your local dump folder. The local dump folder locations are described in Step 6. 10.8 Running Advanced Diagnostic Tests The advanced diagnostics capability gives you greater control than the quick test over the type of diagnostics tests that run.
Emulex OneCommand Manager Application User Guide Figure 74: Diagnostic Test Setup Dialog The following Diagnostic Test Setup dialog fields are displayed: Loopback Tests area: – PCI Loopback – Internal Loopback – External Loopback NOTE: For details about these tests, see Section 10.8.1, Running Loopback Tests. End-to-End (Echo) Test area: – Echo Test – Target WWPN NOTE: For details about this test, see Section 10.8.2, Running End-to-End Tests.
Emulex OneCommand Manager Application User Guide Test Cycles area: Test cycles enables you to specify test cycles in three ways: – Select an established cycle count by choosing the desired number. – Enter a custom cycle count in the blank field in the Test Cycles area. – Set the test to run until you click Stop Test, by selecting Infinite. Test Pattern area: Enter a custom test pattern to be used in tests that transfer data. The test pattern can be up to 8 hexadecimal bytes.
Emulex OneCommand Manager Application User Guide Figure 75: Run Diagnostic Tests Popup 3. Click OK. If you chose to run an external loopback test, the following popup appears (Figure 76). Figure 76: Run Diagnostic Tests Popup for External Loopback 4. Click OK. A progress bar indicates that the test is running. Periodic test feedback, consisting of the current loopback test/cycle plus the completion status of each type of test, is displayed in the Test Log section of the dialog.
Emulex OneCommand Manager Application User Guide Figure 77: Select Echo Test Target Window 3. Define the other parameters you want to use and click Start Test. The following warning popup appears (Figure 78). Figure 78: Run Diagnostic Tests Popup 4. Click OK. A result screen appears, and the test results appear in the test log. Either click Clear to erase the contents of the log display, or click Save to File to save the log file. 10.8.
Emulex OneCommand Manager Application User Guide Figure 79: Example of a DiagTest.log Window To save the log file, perform these steps: 1. After running a test from the Diagnostic Test Setup dialog (Figure 74), click Save to File. The Select Diagnostic Log File Name dialog appears. The default name of a saved file is DiagTest.log. 2. Browse to the desired directory, change the log file name if you want, and click Save (Figure 74).
Emulex OneCommand Manager Application User Guide Chapter 11: Troubleshooting Your system might operate in an unexpected manner in some circumstances. The Troubleshooting chapter explains many of these circumstances and offers one or more workarounds for each situation. 11.1 General Situations The following table lists general situations and their resolution.
Emulex OneCommand Manager Application User Guide 11.2 Emulex Driver for Linux and OneCommand Manager Application Situations The following lists possible situations and resolutions involving the OneCommand Manager application for Linux. Table 6: OneCommand Manager for Linux Situations Situation Resolution The OneCommand Manager application software Reinstall the driver for Linux with the elx_lpfc_install script.
Emulex OneCommand Manager Application User Guide Table 6: OneCommand Manager for Linux Situations (Continued) Situation The OneCommand Manager application cannot see new LUNs. Broadcom Resolution Try the following: 1. Click Refresh LUNs in the toolbar. 2. Exit the OneCommand Manager application and restart it. If new LUNs are visible, you are finished. If that does not work, try the following: 1. Exit the OneCommand Manager application. 2. Navigate to /usr/sbin/ocmanager. 3. Run .
Emulex OneCommand Manager Application User Guide 11.3 vPorts and OneCommand Manager Application Situations The following table lists possible vPort situations and their resolution. Table 7: vPort and OneCommand Manager Application Situations Situation Resolution The OneCommand Manager application fails to create vPorts. If an error occurs during vPort creation, an error message indicates the failure. Several conditions must be met before a virtual port can be created.
Emulex OneCommand Manager Application User Guide Appendix A: License Notices A.1 Oracle Binary Code License Agreement for the Java SE Platform Products and JavaFX ORACLE AMERICA, INC. ("ORACLE"), FOR AND ON BEHALF OF ITSELF AND ITS SUBSIDIARIES AND AFFILIATES UNDER COMMON CONTROL, IS WILLING TO LICENSE THE SOFTWARE TO YOU ONLY UPON THE CONDITION THAT YOU ACCEPT ALL OF THE TERMS CONTAINED IN THIS BINARY CODE LICENSE AGREEMENT AND SUPPLEMENTAL LICENSE TERMS (COLLECTIVELY "AGREEMENT").
Emulex OneCommand Manager Application User Guide 10. GOVERNING LAW. This agreement is governed by the substantive and procedural laws of California. You and Oracle agree to submit to the exclusive jurisdiction of, and venue in, the courts of San Francisco, or Santa Clara counties in California in any dispute arising out of or relating to this agreement. 11. SEVERABILITY.
Emulex OneCommand Manager Application User Guide H. COMMERCIAL FEATURES NOTICE. For purpose of complying with Supplemental Term Section C.(v)(b) and D.(v)(b), your license agreement shall include the following notice, where the notice is displayed in a manner that anyone using the Software will see the notice: Use of the Commercial Features for any commercial or production purpose requires a separate license from Oracle.
Emulex OneCommand Manager Application User Guide * software must display the following acknowledgment: * "This product includes software developed by the OpenSSL Project * for use in the OpenSSL Toolkit. (http://www.openssl.org/)" * * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to * endorse or promote products derived from this software without * prior written permission. For written permission, please contact * openssl-core@openssl.org. * * 5.
Emulex OneCommand Manager Application User Guide * must display the following acknowledgement: * "This product includes cryptographic software written by * Eric Young (eay@cryptsoft.com)" * The word 'cryptographic' can be left out if the rouines from the library * being used are not cryptographic related :-). * 4.
Emulex OneCommand Manager Application User Guide * are met: * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * 3.
