The necessary packages for ASR Manager must first be downloaded and stored in an installation directory that is accessible from both management nodes. For ASR Manager to work on Oracle PCA, it must be installed on both management nodes, and failover must be configured so that the ASR Manager role is always fulfilled by the management node that also has the master role.
Downloading the Current ASR Packages
Verify whether ASR Manager is already installed. If any version older than 5.0 is installed, uninstall it first.
For detailed information, refer to the document ASR Manager 5.x Installation, Backup and Upgrade (Doc ID 1392042.1).
Download ASR Manager Release 5.0 or newer from the ASR download page.
Select the download for the Linux x86-64 platform.
NoteThe version tested at the time of writing is 5.2.1. The latest version is 5.3.
Unpack the
*.zip
file in a directory available to both management nodes. For example:/nfs/shared_storage/ASRM/pkg
.[root@ovcamn05r1 ~]# cd /nfs/shared_storage/ASRM/pkg [root@ovcamn05r1 pkg]# unzip p21056276_521_Linux-x86-64.zip Archive: p21056276_521_Linux-x86-64.zip inflating: asrmanager-5.0.2-20141215170108.rpm inflating: readme.html inflating: license_agreement.html
Installing ASR Components on the Management Nodes
Using SSH and an account with superuser privileges, log into the master management node.
NoteThe data center IP address used in this procedure is an example.
# ssh root@10.100.1.101 root@10.100.1.101's password: [root@ovcamn05r1 ~]# pca-check-master NODE: 10.100.1.101 MASTER: True
Go to the shared directory where you stored the ASR package.
# cd /nfs/shared_storage/ASRM/pkg
Install the ASR Manager package.
#
rpm -i asrmanager-5.2.1-20150501144949.rpm
Copyright [2008,2014], Oracle and/or its affiliates. All rights reserved. License and Terms of Use for this software are described at https://support.oracle.com/ (see Legal Notices and Terms of Use). ASR Manager (pid 345193) is RUNNING. Installing ASR Manager bundles... Successfully installed ASR Manager bundles. asrm: unrecognized service Successfully added ASR Manager (asrm) service. ******************************************************* To allow a non-root user to manage ASR Manager service: Add the following line to /etc/sudoers file '<userName> ALL=(root) NOPASSWD:/opt/asrmanager/bin/asr start,/opt/asrmanager/bin/asr stop, /opt/asrmanager/bin/asr status,/opt/asrmanager/bin/asr restart' ******************************************************* The ASR Manager application is installed in '/opt/asrmanager'. Log files are located in '/var/opt/asrmanager'. ASR Administration command is now available at /opt/asrmanager/bin/asr. ASR Manager is stopped. ASR Manager (pid 347799) is RUNNING. Checking ASR Manager status ....Installation of asrmanager was successful.WarningFor Oracle PCA the auto-update feature of ASR must not be used.
At the end of the installation, the ASR Manager service (
asrm
) is started automatically.Disable auto-update.
# /opt/asrmanager/bin/asr disable_autoupdate
Stop the ASR Manager service and prevent it from starting automatically.
# service asrm status ASR Manager (pid 357177) is RUNNING. # service asrm stop ASR Manager is stopped. # chkconfig asrm off
Configure the
init
service to log when the ASR Manager service starts and stops.Open the file
/etc/init.d/asrm
for editing.In the start and stop sections, add the echo commands as shown.
start) /opt/asrmanager/bin/asrm start
echo "START: `hostname` `date "+%D %T"`" >> /nfs/shared_storage/ASRM/ASRHA.log
;; stop) /opt/asrmanager/bin/asrm stopecho "STOP: `hostname` `date "+%D %T"`" >> /nfs/shared_storage/ASRM/ASRHA.log
;;Save and close the file
/etc/init.d/asrm
.
Preserve the data in the original ASR directories.
# mv /var/opt/asrmanager /var/opt/orig_asrmanager
Repeat this procedure on the other management node.
# ssh root@10.100.1.102 root@10.100.1.102's password: [root@ovcamn06r1 ~]# pca-check-master NODE: 10.100.1.102 MASTER: False
CautionThe secondary management node does not need to take over the master role during the ASR installation.
The ASR Manager service must remain stopped on both management nodes.
Configuring ASR Manager Failover
Using SSH and an account with superuser privileges, log into the master management node.
NoteThe data center IP address used in this procedure is an example.
# ssh root@10.100.1.101 root@10.100.1.101's password: [root@ovcamn05r1 ~]#
Create the following directories and log file on the shared storage:
# mkdir /nfs/shared_storage/ASRM # mkdir /nfs/shared_storage/ASRM/VarOptAsrmanager # touch /nfs/shared_storage/ASRM/ASRHA.log
Copy the original ASR data from the master management node local file system to the shared storage.
# cp -r /var/opt/orig_asrmanager/* /nfs/shared_storage/ASRM/VarOptAsrmanager
Create a symlink to the directory on the shared storage.
# ln -s /nfs/shared_storage/ASRM/VarOptAsrmanager /var/opt/asrmanager
Add the
asrm
service to the Oracle PCA system configuration.Open the file
/var/lib/ovca/ovca-system.conf
for editing.Insert a new line to add
asrm
to the foundational services.[mgmt_init] [...] foundational_services: ovmm_mysql ovmm tinyproxy xms dhcpd
asrm
[...]Save and close the file
/var/lib/ovca/ovca-system.conf
.
Log into the other management node and execute steps 4 and 5.
Create a symlink to the directory on the shared storage.
Add the
asrm
service to the Oracle PCA system configuration.
Starting ASR Manager
Using SSH and an account with superuser privileges, log into the master management node.
NoteThe data center IP address used in this procedure is an example.
# ssh root@10.100.1.101 root@10.100.1.101's password: [root@ovcamn05r1 ~]#
Start the ASR Manager service.
NoteYou can monitor the process by tailing the log file
/nfs/shared_storage/ASRM/ASRHA.log
.# service asrm start
Register the ASR Manager.
ASR Manager (ASRM) can be registered as a stand-alone ASRM, pointing directly to My Oracle Support, or as a relay to another ASRM in your network. Even if other systems at your site already use an ASRM, you can choose to register the Oracle PCA ASRM as stand-alone. This means it communicates directly with the Oracle backend systems, which is the standard registration method.
For details and instructions, refer to the section entitled “Register the ASR Manager” in the Oracle Auto Service Request ASR Manager User's Guide.
The basic registration command is:
/opt/asrmanager/bin/asr register
.A relay ASRM could be used if an established ASRM is already in use by other systems in their facility. Since the other systems cannot be routed through the Oracle PCA ASR Manager, you must route the Oracle PCA ASR Manager through the existing one.
The instructions for setting up the ASR Manager in relay mode are in the ASR documentation. In short you must register the Oracle PCA ASR Manager to the web address generated by the relay ASR Manager, which must already be configured for relaying the data. (Follow the instructions in the documentation for your particular ASR version, as it may be different with each version of ASR.) To get the destination address, enter the following command at the ASR prompt on the destination ASR Manager:
# /opt/asrmanager/bin/asr show_http_receiver HTTP Receiver configuration: HTTP Receiver Status: Enabled Host Name: Relay_Node.Company.com HTTP Port: 7777 HTTPS/SSL configuration is not enabled.
The basic ASR Manager relay command is:
/opt/asrmanager/bin/asr register -e http://Relay_Node.Company.com:7777/asr
.Test ASR Manager failover by rebooting the current master management node.
NoteYou can monitor the process by tailing the log file
/nfs/shared_storage/ASRM/ASRHA.log
.[root@ovcamn05r1 ]# reboot [root@ovcamn06r1 ]# tail -f /nfs/shared_storage/ASRM/ASRHA.log STOP: ovcamn05r1 07/20/15 14:35:20 START: ovcamn05r1 07/20/15 14:35:20 STOP: ovcamn05r1 07/20/15 14:37:37 START: ovcamn06r1 07/20/15 14:39:15