QConvergeConsole Graphical User Interface (GUI) installation packages are available for the following supported OS platforms:

Transcription

1 QConvergeConsole GUI Readme QLogic Corporation All rights reserved Table of Contents 1. Package Contents 3 2. Requirements 2.1 Hardware Requirements 2.2 Software Requirements 3. OS Support 4. Supported Features 5. Using the QConvergeConsole 5.1 Installing QConvergeConsole 5.2 Starting QConvergeConsole 6. Additional Notes 6.1 General (Applies to All Operating Systems) 6.2 Windows 6.3 Linux 7. Known Issues and Workarounds 8. 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_<version>.exe * Linux platforms: QConvergeConsole_Installer_Linux_x32_<version>.bin QConvergeConsole_Installer_Linux_x64_<version>.bin QConvergeConsole_Installer_Linux_IA64_<version>.bin QConvergeConsole_Installer_Linux_ppc64_<version>.bin * SPARC platforms: QConvergeConsole_Installer_Solaris_SPARC_<version>.bin * Solaris x86 platforms: QConvergeConsole_Installer_Solaris_x86_<version>.bin NOTE: The "<version>" in the preceding file names represents

2 the build number of the current software release. 2. Requirements This section defines the following: * 2.1 Hardware Requirements * 2.2 Software Requirements 2.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 QLogic adapters: , 2500 and 2600 Series Fibre Channel Adapters Series Intelligent Ethernet Adapters , 8200, or 8300 Series Converged Network 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 QLogic Storage Networking Interoperability Guide, which you can download from the following QLogic Web page: NOTE: Tape devices are shown as part of the configuration, but are not fully supported. Only persistent binding is supported. 2.2 Software Requirements QConvergeConsole requires the following minimum software: * Server on which your adapter is physically installed - QLogic adapter drivers for your operating system (OS) - QLogic 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

3 * 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 8,IE 9, IE 10, Firefox 3.6, Opera 11 or Chrome 9 * Adobe Flash Player - Browser must have Flash plug-in enabled to support Graphical Chart. 3. OS Support QConvergeConsole runs on the following OS platforms: * Client browser. These operating systems support running or hosting the QConvergeConsole by running one of the following supported browsers. - Windows Server 2012 (64-bit) Intel 64, AMD64 - Windows Server 2008 (32-bit, 64-bit) Intel x86, Intel 64, AMD64 - Red Hat RHEL AS/ES 6.0/6.1/6.2/6.3 (32-bit, 64-bit) Intel x86, Intel 64, AMD64 - Red Hat RHEL AS/ES 5.5/5.6/5.7/5.8 (32-bit, 64-bit) Intel x86, Intel 64, AMD64 - Novell SLES 11 SP2 (32-bit, 64-bit) Intel x86, Intel 64, AMD64 - Novell SLES 11 SP1 (32-bit, 64-bit) Intel x86, Intel 64, AMD64 - Novell SLES 11 (32-bit, 64-bit) Intel x86, Intel 64, AMD64 - Novell SLES 10 SP3 (32-bit, 64-bit) Intel x86, Intel 64, AMD64 - Novell SLES 10 SP4 (32-bit, 64-bit) Intel x86, Intel 64, AMD64 - XenServer 5.6 FP1/FP2, 6.x (64-bit) Intel 64, AMD64 - 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 2012 (32-bit, 64-bit) Intel 64, AMD64 - Windows Server 2008 (32-bit, 64-bit) Intel 64, AMD64 - Red Hat RHEL AS/ES 6.0/6.1/6.2/6.3 (32-bit, 64-bit) Intel 64, AMD64 - Red Hat RHEL AS/ES 5.4 (32-bit, 64-bit) Intel 64, AMD64 - Red Hat RHEL AS/ES 5.5 (32-bit, 64-bit) Intel 64, AMD64 - Red Hat RHEL AS/ES 5.6/5.7/5.8 (32-bit, 64-bit) Intel x86, Intel 64, AMD64 - Novell SLES 11 SP1/SP2 (32-bit, 64-bit) Intel x86, AMD64 - Novell SLES 10 SP3 (32-bit, 64-bit) Intel IA64, Intel 64, AMD64 - Novell SLES 10 SP4 (32-bit, 64-bit) Intel IA64, Intel 64, AMD64 - XEN 5.6 FP1/FP2, 6.x (64-bit) Intel 64, AMD64 - Solaris 10 Sparc, Solaris 10 x86, Solaris 11 Sparc, Solaris 11 x86

4 * Server agent. Multiple operating system support allows control of heterogeneous environments. The QConvergeConsole works with the following operating system. - Windows Server 2012 (32-bit, 64-bit) Intel 64, AMD64 - Windows Server 2008 (32-bit, 64-bit) Intel 64, AMD64 - Red Hat RHEL AS/ES 6.0/6.1/6.2/6.3 (32-bit, 64-bit) Intel 64, AMD64 - Red Hat RHEL AS/ES 4.9 (32-bit, 64-bit) Intel x86, Intel 64, AMD64 - Red Hat RHEL AS/ES 5.5/5.6/5.7/5.8 (32-bit, 64-bit) Intel x86, Intel 64, AMD64 - Novell SLES 11 SP1/SP2 (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 (64-bit) Intel 64, AMD64 NOTE: For specific service packs (SP) and OS updates, refer to the descriptions where this software version is posted on the QLogic Web site or on your OEM website. 4. Supported Features The QConvergeConsole supports the following features: * Unified adapter management. QConvergeConsole provides a browser-based GUI that lets you monitor, configure, and manage QLogic 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 QLogic adapters with connected storage devices. * Configuration management. QConvergeConsole allows you to configure local and remote systems. With QConvergeConsole, you can configure QLogic 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

5 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. * notifications. QConvergeConsole can automatically send notifications with a copy of the current host configuration to an 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. 5. Using QConvergeConsole 5.1 Installing 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 QLogic's Driver Downloads/Documentation page ( NOTE: Management agents (Ethernet networking, FCoE, and iscsi) to use for remote access to the adapters can be installed using Windows or Linux SuperInstallers. These SuperInstallers can be found on the download section for Windows/Linux OSs for your specific adapter at The management agents are not included in the QConvergeConsole package that you download from the QLogic downloads page. 5.2 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 QLogic's Driver Downloads/Documentation page ( 6. Additional Notes The following sections provide additional information according to operating system: * 6.1 General (Applies to All Operating Systems) * 6.2 Windows * 6.3 Linux 6.1 General (Applies to All Operating Systems) 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

6 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: <install drive>:windows\system32\drivers\etc\hosts * Linux, Solaris SPARC and Solaris x86: /etc/hosts 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, 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. 6.2 Windows ConfigRequired Parameter None 6.3 Linux Running QConvergeConsole and Connecting to a Remote Red Hat Linux Machine

7 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: localhost runner.domain.com Modified: localhost runner.domain.com 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 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 <Linux 7.2 CD-1>: /Red Hat/RPMS/shadow-utils i386.rpm 2. Go to the /etc file, and then type the pwconv command to convert the passwords to shadow password format 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-<version>.el rpm. If the libraries are missing, the following exception displays:

8 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 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 <arch>.rpm * libxp <arch>.rpm NOTES: * On x86_64 machines, load 32-bit libs * On ppc64 Linux machines, load both ppc64/ppc rpms 7. Known Issues and Workarounds 7.1 Issue: Internet Explorer 8.0 sometimes displays the error message "A script on this page is causing Internet Explorer to run slowly. Workaround: Follow the procedures described in the article located at Issue: The administrator/admin enabled account password must not be blank when changing the QConvergeConsole utility password. Workaround: This is a Windows security restriction. 7.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. 7.4 QConvergeConsole does not support adapter parameters and Flash updates on 8Gb adapters when running Windows Server 2008 Inbox Driver Version or Workaround: You must update the host to the latest QLogic driver. 7.5 The hot swap feature does not work on QLogic Fibre Channel Adapters. Workaround: Stop the qlremote agent. 7.6 During normal operation of QConvergeConsole on Solaris, a stale semaphore may be left behind, causing QConvergeConsole

9 to fail on load. Workaround: Manually remove the following two files: /var/tmp/.semd /var/tmp/.seml 7.7 The Following features will not be supported from FC/FCoE on 82xx adapters: - Loopback test (Internal/External) - iidma 7.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 <qlcnic-port> plumb up 7.9 Virtual Port is non-persistent If a virtual Port is created, it will be removed after a reboot 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 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 Timeout error Using file update operation while system is busy may cause a timeout error 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 Virtual Port missing info On Windows host, the LUN size and WWULN are not displayed. This is known limitation of Windows Management Instrumentation components FC adapter QMH2572

10 On Windows platform, the inbox driver version is installed automatically for adapter QMH2572. QCC driver update feature does not support updating from this Windows inbox driver version Use Device Manager to update this inbox driver to version or higher address rejected When using the QCC feature, there might be issue with some servers due to the From address is fixed to: and cannot be changed. To avoid this issue, please add this fixed address in spam exclusion list 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: Internet Explorer 9 requirement When using IP address to open QCC on Internet Explorer version 9, the IP address must be added to the list of Local intranet zone. This is an IE 9 requirement due to security reason. To add a site to the Local intranet zone, do the following steps: a. Open the site in Internet Explorer. b. Click File and point to Add this site to. c. Click Local intranet zone. d. Click Add in the Local intranet dialog box. e. Click Close 7.19 Host refresh requirement Refreshing host is required after making a LUN change 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 Driver uninstallation requirement

11 It is required that QCC application and agents must be stopped prior to disable or unload or uninstall driver Internet Explorer version 10 When using Internet Explorer browser version 10 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 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: During flash update, the browsers IE8 and Firefox, 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 m FF IE Safari ( ) Opera Virtual Disk and Virtual LUN QConvergeConsole does not recognize virtual Disk and virtual LUN. This feature is Not Yet supported 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 Browser security settings requirement When using Internet Explorer browser to open QConvergeConsole,

12 please make sure the IP address and/or "localhost" are added to the list of Trusted Sites Driver Update Wizard file selection requirement 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 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 BPS value not incremented on VP for BFS setup On Linux machine running RHEL 5.x or 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 RHEL 6.x and SLES 11.x 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 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 existed. It is possible to retrieve the same dump file multiple times. This situation happens when new dump event has not been occurred Linux driver update When selecting a driver file to update via QConvergeConsole's driver update, the

13 driver file must be in RPM format. The name of the driver file must follow one of the following naming convention: kmod-qlgc-qla2xxx-<version-number>-n.<kernel-architecture>.rpm qlgc-qla2xxx-kmp-default-<version-number>-n.<kernel-architecture>.rpm qla2xxx-<version-number>-ndkms.<kernel-architecture>.rpm where n is an unsigned integer. Driver source file is not supported IE 10 text box issue When using Internet Explorer 10 to open QConvergeConsole, there is an 'x' mark displayed at the end of the text box when text box is in focus. This is new feature in IE 10. This 'x' mark is the clear button which IE 10 automatically added to the text box VPD update after flash update issue When performing a flash update make sure all steps are completed before shuting down the application or rebooting the machine 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 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 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 m and Firefox This problem is not seen on IE browser 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 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. 8. Contacting Support

14 Please feel free to contact your QLogic approved reseller or QLogic Technical Support at any phase of integration for assistance. QLogic Technical Support can be reached by the following methods: Web: (c) Copyright All rights reserved worldwide. QLogic, QConvergeConsole, the QLogic logo, and the Powered by QLogic logo are registered trademarks of QLogic Corporation. All other brand and product names are trademarks or registered trademarks of their respective owners.