QConvergeConsole Linux Agent Installer(s) Readme File This software license applies only to Marvell customers. Marvell Semiconductor Inc. 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 Linux Agent installers 5.1 Installing QConvergeConsole Linux Agent 5.2 Starting the QConvergeConsole Linux Agent 5.3 Removing the QConvergeConsole Linux Agent 6. Additional Notes 7. Known Issues and Workarounds 8. Contacting Support 1. Package Contents The QConvergeConsole Linux Agent package contains the following files: 1.1 QConvergeConsole Linux Agent for FC/FCoE qlremote-.i386.rpm qlremote-.ia64.rpm qlremote-.ppc64.rpm qlremote-.x86_64.rpm 1.2 QConvergeConsole Linux Agent for iSCSI iqlremote--linux-i386.rpm iqlremote--linux-x86_64.rpm 1.3 QConvergeConsole Linux Agent for NIC netqlremote-.i386.rpm netqlremote-.x86_64.rpm 1.4 QConvergeConsole Linux Agent for FastLinq qlnxremote-.i386.rpm qlnxremote-.x86_64.rpm qlnxremote-.ppc64.rpm qlnxremote-.ppc64le.rpm qlnxremote-.aarch64.rpm qlnxremote-.arm64.rpm qlnxremote-_arm64.deb 2. Requirements This section defines the minimum requirements. 2.1 Hardware Requirements * Minimum of 40MB of disk space (NIC/FC) 2.2 Software Requirements rpm Package Manager command rpcbind service running 3. OS Support The QConvergeConsole Linux Agent Installer runs on the following OS platforms: Linux x86/x64 4. Supported features The QConvergeConsole Linux Agent supports QConvergeConsole application with Tomcat server running on Linux platform. 5. Using The QConvergeConsole Linux Agent Installer The QConvergeConsole Linux Agent Installer installs QConvergeConsole Linux Agent on Linux platform. 5.1 Installing QConvergeConsole Linux Agent To install QConvergeConsole Linux Agent using RPM package, use the following Linux command: rpm -i The rpm file name has the following format: netqlremote-..rpm qlremote-..rpm iqlremote-..rpm qlnxremote-..rpm where can be one of the following: i386 x86_64 ia64 (qlremote only) ppc64 (qlremote and qlnxremote only) ppc64le (qlremote and qlnxremote only) To install QConvergeConsole ARM64 Linux Agent for FastLinq adapter, use the following Linux command: dpkg -i qlnxremote-_arm64.deb 5.2 Starting QConvergeConsole Linux Agent QConvergeConsole Linux Agent starts immediately right after installation completes. 5.3 Removing QConvergeConsole Linux Agent To uninstall QConvergeConsole Linux Agent, use the following command: rpm -e where can be one of the following: netqlremote qlremote iqlremote qlnxremote To uninstall QConvergeConsole ARM64 Linux Agent for FastLinq adapter, use the following Linux command: dpkg -r qlnxremote 6. Additional Notes 1. Agents for x86_64 platform are valid on RHEL 6.x/SLES 11.x or newer kernel version only. 2. For PowerPC 64-bit system, glibc.ppc package installation is required on RHEL 7.x and newer kernel version. 7. Known Issues and Workarounds 1. rpm command limit support: a. Currently, using rpm command with -U switch is not supported. b. To update an existing agent, it is required to use rpm command with -e switch to uninstall old agent, then use rpm command with -i switch to install new agent. 2. command service reload is not supported Currently, reload qlremote service is not supported. To restart qlremote service, run "service qlremote stop" command then run "service qlremote start" command. 3. Loading SCSI Generic (SG) driver requirement for RH7.1 In RH7.1, loading SG driver is required to display the LUNs. To load SG driver: # modprobe sg Agent must be restarted after loading SG driver. To restart agent: service "agent" restart 4. Installing agent on Ubuntu system On an Ubuntu Linux system, we use the alien program to convert/install agent RPM packages. During installation, alien converts RPM format to Debian format and stores the new format in a file with extention .deb. The conversion does not include scripts for uninstallation. Therefore, after an agent package is uninstalled, the agent binary file is removed but the agent running process is not stopped until system is rebooted or manually killed. 5. Localhost only restriction To restrict portmap to only respond to requests for connections from localhost only, it is required to edit the following two files: /etc/hosts.allow and /etc/hosts.deny. Steps to do: 1. Add the following two lines to the very end of file /etc/hosts.allow: Line #1: rpcbind: LOCAL, 127.0.0.1, (plus any allowable IP) Line #2: blank line (note: must be the last line in file) 2. Add the following two lines to the very end of file /etc/hosts.deny: Line #1: rpcbind: ALL Line #2: blank line (note: must be the last line in file) 8. Contacting Support Please feel free to contact your Marvell approved reseller or Marvell Technical Support at any phase of integration for assistance. Marvell Technical Support can be reached by the following methods: Web: http://support.qlogic.com North America Contact Information Email: support@qlogic.com Phone: (952) 932-4040 Support contact information for other regions of the world is available at the QLogic website: http://support.qlogic.com (c) Copyright 2018-2021. All rights reserved worldwide. QLogic, the QLogic 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.