(Agent‑based Linux PNs) Enroll protected nodes

onQ supports both agent‑based and agent‑less PNs. Nodes that are not hosted by VMware require that an agent (onQ Service) be installed. Agent‑based enrollment enables you to use all of the operation and monitoring features that onQ has to offer.

To enroll an agent‑based Linux PN:

You must perform this procedure from the node that you want to enroll. Repeat this procedure for each node that you want to enroll.

1.	Log on to the HA Appliance’s onQ Portal as varadmin.

2.	Stop protection.

3.	SSH to the to the server that you want to enroll as a PN, then log on as root.

4.	(Redhat 6.x PNs with EFI boot) Copy and modify /boot/grub/menu.lst:

[root@RHEL62x64-16-110 grub]# cd /boot/grub [root@RHEL62x64-16-110 grub]# ls \ /boot/efi/EFI/redhat/grub.conf [root@RHEL62x64-16-110 grub]# cp \ /boot/efi/EFI/redhat/grub.conf /boot/grub/ [root@RHEL62x64-16-110 grub]# cd /boot/grub/ [root@RHEL62x64-16-110 grub]# ln -s \ ./grub.conf menu.lst

Note:  If you want a custom boot menu, create a /boot/grub/grub.conf.xvf5 file. If .xvf1 thru .xvf4 exist, delete them because those files have a higher priority than .xvf5.

5.	(Redhat 5.x PNs) install kernel‑xen RPM package.

 

6.	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.

 

7.

(Redhat 6.x PNs) On your yum‑enabled PN, run the following command to install the Netcat (nc) utility, then verify that the package was installed. This utility reads and writes data across network connections using TCP or UDP. onQ depends on this utility for FLR restores. 5.x RHEL installs this utility by default.

# yum install nc # which nc nc is /usr/bin/nc # rpm -qf /usr/bin/nc nc-1.84-22.el6.x86_64

8.	On the protected node, open the following ports in order for onQ to see the protected node.

•	UDP port 5990

•	TCP ports 5000 and 5990

Quorum recommends that you use the Firewall Configuration GUI that’s included with your operating system. For example:

9.	(Oracle database) Install RMAN scripts.

If the PN has an Oracle database, install the RMAN scripts so that onQ can execute a hot backup of your database as outlined in Back up and restore Oracle 11g database on Linux.

v3.8 HF1