QConvergeConsole GUI Readme Marvell Semiconductor Inc. All rights reserved Table of Contents 1. Package Contents 2. Supported Adapters/Controllers 3. Supported Operating Systems 4. Installing Application 5. Additional Notes 6. Contacting Support 1. Package Contents QConvergeConsole Graphical User Interface (GUI) installation packages are available for the following supported OS platforms: * Windows platforms: QConvergeConsole_Installer_Windows_.exe QConvergeConsole_Installer_Windows_x64_.exe * Linux platforms: QConvergeConsole_Installer_Linux_i386_.bin QConvergeConsole_Installer_Linux_x64_.bin QConvergeConsole_Installer_Linux_IA64_.bin QConvergeConsole_Installer_Linux_ppc64_.bin QConvergeConsole_Installer_Linux_ppc64_LE_.bin * SPARC platforms: QConvergeConsole_Installer_Solaris_SPARC_.bin * Solaris x86 platforms: QConvergeConsole_Installer_Solaris_x86_.bin NOTE: The "" in the preceding file names represents the build number of the current software release. 2. Supported Adapters/Controllers * 2400, 2500, 2600 and 2700 Series Fibre Channel Adapters * 3200, 3400 Series Intelligent Ethernet Adapters * 8200, 8300, 8400 Series Converged Network Adapters * 34xx, 41xxx, 45xxx FastLinq Adapters NOTE: Agent QLNXRemote for FastLinq adapters is not supported on Solaris x86/Sparc. 3. Supported Operating Systems QConvergeConsole runs on the following OS platforms: * Client browser. The operating systems listed below support running or hosting the QConvergeConsole by running one of the following supported browsers: * IE 11 * Firefox 3.6, 62+ * Opera 39+ * Safari 9.1+ * Chrome 54+ List of Operating Systems: * Windows Server Nano (64-bit) Intel 64, AMD64 * Windows Server 2016 (64-bit) Intel 64, AMD64 * Windows Server 2012 (64-bit) Intel 64, AMD64 * Windows Server 2012 R2 (64-bit) Intel 64, AMD64 * Windows Server 2008 (32-bit, 64-bit) Intel 64, AMD64 * Windows Server 2008 R2 (64-bit) Intel 64, AMD64 * Red Hat RHEL AS/ES 7.x (32-bit, 64-bit) Intel x86, Intel 64, AMD64 * Red Hat RHEL AS/ES 6.0/6.1/6.2/6.3/6.4/6.5 (32-bit, 64-bit) Intel x86, Intel 64, AMD64 * Novell SLES 15 (64-bit) Intel 64, AMD64 * Novell SLES 12 SP1/SP2/SP3 (64-bit) Intel 64, AMD64 * Novell SLES 11 SP1/SP2/SP3 (32-bit, 64-bit) Intel x86, AMD64 * Novell SLES 10 SP3 (32-bit, 64-bit) Intel 64, AMD64 * Novell SLES 10 SP4 (32-bit, 64-bit) Intel IA64, Intel 64, AMD64 * XenServer 5.6 FP1/FP2, 6.x, 7.x (32-bit) Intel x86 * Solaris 10 SPARC, Solaris 10 x86, Solaris 11 SPARC, Solaris 11 x86 * Apache Tomcat application server. The following operating systems can host the Tomcat server, which is required to support the QConvergeConsole GUI. * Windows Server Nano (64-bit) Intel 64, AMD64 * Windows Server 2016 (64-bit) Intel 64, AMD64 * Windows Server 2012 (64-bit) Intel 64, AMD64 * Windows Server 2012 R2 (64-bit) Intel 64, AMD64 * Windows Server 2008 (32-bit, 64-bit) Intel 64, AMD64 * Windows Server 2008 R2 (64-bit) Intel 64, AMD64 * Red Hat RHEL AS/ES 7.x (32-bit, 64-bit) Intel x86, Intel 64, AMD64 * Red Hat RHEL AS/ES 6.0/6.1/6.2/6.3/6.4/6.5 (32-bit, 64-bit) Intel 64, AMD64 * Novell SLES 15 (64-bit) Intel 64, AMD64 * Novell SLES 12 SP1/SP2/SP3 (64-bit) Intel 64, AMD64 * Novell SLES 11 SP1/SP2/SP3 (32-bit, 64-bit) Intel x86, AMD64 * Novell SLES 10 SP3 (32-bit, 64-bit) Intel 64, AMD64 * Novell SLES 10 SP4 (32-bit, 64-bit) Intel IA64, Intel 64, AMD64 * XenServer 5.6 FP1/FP2, 6.x, 7.x (32-bit) Intel x86 * Solaris 10 Sparc, Solaris 10 x86, Solaris 11 Sparc, Solaris 11 x86 Server agent. Multiple operating system support allows control of heterogeneous environments. The QConvergeConsole works with the following operating system. * Windows Server Nano (64-bit) Intel 64, AMD64 * Windows Server 2016 (64-bit) Intel 64, AMD64 * Windows Server 2012 (64-bit) Intel 64, AMD64 * Windows Server 2012 R2 (64-bit) Intel 64, AMD64 * Windows Server 2008 (32-bit, 64-bit) Intel 64, AMD64 * Windows Server 2008 R2 (64-bit) Intel 64, AMD64 * Red Hat RHEL AS/ES 7.x (32-bit, 64-bit) Intel x86, Intel 64, AMD64 * Red Hat RHEL AS/ES 6.0/6.1/6.2/6.3/6.4/6.5 (32-bit, 64-bit) Intel 64, AMD64 * Novell SLES 15 (64-bit) Intel 64, AMD64 * Novell SLES 12 SP1/SP2/SP3 (64-bit) Intel 64, AMD64 * Novell SLES 11 SP1/SP2/SP3 (32-bit, 64-bit) Intel x86, AMD64 * Novell SLES 10 SP3 (32-bit, 64-bit) Intel 64, AMD64 * Novell SLES 10 SP4 (32-bit, 64-bit) Intel IA64, Intel 64, AMD64 * Solaris 10 x86 (32-bit) Intel 64, AMD64 * Solaris 10 SPARC (32-bit, 64-bit) SPARC * Solaris 11 x86 (32-bit) Intel 64, AMD64 * Solaris 11 SPARC (32-bit, 64-bit) SPARC * VMware ESX 4.1 (legacy support only) (64-bit) Intel 64, AMD64 * VMware ESX 4.0 (legacy support only) (64-bit) Intel 64, AMD64 * XenServer 5.6 FP1/FP2, 6.x, 7.x (32-bit) Intel x86 NOTE: For specific service packs (SP) and OS updates, refer to the descriptions where this software version is posted on the Marvell Web site https://www.marvell.com/support/downloads or on your OEM website. 4. Installing Application 4.1 Hardware Requirements The minimum hardware requirements for the Apache Tomcat application server are as follows: * Application server. Single-processor or multiprocessor server or workstation: - Intel Core 2 Duo with 1GHz or greater * Memory. 512MB of physical RAM required to run QConvergeConsole; 1 GB recommended. Running with less memory can cause disk swapping, which severely affects performance. * Video card. Capable 16K colors and 1024 x 768 pixels recommended. * Hard disk space. About 150MB disk space. The minimum hardware requirements for the server agent are as follows: Adapters. One or more of the following Marvell adapters: * 2400, 2500, 2600 and 2700 Series Fibre Channel Adapters * 3200, 3400 Series Intelligent Ethernet Adapters * 8200, 8300, 8400 Series Converged Network Adapters * 34xx, 41xxx, 45xxx FastLinq Adapters The minimum requirements for a SAN environment are as follows: * Storage. Fibre Channel or iSCSI devices, such as disks and RAID subsystems. QConvergeConsole supports most Fibre Channel and iSCSI devices. See the Marvell Storage Networking Interoperability Guide, which you can download from the following Marvell Web page: http://connect.qlogic.com/interopguide/info.asp NOTE: Tape devices are shown as part of the configuration, but are not fully supported. Only persistent binding is supported. 4.2 Software Requirements QConvergeConsole requires the following minimum software: Server on which your adapter is physically installed - Marvell adapter drivers for your operating system (OS) * Marvell adapter management agents for your OS * TCP/IP protocol for Windows remote management * Administrative privileges to perform management functions * Disable user access control to run the agent service (qlremote) on Windows 2008 Apache Tomcat application server * Apache Tomcat (if not already installed, installed using the QConvergeConsole installer) * QConvergeConsole * One of the operating systems identified in the OS Support section Web browser * Capability to launch IE 11 Firefox 3.6, 62+, Opera 36+, Safari 9.02+, or Chrome 50+ Adobe Flash Player - Browser must have Flash plug-in enabled to support Graphical Chart. 4.3 Supported Features The QConvergeConsole supports the following features: * Unified adapter management. QConvergeConsole provides a browser-based GUI that lets you monitor, configure, and manage Marvell adapters with Fibre Channel, FCoE, Ethernet networking (NIC), and iSCSI networking protocols. * Virtualization. QConvergeConsole provides configuration pages on selected Fibre Channel ports that let you create multiple virtual ports from a single physical adapter. * Asset management. QConvergeConsole allows you to connect to and disconnect from local and remote hosts. It also provides information about connected hosts and their attached Marvell adapters with connected storage devices. * Configuration management. QConvergeConsole allows you to configure local and remote systems. With QConvergeConsole, you can configure Marvell adapters and connected devices. It also lets you update adapter parameters, firmware, boot code, and drivers. * Statistics. QConvergeConsole provides statistics for each host and adapter port. These statistics can be collected automatically or on request. They can be reset at any time. In addition, you can export the statistics to a comma separated values (CSV) file that can be imported into other applications, for example, Microsoft Excel. * Reports. QConvergeConsole provides a report facility that lets you generate reports, which you can use to view lists of all SAN assets: adapters, devices, and LUNs. After generating reports, you can view them and save them to a variety of file formats. * E-mail notifications. QConvergeConsole can automatically send notifications with a copy of the current host configuration to an e-mail distribution list, thus enabling the information to be opened and analyzed from other locations. * Wizards. QConvergeConsole provides some easy-to-use wizards that walk you through Flash and driver parameter file updates on Fibre Channel and Converged Network Adapters. 4.4 Using QConvergeConsole Please refer to the QConvergeConsole User's Guide for detailed information on installing QConvergeConsole. You can download a copy of this document from the driver download page for your adapter at Marvell's Driver Downloads/Documentation page (https://www.marvell.com/support/downloads). NOTE: Management agents (FastLinq, Ethernet networking, FCoE, and iSCSI) to use for remote access to the adapters can be installed using Windows SuperInstallers. These SuperInstallers can be found on the download section for Windows OSs for your specific adapter at https://www.marvell.com/support/downloads. The management agents are not included in the QConvergeConsole package that you download from the Marvell downloads page. 4.5 Starting QConvergeConsole Please refer to the QConvergeConsole User's Guide for detailed information on starting QConvergeConsole. You can download a copy of this document from the driver download page for your adapter at Marvell's Driver Downloads/Documentation page (https://www.marvell.com/support/downloads). 5. Additional Notes 5.1 General (Applies to All Operating Systems) 5.1.1 Manually Mapping the Host Name to IP QConvergeConsole does not allow connecting to the same host more than once; doing so causes issues with policies and wastes system resources. Consequently, all host IP addresses must resolve to a host name to allow the connection to complete. If DNS is not used, you must edit the local host file on the system where you are running QConvergeConsole to manually map the host name to the static IP address. The following shows the name and location of the host file for each OS: * Windows: :windows\system32\drivers\etc\hosts * Linux, Solaris SPARC and Solaris x86: /etc/hosts 5.1.2 Understanding the Displayed Hard Drive Size Under LUN Information Two different measurement formats are used when displaying the hard drive size: decimal (GB) and binary (GB). Both Linux and Windows show the correct number using their numeric format: * Windows uses binary (numbers that are a power of 2) * Linux uses decimal (numbers that are a power of 10) For example: 2^10 is 1,024. The closest decimal number is 10^3 or 1,000. 2^20 is 1,048,576. The closest decimal number is 10^6 or 1,000,000. 2^30 is 1,073,741,824. The closest decimal number is 10^9 or 1,000,000,000. 5.1.3 Online update requirement QCC provides utility to update application to latest version. This utility requires Domain Name Service server running on the same host that Tomcat server is running. Note: Update QCC app using update utility, all features setup by QCC installer are removed. 5.2 Linux 5.2.1 Running QConvergeConsole and Connecting to a Remote Red Hat Linux Machine When running QConvergeConsole and connecting to a remote Red Hat Linux machine, you must modify the /etc/hosts files on the two machines to allow asynchronous notifications from the agent to QConvergeConsole to operate properly. To resolve this issue, create a new entry with the host IP address assigned to ethx. Modify the existing entry by moving the hostname from the localhost line to the newly created line. For example: Initial: 127.0.0.1 localhost runner.domain.com Modified: 127.0.0.1 localhost 10.0.0.1 runner.domain.com 5.2.2 Secure Portmapper For Linux 7.x and Advanced Server 2.1, QConvergeConsole includes a new secure portmapper. Add the statement "portmap:ALL" to the /etc/hosts.allow file for remote communication to work properly between the graphical user interface and agents. 5.3 QConvergeConsole Password The default QConvergeConsole password is "config". Make sure to change this password after installation to ensure security is not compromised. To change the current QConvergeConsole password, you must install the shadow password option on your Linux machine. For example, the following steps install the etc/shadow file on a Linux 7.2 machine: 1. Install shadow-utils rpm package from : /Red Hat/RPMS/shadow-utils-20000902-4.i386.rpm 2. Go to the /etc file, and then type the pwconv command to convert the passwords to shadow password format. 5.4 IA32 QConvergeConsole Installer To run the IA32 QConvergeConsole installer under Linux x86_64 (Intel 64), you must install the IA32 X11 libraries. These libraries are included in the xorg-x11-libs-.EL rpm. If the libraries are missing, the following exception displays: java.lang.UnsatisfiedLinkError: /tmp/install.dir.4191/Linux/resource/jre/lib/i386/xawt/libmawt.so: libXext. o.6: cannot open shared object file: No such file or directory 5.5 QConvergeConsole Installer on Red Hat 5 To run the QConvergeConsole installer on a Red Hat 5 Linux machine when using the default installation, you must install the following rpms: * compat-libstdc++-33-3.2.3-61..rpm * libXp-1.0.0-8..rpm NOTES: * On x86_64 machines, load 32-bit libs * On ppc64 Linux machines, load both ppc64/ppc rpms 5.6. Known Issues and Workarounds 1. Solaris required settings for Refresh Host feature * IP address of the host must be specified in the host file as follows: * Do not use IP address 127.0.0.1. * Firewall must be turned off. * After updating host file, restart qlremote agent and execute command "netservices open". * Use IP address specified in host file to connect to host. 2. Issue: The administrator/admin enabled account password must not be blank when changing the QConvergeConsole utility password. Workaround: This is a Windows security restriction. 3. Issue: There is a Microsoft portmapper conflict if Microsoft Windows Services for UNIX is installed after SANsurfer Fibre Channel and FCoE Manager. Workaround: Perform the following steps: 1. Temporarily uninstall QConvergeConsole Fibre Channel and FCoE agent. 2. Install Microsoft Windows Services for UNIX. 3. Re-install QConvergeConsole Fibre Channel and FCoE agent. 4. QConvergeConsole does not support adapter parameters and Flash updates on 8Gb adapters when running Windows Server 2008 Inbox Driver Version 9.1.4.5 or 9.1.4.6. Workaround: You must update the host to the latest Marvell driver. 5. The hot swap feature does not work on Marvell Fibre Channel Adapters. Workaround: Stop the qlremote agent. 6. During normal operation of QConvergeConsole on Solaris, a stale semaphore may be left behind, causing QConvergeConsole to fail on load. Workaround: Manually remove the following two files: /var/tmp/.SEMD /var/tmp/.SEML 7. The Following features will not be supported from FC/FCoE on 82xx adapters: - Loopback test (Internal/External) - iiDMA 8. Solaris SunOS flash update issue QConvergeConsole provides utilities to upgrade the flash image. To upgrade using NIC protocol, all NIC interfaces need to be enabled. Usage: To display CNA NIC interface: #ifconfig –a To scan all available CNA NIC interfaces: #dladm show-link To enable CNA NIC interface: #ifconfig plumb up 9. Virtual Port is non-persistent If a virtual Port is created, it will be removed after a reboot. 10. Agents installation requirement If agents are installed during installation of SanSurfer, these agents will be uninstalled when SanSurfer is uninstalled. Consequently, agents must be reinstalled for QCC to continue to work. 11. Order of agents installation It is required to install agents in a specific order. iqlremote agent must be installed prior to installing other agents. Therefore, before installing iqlremote, all installed agents must be uninstalled. 12. Timeout error Using file update operation while system is busy may cause a timeout error. 13. Unable to search Help system using Google Chrome browser The Search and Index tools work best on Internet Explorer or Firefox browsers. Chrome and Safari browsers do not support features required to display the Index and Search results. 14. Virtual Port missing info On Windows host, the LUN size and WWULN are not displayed. This is known limitation of Windows Management Instrumentation components. 15. FC adapter QMH2572 On Windows platform, the inbox driver version 9.1.4.6 is installed automatically for adapter QMH2572. QCC driver update feature does not support updating from this Windows inbox driver version 9.1.4.6. Use Device Manager to update this inbox driver to version 9.1.9.45 or higher. 16. Email address rejected When using the QCC email feature, there might be issue with some email servers due to the From email address is fixed to: QConvergeConsole.Application@qlogic.com and cannot be changed. To avoid this issue, please add this fixed email address in spam exclusion list. 17. Browser refresh requirement When updating QConvergeConsole from version to version, please make sure the browser cache is clear and the QConvergeConsole URL is reloaded. Instructions for clearing cache of a specific version of browser are described in the following link: http://kb.iu.edu/data/ahic.html 18. Internet Explorer requirements 18.1 Compatibility View When using Internet Explorer browser version 10 and newer version to open QConvergeConsole, the browser may not recognize QConvergeConsole web page. QConvergeConsole is not displayed. When this situation occurs, you will see the Compatibility View button on the Address bar. IE browser will display QConvergeConsole correctly when Compatibility View is turned on. To turn on Compatibility View, click the Compatibility View button. The color of Compatibility View icon will change to a solid color. 18.2 Desktop Experience feature installation required QConvergeConsole has flash-based components which required Flash player plugin. When using Internet Explorer 10 to open QConvergeConsole, the Desktop Experience feature must be installed to enable Flash player. For more information of the Desktop Experience feature, please refer to the following link: http://www.win2012workstation.com/desktop-experience 18.3 Security settings For security reason, it is required the IP address and/or "localhost" must be added to the list of Trusted Sites. To add a site to the Local intranet zone, do the following steps: 1. Open the site in Internet Explorer. 2. Click File and point to Add this site to. 3. Click Local intranet zone. 4. Click Add in the Local intranet dialog box. 5. Click Close 18.4 Downloading files over SSL secured connection. When using Internet Explorer browser to open QConvergeConsole via port 8443, an attempt to download a file could fail. Internet Explorer displays error that it is unable to download the file. When this situation occurs, please follow the instructions published by Microsoft in the following support page to remedy the problem: http://support.microsoft.com/kb/2549423 18.5 Issue Displaying SSL Enabled QConvergeConsole in Internet Explorer 11 Some older versions of Internet Explorer 11 may have an issue displaying QConvergeConsole when SSL is enabled. Updating to the latest version of Internet Explorer 11 may remedy the issue. 19. Host refresh requirement Refreshing host is required after making a LUN change. 20. CNA Flash update limitation When running using QCC GUI, it is required to have only one NIC port active or link is up per subnet. If there are more than 1 NIC port on the same subnet they should be using different VLANs. If the ports are on the same subnet and/or the same VLAN, you can temporarily disable the port driver to reduce the number of active NIC ports to 1 prior to running QCC. 21. Driver uninstallation requirement It is required that QCC application and agents must be stopped prior to disable or unload or uninstall driver. 22. Secured Login via Tomcat Realm requirements Secured Login via Tomcat Realm can be setup during QCC installation. If Secured Login option is selected, user name and password are required in order to open QCC in supported browsers. It is recommended to open QCC in a fresh browser. Opening more than one QCC instance in a browser, using different tab, is not supported. 23. Interrupt delay timer setting requirement On Advanced HBA Parameters panel, if the setting for Operation Mode is "5 - Interrupt when Interrupt Delay Timer expires" and the value set for Interrupt Delay Timer is greater than 10 (10 * 100 or one millisecond), fabric scanning must be disabled. 24. During flash update, Firefox browser, version 4 and newer, use memory significantly more than other browsers such as Chrome or Safari. Please use the browsers with specific version number listed below to perform the flash update: Chrome 50+ FF 62+ IE 11 Safari 9.02+ Opera 36+ 25. Virtual Disk and Virtual LUN QConvergeConsole does not recognize virtual Disk and virtual LUN. This feature is Not Yet supported. 26. NIC diagnostics When running NIC diagnostic tests, it is recommended to run each test in separate instance to avoid timing issue. Link test and loopback test will fail if running these tests simultaneously. 27. Display resolution requirement It is recommended to set monitor resolution to be 1280x960 at the minimum. 28. Driver Update requirements 28.1 The feature driver update supports only signed driver file with WHQL signature. 28.2 Driver Update Wizard file selection When using Driver Update Wizard, driver file selection must be done for each host which appears in the list of selected host(s). Hosts are listed by IP address or by name or by the term "localhost". A selected driver file for a selected host will be used in the update process on all applicable adapter(s) installed in that specific selected host. If there are more than one type of adapters installed in a host, there must be more than one driver file selected for use in the update process. 29. Link status after running Ext LB test If HBA parameters were set to use standard Connection option and value "Auto" for Data Rate then when inserting a LB connect, the link will still show as down. When the Connection Option is set as Loop Only and Data Rate is set to 8G and the LED/link is up as expected on Hilda FC. 30. BPS value not incremented on VP for BFS setup On Linux machine running SLES 10.x with BFS setup, when run IO on LUN attached to virtual port, the BPS value does not get updated. This problem is fixed in SLES 11.x. 31. Smart Screen Filter feature on Windows platform Whenever you execute a file that you have downloaded from the Internet, it is first checked by SmartScreen Filter against a database. Files that cannot be identified are blocked automatically, and a warning is displayed instead. The only two options on the screen are the highlighted OK button, and a more info link that is nearly as distinguishable from the background. A click on OK closes the message and blocks the executable from being started. If you want to start the program, you need to click on More Info. You can disable SmartScreen Filter in the Windows Control Panel. Use Windows-Pause to bring it up, and click on Control Panel in the address bar afterwards. Select System and Security and then Action Center afterwards. Select Change SmartScreen Settings on the left. This opens a menu where you can turn Windows SmartScreen off. 32. Retrieving firmware dump file If firmware dump data is available and is stored in a file system, the dump data can be retrieved using Utilities tab for the selected adapter. When request, the latest dump file is retrieved if exists. It is possible to retrieve the same dump file multiple times. This situation happens when new dump event has not been occurred. 33. Linux driver update When selecting a driver file to update via QConvergeConsole's driver update, the driver file must be in RPM format. The name of the driver file must follow one of the following naming convention: kmod-qlgc-qla2xxx--n..rpm qlgc-qla2xxx-kmp-default--n..rpm qla2xxx--ndkms..rpm where n is an unsigned integer. Driver source file is not supported. 34. IE 11 text box issue When using Internet Explorer 11 to open QConvergeConsole, there is an 'x' mark displayed at the end of the text box when text box is in focus. This 'x' mark is the clear button which IE 11 automatically added to the text box. 35. VPD update after flash update issue When performing a flash update make sure all steps are completed before shutting down the application or rebooting the machine. 36. Updating NIC parameters that affect the link, as well as running LB test under a PXE boot issue. Any operation that will result in loss of network connectivity shall not be performed when the rootfs is mounted over nfs. LB, some of the parameter updates can result in link loss and are not supported. 37. Fabric scanning feature In a large enterprise network, that is on the scale of 5 edge switches or more with a single director, SAN fabric scanning can take some time to complete. To avoid lengthy scanning, fabric scanning must be turned off. To turn off fabric scanning feature, open Host->Options dialog and uncheck the box "Enable Fabric Scanning". By default, fabric scanning is disabled. 38. UI Button issue When using Chrome or Firefox browser, a disabled button may be displayed as active(not grayed out). This issue can be seen on Chrome version 24.0.1312.56m and Firefox 18.0.1. This problem is not seen on IE browser. 39. Running multiple operations in parallel not supported While an operation is still in progress, starting another operation could cause system to crash. Running multiple operations concurrently is not supported. 40. Loopback mode request When a port is already setup to operate in loopback mode, requesting loopback mode on this port is disallowed. This request should not be made by any protocol driver. 41. Loopback data patterns On adapter series 83xx, data patterns (CRPAT, CJPAT, CSPAT) for Loopback are not supported. 42. Multihomed Host issue When a host is configured with multiple IP addresses, it is possible that the hostname-to-IP resolution via DNS returns two or more different IP addresses for one host name. In this multihoming environment, it is recommended to use IP address for the host, not hostname. 43. Hyper-V Server requirement a. When running application on Hyper-V supported OS, Hyper-V server must be installed to avoid WMI error code 0x8004100E. b. After updating driver, all Virtual Machines must be restarted. 44. Internet Explorer 11 display issue When using Internet Explorer to open QConvergeConsole, for QConvergeConsole to function properly, it is recommend to have only one instance of QConvergeConsole at any given time. Internet Explorer does not display a window that QConvergeConsole already created previously and have not been closed. 45. Driver update using src rpm driver requirement Before submitting src rpm driver file to update existing driver, please make sure the following packages are installed on the host: rpm-build kernel-syms kernel-source kernel-devel or kernel-PAE-devel gcc glibc 46. Xen server password change requirement In order to update password using Security panel on QConvergeConsole GUI, the shadow password file must be present. Shadow password file can be created using pwconv command. 47. Solaris agent installation requirement If QConvergeConsole GUI is planned to be installed on the system, to install agent on this same system, the agent installer PKG package format must be used. Please do not use P5P installer format. 48. Solaris networking issue Connecting to a Solaris system may fail if connecting from a remote host using QConvergeConsole. To fix this issue, execute the following command: # netservices open 49. Hyper-V Virtual Port new FC/FCoE driver required System that is configured with virtual port created from Hyper-V Server must run driver with minimum version as shown below: For FC driver: v9.1.11.24 For FCoE driver: v9.1.11.12 50. Security Login requirements The Security Login feature is initially introduced in QCC version 5.1.0.170. Several data files must be placed in certain locations under the installation directory. Due to this requirement, the Security Login feature is not supported, or is not enabled, or is removed under the following circumstances: - If Tomcat server is already installed (not by the QCC installer) when you run the QCC installer, the QCC Installer does not display the option for the Security Login feature. To enable the Security Login option, uninstall the Tomcat server before installing QCC. - The Security Login feature, if enabled, is removed after QCC is updated using the menu item “Check For Update Now ...”. - If the QCC war file is deployed either via Tomcat Application Manager or by placing the file under the webapps directory, the Security Login feature is not enabled. - The Security Login feature’s default login is “QCC” and default password is “config”. - Login name and password are not saved after QCC is uninstalled. If Security Login feature is enabled and default password for "QCC" is modified, new password takes effect until QCC is uninstalled. 51. NIC-Partitioning (NPAR) and Single Root - IO Virtualization (SR-IOV) configuration requirements QCC provides 2 panels for NPAR and SR-IOV configurations. When NPAR is enabled, SR-IOV must be disabled. When SR-IOV is disabled, VFs value of all ports on SR-IOV panel is set to 0. When SR-IOV is enabled, NPAR panel is not displayed. To switch from SR-IOV enable mode to NPAR enable mode, perform the following steps: 1. On SR-IOV panel, set VFs value of all ports to 0. 2. Reboot 3. NPAR panel is displayed for configuration. 4. Click on "Enable Partition" button. 5. Reboot To switch from NPAR enable mode to SR-IOV enable mode, perform the following steps: 1. On NPAR panel, click on "Disable Partition" button of all ports. 2. Reboot 3. On SR-IOV panel, change VFs value of at least one port to non-zero. 4. Reboot 52. External standard Echo command is not supported on Cisco switch, therefore, when running Diagnostics Loopback test on Cisco switch, the test fails. This is known limitation. 53. Security Login feature on Citrix machine The Security Login feature works only on SSL port (port number 8443), therefore, SSL feature must be enabled if Security Login feature is enabled. This is known limitation. 54. Flash update 82xx series adapter On Windows system, when Health Monitoring is enabled, and running flash update for 82xx series adapter, the update process could be intermittently interfered and the flashing may not complete. However, the occurrence of this issue is relatively uncommon. It is recommended to disable Health Monitoring when performing flash update on 82xx series adapter running on Windows host. 55. Issue: When updating firmware on a FabricCache adapter using Chrome or IE, the following error may happen: Unable to open file to be copied to the adapter Workaround: Use Firefox to update the firmware. 56. Requirement for Adding iSCSI Target with CHAP authentication (RHEL 6.5 only) For RHEL 6.5, after adding CHAP entry through QCC, qla4xxx driver module needs to be unloaded and reloaded for the updated CHAP entries to take effect. It can be done using following steps: 1. Logout any existing sessions 2. Unload qla4xxx: # rmmod qla4xxx 3. Reload qla4xxx: # modprobe qla4xxx After the above command completes, the new CHAP entries will be effective. NOTE: This workaround is required only in case of RHEL6.5 Inbox qla4xxx driver. This workaround is not required for newer Linux Red Hat version. 57. Missing flash player issue QConvergeConsole has flash-based components which required Flash player plugin. If Flash player plugin is not installed, there will be no graphical display for Utilization and Monitoring tab panels. Instead, numerical results are displayed on Utilization tab and option to save the results to file is displayed on Monitoring tab. 58. Netqlremote Agent Update issue on RH 7.1 and SLES 12 There is an issue with the script used in Netqlremote Agent Update feature. The update does not work if Netqlremote version 2.1.66 or version 2.1.68 is used to update to a newer version on system RH 7.1 or on system SLES 12. 59. Adapter displayed on Host tree An adapter installed on system can be discovered by an installed agent supporting the adapter. If there are multiple agents installed on system discover the same installed adapter, the adapter could be displayed on host tree multiple times. 60. Flash Update early termination issue * Issue: On Linux, during flash update, if the update process is interrupted by pressing Ctrl-C or the update process is killed by issuing command "kill -9 " . a stale shared file may be left behind as the clean up process may not be done thoroughly, the next attempt of flash update by QCC GUI or by QCC CLI will fail subsequently. * Workaround: Manually remove the following file in /tmp directory /tmp/ql_shared.dat 61. Link speed on 25G/100G adapters On Linux systems, support for link speed modification on 25G/100G adapters is pending. Therefore, current link speed for 25G/100G is displayed for information purposes only. 62. Recommended Bandwidth setting for 25G/40G/100G adapters For 25G/40G/100G adapters, if DCBX/ETS are used, setting of bandwidth to 0 on storage functions is the best practice. 63. Teaming configuration limitation In NPAR mode, the team configuration type: (FEC/GEC)/802.3ad is not supported. 64. NPAR configuration for PCI Function '0' and '1' To view/configure NPAR configuration for 578XX/579XX family of adapters, it is necessary that the VBD (Virtual Bus Device) instances (in ‘devices manager’ under ‘System Devices’) corresponding to PCI Function zero and one be enabled in the ‘device manager’. 65. Windows Server Nano TP5 QLNXRemote agent known issues: * Getting incorrect IP Address is still a known issue. 66. Unsafe Port error when using Chrome browser When using port number other than port 8080 for Tomcat server, opening QConvergeConsole on Chrome browser may fail with error ERR_UNSAFE_PORT. This error indicated the port number used is not supported on Chrome browser. The workaround is to explicitly allow the unsafe port when you start up Chrome. To allow ports 81,84 and 87, change it to: chrome.exe --explicitly-allowed-ports=81,84,87 67. Port-mapper based service requirement for Marvell adapter configuration On the Windows based platforms only a single port-mapper service can be running at a time. Common applications that include a port-mapper are System Management applications, and Tape Backup applications. In order to configure the Marvell adapters in Windows based system, the conflicting port-mapper based service will need to be temporarily disabled. Once the Marvell adapter is configured properly, the port-mapper based service can be enabled, and other port-mapper based applications can be restarted. The Marvell ONC/RPC port-mapper is installed if the Windows RPC port-mapper service does not exist. 68. QConvergeConsole application update feature Using QConvergeConsole application update feature using war file may fail if using local file system option. This is known issue. The workaround is to use Tomcat Manager application to deploy war file from local server. 69. QConvergeConsole will not launch after install One possible issue for the QConvergeConsole to not launch is an error in the hosts file of the system where the QConvergeConsole was installed. Make sure the hosts file is formatted correctly and has at least the entry for the localhost included. The hosts file may be found in the following locations: * Windows: :windows\system32\drivers\etc\hosts * Linux, Solaris SPARC and Solaris x86: /etc/hosts 6. Contacting Support For further assistance, contact Marvell Technical Support at: https://www.marvell.com/support (c) Copyright 2018. All rights reserved worldwide. Marvell and the Marvell logo, and the Powered by Cavium logo are registered trademarks of Marvell Semiconductor Inc. All other brand and product names are trademarks or registered trademarks of their respective owners.