12 Post-Installation Tasks

12.8.1 Configuring mod_osso (Required for Oracle Delegated Administration Services)

If you did not configure Oracle Delegated Administration Services during installation, you can do it after installation using Oracle Enterprise Manager Application Server Control.

Before you can do so, ensure that OracleAS Single Sign-On is configured against Oracle Internet Directory. This is done for you if you have installed and configured these two components from the installer.

Also, check whether or not mod_osso is configured. mod_osso is an Oracle HTTP Server module that communicates with the Single Sign-On server. If mod_osso is not configured, you have to configure it before you can configure Oracle Delegated Administration Services. Here are the steps:

1. Check if mod_osso is configured in the ORACLE_HOME where you want to configure Oracle Delegated Administration Services.

   Examine the following line in the ORACLE_HOME/Apache/Apache/conf/httpd.conf file. ORACLE_HOME refers to the directory where you want to configure Oracle Delegated Administration Services.

   include "ORACLE_HOME/Apache/Apache/conf/mod_osso.conf"
   
   

   If the line starts with #, then it is commented out and mod_osso is not configured in this installation. Perform step 2 to configure mod_osso.

   If the line is not commented out, mod_osso is already configured. You can go ahead and configure Oracle Delegated Administration Services using Application Server Control. Go to step 4.

2. To configure mod_osso manually, perform these steps:

   1. Set the ORACLE_HOME environment variable to the full path of the directory where you want to configure Oracle Delegated Administration Services.

   2. On Linux, set the LD_LIBRARY_PATH environment variable to contain $ORACLE_HOME/lib and $ORACLE_HOME/network/lib. On HP-UX, set the SHLIB_PATH environment variable to contain $ORACLE_HOME/lib32 and $ORACLE_HOME/network/lib32.

   3. Run the following command (all on one line). Note: for the -classpath parameter, do not type any space characters after the colon (:) characters, as indicated by <no spaces>:

      prompt> $ORACLE_HOME/jdk/bin/java
       -classpath .:$ORACLE_HOME/sso/lib/ossoreg.jar:<no spaces>
       $ORACLE_HOME/jlib/ojmisc.jar:<no spaces>
       $ORACLE_HOME/jlib/repository.jar:<no spaces>
       $ORACLE_HOME/j2ee/home/jazn.jar:$ORACLE_HOME/jdk/lib/dt.jar:<no spaces>
       $ORACLE_HOME/jdk/lib/tools.jar:$ORACLE_HOME/jlib/infratool.jar
       oracle.ias.configtool.UseInfrastructure i
       -f $ORACLE_HOME/config/infratool_mod_osso.properties
       -h OIDhost -p OIDport -u OIDadminName -w OIDclearTextPassword
       -o ORACLE_HOME -m ASinstanceName
       -infra infraGlobalDBName -mh host -sso true
       -sslp sslPort -sslf false
      

      Table 12-1 describes the parameters where you have to supply values:

      Table 12-1 Parameters for Configuring mod_osso

      Parameter	Description
      -h OIDhost	Specifies the name of the computer where Oracle Internet Directory is running. You can determine this value from the OIDhost parameter in the ORACLE_HOME/config/ias.properties file.
      -p OIDport	Specifies the port number on which Oracle Internet Directory is listening. You can determine this value from the OIDport parameter in the ORACLE_HOME/config/ias.properties file.
      -u OIDadminName	Specifies the login name for Oracle Internet Directory. Use the superuser: cn=orcladmin.
      -w OIDclearTextPassword	Specifies the password for the Oracle Internet Directory user.
      -o ORACLE_HOME	Specifies the full path to the directory where you installed OracleAS Infrastructure 10g.
      -m ASinstanceName	Specifies the name of the OracleAS Infrastructure 10g instance where you want to configure mod_osso. You can determine this value from the IASname parameter in the ORACLE_HOME/config/ias.properties file.
      -infra infraGlobalDBname	Specifies the name of the OracleAS Metadata Repository database. You can determine this value from the InfrastructureDBCommonName parameter in the ORACLE_HOME/config/ias.properties file.
      -mh host	Specifies the full hostname (including the domain name) of the computer where you want to configure Oracle Delegated Administration Services.
      -sslp sslPort	Specifies the SSL port for Oracle Internet Directory. You can determine this value from the OIDsslport parameter in the ORACLE_HOME/config/ias.properties file.

      
      

3. Restart OC4J and Oracle HTTP Server. You can do this using the opmnctl command.

   prompt> $ORACLE_HOME/opmn/bin/opmnctl restartproc ias-component=OC4J
   prompt> $ORACLE_HOME/opmn/bin/opmnctl restartproc ias-component=HTTP_Server
   
   

4. Once mod_osso is configured, you can configure Oracle Delegated Administration Services using the Application Server Control. See the Oracle Internet Directory Administrator's Guide for details.