Oracle® Real User Experience Insight Installation Guide 12c Release 1 for Linux x86-64 Part Number E35688-02 |
|
|
PDF · Mobi · ePub |
This chapter describes the procedure for installing and configuring the Oracle HTTP server. This is an optional part of the RUEI installation process, and is only required if you intend to use the Oracle Single Sign-On (SSO) service to authenticate RUEI users. Note that the Oracle SSO service must be fully installed and configured before it can be used for RUEI user authentication.
The procedure to configure the Reporter system for Oracle SSO user authentication is described in the Oracle Real User Experience Insight User's Guide. Note that RUEI must be fully installed before it can be configured for Oracle SSO user authentication.
The Oracle SSO server uses its own Web server in order to prevent conflicts with the currently installed Web server. Therefore, the currently installed Web server needs to be turned off by issuing the following commands:
/sbin/service httpd stop /sbin/chkconfig --del httpd
Note:
It is recommended that you do not un-install the default Linux Apache Web server because this would also un-install the PHP module.The procedure described in this section should only be followed if you are installing and configuring the oracle HTTP server for a Reporter that does not a local database. Otherwise, the procedure described in Reporter System With Local Database should be followed.
This section is only relevant for RUEI installations configured to use a remote database. In this case, the oracle
user does not yet exist, and so must be created by issuing the following commands:
/usr/sbin/groupadd oinstall oinstall /usr/sbin/useradd -g oinstall oracle
The procedure described in this section should only be followed if you are installing and configuring the oracle HTTP server for a Reporter that is configured with a local database. Otherwise, the procedure described in Reporter System Without Local Database should be followed.
Increase the number of open files limit. Edit the following line in the /etc/security/limits.conf
file:
oracle soft nofile 16384
Do the following:
Login to the Reporter server as the oracle
user, and unzip the Oracle HTTP server zip file. Ensure that your X Window environment is properly set up. In addition, when logging on remotely with SSH, ensure X forwarding is enabled. The installation of Oracle HTTP server needs to be performed as the oracle
user (only certain parts of this chapter require root
privileges). Issue the following commands:
unzip ofm_webtier_11.1.1.1.0_64_disk1_10f1.zip cd webtier/Disk1 export ORACLE_BASE=/u01/app/oracle ./runInstaller
As the installation script runs, you should accept all default values, except for step 5. Here, you must uncheck the two check boxes Oracle Web Cache and Associate selected components with weblogic domain shown in Figure 5-1.
After exiting the installation script, set the following environment variables:
export ORACLE_HOME=$ORACLE_BASE/product/11.1.1/as_1 export ORACLE_INSTANCE=$ORACLE_HOME/instances/instance1
Stop the Oracle HTTP server and Oracle Process Manager Notification (OPMN) using the following command:
$ORACLE_INSTANCE/bin/opmnctl stopall
Edit the $ORACLE_HOME/ohs/bin/apachectl
file to fix the bug 8327898. Change the prefork
as follows:
case ${MPM} in async ) _httpd="httpd.async" ;; prefork ) _httpd="httpd.prefork" ;; * ) _httpd="httpd.worker" ;; esac
Note more information about this bug is available at the following location:
https://support.oracle.com/CSP/ui/flash.html
Edit the $ORACLE_INSTANCE/config/OPMN/opmn/opmn.xml
file to use the httpd.prefork
in order so that the PHP module can be loaded. In addition, set the following variables from the /etc/ruei.conf
configuration file:
<environment> <variable id="TEMP" value="/tmp"/> <variable id="TMP" value="/tmp"/> <variable id="OHSMPM" value="prefork"/> <variable id="TNS_ADMIN" value="/var/opt/ruei"/> <variable id="RUEI_DB_TNSNAME" value="uxinsight"/> <variable id="RUEI_DB_USER" value="uxinsight"/> <variable id="RUEI_HOME" value="/opt/ruei"/> <variable id="RUEI_DATA" value="/var/opt/ruei"/> <variable id="JAVA_HOME" value="/usr/java/jre"> </environment>
Logon as the root
user, and change the permissions for the .apachectl
file so that the Oracle HTTP server can run as the Apache user. Issue the following commands:
chown root $ORACLE_HOME/ohs/bin/.apachectl chmod 6750 $ORACLE_HOME/ohs/bin/.apachectl
Add apache
to the oinstall
group using the following command:
usermod -aG oinstall apache
Logon as the oracle
user and edit the $ORACLE_INSTANCE/config/OHS/ohs1/httpd.conf
file for the Oracle HTTP server to run as the Apache user. Edit the following lines:
User apache Group apache
Create the $ORACLE_INSTANCE/config/OHS/ohs1/moduleconf/php5.conf
file, and edit it to contain the following:
LoadModule php5_module "/usr/lib64/httpd/modules/libphp5.so" AddHandler php5-script php AddType text/html php
Copy the /etc/httpd/conf.d/uxinsight.conf
file, and make it available to the Oracle HTTP server using the following command:
cp /etc/httpd/conf.d/uxinsight.conf $ORACLE_INSTANCE/config/OHS/ohs1/moduleconf
Start Oracle Process Manager Notification (OPMN) and the Oracle HTTP server using the following command:
oracle$ $ORACLE_INSTANCE/bin/opmnctl startall
Stop the HTTP server using the following command:
$ORACLE_INSTANCE/bin/opmnctl stopproc ias-component=ohs1
In order to have RUEI running on the default HTTPS port, edit the $ORACLE_INSTANCE/config/OHS/ohs1/ssl.conf
file, and change the line with the Listen
directive to the following:
Listen 443
In addition, edit the VirtualHost
definition as follows:
<VirtualHost *:443>
Start the Oracle HTTP server using the following command:
$ORACLE_INSTANCE/bin/opmnctl startproc ias-component=ohs1
Stop the Oracle HTTP server using the following command:
oracle$ $ORACLE_INSTANCE/bin/opmnctl stopproc ias-component=ohs1
Create the $ORACLE_INSTANCE/config/OHS/ohs1/moduleconf/mod_osso.conf
file:
LoadModule osso_module "${ORACLE_HOME}/ohs/modules/mod_osso.so" <IfModule osso_module> OssoConfigFile /u01/app/oracle/product/11.1.1/as_1/instances/instance1/config/OHS/ohs1/osso.conf OssoIpCheck off OssoIdleTimeout off </IfModule>
Copy the osso.conf
file that you received after registering RUEI with the Oracle SSO server to the $ORACLE_INSTANCE/config/OHS/ohs1
directory.
Start the Oracle HTTP server using the following command:
$ORACLE_INSTANCE/bin/opmnctl startproc ias-component=ohs1
You can test the Oracle HTTP server for integration with RUEI by directing your browser to https://
Reporter
/ruei
. When you select System, then User management, the Configure SSO connection option should be enabled.
For information about enabling Oracle SSO user authentication within RUEI, see the Oracle Real User Experience Insight User's Guide.