7 Reconfiguring Application Server Instances

7.2.1.1 Things to Know Before You Start

During installation, port numbers were reserved for OracleAS Web Cache services. You can find the port numbers in the following file:

• On UNIX systems:

  ORACLE_HOME/install/portlist.ini
  
  

• On Windows systems:

  ORACLE_HOME\install\portlist.ini
  
  

The port numbers are listed as:

Web Cache HTTP Listen port = port_number
Web Cache HTTP Listen (SSL) port = port_number
Web Cache Administration port = port_number
Web Cache Invalidation port = port_number
Web Cache Statistics port = port_number

These port numbers will be used when you configure OracleAS Web Cache. If you want to use different port numbers, you can change them after you configure OracleAS Web Cache.

7.2.1.2 Configuring OracleAS Web Cache

To configure OracleAS Web Cache, take the following steps:

1. Using the Application Server Control Console, navigate to the Application Server home page for the instance in which you want to configure OracleAS Web Cache.

2. On the Application Server home page, in the System Components section, click Configure Component.

3. On the Select Component page, select Web Cache from the menu. Click Continue.

4. On the Login page, in the Administration Password field, enter the ias_admin password. Click Finish.

7.2.1.3 Post-Configuration Tasks

When the configuration is finished, take the following steps:

1. In the Application Server Control Console, click OK. The Application Server home page appears.

2. Verify that Web Cache is listed in the System Components section. It will have a status of Down. Select the check box next to Web Cache and click Start.

3. Verify that Web Cache shows a status of Up. Then, click the Web Cache instance and verify that the Web Cache home page is displayed.

4. On the Web Cache home page, click Administration to set up OracleAS Web Cache.

   
   

   See Also: Oracle Application Server Web Cache Administrator's Guide for basic setup and configuration tasks

   
   

7.2.2.1 Configuring OracleAS Portal

To configure OracleAS Portal, take the following steps:

1. Using the Application Server Control Console, navigate to the Application Server home page for the instance in which you want to configure OracleAS Portal.

2. On the Application Server home page, in the System Components section, click Configure Component.

3. On the Select Component page, select Portal from the menu. Click Continue.

4. On the Login page, in the Administration Password field, enter the ias_admin password. Click Finish.

7.2.2.2 Post-Configuration Tasks

When the configuration is finished, take the following steps:

1. When the configuration is finished, click OK. The Application Server home page appears.

2. Verify that OC4J_Portal and Portal:portal are listed in the System Components section. Select the check box next to OC4J_Portal and click Start.

3. Verify that OC4J_Portal and Portal:portal have a status of Up. Click the OC4J_Portal instance and verify that the OC4J_Portal page is displayed. Click the Portal:portal instance and verify that the Portal page is displayed.

   Note: The Portal:portal status may be displayed as Down. This is normal. The status should be updated approximately five minutes after configuration.

4. Restart Oracle HTTP Server, using the opmnctl command:

   opmnctl stopproc ias-component=HTTP_Server
   opmnctl startproc ias-component=HTTP_Server
   
   

5. If you perform this step, OracleAS Portal will write configuration entries into OracleAS Metadata Repository. This presents no problem if this is the first instance of OracleAS Portal to use this OracleAS Metadata Repository. However, if you already have OracleAS Portal instances using OracleAS Metadata Repository, you should not perform this step, because you will overwrite the existing OracleAS Portal configuration entries in OracleAS Metadata Repository.

   If this is the first instance of OracleAS Portal to use this OracleAS Metadata Repository, run the following command in the middle-tier Oracle home to write OracleAS Portal configuration entries into OracleAS Metadata Repository (make sure the ORACLE_HOME environment variable is set before you run this command):

   • On UNIX systems:

     ORACLE_HOME/portal/conf/ptlconfig -dad portal [-pw PORTAL_schema_password]
     
     

   • On Windows systems:

     ORACLE_HOME\portal\conf\ptlconfig -dad portal [-pw PORTAL_schema_password]
     
     

6. Verify that you can access OracleAS Portal at the following URL:

   http://hostname.domain:port/pls/portal
   
   

   In the URL, hostname.domain is the OracleAS Portal host and port is the OracleAS Web Cache HTTP port number for the instance (default 7777).

   You can log in to OracleAS Portal as the user portal. If this is the first instance of OracleAS Portal to use this OracleAS Metadata Repository, then the password is portal10g. Otherwise, the password is the original ias_admin password of the first OracleAS Portal instance associated with this OracleAS Metadata Repository.

   
   

   See Also: Oracle Application Server Portal Configuration Guide for more information on configuring OracleAS Portal

   
   

7.2.3.1 Configuring OracleAS Wireless

To configure OracleAS Wireless, take the following steps:

1. Using the Application Server Control Console, navigate to the Application Server home page for the instance in which you want to configure OracleAS Wireless.

2. On the Application Server home page, in the System Components section, click Configure Component.

3. On the Select Component page, select Wireless. Click Continue.

4. On the Login page:

   • User Name: Enter cn=orcladmin, or the distinguished name of a user in the iASAdmins group.

   • Password: Enter the password for the user.

   • The SSL Only check box indicates if OracleAS Wireless is enabled to access Oracle Internet Directory in SSL-mode only. It is grayed out because you cannot change this feature in this operation.

5. Click Finish.

7.2.3.2 Post-Configuration Tasks

When the configuration is finished, take the following steps:

1. When the configuration is finished, click OK. The Application Server home page appears.

2. Verify that OC4J_Wireless and Wireless are listed in the System Components section. OC4J_Wireless and Wireless will have a status of Down. Select the check boxes next to OC4J_Wireless and Wireless, and click Start.

3. Select the check boxes next to HTTP_Server and Web Cache, and click Restart.

4. Verify that OC4J_Wireless and Wireless have a status of Up. Click the OC4J_Wireless instance and verify that the OC4J_Wireless page is displayed. Click the Wireless instance and verify that the Wireless page is displayed.

5. Verify that you can access OracleAS Wireless at the following URL:

   http://hostname.domain:port/webtool/login.uix
   
   

   In the URL, hostname.domain is the OracleAS Wireless host and port is the OracleAS Web Cache HTTP port number for the instance (default 7777).

   You can log in as the user orcladmin with the orcladmin password.

   
   

   See Also: Oracle Application Server Wireless Administrator's Guide for more information on configuring OracleAS Wireless

   
   

7.2.4.1 Configuring OracleAS Single Sign-On

To configure OracleAS Single Sign-On, take the following steps:

1. Using the Application Server Control Console, navigate to the Application Server home page for the Infrastructure instance in which you want to configure OracleAS Single Sign-On.

2. On the Application Server home page, in the System Components section, click Configure Component.

3. On the Select Component page, select Single Sign-On Server. Click Continue.

4. On the Login page:

   • User Name: Enter cn=orcladmin, or the distinguished name of a user in the iASAdmins group.

   • Password: Enter the password for the user.

   • The SSL Only check box indicates if OracleAS Single Sign-On is enabled to access Oracle Internet Directory in SSL-mode only. It is grayed out because you cannot change this feature in this operation.

5. Click Finish.

7.2.4.2 Post-Configuration Tasks

When the configuration is finished, take the following steps:

1. When the configuration is finished, click OK. The Application Server home page appears.

2. If you did not have an OC4J_SECURITY instance before, you will have one now. The OC4J_SECURITY instance will have a status of Down. You will also have a Single Sign-On:orasso instance with a status of Down. Select the check box next to OC4J_SECURITY and click Start.

   Note: You cannot start the Single Sign-On:orasso instance. This feature is started and stopped when you start and stop HTTP_Server and OC4J_SECURITY.

3. Verify that OC4J_SECURITY has a status of Up.

   Note: The Single Sign-On:orasso status may be displayed as Down. This is normal. The status should be updated approximately five minutes after configuration.

4. Select HTTP_Server and click Restart.

5. Verify that you can access OracleAS Single Sign-On at the following URL:

   http://hostname.domain:port/pls/orasso
   
   

   In the URL, hostname.domain is the host OracleAS Single Sign-On is installed on and port is the Infrastructure HTTP Server port (default 7777).

   You can log in as orcladmin with the orcladmin password.

   
   

   See Also: Oracle Application Server Single Sign-On Administrator's Guide for more information on configuring OracleAS Single Sign-On

   
   

7.2.5.1 Things to Know Before You Start

When you configure Oracle Delegated Administration Services after installation using the Application Server Control Console, the following happens:

• The URL for Oracle Delegated Administration Services is set up.

• The appropriate privileges are created.

• Oracle Delegated Administration Services are deployed in the OC4J_SECURITY instance.

7.2.5.2 Configuring mod_osso for Oracle Delegated Administration Services

Before you configure Oracle Delegated Administration Services, you must make sure mod_osso is configured, as follows:

1. Check if mod_osso is configured in the Oracle home where you want to configure Oracle Delegated Administration Services. Examine the following file:

   • On UNIX systems:

     ORACLE_HOME/Apache/Apache/conf/httpd.conf
     
     

     Look for the following line in the file:

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

   • On Windows systems:

     ORACLE_HOME\Apache\Apache\conf\httpd.conf
     
     

     Look for the following line in the file:

     include "ORACLE_HOME\Apache\Apache\conf\mod_osso.conf"
     
     

   ORACLE_HOME refers to the directory where you want to configure Oracle Delegated Administration Services.

   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 proceed and configure Oracle Delegated Administration Services using Application Server Control, as described in Configuring Delegated Administration Service.

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 UNIX systems, set the LD_LIBRARY_PATH, LD_LIBRARY_PATH_64, LIB_PATH,or SHLIB_PATH environment variables to the proper values, as shown in Table 1-1. The actual environment variables and values that you have to set depend on the type of your UNIX operating system.

   3. On Windows systems, set the PATH environment variable to contain %ORACLE_HOME%\lib.

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

      On UNIX:

      $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
      
      

      On Windows:

      %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 7-3 describes the parameters that require values.

      Table 7-3 Parameters for Configuring mod_osso

      Parameter	DescriptionFoot 1
      -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.

      
      
      ^Footnote 1 Paths are shown in UNIX format; invert the slashes for Windows.
      

3. Restart OC4J and Oracle HTTP Server, using the opmnctl command:

   opmnctl restartproc ias-component=OC4J
   opmnctl restartproc ias-component=HTTP_Server
   

7.2.5.3 Configuring Delegated Administration Service

To configure Oracle Delegated Administration Services, take the following steps:

1. Using the Application Server Control Console, navigate to the Application Server home page for the Infrastructure instance in which you want to configure Oracle Delegated Administration Services.

2. On the Application Server home page, in the System Components section, click Configure Component.

3. On the Select Component page, select Delegated Administration Service. Click Continue.

4. On the Login page:

   • User Name: Enter cn=orcladmin.

   • Password: Enter the password for the user.

   • The SSL Only check box indicates if Oracle Delegated Administration Services is enabled to access Oracle Internet Directory in SSL-mode only. It is grayed out because you cannot change this feature in this operation.

5. Click Finish.

7.2.5.4 Post-Configuration Tasks

When the configuration is finished, take the following steps:

1. When the configuration is finished, click OK. The Application Server home page appears.

2. If you did not have an OC4J_SECURITY instance before, you will have one now. The OC4J_SECURITY instance will have a status of Down. Select the check box next to OC4J_SECURITY and click Start.

3. Stop and restart all components, using the opmnctl command:

   opmnctl stopall
   opmnctl startall
   
   

4. Verify that Oracle Delegated Administration Services is started by navigating to the following URL:

   http://hostname.domain:port/oiddas
   
   

   In the URL, hostname.domain is the host on which Oracle Delegated Administration Services is installed and port is the Infrastructure HTTP Server port (default 7777).

   
   

   See Also: Oracle Internet Directory Administrator's Guide for more information on configuring Oracle Delegated Administration Services