6 Post-Installation Tasks

6.7.1 Configuring mod_osso (Required for Oracle Delegated Administration Services)

Oracle Delegated Administration Services can be configured using Oracle Enterprise Manager Application Server Control.

Oracle Delegated Administration Services requires Oracle Application Server Single Sign-On and mod_osso. 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. Ensure that Oracle Application Server 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.

2. 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 3 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 5.

3. 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. Set the PATH environment variable to contain %ORACLE_HOME%\lib.

   3. Run the following command (all on one line). Note: for the -classpath parameter, do not type any space characters after the semicolon (;) 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;<no spaces>
       %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 6-1 describes the parameters where you have to supply values:

      Table 6-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.
      -m ASinstanceName	Specifies the name of the OracleAS Infrastructure 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.

      
      

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

   C:\> %ORACLE_HOME%\opmn\bin\opmnctl restartproc ias-component=OC4J
   C:\> %ORACLE_HOME%\opmn\bin\opmnctl restartproc ias-component=HTTP_Server
   
   

5. 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.