QConvergeConsole Readme QLogic Corporation All rights reserved Table of Contents 1. Package Contents 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 installation packages are available for the following supported OS platforms: * QConvergeConsole_Installer_Windows_.exe - All supported Windows platforms * QConvergeConsole_Installer_Linux_x32_.bin - All supported Linux platforms * QConvergeConsole_Installer_Linux_x64_.bin - All supported Linux platforms * QConvergeConsole_Installer_Linux_IA64_.bin - All supported Linux platforms * QConvergeConsole_Installer_Solaris_SPARC_.bin - All supported Solaris SPARC platforms * QConvergeConsole_Installer_Solaris_x86_.bin - All supported Solaris x86 platforms NOTE: The "" in the preceding file names represents 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: - 2400 and 2500 Series Fibre Channel Adapters - 3200 Series Intelligent Ethernet Adapters - 8100 and 8200 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: 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. 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 * 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, 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 2003 (32-bit, 64-bit) Intel x86, 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 (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 - Red Hat RHEL AS/ES 4.9 (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 - XEN 5.6 FP1 (32-bit, 64-bit) Intel 64, AMD64 * Apache Tomcat application server. The following operating systems can host the Tomcat server, which is required to support the QConvergeConsole GUI. - Windows Server 2003 (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 (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.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 (32-bit, 64-bit) Intel 64, AMD64 * Server agent. Multiple operating system support allows control of heterogeneous environments. The QConvergeConsole works with the following operating system. - Windows Server 2003 (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 (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 (legacy support only) (32-bit) Intel 64, AMD64 - Solaris 10 SPARC (legacy support only) (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 - XEN 5.6 FP1 (32-bit, 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: http://driverdownloads.qlogic.com/ 4. Supported Features The QConvergeConsole has 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 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. 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 (http://driverdownloads.qlogic.com). 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 http://driverdownloads.qlogic.com. 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 (http://driverdownloads.qlogic.com). 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) 6.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 6.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. 6.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. 6.2 Windows 6.2.1 ConfigRequired Parameter None 6.3 Linux 6.3.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 6.3.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. 6.3.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. 6.3.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 6.3.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 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 http://support.microsoft.com/kb/175500. 7.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. 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 9.1.4.5 or 9.1.4.6. 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 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: 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 plumb up 7.9 Virtual Port is non-persistent If a virtual Port is created, it will be removed after a reboot. 7.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. 7.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. 7.12 Timeout error Using file update operation while system is busy may cause a timeout error. 7.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. 7.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. 7.15 Little River adapter QMH2572 On Windows platform, the inbox driver version 9.1.4.6 is installed automatically for Little River adapter QMH2572. This driver version is not a valid driver for Little River adapter. The QCC driver update feature does not support updating from this Windows inbox driver version 9.1.4.6. For the Little River adapter to function properly, the inbox driver must be updated to version 9.1.9.45 or later via Device Manager. 7.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. 7.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 7.18 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 a 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. 7.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. 7.21 Driver uninstallation requirement It is required that QCC application and agents must be stopped prior to disable or unload or uninstall driver. 8. Contacting Support 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: http://support.qlogic.com E-mail: support@qlogic.com (c) Copyright 2012. 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.