                   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-<x.xx.xxxx-x>.i386.rpm
qlremote-<x.xx.xxxx-x>.ia64.rpm
qlremote-<x.xx.xxxx-x>.ppc64.rpm
qlremote-<x.xx.xxxx-x>.x86_64.rpm


1.2 QConvergeConsole Linux Agent for iSCSI

iqlremote-<x.xx.xxx>-linux-i386.rpm
iqlremote-<x.xx.xxx>-linux-x86_64.rpm

1.3 QConvergeConsole Linux Agent for NIC 

netqlremote-<x.xx.xx-x>.i386.rpm
netqlremote-<x.xx.xx-x>.x86_64.rpm

1.4 QConvergeConsole Linux Agent for FastLinq

qlnxremote-<x.xx.xx-x>.i386.rpm
qlnxremote-<x.xx.xx-x>.x86_64.rpm
qlnxremote-<x.xx.xx-x>.ppc64.rpm
qlnxremote-<x.xx.xx-x>.ppc64le.rpm
qlnxremote-<x.xx.xx-x>.aarch64.rpm
qlnxremote-<x.xx.xx-x>.arm64.rpm
qlnxremote-<x.xx.xx-x>_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 <protocol-specific agent rpm file>

The rpm file name has the following format:

netqlremote-<VERSION>.<system_architecture>.rpm
qlremote-<VERSION>.<system_architecture>.rpm
iqlremote-<VERSION>.<system_architecture>.rpm
qlnxremote-<VERSION>.<system_architecture>.rpm

where <system_architecture> 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-<VERSION>_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 <protocol-specific agent>

where <protocol-specific agent> 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. 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.