Skip Headers
Oracle® Real User Experience Insight Installation Guide
Release 6.0.1 for Linux x86-64

Part Number E16360-02
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

7 Installing and Configuring the Oracle HTTP Server

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.

7.1 Turning off the Default Web Server

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 Enterprise Linux Apache Web server because this would also un-install the PHP module.

7.2 Reporter System Without Local Database

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 Section 7.3, "Reporter System With Local Database" should be followed.

7.2.1 Creating the Oracle User

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

7.2.2 Setting up the Oracle HTTP Server Environment

This section is only relevant for RUEI installations configured to a remote database. In this case, the following lines need to be added to the /etc/security/limits. conf file:

oracle soft nofile 16384
oracle hard nofile 65536

7.2.3 Creating the Installation Directory

Issue the following commands:

mkdir -p /u01/app/oracle
chown -R oracle:oinstall /u01/app/oracle

7.3 Reporter System With Local Database

The procedure described in this section should only be followed if you are installing and configuring the oracle HTTP server for a Reporter that with a local database. Otherwise, the procedure described in Section 7.2, "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

7.4 Installing Oracle HTTP Server

Do the following:

  1. Login to the Reporter server as the oracle user, and unzip the Oracle HTTP Server zip file. Ensure that you have you display environment setup correctly (reference or copy a piece about setting up the X server in other part of the install manual). The installation of Oracle HTTP server needs to be performed as the oracle user (only some parts in this chapter require root privileges).

    unzip ofm_webtier_11.1.1.1.0_64_disk1_10f1.zip
    cd webtier/Disk1
    export ORACLE_BASE=/u01/app/oracle
    ./runInstaller
    
  2. 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 7-1.

    Figure 7-1 Configure Components Dialog

    Description of Figure 7-1 follows
    Description of "Figure 7-1 Configure Components Dialog"

  3. 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
    
  4. Stop the Oracle HTTP server and Oracle Process Manager Notification (OPMN) using the following command:

    $ORACLE_INSTANCE/bin/opmnctl stopall
    
  5. 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 https://bug.oraclecorp.com/pls/bug/webbug_print.show?c_rptno=8327898.

  6. 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>
    
  7. 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
    
  8. Add apache to the oinstall group using the following command:

    usermod -aG oinstall apache
    
  9. 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
    
  10. 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
    
  11. 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
    
  12. Start Oracle Process Manager Notification (OPMN) and the Oracle HTTP server using the following command:

    oracle$ $ORACLE_INSTANCE/bin/opmnctl startall
    
  13. Stop the HTTP server using the following command:

    $ORACLE_INSTANCE/bin/opmnctl stopproc ias-component=ohs1
    
  14. 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>
    
  15. Start the Oracle HTTP server using the following command:

    $ORACLE_INSTANCE/bin/opmnctl startproc ias-component=ohs1
    
  16. Stop the Oracle HTTP server using the following command:

    oracle$ $ORACLE_INSTANCE/bin/opmnctl stopproc ias-component=ohs1
    
  17. 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>
    
  18. Copy the osso.conf file that you received after registering RUEI with the Oracle SSO server to the $ORACLE_INSTANCE/config/OHS/ohs1 directory.

  19. Start the Oracle HTTP server using the following command:

    $ORACLE_INSTANCE/bin/opmnctl startproc ias-component=ohs1
    

7.5 Verifying the Oracle HTTP Server Configuration

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 User's Guide.