(Agent‑based Linux PNs) Update node software

You do not need to initiate an upgrade of the onQ Service on your agent‑based PNs because onQ does this for you automatically immediately after you initiate an onQ Appliance upgrade, if the:

•	PN is available.

•	onQ is not backing up the PN or processing a recent snapshot from the PN. Otherwise, onQ performs the upgrade after the PN is no longer busy with these tasks.

If you hover‑over the DASHBOARD tab > PROTECTED NODES page > RN Status icon, you’ll see messages for the upgrade in progress.

Lastly, onQ sends alerts about the upgrade. If you aren’t a recipient of such alerts, you can generate the Event Log for a given PN; this log shows the coordination that transpired between onQ and the PNs.

There is no way to disable automatic upgrades of the onQ Service. However, you can continue to use the following alternative method if your PNs are in a state that requires a manual upgrade.

 

To manually install an update on an agent‑based Linux PN:

1.	Stop protection.

2.	Log on to the Linux PN as root or administrator.

 

3.	Install the packages:

a.	Launch the installer:

Note:  By default, wget preserves the original files. Newly retrieved install.py are saved with extensions .1, .2, etc. Use the -r option (see wget man page) to overwrite the existing file.

b.	From within a folder where you want to save the install script, run the following command:

# wget -r http://<onQ-IP-address>/install.py

c.	Start the installer:

# cd <onQ-IP-address> # python ./install.py

d.	Type the credentials for either onQ varadmin or admin user.

e.	Specify all valid values in the blank fields provided and modify defaults as needed. The install utility lists all available volumes/partitions/mount points.

•	For any Linux PN, you must protect both / and /boot and any other mount points that contain the necessary software to boot the RN.

•	For PNs running RHEL 5.x and due to the known limitation outlined in Linux RN Limitations, set the Format (file system type) parameter for both the root partition (/) to ext3.

•	For more information on the parameters, go to Protected Node Parameters.

f.	Select Save to update/install the client node package on the Linux node.

g.	Wait! Do not press Enter. Was the installation successful? Use the error messages below to evaluate the screen output.

•	If yes, exit the script.

•	If no, press Enter to launch the installer UI again. Correct the problem, then repeat Step e through Step g.

Completed Successfully   The iptables firewall is enabled on this system....	Message appears in the shell, after the GUI curser exits. In addition, you’ll be instructed to open up ports.
Incorrect/invalid values entered	Install utility stops if you type incorrect/invalid values. Correct the problem and Save again or Cancel.
PN configuration failed: Operation not permitted while protection is running	Turn off protection (go to Stop node protection). Press Enter for the GUI’s curser to reappear. Utility preserves all values entered previously.
not authorized	You either typed the credentials incorrectly or the user account does not have root privileges.

 

 

v3.8 HF1