User’s Guide QConvergeConsole 2400, 2500, 3200, 8100, 8200 Series SN0054669-00 C
User’s Guide—QConvergeConsole 2400, 2500, 3200, 8100, 8200 Series Information furnished in this manual is believed to be accurate and reliable. However, QLogic Corporation assumes no responsibility for its use, nor for any infringements of patents or other rights of third parties which may result from its use. QLogic Corporation reserves the right to change product specifications at any time without notice.
User’s Guide QConvergeConsole 2400, 2500, 3200, 8100, 8200 Series Added new section regarding Windows Firewall configuration “Windows Firewall Configuration” on page 2-4 Added a note to ensure that the management agents were installed using the SuperInstaller “Getting Started” on page 3-1 Added an appendix with troubleshooting information “Troubleshooting” on page A-1 SN0054669-00 C Page iii
User’s Guide QConvergeConsole 2400, 2500, 3200, 8100, 8200 Series Page iv SN0054669-00 C
Table of Contents Preface What’s in this Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . What’s in the Help System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Materials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Documentation Conventions . . . . . . . . . . . . . . . . . . .
User’s Guide—QConvergeConsole 2400, 2500, 3200, 8100, 8200 Series Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Browsing Help Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Viewing QConvergeConsole Version Details . . . . . . . . . . . . . . . . . . . ........................................................... A 3-3 3-4 3-5 3-5 Troubleshooting How to Change the Tomcat Port Number. . . . . . . . . . . . . . .
Preface The User’s Guide QConvergeConsole describes QConvergeConsole®, a Web-based GUI utility for configuring and managing QLogic Fibre Channel adapters, Intelligent Ethernet adapters, and Converged Network Adapters within storage area networks (SANs). NOTE: Throughout this guide, the terms target and device are used interchangeably. What’s in this Guide This user’s guide contains the basic information you need to get started with the QConvergeConsole management utility.
Preface What’s in the Help System What’s in the Help System NOTE: To access help, see “Getting Help” on page 3-3. For detailed information on configuring and managing adapters using QConvergeConsole, refer to the built-in help system. The QConvergeConsole help system contains features and functionality not covered in this guide, including the following: viii Getting Started shows how to start using QConvergeConsole and the help system.
Preface Intended Audience Managing Ethernet Networking (NIC) Ports shows and describes the parameters and configuration options provided on the NIC port management pages for 3200 Series Intelligent Ethernet Adapters, as well as 8100 and 8200 Series Converged Network Adapters. Troubleshooting describes tools you can use to resolve the problems that can occur when installing and using QConvergeConsole.
Preface License Agreements Text in blue font indicates a hyperlink (jump) to a figure, table, or section in this guide, and links to Web sites are shown in underlined blue. For example: Text in bold font indicates user interface elements such as a menu items, buttons, check boxes, or column headings. For example: Click the Start button, point to Programs, point to Accessories, and then click Command Prompt. Under Notification Options, select the Warning Alarms check box.
Preface Technical Support Technical Support Customers should contact their authorized maintenance provider for technical support of their QLogic products. QLogic-direct customers may contact QLogic Technical Support; others will be redirected to their authorized maintenance provider. Visit the QLogic support Web site listed in Contact Information for the latest firmware and software updates.
Preface Knowledge Database Knowledge Database The QLogic knowledge database is an extensive collection of QLogic product information that you can search for specific solutions. We are constantly adding to the collection of information in our database to provide answers to your most urgent questions. Access the database from the QLogic Support Center: http://support.qlogic.com.
1 System Requirements QConvergeConsole is a Web-based client and server GUI utility that provides centralized management and configuration of QLogic adapters within the entire network (LAN and SAN). On the server side, QConvergeConsole runs as an Apache Tomcat™ application server. After the utility is launched on the application server, you can connect to QConvergeConsole through a browser, either locally on the server or remotely from another computer.
1–System Requirements Software Requirements The minimum hardware requirements for the server agent are as follows: Adapters. One or more of the QLogic adapters listed under “Supported QLogic Adapters” on page 1-4. 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.
1–System Requirements Operating System Requirements Web browser. QConvergeConsole runs on the following Web browsers: Google Chrome™ version 9.0 Mozilla® Firefox® versions 5 and 6 Microsoft Internet® Explorer® versions 8 and 9 Apple® Safari® version 5 Opera™ version 11 NOTE: For the supported Web browser versions, refer to the Readme where QConvergeConsole is posted on the QLogic Web site: http://driverdownloads.qlogic.com.
1–System Requirements Supported QLogic Adapters Apache Tomcat application server. The following operating systems can host the Tomcat server, which is required to support the QConvergeConsole GUI: Windows Server 2008 Red Hat Linux Advance Server and Enterprise Server Novell SUSE Linux Enterprise Server (SLES) Citrix® XenServer® Server agent. Multiple operating system support allows control of heterogeneous environments.
2 Installing QConvergeConsole Installing QConvergeConsole consists of installing the QConvergeConsole user interface, a platform-specific management agent, and help components, as appropriate.
2–Installing QConvergeConsole Downloading QConvergeConsole Downloading QConvergeConsole To download QConvergeConsole from the QLogic Web site: 1. Go to the QLogic Driver Downloads/Documentation page at http://driverdownloads.qlogic.com. 2. Click QLogic Products. 3. Click Guided Search. A window opens prompting you to Enter your search criteria. 4. 2-2 Provide the information necessary: a. In the Select a Product Type menu, select Adapters. b. In the Select by Model or by OS, select by Model. c.
2–Installing QConvergeConsole Installing QConvergeConsole Installing QConvergeConsole Refer to the installation procedure for your operating system: “Installing QConvergeConsole in a Windows Environment” on page 2-3 “Installing QConvergeConsole in a Linux Environment” on page 2-5 “Installing QConvergeConsole in Silent Mode” on page 2-6 NOTE: Before installing QConvergeConsole, be sure to read the Note on page 2-1.
2–Installing QConvergeConsole Installing QConvergeConsole in a Windows Environment 8. On the Install Complete dialog box, click Done to exit the installer. You have installed QConvergeConsole on your server. 9. Start QConvergeConsole (see “Starting QConvergeConsole” on page 3-1 for detailed information).
2–Installing QConvergeConsole Installing QConvergeConsole in a Linux Environment i. When asked When do you want this rule to be applied to Domain, Public?, click All. j. Enter a name and description for each rule. 5. Click Outbound Rules, and then repeat steps 3 and 4. 6. For the changes to take effect, restart the Windows firewall. 7. If any agent was previously running, restart it.
2–Installing QConvergeConsole Installing QConvergeConsole in Silent Mode You can graphically install QConvergeConsole on a Linux host by running a Virtual Network Computing (VNC®) program on a Windows host. The TightVNC Viewer, a VNC program, can remotely control QConvergeConsole installation on a Linux host. To install QConvergeConsole in a Linux environment: 1. Open the directory containing the installer file, either QConvergeConsole_Installer_Linux_x32_.
2–Installing QConvergeConsole Uninstalling QConvergeConsole Uninstalling QConvergeConsole Refer to the uninstallation procedure for your operating system: “Uninstalling QConvergeConsole in a Windows Environment” on page 2-7 “Uninstalling QConvergeConsole in a Linux Environment” on page 2-8 Uninstalling QConvergeConsole in a Windows Environment Follow these steps to uninstall QConvergeConsole from a Windows system. To uninstall QConvergeConsole in a Windows environment: 1.
2–Installing QConvergeConsole Uninstalling QConvergeConsole in a Linux Environment Uninstalling QConvergeConsole in a Linux Environment Follow these steps to uninstall QConvergeConsole from a Linux system. To uninstall QConvergeConsole in a Linux environment: 1. Change to the directory where QConvergeConsole is installed. The default location is: /opt/QLogic_Corporation/QConvergeConsole/ Uninstall_QConvergeConsole/ 2.
3 Getting Started This chapter includes procedures for starting and exiting the QConvergeConsole user interface, and getting help: “Starting QConvergeConsole” on page 3-1 “Exiting QConvergeConsole” on page 3-3 “Getting Help” on page 3-3 NOTE: Before starting QConvergeConsole, ensure that the management agents (Ethernet networking [NIC], FCoE, and iSCSI) have been installed using the Windows or Linux SuperInstallers.
3–Getting Started Opening the QConvergeConsole Main Page To open QConvergeConsole locally on the server: Open a Web browser, and then enter the following address in the address bar: http://localhost:/QConvergeConsole Where is the port number you specified during QConvergeConsole installation. The default port number is 8080. The initial window of QConvergeConsole opens, as shown in Figure 3-1. Figure 3-1.
3–Getting Started Connecting to a Host Server Figure 3-2 shows an example of entering the Web address of the QConvergeConsole server. Figure 3-2. Entering QConvergeConsole Web Address (Example) The initial window of QConvergeConsole opens, as shown in Figure 3-1. Connecting to a Host Server To connect to a host server from the QConvergeConsole main window: 1. Locate the Input hostname/address box in the upper-left corner of the QConvergeConsole window. 2.
3–Getting Started Browsing Help Contents Browsing Help Contents Access the QConvergeConsole help system to view detailed information about using the utility. For a high-level list of topics covered in the help system, see “What’s in the Help System” on page viii. To view the help system from the main window: 1. Open the Help menu, and then click Browse Contents. The help window shows a navigation pane on the left and a topic pane on the right. 2.
3–Getting Started Viewing QConvergeConsole Version Details Viewing QConvergeConsole Version Details If you need technical assistance with QConvergeConsole, your technician will request the version number. To view the QConvergeConsole version: 1. On the QConvergeConsole main window Help menu, click About. A message box opens; Figure 3-4 shows an example. (The message box you view shows the actual product version number and copyright year.) Figure 3-4.
3–Getting Started 3-6 SN0054669-00 C
A Troubleshooting This appendix describes procedures that may be helpful for troubleshooting. “How to Change the Tomcat Port Number” on page A-2 If using the default Tomcat port number (8080) causes a port conflict, use this procedure to change the Tomcat port number to a different port number. “How to Set Up a Tomcat Log File” on page A-5 Follow the instructions in this section to set up a log file for troubleshooting.
A–Troubleshooting How to Change the Tomcat Port Number How to Change the Tomcat Port Number Tomcat by default runs on port number 8080. However, port number 8080 is widely used in other programs. In order to avoid port conflict, you can change the Tomcat port number. Follow these steps to change the Tomcat port number: 1. Edit file server.xml, located in the conf folder of the Tomcat folder. Path to server.
A–Troubleshooting How to Change the Default Port Reference Using the QConvergeConsole Shortcut How to Change the Default Port Reference Using the QConvergeConsole Shortcut The QConvergeConsole installer installs a shortcut named QCC GUI (localhost) in the Program Files menu. If the Tomcat port number is changed from 8080, the port number in the shortcut will also need to be changed from the default value of 8080. Follow these steps to change the port number for the QCC GUI shortcut: 1.
A–Troubleshooting How to Change the Default Port Reference Using the QConvergeConsole Shortcut 4. In the Target field, change the port number 8080 to the port number set in file server.xml. Port number 6789 is used in this example. The Properties dialog should appear as follows: Figure A-2. QCC GUI Shortcut Properties with New Port Number 5. A-4 Click Apply to save the change, and then click OK to close the Properties dialog.
A–Troubleshooting How to Set Up a Tomcat Log File How to Set Up a Tomcat Log File This section explains how to configure Tomcat to direct debug message output from QCC GUI to a given file location. Procedure on Windows-based Systems 1. Select Configure Tomcat from the Tomcat Program Files menu as shown in Figure A-3. Figure A-3. Tomcat Program Files Menu The Configure Tomcat GUI dialog appears. Figure A-4.
A–Troubleshooting Procedure on Windows-based Systems 2. If the Tomcat server is running, the Stop button will be enabled. Click Stop to stop the server. The following screen appears: Figure A-5. Stopping Server Progress 3. Select the Logging tab. Figure A-6. Logging Tab on Configure Tomcat Dialog 4. Click the box to the right of Redirect Stdout to enter the file location for output from Stdout from QCC.
A–Troubleshooting Procedure on Windows-based Systems Figure A-7. Changing Locations of Output Files 5. Click Apply to make the change. Figure A-8.
A–Troubleshooting Procedure on Linux-based Systems 6. Click the General tab. Click Start to restart the Tomcat service. Figure A-9. General Tab of Configure Tomcat Dialog 7. Start QConvergeConsole by pointing your web browser to: http://localhost:8080/QConvergeConsole. 8. Open the log files from the locations entered in step 4. Procedure on Linux-based Systems The QConvergeConsole installer installs Tomcat version 6.0.29 on Linux systems. For Tomcat 6.0.
A–Troubleshooting Procedure on Linux-based Systems 4. Change the file name in "$CATALINA_BASE"/logs/catalina.out to the appropriate file name. For example: CATALINA_OUT="$CATALINA_BASE"/logs/QCC.out 5. Save the change and close file. 6. Re-start the Tomcat server by running the following on a command line: “. /catalina.
A–Troubleshooting Procedure on Linux-based Systems A-10 SN0054669-00 C
Glossary adapter The board that interfaces between the host system and the target devices. Adapter is synonymous with host bus adapter (HBA), host adapter, and adapter board. adapter port A port on the adapter board. CLI Command line interface. A program interface driven by entering commands and parameters. Converged Network Adapter QLogic Converged Network Adapters.
User’s Guide—QConvergeConsole 2400, 2500, 3200, 8100, 8200 Series Fibre Channel A high-speed serial interface technology that supports other higher layer protocols such as SCSI and IP. Fibre Channel over Ethernet See FCoE. Internet Protocol See IP. Internet small computer system interface See iSCSI. IP Internet Protocol. A method by which data are sent from one computer to another over the Internet. IP specifies the format of packets, also called datagrams, and the addressing scheme.
User’s Guide—QConvergeConsole 2400, 2500, 3200, 8100, 8200 Series port instance The number of the port in the system. Each adapter may have one or multiple ports, identified with regard to the adapter as port 0, port 1 and so forth. To avoid confusion when dealing with a system containing numerous ports, each port is assigned a port instance number when the system boots up. So Port 0 on an adapter might have a port instance number of 8, for example, if it is the eighth port discovered by the system.
User’s Guide—QConvergeConsole 2400, 2500, 3200, 8100, 8200 Series Glossary-4 SN0054669-00 C
Index A About box 3-5 adapters definition of Glossary-1 port, definition of Glossary-1 server requirements 1-2 supported series 1-4 agent (server), requirements 1-4 agreements, license x Apache Tomcat changing default port A-2 requirements 1-2 server, system requirements 1-4 setting up log file for A-5 audience, intended ix B Boolean help system search 3-4 browsers recommended for help 1-3 requirements, client 1-3 supported 1-3 browsing help content 3-4 C CLI definition of Glossary-1 utility ix client bro
User’s Guide—QConvergeConsole 2400, 2500, 3200, 8100, 8200 Series F FCoE definition of Glossary-1 management agent, installing 2-1, 3-1 Fibre Channel over Ethernet, See FCoE firewall configuring for Windows 2-4 G getting help 3-3, 3-4 getting started 3-1 glossary of terms Glossary-1 graphics adapter, requirements 1-1 H hardware requirements 1-1 help system browsers, recommended 1-3 contents of viii viewing 3-4 host server, connecting to 3-3 I index, help system 3-4 installation 2-1 steps to perform befo
User’s Guide—QConvergeConsole 2400, 2500, 3200, 8100, 8200 Series Q QLogic adapters, supported 1-4 R RAID definition of Glossary-3 SAN subsystems 1-2 RAM definition of Glossary-3 requirement 1-2 random-access memory, See RAM redundant array of independent/inexpensive disks, See RAID related materials ix remote hosts connecting to 2-4 requirements Apache Tomcat 1-2 Apache Tomcat server 1-4 client browser 1-3 hardware 1-1 operating system 1-3 server agent 1-4 server, adapter 1-2 software 1-2 system 1-1 S S
User’s Guide—QConvergeConsole 2400, 2500, 3200, 8100, 8200 Series W Web browsers recommended for help 1-3 supported 1-3 what’s in this guide vii Windows installation on 2-3 uninstallation on 2-7 Windows firewall configuring 2-4 workstation (management), definition of Glossary-2 Index-4 SN0054669-00 C
Corporate Headquarters QLogic Corporation 26650 Aliso Viejo Parkway Aliso Viejo, CA 92656 949.389.6000 www.qlogic.com International Offices UK | Ireland | Germany | France | India | Japan | China | Hong Kong | Singapore | Taiwan © 2010-2011 QLogic Corporation. Specifications are subject to change without notice. All rights reserved worldwide. QLA, QLogic, the QLogic logo, and QConvergeConsole are registered trademarks of QLogic Corporation.
