OneCommand Manager Application for Solaris Release Notes

Transcription

1 OneCommand Manager Application for Solaris Release Notes Version: System: Solaris 10, 11 (64-bit, x86, and SPARC) Date: September 2014 Purpose and Contact Information These release notes describe the new features, resolved issues, and known issues associated with this OneCommand Manager application version for the Emulex drivers for Solaris. For the latest product documentation, go to If you have questions or require additional information, contact an authorized Emulex technical support representative at (US/Canada toll free), (US/International), or (Europe, Middle East, and Africa). New Features Supports OCe14000-series adapters Supports up to four functions per port on 4-port OCe14000-series adapters (when Alternate routing ID interpretation [ARI] is available). Supports iscsi Boot firmware table (ibft) for UEFI only Supports Diagnostic port (D_Port, also known as ClearLink) for LPe16000-series adapters Supports ExpressLane (also known as FOF priority queueing) Supports Quality of Service (QoS) on LPe16000-series and OCe15000-series adapters Supports Concurrent storage (iscsi and Fibre Channel over Ethernet [FCoE]) on OCe14000-series adapters Supports Solaris 11.2 Supports FC single root I/O virtualization (SR-IOV) on Solaris 11.2 SPARC systems with Oracle-branded LPe16202 adapters only Resolved Issues 1. A physical loopback diagnostic test runs successfully even if no transceiver is present on a OneConnect OCe10100-series Universal Converged Network Adapter (UCNA) port. 2. The OneCommand Manager application correctly reads the adapter configuration for OCe14000-series adapters. 3. For an LPe16202 adapter, the number of virtual functions is correctly shown. 4. In the Change Port Speed dialog box (from the Physical Port Info tab), if the Mode is set to Auto-Negotiate, the Speed drop down menu correctly shows all speed settings. OneCommand Manager Application for Solaris Release Notes 1

2 Known Issues 1. Known Issues related to updating firmware. a) Firmware version includes new features that required new flash regions to support them. Firmware versions earlier than did not have the ability to configure the flash regions to support these new features. If you are updating from a firmware version earlier than , use one of these methods to update the firmware to : Use the ISO flash tool. Use the released 10.2 version of the OneCommand Manager application GUI or OneCommand Manager CLI application. You must perform the firmware update procedure twice to ensure that the flash regions are properly configured, and you must reboot the system after each firmware update. Note: After you have updated the firmware, you must not downgrade the firmware to a version earlier than If you are updating from firmware version or later, use one of these methods to update the firmware to : Use the ISO flash tool. Use the released 10.2 version of the OneCommand GUI or OneCommand CLI application, and reboot the system after the firmware update. (It is not necessary to perform the firmware update process twice.) Note: After you have updated the firmware, you must not downgrade the firmware to a version earlier than b) If ibft boot is non-functional, and version or later firmware is installed, you must update the firmware to version using the ISO flash image or using a version 10.2 management application or firmware update utility. You must reboot the system after the firmware update. If you updated the firmware from a version earlier than , you must perform the update process twice using a version 10.2 management application or firmware update utility. You must reboot the system after each firmware update. 2. Enabling or disabling boot on LPe16000-series adapters may show an error message. When enabling or disabling boot from the OneCommand Manager application GUI or CLI, an error message may be displayed. The error message can be ignored. The boot state is changed even though the error message is displayed OneCommand Manager Application for Solaris Release Notes 2

3 3. The OneCommand Manager Command Line Interface User Manual contains incorrect syntax and parameter information for several commands. The commands and parameters specify a WWPN or MAC is required to run these commands. A WWPN or MAC is not required to run these commands: GetDumpFileNames GetDumpDirectory SetDumpDirectory GetRetentionCount SetRetentionCount None required. 4. Data center bridging (DCB) features are not available with 40G adapters. Configure the DCB settings through the switch settings. 5. For the LPe16000-series adapters, if an external loopback plug is connected to the system, a D_Port test runs but does not stop running. This issue exists for the OneCommand Manager application GUI and the OneCommand Manager CLI DportTest command. Do not install an external loopback plug before running the D_Port test. The D_Port test can only run if the port is connected to an appropriate switch. 6. For the LPe16000-series adapters, if a diagnostic test (OneCommand Manager application or OneCommand Manager CLI) determines that the switch does not support D_Port, the port remains in D_Port mode. Manually reset the port. 7. The OneCommand Manager CLI GetQoSInfo command shows incorrect units. The output for this command is shown in bps. It is actually 20 Gbps, not bps. For example: Max. GBit/sec: For OCe14000-series adapters, on the Physical Port Info tab, the Set Speed button may be grayed out. OneCommand Manager Application for Solaris Release Notes 3

4 9. The OneCommand Manager Application User Manual (GUI) and online help omitted a description of the VEPA (Virtual Ethernet Port Aggregator) field on the NIC Port Information tab. VEPA allows virtual function network traffic to bypass the hypervisor's virtual switch, and allows the physical functions to transmit the traffic to the external switch. Check "Enable" to use VEPA (only available on OCe14000-series adapter NIC ports). 10. The OneCommand Manager CLI User Manual incorrectly lists that the DMA loopback test is supported on the LPe16202 adapters. The DMA loopback test is supported only on OneConnect adapters. 11. For OCe14000-series adapters, SR-IOV cannot be enabled or disabled on a Solaris system. Enable or disable SR-IOV in a non-solaris server. 12. For OCe14000-series adapters with an OCe11102 TCP offload, Mutual CHAP credentials are inverted in the OneCommand Manager application. In the Target Login dialog box (from the iscsi Target Discovery tab), if Mutual CHAP is selected as the authentication method when you enter credential information and click OK the following error message is displayed: Target login failed authentication Note: In the OneCommand Manager CLI for the AddTarget and AddTargetPortal commands, the TgtCHAPName, TgtSecret, InitCHAPName, and InitSecret parameters are also inverted. In the OneCommand Manager application: Enter the Target CHAP Name and Target Secret into the Initiator CHAP Name and Initiator Secret fields. Enter the Initiator CHAP Name and Initiator Secret into the Target CHAP Name and Target Secret fields. 13. The OneCommand Manager CLI Portattributes command reports the wrong VEPA state on SPARC clients. Use the OneCommand Manager application GUI. 14. The OneCommand Manager CLI CMsetBW and umcsetlpvid commands may error on SPARC clients. The cmsetbw command may show an error <114>: MAL or MILI error. The umcsetlpvid command may show: Insufficient number of parameters. For the umcsetlpvid command, use the OneCommand Manager application GUI. For the umcsetlpvid command, if the error is caused by missing arguments, you can reenter the OneCommand Manager Application for Solaris Release Notes 4

5 CLI command with the correct number of arguments. The command runs successfully if the correct number of arguments are specified. For the CMsetBW command, use the OneCommand Manager application GUI with the exception of OCe14000-series adapters. 15. For OCe14000-series adapters, the OneCommand Manager CLI SetAdapterPortConfig command fails on SPARC clients. The SetAdapterPortConfig command fails and shows ERROR: the NIC protocol is not supported on the specified function. 16. For OCe14000-series adapters, the OneCommand Manager GUI on SPARC clients shows incomplete Adapter Configuration tab information if the adapter configuration is changed. The Adapter Configuration tab does not show minimum and maximum bandwidth information. 17. PFC (priority-based flow control), active priority information is incorrect. The OneCommand Manager application GUI shows incorrect information in the PFC Properties area on the DCB tab. If the PFC Properties state is disabled, the Active Priority field shows a value. It should show "N/A". The OneCommand Manager CLI getpginfo and getdcbparams commands also show a value for the PFC Priority field if the PFC State is disabled. 18. External loopback diagnostics are not supported on OCe14000-series adapters. The OneCommand Manager application external loopback diagnostic test is not supported for the OCe14000-series adapter. 19. On the Channel Management tab, the OneCommand Manager application always shows the permanent MAC address for each channel. To correlate the permanent MAC address with the current MAC address, view the Port Information tab. The Port Information tab always shows the current (user-settable) MAC address and the permanent MAC address. OneCommand Manager Application for Solaris Release Notes 5

6 20. The NIC driver must be installed and enabled to run the OneCommand Manager application on an FCoE OneConnect adapter. If the OneConnect FCoE adapter is run without the NIC driver installed and enabled, many of the management functions are unavailable and erroneous/corrupted information is displayed by the OneCommand Manager application. Unavailable management functions include: Downloading All diagnostics, including beaconing and diagnostic dumps Disabling or enabling a port Erroneous or corrupt display information includes: FCoE storage ports are incorrectly grouped under the physical port NIC, FCoE, and iscsi ports do not appear under the correct adapter Active and flash firmware versions Firmware status BIOS version Boot code version Transceiver data display Physical port link status All DCB settings Event log display (OneCommand Manager CLI only) Install and enable the NIC driver before running the OneCommand Manager application GUI or OneCommand Manager CLI. 21. Changing the channel management mode may disrupt network traffic. When the channel management mode of the OneConnect CNA is changed from SIMode to vnic1 mode, the existing SIMode LPVID settings carry over to the vnic1 LPVID settings (also called Inner VLAN ID settings). This carry over may disrupt network traffic. The OneCommand Manager application GUI and OneCommand Manager CLI do not allow you to change the vnic1 LPVIDs. Use the Emulex PXESelect Utility to set the vnic1 LPVID value: a) Start or reboot the system. When prompted, hold down <Ctrl> and press <P> to enter the Emulex PXESelect Utility. b) In the Controller Configuration menu, press <Tab> until Continue is highlighted. Press <Enter>. c) Select the adapter and port number to be configured and press <Enter>. d) Under the MultiChannel Configuration menu, set the LPVID for each NIC channel to either 0 (default) or the desired value. Press <Tab> until Save is highlighted and press <Enter>. e) Continue to press <Esc > until prompted with the message: "Do you want to exit from the utility?" f) Press <Y> to exit. OneCommand Manager Application for Solaris Release Notes 6

7 22. A reboot is required if you change the volatile WWN on an adapter in the Emulex LPe16000 family. 23. Rebooting the system after a firmware update does not activate the new firmware. Perform a standard reboot using one of the following methods: Issue the reboot p command. Configure the boot-config service to issue the standard reboot by default. On x86 platforms running Solaris 11, disable Fast Reboot. Note: See the Solaris documentation for more details on Fast Reboot. If a standard reboot does not resolve the issue, power cycle the system. 24. While running the OneCommand Manager application and during high converged I/O traffic, a panic can occur when enabling or disabling Ethernet switch ports. Stop OneCommand Manager application daemons before enabling or disabling Ethernet ports. 25. DH-CHAP authentication is not supported for OneConnect and LPe16000-series adapters. There is no support for FCoE Diffie-Hellman Challenge Handshake Authentication Protocol (DH-CHAP) authentication for OneConnect and LPe16000-series adapters. Although the DH-CHAP tab is displayed by the OneCommand Manager application GUI when an FCoE node of a OneConnect port is selected in the discovery-tree, the DH-CHAP option should not be used. No errors are sent if you enable DH-CHAP authentication in the DH-CHAP tab or use the OneCommand Manager CLI. However if you configure DH-CHAP authentication and the link on the port goes down, the port may disappear from the OneCommand Manager application GUI, making it impossible to disable DH-CHAP authentication. In the OneCommand Manager CLI, the authentication commands return an error indicating the command is not supported when a OneConnect FCoE port is specified. 26. The OneCommand Manager application GUI and the OneCommand Manager CLI may fail to run and return an error. The OneCommand Manager application and OneCommand Manager CLI may fail to run and return the following error: ld.so.1: hbacmd: fatal: libgcc_s.so.1: open failed: No such file or directory This error is caused by an unsatisfied dependency on the GCC Runtime library. : Install the SUNWgccruntime package. OneCommand Manager Application for Solaris Release Notes 7

8 27. When you install the OneCommand Manager application on a guest operating system, the installer prompts you for a management mode. When installing the OneCommand Manager application on a guest operating system running on a virtual machine, the installer prompts you for a management mode (e.g. local-only, full-remote, etc.) and read-only mode. However, when the OneCommand Manager application runs on a guest operating system it runs in local-only and read-only modes, so it does not matter how these modes are specified during installation. 28. OneCommand Manager Secure Management mode on Solaris systems require PAM authentication configuration on the host machine. In Secure Management mode, a user is authenticated on the machine at OneCommand Manager application GUI startup. This is handled via the PAM interface. Place the correct setting in the auth section of /etc/pam.d/other file or its earlier equivalent, /etc/pam.conf. Note: Refer to the OneCommand Manager Application User Manual for more information about Secure Management mode. 29. The OCe11101-E UCNA cannot run loopback diagnostic tests (PHY, MAC, External). Any attempt to run a loopback test on the OCe11101-E UCNA results in failure. 30. OneCommand Manager Secure Management Group Assignment/Configuration on Solaris using the useradd command requires a -G option. If you assign users to one of the four OneCommand Manager application groups using the useradd command, using the -g option instead of the -G option results in the user membership data not being returned in the getent group command and associated OneCommand Manager Secure Management code failure to retrieve OneCommand Manager application user group membership data (and thus provide privileges to user). Use the -G option instead. 31. SR-IOV: Running the OneCommand Manager application on a guest operating system with more than one virtual function causes all NIC ports to appear under a single adapter. If you assign NIC virtual functions from multiple adapters to a virtual machine and run the OneCommand Manager application in the virtual machine s guest operating system, the NIC functions appear under a single adapter node in the OneCommand Manager application discovery tree. In this situation, the guest operating system in a virtual machine reports the same PCI bus number for all virtual functions and the OneCommand Manager application incorrectly ascertains that each of the discovered NICs are from the same adapter. OneCommand Manager Application for Solaris Release Notes 8

9 32. On OCe11100-series adapters, if the Mode is set to Force and the Speed is set to 1Gb, do not perform a MAC loopback test using the OneCommand Manager application. The Mode and Speed can be set from the Physical Port info tab in the OneCommand Manager application or with the SetPhyPortSpeed OneCommand CLI command. If you perform a MAC loopback test, the link does not come back up after the test is performed. 33. On Solaris 10 systems, the OneCommand Manager application, OneCommand Manager CLI, and all OneCommand Manager services may not run. The following error message appears: "HBA_LoadLibrary: previously unfreed libraries exist, call HBA_FreeLibrary()" The problem may be caused by devices on the SAN behaving incorrectly. This has been seen only on Solaris 10 x86 and SPARC platforms, beginning with update 6. Any one of the following solutions may correct this problem. Reboot the system. Check for any malfunctioning host bus adapters (HBAs) or UCNAs. Check SAN infrastructure for connections or elements that may create excessive network latency. Make adjustments and reduce complexity where possible. Remove unneeded virtual ports. 34. The OneCommand Manager application, OneCommand Manager CLI, and all OneCommand Manager services are unable to run. The following error message repeatedly prints to the syslog and/or console: "ElxInitBrdMap: HBAAPI initialization attempt failed" This known issue occurs when the HBAAPI fails to report all adapters in the system. This known issue often resolves itself after several minutes. If the problem does not resolve itself, the following actions may resolve the problem: Reboot the system. Check for any malfunctioning HBAs or UCNAs. Check SAN infrastructure for connections or elements that may create excessive network latency. Make adjustments and reduce complexity where possible. Remove unneeded virtual ports. 35. If a system contains several HBAs or UCNAs and is experiencing slow performance, the elxhbamgrd service may fall into a maintenance state during boot. This would prevent the system from being managed by a remote OneCommand Manager application client. Any one of the following solutions may correct this problem. Remove any unused HBAs or UCNAs. OneCommand Manager Application for Solaris Release Notes 9

10 After each reboot, restart the OCM services using the commands: /opt/elxocm/stop_ocmanager /opt/elxocm/start_ocmanager After each reboot, restart the elxhbamgrd service using the commands: svcadm disable elxhbamgrd svcadm enable elxhbamgrd 36. The Web Launch browser client must be run with administrator/root privileges. When running the OneCommand Manager Web Launch GUI, you must have administrator privileges when logged into the Web Launch client. On Solaris browser clients, you must be logged in as the 'root' user. Unusual behavior may occur if this requirement is not met. 37. Set Link Speed Issue after SFP Hot Swap The LPe16000-series adapters do not support SFP hot swap if the replacement SFP is not the same model as the original SFP. There are two ramifications in the OneCommand Manager application: 1. The Port Attributes tab in the OneCommand Manager application GUI or the OneCommand Manager CLI PortAttributes command may display incorrect data for the Supported Link Speeds attribute. This issue is cosmetic. 2. Boot From SAN management may be unable to set the Boot Code Link Speed parameter to 16 Gb. After changing the SFP, reset the LPe16000-series adapter port or reboot the server. 38. An in-band FCoE-CT may fail with an ERROR 254 (Response Timeout). An in-band FCoE-CT download requires that the FCoE switch have support for non-standard jumbo frames or frames that are larger than the standard Ethernet frame size. Enable support for jumbo frames on the FCoE switch. 39. In-band COMSTAR (Solaris 11 system, target-mode) ports do not appear in the OneCommand Manager application discovery-tree. In-band management of COMSTAR ports is no longer supported by the OneCommand Manager application GUI. Use either of the following methods to manage in-band COMSTAR ports: Manage the system containing the COMSTAR port out-of-band (via TCP/IP) by selecting Discovery>TCP/IP>Add Host from the OneCommand Manager application s main menu bar and entering the system s IP address. Use the OneCommand CLI to manage the in-band COMSTAR port. Technical Tips OneCommand Manager Application for Solaris Release Notes 10

11 1. The OneCommand Manager CLI UmcEnableChanLink command has been removed. To enable the logical link status of a channel, use the CMSetBW command to set the minimum bandwidth to a value greater than 0. To disable the logical link status, set the minimum bandwidth to The OneCommand Manager application no longer installs OneCommand Vision components. 3. Roles based Secure Management mode is available. Secure Management mode is a management mode available with this release. It is a roles based security implementation. During the OneCommand Manager application installation, a user is prompted as to whether or not to run in Secure Management mode. When the OneCommand Manager application is installed in this mode, the following operational changes occur: A non-root or non-administrator user can run the OneCommand Manager application. The OneCommand Manager application host uses a user s credentials for authentication. A user has OneCommand Manager application configuration privileges according to the OneCommand Manager application group to which the user is assigned. In Secure Management mode, a root or administrator user is provided full privileges on the local machine (OneCommand CLI does not require credentials) but no remote privileges. Note: Refer to the OneCommand Manager Application User Manual for more information on Secure Management mode. 4. FC in-band management is no longer supported. 5. OneCommand Manager Secure Management mode requires OneCommand Manager user groups be configured on the domain or if the host is not running in a domain, the host machine. OneCommand Manager Secure Management must be able to get the OneCommand Manager application group to which the user belongs from the host's domain (Active Directory or Lightweight Directory Access Protocol [LDAP]) or if the host is not part of a domain, the host's local user accounts. This access is associated with the user groups, not with specific users. An administrator needs to create these user groups and then set up user accounts such that a user belongs to one of these four OneCommand Manager application user groups: Table 1 Secure Management User Privileges User Group ocmadmin ocmlocaladmin ocmuser ocmlocaluser OneCommand Manager Capability Allows full active management of local and remote adapters. Permits full active management of local adapters only. Permits read-only access of local and remote adapters. Permits read-only access of local adapters. These four OneCommand Manager application groups must be created and configured on the host machine or network domain. OneCommand Manager Secure Management uses the OneCommand Manager Application for Solaris Release Notes 11

12 C-library API calls getgrnam and getgrid to retrieve the OneCommand Manager Secure Management group information. The equivalent to these can be obtained on the shell command line by typing getent group command. If the four OneCommand Manager application groups are listed, along with their member users, this is an indication that the host machine is sufficiently configured to work with OneCommand Manager Secure Management. 6. On OneConnect adapters, if you change the port speed via the Change Port Speed dialog box, and the selected speed is supported by the adapter's port but is not supported by the connected hardware, the link does not come up. 7. Requirement if DCB settings are connected to a non-data center bridging exchange (DCBX) switch. If DCB settings are required when connected to a non-dcbx switch (or switch with DCBX disabled), DCBX must be disabled on the OneConnect adapter to use the adapter's configured parameters. If DCBX is enabled, the DCB PFC and Priority Groups are ignored (the adapter assumes that the switch does not support these parameters) and for FCoE adapters, the FCoE priority (COS) is The OneCommand Manager application Firmware tab is in a different location for 8 Gb/s and lower Fibre Channel adapters than it is for 16 Gb/s Fibre Channel adapters and OneConnect UCNAs. Because the 16 Gb/s FC adapters and OneConnect UCNAs share a single firmware image for all ports on the adapter, the Firmware tab for them is at the adapter level. Because 8 Gb/s and lower adapters have a separate firmware images for each individual port, the Firmware tab for them is at the port level. 9. To view online help using the Google Chrome browser, you must disable Chrome's security check using the "--allow-file-access-from-files" option. a) Create a copy of the Chrome shortcut on the desktop and rename it to RH Chrome L b) Right-click on the new Chrome icon and choose Properties. c) Add the "--allow-file-access-from-files" text to the end of the path appearing in Target. You must leave a space between the original string and the tag you are adding to the end of it. d) Click OK to save your settings. e) Close any open instances of Chrome. f) To open a local copy of the online help, use the new shortcut to open Chrome, then hold down <Ctrl> and press Open and browse to the start page; or open Chrome with the new shortcut, then right-click the start page and click Open With > Google Chrome. Copyright Emulex. All rights reserved worldwide. This document refers to various companies and products by their trade names. In most, if not all cases, their respective companies claim these designations as trademarks or registered trademarks. This information is provided for reference only. Although this information is believed to be accurate and reliable at the time of publication, Emulex assumes no responsibility for errors or omissions. Emulex reserves the right to make changes or corrections without notice. This report is the property of Emulex and may not be duplicated without permission from the Company. Note: References to OCe11100-series products also apply to OCe11100R series products. OneCommand Manager Application for Solaris Release Notes 12