Oracle® Real User Experience Insight Installation Guide Release 6.0.1 for Linux x86-64 Part Number E16360-02 |
|
|
View PDF |
This chapter describes the procedure for upgrading an existing RUEI 5.x or 6.0.0 installation to release 6.0.1. The post-installation configuration procedure is described in Chapter 6, "Configuring RUEI".
If the DVD is not automatically mounted, use the following commands to mount it:
mkdir -p /mnt/dvd mount /dev/dvd /mnt/dvd
Note:
In the rest of this chapter it is assumed that the RUEI DVD is mounted on/mnt/dvd
.Note that the upgrade procedure described below should be performed as the root
user unless indicated otherwise.
This section describes the procedure for upgrading from an existing RUEI 5.x installation to release 6.0.1.
Important:
Before proceeding with the upgrade, make a backup of your configuration. Select Configuration, then System, then Maintenance, and then Backup and restore. The configuration backup is required in case of a rollback. In addition, it is strongly recommended that you create a database backup. Information on database backup procedures is available athttps://support.oracle.com/CSP/ui/flash.html
.Upgrading Accelerator packages
If your RUEI installation makes use of accelerator packages (such as for Oracle E-Business Suite or Siebel), these must be upgraded at the same time as the RUEI system. Ensure you follow the sequence of steps described in the rest of this section.
Do the following:
Copy the RUEI distribution pack (V
xxx
.zip
) to the Reporter system /root
directory, and unzip it. Repeat the unzip action for all required accelerator packages. Issue the following commands:
cd /root unzip Vxxx.zip
Install the XML::Twig module by issuing the following commands:
cd /mnt/dvd/Server rpm -Uhv perl-XML-Twig-3.26-*.fc6.noarch.rpm \ perl-XML-Parser-2.34-*.x86_64.rpm
Install the Java Runtime Environment (JRE). Note that this step can be skipped if you are upgrading from RUEI 5.1. Issue the following commands:
cd /root/RUEI/Java chmod +x ./jre-1_5_0_21-linux-amd64-rpm.bin ./jre-1_5_0_21-linux-amd64-rpm.bin ln -s /usr/java/jre1.5.0_21 /usr/java/jre
Note you are prompted to accept the Java license agreement. You cannot continue until you have done so.
This installs the JRE from a standalone package bundled with the RUEI distribution set, rather than the one built into the database.
Temporarily stop all processing by issuing the following command:
cd /root/RUEI/extra chmod +x ruei-upgrade-5.x-6.0.sh ./ruei-upgrade-5.x-6.0.sh stop_ruei
For each Collector system, issue the following commands:
./ruei-upgrade-5.x-6.0.sh stop_collector Collector-IP-address
where Collector-IP-address
is the IP address of the collector system. Note that this command must also be issued for the local Collector (localhost).
Note that this step can be skipped if you are upgrading from RUEI 5.1. Update the /etc/ruei.conf
file by issuing the following commands:
cp /etc/ruei.conf /etc/ruei.conf.50 cp /root/RUEI/extra/ruei.conf.upgrade /etc/ruei.conf chmod 644 /etc/ruei.conf source /etc/ruei.conf chown $RUEI_USER:$RUEI_GROUP /etc/ruei.conf
Update the RUEI database instance by issuing the following commands:
cd /root/RUEI/60 cp ruei-prepare-db.sh /home/oracle cp ruei-check.sh /home/oracle chmod +x /home/oracle/ruei-*.sh su - oracle export ORACLE_HOME=/u01/app/oracle/product/11.1.0/db_1 ./ruei-prepare-db.sh exit
Upon completion, you should again be the root
user.
Upgrade the RUEI Reporter RPMs by issuing the following commands:
cd /root/RUEI/extra ./ruei-upgrade-5.x-6.0.sh rpm_pre_install cd /root/RUEI/60 chmod u+x ./ruei-install.sh ./ruei-install.sh *.rpm cd /root/RUEI/extra ./ruei-upgrade-5.x-6.0.sh rpm_post_install
Note:
When upgrading a Reporter system that has little or no replay data on its local Collector, "*LTS?*" errors can be reported. These can be safely ignored.Note that this step can be skipped if you are upgrading from RUEI 5.1. Enable additional fonts for PDF generation. Because the PDF generator uses Java libraries, these need to be made available to Java. Copy (or move) the RUEI included fonts to the appropriate Java directory. For example:
cp /opt/ruei/gui/include/bi_publisher/fonts/* \ /usr/java/jre/lib/fonts/
Restart the Apache Web server by issuing the following command:
/sbin/service httpd restart
Important:
At this point you should complete the Collector upgrade procedure described below before proceeding with step 11.Restart processing (after you have upgraded all Collector systems) by issuing the following commands:
cd /root/RUEI/extra ./ruei-upgrade-5.x-6.0.sh start_ruei
The procedure for upgrading the Reporter system is complete.
Note:
After completion of the upgrade procedure, the default URL prefix masking action is set to "No replay". Review this setting (as described in the Oracle Real User Experience Insight User's Guide) to determine whether it meets your operational requirements.Note:
During and after the upgrade procedure, if error or information messages appear in the event log (select System, then Status, and then Event log), you should mark them as read after completing the upgrade procedure, and monitor whether new messages are reported. In the event of re-occurring error messages, you should contact Customer Support.Upgrading the Collector System(s)
Do the following:
Note steps 1 through 4 are only required if you are upgrading from RUEI 5.0. If you are upgrading from RUEI 5.1, you should proceed directly to step 5.
Remove the line containing the entry /home/oracle/bin/ruei-clean.sh
from Oracle's crontab
file by issuing the following commands:
su - oracle crontab -e exit
Stop the Oracle database, and remove the installation script so that it will no longer be started after a reboot, by issuing the following commands:
service oracledb stop chkconfig --del oracledb
Note that if stopping the Oracle database service seems to take an usually long period of time, you should open a second terminal and kill any running process called rsynclogdird
.
Stop the Apache Web server by issuing the following commands:
service httpd stop chkconfig --del httpd
De-install all RUEI RPMs (except ux-collector
) by issuing the following command:
rpm -qa | grep ^ux-.*-5.0 | grep -v ^ux-collector | xargs rpm -e
Copy the RUEI distribution pack (V
xxx
.zip
) to the Collector system /root
directory, and unzip it. Issue the following commands:
cd /root unzip Vxxx.zip cd /root/RUEI/60
Install the Java Runtime Environment (JRE). Note that this step can be skipped if you are upgrading from RUEI 5.1. Issue the following commands:
cd /root/RUEI/Java chmod +x ./jre-1_5_0_21-linux-amd64-rpm.bin ./jre-1_5_0_21-linux-amd64-rpm.bin ln -s /usr/java/jre1.5.0_21 /usr/java/jre
Note you are prompted to accept the Java license agreement. You cannot continue until you have done so.
This installs the JRE from a standalone package bundled with the RUEI distribution set, rather than the one built into the database.
Note that this step can be skipped if you are upgrading from RUEI 5.1. Update the /etc/ruei.conf
file by issuing the following commands:
cp /etc/ruei.conf /etc/ruei.conf.50 cp /root/RUEI/extra/ruei.conf.upgrade /etc/ruei.conf chmod 644 /etc/ruei.conf source /etc/ruei.conf chown $RUEI_USER:$RUEI_GROUP /etc/ruei.conf
Convert the Replay store and upgrade the RUEI Collector RPM by issuing the following commands:
cd /root/RUEI/extra chmod +x ruei-upgrade-5.x-6.0.sh ./ruei-upgrade-5.x-6.0.sh convert_replay_store cd /root/RUEI/60 chmod +x ruei-install.sh ./ruei-install.sh collector
Repeat the above steps for each Collector system in your RUEI infrastructure.
At this point, you should return to step 10 of the Reporter system upgrade procedure.
The upgrade procedure from version 6.0.0 to 6.0.1 only takes a few minutes. There is a short interruption of the Collector service, but it is automatically restarted during the upgrade.
Important:
Before proceeding with the upgrade, make a backup of your configuration. Select Configuration, then System, then Maintenance, and then Backup and restore. The configuration backup is required in case of a rollback.Reporter System
The Reporter upgrade procedure described in this section applies to both single server installations as well as dedicated Reporter systems.
Do the following:
Login to the Reporter as root
. Within the /root
directory, unzip the RUEI zip file, and go to the directory containing the application files. Repeat the unzip action for all required accelerator packages. Use the following commands:
cd /root
unzip Vxxxx.zip
Stop all processing on the Reporter system using the following commands:
cd /root/RUEI/extra chmod +x ruei-upgrade-5.x-6.0.sh ./ruei-upgrade-5.x-6.0.sh stop_ruei
Install the new versions of the RPMs using the following commands:
cd /root/RUEI/60 chmod +x ruei-install.sh ./ruei-install.sh *.rpm
As the moniforce
user, restart processing using the following commands:
cd /root/RUEI/extra ./ruei-upgrade-5.x-6.0.sh start_ruei
Collector System(s)
For each required Collector system, login as root
. Within the /root
directory, unzip the RUEI zip file, go to the directory containing the application files, and install the new versions of the RPMs. Do the following:
Unzip the RUEI distribution package using the following commands:
cd /root
unzip Vxxxx.zip
Upgrade the Collector RPMs using the following commands:
cd /root/RUEI/60 chmod +x ruei-install.sh ./ruei-install.sh collector
This section describes the procedure to rollback to version 6.0.0 after upgrading to version 6.0.1. Note that the Collector included in the Reporter installation is automatically rolled back during the described procedure. However, remote Collector systems must be individually rolled back. The procedure to do this is described later in this section.
Important:
Be aware that it may not be possible to restore your system to its exact state prior to upgrading. It is strongly recommended that you contact Customer Support before rolling back an upgrade.Login to the Reporter system as root
. Within the /root
directory, unzip the RUEI 6.0.0 distribution zip file, and go to the directory containing the application files. Use the following commands:
cd /root
unzip Vxxx.zip
Important:
Ensure that the directory where you place the 6.0.0 distribution pack does not conflict with the 6.0.1 release. In addition, if your RUEI installation makes use of accelerator packages (such as Oracle E-Business Suite or Siebel), repeat the unzipping for all previously installed accelerator packages.Stop all processing on the Reporter system by issuing the following commands:
cd /root/RUEI/60 ./ruei-upgrade-5.x-6.0.sh stop_ruei
Restore the previous RPMs by issuing the following commands:
cd /root/RUEI/60 chmod +x ruei-install.sh ./ruei-install.sh *.rpm
Restart processing by issuing the following commands:
cd /root/RUEI/extra ./ruei-upgrade-5.x-6.0.sh start_ruei
Rolling Back Remote Collector Systems
Do the following:
Login to the remote Collector system as root
. Within the /root
directory, unzip the 6.0.0 distribution zip file, and go to the directory containing the application files. Issue the following commands:
cd /root
unzip Vxxx.zip
Important:
Ensure that the directory where you place the 6.0.0 distribution pack does not conflict with the 6.0.1 release.Restore the previous RPMs by issuing the following commands:
cd /root/RUEI/60 chmod +x ruei-install.sh ./ruei-install.sh ux-collector-*.rpm
This section describes the procedure to rollback to version 5.1.x after upgrading to version 6.0.x. Note that the Collector included in the Reporter installation is automatically rolled back during the described procedure. However, remote Collector systems must be individually rolled back. The procedure to do this is described later in this section.
Important:
Be aware that it may not be possible to restore your system to its exact state prior to upgrading. It is strongly recommended that you contact Customer Support before rolling back an upgrade.In addition, you will require a configuration backup of your 5.1.x installation, as well as the 5.1.x and 6.0.x distribution packages to perform the described rollback procedure.
Do the following:
Login to the Reporter system as root
. Within the /root
directory, unzip the previous 5.1.x distribution package, and go to the directory containing the application files. Issue the following commands:
mkdir /root/rollback51
cd /root/rollback51
unzip Vxxx.zip
Important:
If your RUEI installation makes use of accelerator packages (such as Oracle E-Business Suite or Siebel), repeat the unzipping for all previously installed accelerator packages.Stop all RUEI processing by issuing the following commands:
cd /root/RUEI/extra chmod +x ./ruei-rollback-6.0-5.x.sh ./ruei-rollback-6.0-5.x.sh stop_ruei
Execute the RPM pre-install phase by issuing the following command:
./ruei-rollback-6.0-5.x.sh rpm_pre_install
Remove the ADF RPM and downgrade existing Reporter RPMs by issuing the following commands:
rpm -e ux-adf cd /root/RUEI/60 ./ruei-install.sh /root/roolback51/RUEI/51/*.rpm
Execute the RPM post-install phase by issuing the following commands:
cd/ root/RUEI/extra ./ruei-rollback-6.0-5.x.sh rpm_post_install
Re-start the Apache Web server by issuing the following command:
service httpd restart
At this point, you should rollback all remote Collector systems (using the procedure described below). Proceed to step 7 after you have rolled back all remote Collector systems. If your installation does not make use of remote Collector systems, you should proceed directly to step 7.
Restart RUEI processing by issuing the following commands:
cd /root/RUEI/extra chmod +x ./ruei-rollback-6.0-5.x.sh ./ruei-rollback-6.0-5.x.sh start_ruei
Be aware that this phase can take a considerable amount of time.
Restore the RUEI configuration backup you created prior to upgrading by selecting Configuration, then System, then Maintenance, then Backup and restore, and then select Restore system from file.
Troubleshooting Rollback Problems
The rollback script ruei-rollback-6.0-5.x.sh
logs its actions in the file /tmp/ruei-rollback-6.0-5.x.log
. If you encountered any problems during the rollback, please attach this file to any request to Customer Support.
This section describes the procedure to rollback remote Collector systems to version 5.1.x after upgrading to version 6.0.x.
Do the following:
Login to the remote Collector system as root
. Within the /root
directory, unzip the previous 5.1.x distribution package, and go to the directory containing the application files. Issue the following commands:
mkdir /root/rollback51
cd /root/rollback51
unzip Vxxx.zip
Restore the Collector replay store by issuing the following commands:
cd /root/RUEI/extra ./ruei-rollback-6.0-5.x.sh convert_replay_store
Restore the previous Collector RPMs by issuing the following commands:
cd /root/RUEI/60 ./ruei-install.sh /root/rollback51/RUEI/51/ux-collector-*.rpm
Repeat the above procedure for each required remote Collector system. When ready, return to the Reporter rollback procedure.
This section describes the procedure to rollback to version 5.0.x after upgrading to version 6.0.x. Note that the Collector included in the Reporter installation is automatically rolled back during the described procedure. However, remote Collector systems must be individually rolled back. The procedure to do this is described later in this section.
Important:
Be aware that it may not be possible to restore your system to its exact state prior to upgrading. It is strongly recommended that you contact Customer Support before rolling back an upgrade.In addition, you will require a configuration backup of your 5.0.x installation, as well as the 5.0.x and 6.0.x distribution packages to perform the described rollback procedure.
Do the following:
Login to the Reporter system as root
. Within the /root
directory, unzip the previous 5.0.x distribution package, and go to the directory containing the application files. Issue the following commands:
mkdir /root/rollback50
cd /root/rollback50
unzip Vxxx.zip
Important:
If your RUEI installation makes use of accelerator packages (such as Oracle E-Business Suite or Siebel), repeat the unzipping for all previously installed accelerator packages.Stop all RUEI processing by issuing the following commands:
cd /root/RUEI/extra/ chmod +x ./ruei-rollback-6.0-5.x.sh ./ruei-rollback-6.0-5.x.sh stop_ruei
Execute the RPM pre-install phase by issuing the following command:
/ruei-rollback-6.0-5.x.sh rpm_pre_install
Restore the previous RPMs by issuing the following commands:
rpm -e ux-wlp rpm -e ux-adf cd /root/rollback50/RUEI/50 rpm -Uhv --oldpackage ux-*
Execute the RPM post-install phase by issuing the following command:
cd /root/RUEI/extra/ ./ruei-rollback-6.0-5.x.sh rpm_post_install
At this point, you should rollback all remote Collector systems (using the procedure described in Section 5.4.1, "Rolling Back Remote Collector Systems"). Proceed to step 7 after you have rolled back all remote Collector systems. If your installation does not make use of remote Collector systems, you should proceed directly to step 7.
Re-start the Apache Web server by issuing the following command:
service httpd restart
Restart RUEI processing by issuing the following command:
./ruei-rollback-6.0-5.x.sh start_ruei
Restore the backup of the /etc/ruei.conf
file (as the root
user) you created at the start of the upgrade procedure by issuing the following commands:
mv /etc/ruei.conf /etc/ruei.conf.60.backup cp /etc/ruei.conf.50 /etc/ruei.conf
Restore the RUEI configuration backup you created prior to upgrading by selecting Configuration, then System, then Maintenance, then Backup and restore, and then select Restore system from file.
This section describes the procedure to rollback remote Collector systems to version 5.0.x after upgrading to version 6.0.x.
Do the following:
Login to the remote Collector system as root
. Within the /root
directory, unzip the previous 5.0.x distribution package, and go to the directory containing the application files. Issue the following commands:
mkdir /root/rollback50
cd /root/rollback50
unzip Vxxx.zip
Restore the Collector replay store by issuing the following commands:
cd /root/RUEI/extra ./ruei-rollback-6.0-5.x.sh stop_collector ./ruei-rollback-6.0-5.x.sh convert_replay_store
Restore the previous Collector RPMs by issuing the following commands:
cd /root/RUEI/60 ./ruei-install.sh /root/rollback50/RUEI/50/ux-collector-*.rpm
Repeat the above procedure for each required remote Collector system. When ready, return to the Reporter rollback procedure.