Skip Headers
Oracle® Application Server Enterprise Deployment Guide
10g (10.1.4.0.1)

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

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

2 Installing and Configuring the Security Infrastructure

Installing the Oracle Application Server Metadata Repository for the Security Infrastructure

Installing the Oracle Internet Directory Instances in the Data Tier

Configuring the Virtual Server to Use the Load Balancing Router

Testing the Data Tier Components

2.1 Installing the Oracle Application Server Metadata Repository for the Security Infrastructure

You must install the 10g (10.1.4.0.1) OracleAS Metadata Repository before you install components into the Security DMZ. Oracle Application Server provides a tool, the Oracle Application Server Repository Creation Assistant, to create the OracleAS Metadata Repository in an existing database.

The 10g (10.1.4.0.1) OracleAS RepCA is available on the OracleAS RepCA CD-ROM or the Oracle Application Server DVD-ROM. You install the OracleAS RepCA in its own, separate Oracle home.

To install the OracleAS Metadata Repository, you must perform these steps:

  1. Install the OracleAS RepCA, following the steps in Section 2.1.1.

  2. Ensure that the database meets the requirements specified in the "Database Requirements" section of the Oracle Application Server Metadata Repository Creation Assistant User's Guide. You can find this guide in the Oracle Application Server platform documentation library for the platform and version you are using. In addition, ensure that:

    • The database computer has at least 512 MB of swap space available for execution of the OracleAS RepCA

    • There are no dependencies of any kind related to the ultrasearch directory in the database's Oracle home. The OracleAS RepCA replaces this directory with a new version, renaming the existing version of the directory to ultrasearch_timestamp.

  3. Execute the OracleAS RepCA, following the steps in Section 2.1.2 or Section 2.1.3.

  4. Perform the post-installation step described in Section 2.1.4.

2.1.1 Installing the OracleAS RepCA

Follow these steps to install the OracleAS RepCA into its own Oracle home:

  1. Insert the OracleAS RepCA CD-ROM or the Oracle Application Server DVD-ROM.

    Note:

    If your computer does not mount CD-ROMs or DVD-ROMs automatically, you must set the mount point manually.
  2. Start the installer, using the method corresponding to the installation media:

    (CD-ROM)

    On UNIX, issue this command: runInstaller

    On Windows, double-click setup.exe

    (DVD-ROM) Navigate to the repca_utilities directory and do one of the following:

    On UNIX, issue this command: runInstaller

    On Windows, double-click setup.exe

    The Welcome screen appears.

  3. Click Next.

    The Specify File Locations screen appears.

  4. In the Name field, specify a name for the OracleAS RepCA Oracle home. The Oracle home name must contain only alphanumeric characters and the underscore character, and be 128 characters or fewer.

    In the Destination field, enter the full path to a new Oracle home in which to install the OracleAS RepCA, and click Next.

  5. The Launch Repository Creation Assistant screen appears.

  6. Select No and click Next.

    The Summary screen appears.

  7. Click Install.

    The Configuration Assistants screen appears, executing the OracleAS RepCA, and indicating "In Progress".

  8. When the OracleAS RepCA is no longer running, exit the OracleAS RepCA.

    The End of Installation screen appears.

  9. Click Exit, and then confirm your choice to exit.

2.1.2 Installing the Metadata Repository in a Database Using Raw Devices

Follow these steps to install the Metadata Repository into an existing two-node Real Application Clusters (RAC) database using raw devices:

  1. Create raw devices for the OracleAS Metadata Repository.

    Tip:

    The command to create tablespaces is specific to the volume manager used. For example, the command to create a tablespace in VERITAS Volume Manager is vxassist.
  2. Create a file to map the tablespaces to the raw devices. Each line in the file has the format:

    tablespace name=raw device file path
    
    

    Note:

    Creating the sample file is not mandatory; you can enter the tablespace values into the Specify Tablespace Information screen during execution of the OracleAS RepCA.
  3. Populate the DBCA_RAW_CONFIG environment variable with the full path and filename of the tablespace mapping file.

  4. Ensure that the database and listener are running.

  5. Ensure that the NLS_LANG environment variable is not set to a non-English locale, or is set to american_america.us7ascii, with one of the following commands:

    UNIX:

    • unsetenv NLS_LANG

    • setenv NLS_LANG american_america.us7ascii

    Windows:

    • set NLS_LANG=

    • set NLS_LANG=american_america.us7ascii

      Note:

      If you need to, you can set NLS_LANG to its original value after executing the OracleAS RepCA.
  6. Start the OracleAS RepCA from the OracleAS RepCA Oracle home with this command:

    runRepca

    The Welcome screen appears.

  7. Click Next.

    The Specify Oracle Home screen appears.

  8. In the Oracle Home field, specify the full path of the database Oracle home.

    In the Log File Directory field, specify the full path of the directory on the current computer in which you want the OracleAS RepCA to write its log files. Ensure correct input for the Log File Directory on this screen, as you will not be able to change it after you have proceeded beyond this screen.

  9. Click Next.

    The Select Operation screen appears.

  10. Select Load and click Next.

    The Specify Database Connection screen appears.

  11. Enter the SYS user name and password and the host and port information. For example:

    infradbhost1.mycompany.com:1521,infradbhost2.mycompany.com:1521
    
  12. Click Next.

    The Specify Storage Options screen appears.

  13. Select Regular or Cluster File System.

    The Specify Tablespace Information screen appears, displaying the values from the file specified by the DBCA_RAW_CONFIG environment variable.

  14. Correct the values, if necessary, and click Next.

    The Warning: Check Disk Space dialog appears if your SYSTEM and UNDO tablespaces are set to autoextend.

  15. Check the disk space as specified in the dialog and click OK.

    The Loading Repository screen appears. The tablespaces and schemas are created and populated.

    The Success screen appears.

  16. Click OK.

    The OracleAS RepCA exits.

If the installation was unsuccessful, or you need more information, see the Oracle Application Server Metadata Repository Creation Assistant User's Guide.

2.1.3 Installing the Metadata Repository in an Oracle Cluster File System (OCFS)

Follow these steps to install the Metadata Repository into an existing two-node Real Application Clusters (RAC) database using an OCFS file system:

  1. Ensure that the database and listener are running.

  2. Start the OracleAS RepCA from the OracleAS RepCA Oracle home with this command:

    runRepca

    The Welcome screen appears.

  3. Click Next.

    The Specify Oracle Home screen appears.

  4. In the Oracle Home field, specify the full path of the database Oracle home.

    In the Log File Directory field, specify the full path of the directory on the current computer in which you want the OracleAS RepCA to write its log files. Ensure correct input for the Log File Directory on this screen, as you will not be able to change it after you have proceeded beyond this screen.

  5. Click Next.

    The Select Operation screen appears.

  6. Select Load and click Next.

    The Specify Database Connection screen appears.

  7. Enter the SYS user password, select the Real Application Clusters Database option, and enter the host and port information. For example:

    infradbhost1.mycompany.com:1521,infradbhost2.mycompany.com:1521
    
    

    Enter the service name.

  8. Click Next.

    The Specify Storage Options screen appears.

  9. Select Regular or Cluster File System.

    The Specify Tablespace Information screen appears.

  10. Select a directory option (Use Same Directory for All Tablespaces or Use Individual Directories for Each Tablespace) and complete the remaining fields. When specifying a directory, ensure that it is an existing, writable directory with sufficient free space. Click Next.

    The Warning: Check Disk Space dialog appears if your SYSTEM and UNDO tablespaces are set to autoextend.

  11. Check the disk space as specified in the dialog and click OK.

    The Loading Repository screen appears. The tablespaces and schemas are created and populated.

    The Success screen appears.

  12. Click OK.

    The OracleAS RepCA exits.

If the installation was unsuccessful, or you need more information, see the Oracle Application Server Metadata Repository Creation Assistant User's Guide.

2.1.4 Configuring the Time out Value in the sqlnet.ora File

You must configure the SQLNET.EXPIRE_TIME parameter in the sqlnet.ora file on the application infrastructure database.

  1. Open the file ORACLE_HOME/network/admin/sqlnet.ora file (UNIX) or the ORACLE_BASE/ ORACLE_HOME/network/admin/sqlnet.ora file (Windows).

  2. Set the SQLNET.EXPIRE_TIME parameter to a value lower than the TCP session time out value for the Load Balancing Router and firewall.

  3. Restart the listener by issuing these commands in ORACLE_HOME/bin:

    lsnrctl stop

    lsnrctl start

2.2 Installing the Oracle Internet Directory Instances in the Data Tier

Follow these steps to install the Oracle Internet Directory components (OIDHOST1 and OIDHOST2) on the Data Tier with the Metadata Repository. The procedures for the installations are very similar, but the selections in the configuration options screen differ.

Note:

Ensure that the clocks are synchronized between the two computers on which you intend to install the Oracle Internet Directory instances. Errors will occur if this is not done.

2.2.1 Installing the First Oracle Internet Directory

The OracleAS Metadata Repository must be running before you perform this task. Follow these steps to install the 10g (10.1.4.0.1)Oracle Internet Directory on OIDHOST1:

  1. Ensure that the system, patch, kernel and other requirements are met. These are listed in the Oracle Application Server Quick Installation Guide in the Oracle Application Server platform documentation library for the platform and version you are using.

  2. Ensure that ports 389 and 636 are not in use by any service on the computer by issuing these commands for the operating system you are using. (If the port is not in use, no output is returned from the command.)

    On UNIX:

    netstat -an | grep "389"

    netstat -an | grep "636"

    On Windows:

    netstat -an | findstr :389

    netstat -an | findstr :636

    If the port is in use (if the command returns output identifying the port), you must free the port.

    In UNIX:

    Remove the entries for ports 389 and 636 in the /etc/services file and restart the services, or restart the computer.

    In Windows:

    Stop the component that is using the port.

  3. Copy the staticport.ini file from the Disk1/stage/Response directory to the Oracle home directory.

  4. Edit the staticport.ini file to assign the following custom ports:

    Oracle Internet Directory port = 389
    Oracle Internet Directory (SSL) port = 636
    
    
  5. Start the Oracle Universal Installer as follows:

    On UNIX, issue this command: runInstaller

    On Windows, double-click setup.exe

    The Welcome screen appears.

  6. Click Next.

    On UNIX systems, the Specify Inventory Directory and Credentials screen appears.

  7. Specify the directory you want to be the oraInventory directory and the operating system group that has permission to write to it.

  8. Click Next.

    On UNIX systems, a dialog appears, prompting you to run the oraInstRoot.sh script.

  9. Open a window and run the script, following the prompts in the window.

  10. Return to the Oracle Universal Installer screen and click Next.

    The Specify File Locations screen appears with default locations for:

    • The product files for the installation (Source)

    • The name and path to an Oracle home (Destination)

      • Note:

        Ensure that the Oracle home directory path for OIDHOST1 is the same as the path to the Oracle home location of OIDHOST2. For example, if the path to the Oracle home on OIDHOST1 is:

        /u01/app/oracle/product/AS10gOID

        then the path to the Oracle home on OIDHOST2 must be:

        /u01/app/oracle/product/AS10gOID

  11. Specify the Destination Name and Path, if different from the default, and click Next.

    The Select a Product to Install screen appears.

    Figure 2-1 Oracle Universal Installer Select a Product to Install Screen

    Description of Figure 2-1 follows
    Description of "Figure 2-1 Oracle Universal Installer Select a Product to Install Screen"

  12. Select OracleAS Infrastructure 10g, as shown in Figure 2-1, and click Next.

    The Select Installation Type screen appears.

  13. Select Identity Management, as shown in Figure 2-2, and click Next.

    Figure 2-2 Oracle Universal Installer Select Installation Type Screen

    Description of Figure 2-2 follows
    Description of "Figure 2-2 Oracle Universal Installer Select Installation Type Screen"

    The Product-Specific Prerequisite Checks screen appears.

  14. Click Next.

    The Confirm Pre-Installation Requirements screen appears.

  15. Ensure that the requirements are met, check the box for each, and click Next.

    The Select Configuration Options screen appears.

  16. Figure 2-3 Oracle Universal Installer Select Configuration Options Screen

    Description of Figure 2-3 follows
    Description of "Figure 2-3 Oracle Universal Installer Select Configuration Options Screen"

  17. Select Oracle Internet Directory, OracleAS Directory Integration and Provisioning, and High Availability and Replication, as shown in Figure 2-3, and click Next.

    The Specify Port Configuration Options screen appears.

    Figure 2-4 Oracle Universal Installer Specify Port Configuration Options Screen

    Description of Figure 2-4 follows
    Description of "Figure 2-4 Oracle Universal Installer Specify Port Configuration Options Screen"

  18. Select Manual, as shown in Figure 2-4, and click Next.

    The Specify Repository screen appears.

  19. Provide the DBA login and computer information as shown in Figure 2-5 and click Next.

    Figure 2-5 Oracle Universal Installer Specify Repository Screen

    Specify Repository screen
    Description of "Figure 2-5 Oracle Universal Installer Specify Repository Screen"

    The Select High Availability or Replication Option screen appears.

  20. Select OracleAS Cluster (Identity Management), as shown in Figure 2-6, and click Next.

    Figure 2-6 Oracle Universal Installer Select High Availability or Replication Option Screen

    Description of Figure 2-6 follows
    Description of "Figure 2-6 Oracle Universal Installer Select High Availability or Replication Option Screen"

    The Specify Namespace in Internet Directory screen appears.

    Figure 2-7 Oracle Universal Installer Specify Namespace in Internet Directory

    Description of Figure 2-7 follows
    Description of "Figure 2-7 Oracle Universal Installer Specify Namespace in Internet Directory"

  21. Click Next to specify the default Suggested Namespace shown in Figure 2-7, or enter values for the Custom Namespace and click Next.

    The Specify Instance Name and ias_admin Password screen appears.

  22. Specify the instance name and password and click Next.

    The Summary screen appears.

  23. Review the selections to ensure that they are correct (if they are not, click Back to modify selections on previous screens), and click Install.

    The Install screen appears with a progress bar. On UNIX systems, a dialog opens prompting you to run the root.sh script.

  24. Open a window and run the script.

    The Configuration Assistants screen appears. Multiple configuration assistants are launched in succession; this process can be lengthy. When it completes, the End of Installation screen appears.

  25. Click Exit, and then confirm your choice to exit.

2.2.2 Installing the Second Oracle Internet Directory

The OracleAS Metadata Repository and the first Oracle Internet Directory must be running before you perform this task. Follow these steps to install the 10g (10.1.4.0.1) Oracle Internet Directory on OIDHOST2:

  1. Ensure that the system, patch, kernel and other requirements are met. These are listed in the Oracle Application Server Quick Installation Guide in the Oracle Application Server platform documentation library for the platform and version you are using.

  2. Ensure that ports 389 and 636 are not in use by any service on the computer by issuing these commands for the operating system you are using. (If the port is not in use, no output is returned from the command.)

    On UNIX:

    netstat -an | grep "389"

    netstat -an | grep "636"

    On Windows:

    netstat -an | findstr :389

    netstat -an | findstr :636

    If the port is in use (if the command returns output identifying the port), you must free the port.

    In UNIX:

    Remove the entries for ports 389 and 636 in the /etc/services file and restart the services, or restart the computer.

    In Windows:

    Stop the component that is using the port.

  3. Copy the staticport.ini file from the Disk1/stage/Response directory to the Oracle home directory.

  4. Edit the staticport.ini file and uncomment, and update these entries:

    Oracle Internet Directory port = 389
    Oracle Internet Directory (SSL) port = 636
    
    
  5. Start the Oracle Universal Installer as follows:

    On UNIX, issue this command: runInstaller

    On Windows, double-click setup.exe

    The Welcome screen appears.

  6. Click Next.

    On UNIX systems, the Specify Inventory Directory and Credentials screen appears.

  7. Specify the directory you want to be the oraInventory directory and the operating system group that has permission to write to it.

  8. Click Next.

    On UNIX systems, a dialog appears, prompting you to run the oraInstRoot.sh script.

  9. Open a window and run the script, following the prompts in the window.

  10. Return to the Oracle Universal Installer screen and click Next.

    The Specify File Locations screen appears with default locations for:

    • The product files for the installation (Source)

    • The name and path to an Oracle home (Destination)

      Note:

      Ensure that the Oracle home directory path for OIDHOST1 is the same as the path to the Oracle home location of OIDHOST2. For example, if the path to the Oracle home on OIDHOST1 is:

      /u01/app/oracle/product/AS10gOID

      then the path to the Oracle home on OIDHOST2 must be:

      /u01/app/oracle/product/AS10gOID

  11. Specify the Destination Name and Path, if different from the default, and click Next.

    The Select a Product to Install screen appears.

    Figure 2-8 Oracle Universal Installer Select a Product to Install Screen

    Description of Figure 2-8 follows
    Description of "Figure 2-8 Oracle Universal Installer Select a Product to Install Screen"

  12. Select OracleAS Infrastructure 10g, as shown in Figure 2-8, and click Next.

    The Select Installation Type screen appears.

  13. Select Identity Management, as shown in Figure 2-9, and click Next.

    Figure 2-9 Oracle Universal Installer Select Installation Type Screen

    Description of Figure 2-9 follows
    Description of "Figure 2-9 Oracle Universal Installer Select Installation Type Screen"

    The Product-specific Prerequisite Checks screen appears.

  14. Click Next.

    The Confirm Pre-Installation Requirements screen appears.

  15. Ensure that the requirements are met, check the box for each, and click Next.

    The Select Configuration Options screen appears.

  16. Figure 2-10 Oracle Universal Installer Select Configuration Options Screen

    Description of Figure 2-10 follows
    Description of "Figure 2-10 Oracle Universal Installer Select Configuration Options Screen"

  17. Select Oracle Internet Directory, OracleAS Directory Integration and Provisioning, and High Availability and Replication, as shown in Figure 2-10, and click Next.

    The Specify Port Configuration Options screen appears.

    Figure 2-11 Oracle Universal Installer Specify Port Configuration Options Screen

    Description of Figure 2-11 follows
    Description of "Figure 2-11 Oracle Universal Installer Specify Port Configuration Options Screen"

  18. Select Manual, as shown in Figure 2-11, and click Next.

    The Specify Repository screen appears.

  19. Provide the DBA login and computer information as shown in Figure 2-12 and click Next.

    Figure 2-12 Oracle Universal Installer Specify Repository Screen

    Specify Repository screen
    Description of "Figure 2-12 Oracle Universal Installer Specify Repository Screen"

    A dialog opens, prompting you to synchronize the system time of the primary Oracle Internet Directory computer and the system time on the computer on which you are installing.

  20. Synchronize the system time on the computers and click OK.

    The Specify ODS Password screen appears.

  21. Specify the ODS password (by default, the ias_admin password), as shown in Figure 2-13, and click Next.

    Figure 2-13 Oracle Universal Installer Specify ODS Password Screen

    Description of Figure 2-13 follows
    Description of "Figure 2-13 Oracle Universal Installer Specify ODS Password Screen"

    The Specify OID Login screen appears.

  22. Specify the user name and password, as shown in Figure 2-14, and click Next.

    Figure 2-14 Oracle Universal Installer Specify OID Login Screen

    Description of Figure 2-14 follows
    Description of "Figure 2-14 Oracle Universal Installer Specify OID Login Screen"

    The Specify Instance Name and ias_admin Password screen appears.

  23. Specify the instance name and password and click Next.

    The Summary screen appears.

  24. Review the selections to ensure that they are correct (if they are not, click Back to modify selections on previous screens), and click Install.

    The Install screen appears with a progress bar. On UNIX systems, a dialog opens prompting you to run the root.sh script.

  25. Open a window and run the script.

    The Configuration Assistants screen appears. Multiple configuration assistants are launched in succession; this process can be lengthy. When it completes, the End of Installation screen appears.

  26. Click Exit, and then confirm your choice to exit.

2.3 Configuring the Virtual Server to Use the Load Balancing Router

If you plan to use the Enterprise Deployment Architecture for myJ2EEcompany.com with JAZN-SSO/DAS (shown in Figure 2–1), you must configure the Load Balancing Router to perform these functions:

Note:

Some tuning of the Load Balancing Router's monitoring interval and time out values may be required to ensure system availability. If the interval or time out value is too long, the Load Balancing Router will not detect service failures in time; if it is too short, the Load Balancing Router may erroneously detect that a server is down.

For example, suppose the Load Balancing Router maps the virtual IP address oid.mycompany.com to the two Oracle Internet Directory servers for round robin load balancing, and the monitoring scheme attempts an ldapbind at 10-second intervals.

If the Oracle Internet Directory on OIDHOST1 is down, then the Load Balancing Router directs all traffic to the Oracle Internet Directory on OIDHOST2 only.However, there is a10-second interval during which the Load Balancing Router is unaware that the Oracle Internet Directory on OIDHOST1 is down. There is also a 30-second time out period. During this period, the Load Balancing Router continues to direct traffic to both Oracle Internet Directory servers in round robin mode, and ldapbind failures will occur when it attempts connections to the Oracle Internet Directory on OIDHOST1.

2.4 Testing the Data Tier Components

Perform these steps to test the Data Tier components:

  1. Ensure that you can connect to each Oracle Internet Directory instance and the Load Balancing Router, using this command:

    ldapbind -p 389 -h OIDHOST1

    ldapbind -p 389 -h OIDHOST2

    ldapbind -p 389 -h oid.mycompany.com

  2. Start the oidadmin tool on each Oracle Internet Directory instance in ORACLE_HOME/bin with this command:

    oidadmin

The Data Tier configuration is now as shown in Figure 2-15.

Figure 2-15 Data Tier Configuration

Data Tier configuration
Description of "Figure 2-15 Data Tier Configuration"