(Linux) Enroll protected nodes

This procedure requires that you log on as either onQ varadmin or admin user. Only these users can install/update the node packages on Linux PNs. During the install the Linux PN needs to communicate with onQ to send/retrieve information to enroll/update PNs.

To enroll or update a Linux PN:

1.	Log on to the Linux PN.

2.	Is this an enrollment or an upgrade?

•	If enrollment, skip to Step 4.

•	If upgrade, proceed to Step 3.

3.	(64-bit PNs running 3.4, 3.4HF1, and 3.4HF3). Due to the known limitation outlined in Linux RN Limitations, find and remove the existing node packages.

# pkgs=`rpm -qa|grep BCV` # echo pkgs=$pkgs # if [ "$pkgs" != "" ]; then \ rpm -e $pkgs fi

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 becaue those files have a higher priority than .xvf5.

5.	Is this an enrollment or an upgrade?

•	If upgrade, skip to Step 7.

•	If enrollment, proceed to Step 6.

6.	(Redhat 5.x PNs) If this is the first time you’re enrolling this PN, install kernel‑xen RPM package.

7.	From within a folder where you want to store and use the install script, do the following:

a.	Delete any existing install.py files.

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.	Run the following command to retrieve the installer:

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

8.	Run the following command to start the installer:

# python ./install.py

9.	From the utility, type the credentials for either onQ varadmin or admin user.

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

11.	Do the following:

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

b.	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 a.

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 as outlined in Step 12.
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.

12.	On the protected node, open the following ports:

•	UDP port 5990

•	TCP ports 5000 and 5990

These ports must be open in order for onQ to see the protected node.

13.	(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.

 

 

v3.6 SP1 HF1