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 in 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 6.x and RedHat Enterprise/Oracle Linux 7.x. However, upgrade the system to the latest patch version before upgrading to RUEI 13.3.1.0 for maximum reliability and security.
This section describes the procedure for upgrading from an existing RUEI 13.x.x.x installation to release 13.3.1.0.
Note:
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 >Maintenance, and then click Backup and restore. The configuration backup is required in case of a rollback.
For more information on how to back up your database, see 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.
To upgrade the reporter system from RUEI 13.x.x.x, do the following:
Log in to the Reporter as root
. Within the /root
directory, unzip the RUEI zip file, and go to the directory containing the application files. Run the following commands:
cd /root
unzip Vxxxx.zip
Run the following commands:
cd /usr/java tar xzf /root/RUEI/Java/jre-8u181-linux-x64.tar.gz
This installs the necessary Java software in the directory /usr/java/jre1.8.0_181 /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_181 /usr/java/jre
To upgrade the reporter RUEI system on RedHat Enterprise/Oracle Linux 6.x, you should install the php-process
module.
When using rpm manually (For example, installation media of the operating system), run the following command:
rpm -Uhv php-process-5.3.3*.x86_64.rpm
When using a yum repository, run the following command:
yum install php-process
Stop all processing on the Reporter and Collector system(s) running the following commands:
cd /root/RUEI/extra chmod +x ruei-upgrade-13.3.1.0.sh ./ruei-upgrade-13.3.1.0.sh stop_ruei
Perform the necessary pre-upgrade actions by running the following commands:
cd /root/RUEI/extra ./ruei-upgrade-13.3.1.0.sh rpm_pre_install
For each required Collector system, perform the steps indicated in Upgrading the Remote Collector System(s) from RUEI 13.x.x.x.
Note:
This step should be executed when upgrading from a version prior to 13.2.3.1.
As the root user, run the following commands and changes in order to upgrade the Oracle Instantclient
and php-oci8
versions to 12cR1
rpm -e --nodeps php-oci8-11gR2 rpm -e --nodeps oracle-instantclient11.2-sqlplus rpm -e --nodeps oracle-instantclient11.2-basic cd /root/RUEI/IC rpm -Uvh oracle-instantclient12.1-*
In /etc/ruei.conf
, change the value of INSTANTCLIENT_DIR
to /usr/lib/oracle/12.1/client64
cd /root/RUEI/PHP/OL6 rpm -Uhv php-oci8-* service httpd restart
Install the new versions of the RPMs running the following commands:
cd /root/RUEI/133 chmod +x ruei-install.sh ./ruei-install.sh reporter
Existing installations (upgrades) need to copy the fonts after the RPMs have been installed running the following commands:
. /etc/ruei.conf cp $RUEI_HOME/bi-publisher/fonts/* /usr/java/jre/lib/fonts/
Perform the necessary post-upgrade actions by running the following commands:
cd /root/RUEI/extra ./ruei-upgrade-13.3.1.0.sh rpm_post_install
Restart processing running the following commands:
cd /root/RUEI/extra ./ruei-upgrade-13.3.1.0.sh reinitialize ./ruei-upgrade-13.3.1.0.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 running the following commands:
cd /root
unzip Vxxxx.zip
Run the following commands:
cd /usr/java tar xzf /root/RUEI/Java/jre-8u181-linux-x64.tar.gz
This installs the necessary Java software in the directory /usr/java/jre1.8.0_181
. 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_181 /usr/java/jre
Upgrade the Collector RPMs running the following commands:
cd /root/RUEI/133 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. For more information, see Upgrading the Reporter System from RUEI 13.x.x.x.
Starting release 13.2.3.1, you will experience better database performance by disabling use of the PARALLEL hint. You can apply the new defaults to your configuration by running the following commands as the RUEI_USER user:
execsql config_set_value processor db_core_dop 1 execsql config_set_value processor db_core_dop_kpi 1 execsql config_set_value processor db_gui_dop 1 execsql config_set_value processor cubr_fact_hints ''
For All Sessions data, to make pre-upgrade data available again in the data browser, run 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.3.1.0.sh migrate_visit_data
After migrating the pre-upgrade data successfully, run the following command to delete the old data:
./ruei-upgrade-13.3.1.0.sh drop_visit_cube
For Sessions Diagnostic data, to make pre-upgrade data available again in the data browser, run the following command:
./ruei-upgrade-13.3.1.0.sh migrate_session_data
After migrating the pre-upgrade data successfully, run the following command to delete the old data:
./ruei-upgrade-13.3.1.0.sh drop_session_cube