This chapter describes the procedure for upgrading an existing RUEI 13.x.x.x installation to release 13.2.2.1. The post-installation configuration procedure is described in Chapter 6, "Configuring RUEI". Before upgrading RUEI, check that your system conforms to the prerequisites outlined in Section 2.1, "Prerequisites."
As of Release 13.1.2.1, RUEI does not allow user accounts (as distinct from system accounts) to have the Enterprise Manager access role. When upgrading from a release prior to 13.1.2.1, non-system accounts that have this privilege will have that privilege revoked and a message will be displayed. You need to create new system accounts with the Enterprise Manager access permission as described in the Managing Users and Permissions chapter of the RUEI User's Guide. The revocation of the privilege happens during "rpm_post_install" phase, for example:
2015-01-13 23:28:29 check_em_access_permissions ... [User Permissions] EM access has been revoked, for the following user account(s): [User Permissions] - em_user [User Permissions] To restore, the user(s) must first be converted to a system account. This can be accomplished via the edit user wizard in the UI. 2015-01-13 23:28:30 check_em_access_permissions done ...
RUEI installation is supported for both RedHat Enterprise/Oracle Linux 5.x and RedHat Enterprise/Oracle Linux 6.x, however for maximum reliability and security, upgrade the system to the latest patch version before upgrading to RUEI 13.2.2.1.
This section describes the procedure for upgrading from an existing RUEI 13.x.x.x installation to release 13.2.2.1.
Important:
Before proceeding with the upgrade, make a backup of your configuration, the main database, and the databases on each processor separately. To perform a configuration backup, select System, then select Maintenance, and then click Backup and restore. The configuration backup is required in case of a rollback.For instructions on how to back up your database, refer to the Oracle Enterprise Manager Cloud Control Administrator's Guide.
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. Use the following commands:
cd /root
unzip Vxxxx.zip
Issue the following commands:
cd /usr/java tar xzf /root/RUEI/Java/jre-8u121-linux-x64.tar.gz
This installs the necessary Java software in the directory ln -s /usr/java/jre1.8.0_121 /usr/java/jre. To make the install directory version independent, change the /usr/java/jre symlink to point to the new Java software version:
rm /usr/java/jre ln -s /usr/java/jre1.8.0_121 /usr/java/jre
To upgrade the reporter RUEI system on RedHat Enterprise/Oracle Linux 6.x, you should install the php-process module.
Note:
This step should be executed when upgrading from a version prior to 13.2.2.1.When using rpm manually (For example, installation media of the operating system), issue the following command:
rpm -Uhv php-process-5.3.3*.x86_64.rpm
When using a yum repository, issuing the following command:
yum install php-process
Stop all processing on the Reporter and Collector system(s) using the following commands:
cd /root/RUEI/extra chmod +x ruei-upgrade-13.2.2.1.sh ./ruei-upgrade-13.2.2.1.sh stop_ruei
Perform the necessary pre-upgrade actions by executing the following commands:
cd /root/RUEI/extra ./ruei-upgrade-13.2.2.1.sh rpm_pre_install
For each required Collector system, perform the steps indicated in Section 3.3.2, "Upgrading the Remote Collector System(s) from RUEI 13.x.x.x".
For each required Processing Engine system, perform the steps described in Section 3.3.3, "Upgrading the Processing Engine System(s) from RUEI 13.x.x.x".
Install the new versions of the RPMs using the following commands:
cd /root/RUEI/132 chmod +x ruei-install.sh ./ruei-install.sh reporter
Existing installations (upgrades) need to copy the fonts after the RPMs have been installed using the following commands:
. /etc/ruei.conf cp $RUEI_HOME/bi-publisher/fonts/* /usr/java/jre/lib/fonts/
Perform the necessary post-upgrade actions by executing the following commands:
cd /root/RUEI/extra ./ruei-upgrade-13.2.2.1.sh rpm_post_install
Restart processing using the following commands:
cd /root/RUEI/extra ./ruei-upgrade-13.2.2.1.sh reinitialize ./ruei-upgrade-13.2.2.1.sh start_ruei
For each required remote 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
Issue the following commands:
cd /usr/java tar xzf /root/RUEI/Java/jre-8u121-linux-x64.tar.gz
This installs the necessary Java software in the directory /usr/java/jre1.8.0_121. To make the install directory version independent, change the /usr/java/jre symlink to point to the new Java software version:
rm /usr/java/jre ln -s /usr/java/jre1.8.0_121 /usr/java/jre
Upgrade the Collector RPMs using the following commands:
cd /root/RUEI/132 chmod +x ruei-install.sh ./ruei-install.sh collector
After completing the above procedure for each required Collector system, you should continue with the upgrade of the Reporter system (as described in Section 3.3.1, "Upgrading the Reporter System from RUEI 13.x.x.x").
The upgrade procedure described in this section should be performed for each Processing Engine system. Note that Processing Engine systems should be upgraded sequentially. That is, do not start upgrading the next system until upgrade of the previous system is complete. Do the following:
Login to the Processing Engine as root. Within the /root directory, unzip the RUEI zip file, and go to the directory containing the application files. Use the following commands:
cd /root
unzip Vxxxx.zip
Issue the following commands:
cd /usr/java tar xzf /root/RUEI/Java/jre-8u121-linux-x64.tar.gz
This installs the necessary Java software in the directory /usr/java/jre1.8.0_121. To make the install directory version independent, change the /usr/java/jre symlink to point to the new Java software version:
rm /usr/java/jre ln -s /usr/java/jre1.8.0_121 /usr/java/jre
Perform the necessary pre-upgrade actions by executing the following commands:
cd /root/RUEI/extra ./ruei-upgrade-13.2.2.1.sh rpm_pre_install
Install the new versions of the RPMs using the following commands:
cd /root/RUEI/132 chmod +x ruei-install.sh ./ruei-install.sh processor
After completing the above procedure for each required Processing Engine, you should continue with the upgrade of Reporter system (as described in Section 3.3.1, "Upgrading the Reporter System from RUEI 13.x.x.x").
For All Sessions data, to make pre-upgrade data available again in the data browser, issue the following command:
Note:
These post-upgrade steps should only be executed when upgrading from versions prior to 13.2.1.1../ruei-upgrade-13.2.2.1.sh migrate_visit_data
After migrating the pre-upgrade data successfully, issue the following command to delete the old data:
./ruei-upgrade-13.2.2.1.sh drop_visit_cube
For Sessions Diagnostic data, to make pre-upgrade data available again in the data browser, issue the following command:
./ruei-upgrade-13.2.2.1.sh migrate_session_data
After migrating the pre-upgrade data successfully, issue the following command to delete the old data:
./ruei-upgrade-13.2.2.1.sh drop_session_cube