Skip Headers

Oracle9i Application Server Certified Configuration Deployment and Cloning Guide
Release 2.0.6.0.1 for Solaris Operating Environment (SPARC 64-bit)
Part No. B12185-01
  Go To Table Of Contents
Contents
Go To Index
Index

Previous Next  

3 Installing and Configuring Oracle9iAS CC Using the Product CD-ROMs

This chapter provides instructions on how to install an Oracle9i Application Server Certified Configuration (Oracle9iAS CC).

This chapter contains the following sections:

Creating a Stage Area

If you already created a stage area on your system, then go to the Prerequisites for Installation and Configuration section.

If you do not have a stage area, then complete the following tasks to create a stage area on the system where you want to host the Oracle9iAS CC software:

  1. Use the following commands to create stage directories for installing Oracle9iAS CC:

    # mkdir -p /stage/ias902/Disk0
    
    # mkdir -p /stage/ias902/Disk1 
    
    # mkdir -p /stage/ias902/Disk2
    
    # mkdir -p /stage/ias902/Disk3
    
    # mkdir -p /stage/ias902/Disk4
    
    # mkdir -p /stage/ias902/ifs/Disk1
    # mkdir -p /stage/ias902/oai/Disk1
    
    

    Note:

    If you create the stage area on a different system than the installation system, then the path does not have to start with /stage. You can use any top-level directory name. However, the second level directory name must be ias902, and you must create subdirectories below ias902 as shown in this example.

  2. Insert the Oracle9i Application Server Certified Configuration, J2EE, and WebCache for Solaris Operating Environment (SPARC 64-bit) Release 2 (9.0.3) CD1 into the CD-ROM drive and mount using following command:

    # mount <options> <device-name> /mnt
    
    

    Extract Oracle9iAS Certified Configuration Utility Pack (Disk 0) using following commands:

    # cd /stage/ias902/
    # tar –xvf /mnt/ias903cc_j2eewc_noinfra_solaris_images.tar \
    ias902cc_cdzero_solaris.tar.gz
    # gunzip ias902cc_cdzero_solaris.tar.gz
    # tar –xvf ias902cc_cdzero_solaris.tar
    
    

    After the copy is complete, use the following command to unmount the Utility Pack:

    # umount /mnt
    
    
  3. In numeric order, repeat the following steps to copy the contents of all four CD-ROM of Oracle9iAS CC into the staging area:

    1. Insert the CD-ROM

    2. Mount the CD-ROM.

    3. Using the following command syntax, copy the CD-ROM contents to the stage area whose label matches the CD-ROM number:

      # (cd /mnt; tar cf  - .) | (cd /stage/ias902/DiskN;  tar xf -)
      
      

      where N is the disk number of the CD-ROM that you mounted.

    4. After the CD-ROM is copied, use the following command to unmount the CD-ROM:

      # umount /mnt
      
      
  4. Eject the CD-ROM

  5. Insert the CD-ROM for Oracle Internet File System (Oracle9iFS) and copy its contents using the following commands:

    # mount <options> <device-name> /mnt
    # (cd /mnt; tar cf  - .) | (cd /stage/ias902/ifs/Disk1; tar xf -)
    
    # umount /mnt
    
    
  6. Insert the CD-ROM for Oracle9iAS Integration Release 2 and copy its contents using the following commands:

    # mount <options> <device-name> /mnt
    # (cd /mnt; tar cf  - .) | (cd /stage/ias902/oai/Disk1; tar xf -)
    
    # umount /mnt
    
    

Prerequisites for Installation and Configuration

You will need the following information before installing and configuring Oracle9iAS CC:


See Also:

For details on all installation and configuration requirements, see Chapter 2, " Installing and Configuring Oracle9iAS CC Using the Gold Image".


Note:

The system will prompt you to log in as the root user to start installation, configuration, or cloning. However, internally, all the operations are done as a normal operating system user (not the root user) who owns or will own the Oracle software (except when it is mandatory to perform operations as the root user).

After you complete the installation and configuration of Oracle9iAS CC, you must perform maintenance and management operations using a normal operating system user who is the owner of a particular Oracle home, unless otherwise required by the base product itself.


Two-Tier Deployment

A two-tier deployment involves the deployment of the components in the following table.

Table 3-1 Deployment

Tier Component
Database-Tier
  • Infrastructure database
Middle-Tier
  • Infrastructure mid-tier - Oracle Internet Directory (OiD) and Single Sign-On (SSO) server
  • Complete Oracle9i Application Server mid-tier, Oracle Internet File System (CM_SDK), and Oracle Application Interconnect (OAI).



Note:

You must first configure Infrastructure database on the database-tier, then Infrastructure mid-tier on the middle-tier before configuring other components.

Installing Infrastructure Database on the Database-Tier

Install Infrastructure database on the database-tier using the following steps:

  1. Log in as the root user on the database-tier.

  2. Change directories to the stage area using the following command:

    # cd /<stage area>/Disk0
    
    
  3. Run the install.sh script with the following options:

    # PATH=$PATH:/usr/ccs/bin; export PATH
    # ./install.sh -productcd -custid=<4 letter customer id> -instancetype={t|d|p} -installtype=infradb
    

Preconfiguration Validations

Set the DISPLAY environment variable to a valid X Server, and tune the kernel parameters as specified in Chapter 1, " Installation Requirements". Otherwise, the preconfiguration validation will fail.

Configuring Infrastructure Database on the Database-Tier

Complete the following procedure to configure Oracle9iAS CC Infrastructure:

  1. If you have previous Oracle9iAS installations on your system, then ensure that Enterprise Manager Web site is shut down before starting configuration.

    Verify that Enterprise Manager Web site is shut down if you installed and completed the configuration of Oracle9iAS Infrastructure for OiD/SSO server. If Enterprise Manager Web site is in any of the existing Oracle9iAS ORACLE_HOMEs, then use the following procedure to shut it down:

    1. Log in as the user who owns the ORACLE_HOME in which the Enterprise Manager Web site is running.

    2. Ensure that the ORACLE_HOME variable is set properly.

    3. Run the following command:

      $ $ORACLE_HOME/bin/emctl stop
      
      

      When prompted, enter the Enterprise Manager (EMD) password. This should shut down the Enterprise Manager Web site.

  2. Log in as the root user.

  3. Set the DISPLAY environment variable to a valid display.

  4. Using the following command, start the Rapid Configurator tool as the root user:

    # cd /admin/mwcc/ias/902
    # PATH=$PATH:/usr/ccs/bin; export PATH
    # ./config.sh -productcd
    
    

    The system might prompt you to enter the path for the Oracle9iAS CC release 2 (9.0.2.0.1) ORACLE_HOME that you want to configure. If you have the environmental variable CC_ORACLE_HOME set prior to starting the configuration, then Rapid Configurator will not prompt you for this information, and will configure the ORACLE_HOME that you specified with the variable.

  5. The Welcome screen appears. Click Next.


    Note:

    Click the Help button to obtain further information about input fields for each configuration screen.

  6. The Oracle9iAS Instance Information screen appears. This screen prompts you to enter an instance name, and set the password for the instance.

    According to Outsourcing standards the Oracle9i Application Server instance name should be xyyyys_infradb. Each Oracle9i Application Server install is represented by a unique instance name. At the prompts, enter a name for this installation, and enter a password for the instance. The password must include at least one alphabetic and one numeric character, and it must be at least five characters long. Confirm the password by entering the same password again.

    When you have entered the required information, click Next.

  7. The Oracle9iAS Infrastructure Deployment Type screen appears. Click Next.

  8. Select Oracle9iAS Metadata Database Only, then the Infrastructure SID screen appears.

  9. Accept the default SID and click Next.

  10. The Summary screen appears. This screen shows the summary of information you entered on the previous configuration screens. A progress window appears, and indicates configuration progress. When the configuration is complete, the progress window displays "done" at the bottom of the window.

    If post-configuration instructions appear above the "done" text in the progress window, then you need to complete the required steps listed in the instructions after you exit the Rapid Configurator. Refer to the section "Completing Postconfiguration Steps for Infrastructure" for details.

    You can view the configuration log by clicking on the Open Log button. Check the log for any errors. Click Close to close the configuration log, and click Exit to exit from the Rapid Configurator. The log file is located in the directory, /admin/mwcc/logs/config.


    Note:

    Configuring Oracle9iAS CC Infrastructure takes 60 to 90 minutes to complete.

Installing Infrastructure Mid-Tier on the Middle-Tier

Install Infrastructure mid-tier (OiD and SSO Server) on the middle-tier using the following steps:

  1. Log in as the root user on the middle-tier.

  2. Change directories to the stage area using the following command:

    # cd /<stage area>/Disk0
    
    
  3. Run the install.sh script with the following options:

    # PATH=$PATH:/usr/ccs/bin; export PATH
    # ./install.sh -productcd -custid=<4 letter customer id> -instancetype={t|d|p} -installtype=infraoidsso
    

Preconfiguration Validations

Set the DISPLAY environment variable to a valid X Server, and tune the kernel parameters as specified in Chapter 1, " Installation Requirements". Otherwise, the preconfiguration validation will fail.

Configuring Infrastructure Mid-Tier on the Middle-Tier

Complete the following procedure to configure Oracle9iAS CC Infrastructure:

  1. If you have previous Oracle9iAS installations on your system, then ensure that Enterprise Manager Web site is shut down before starting configuration.

    Verify that Enterprise Manager Web site is shut down if you installed and completed the configuration of Oracle9iAS Infrastructure for OiD and SSO server. If Enterprise Manager Web site is in any of the existing Oracle9iAS ORACLE_HOMEs, then use the following procedure to shut it down:

    1. Log in as the user who owns the ORACLE_HOME in which the Enterprise Manager Web site is running.

    2. Verify that the ORACLE_HOME variable is set properly.

    3. Run the following command:

      $ $ORACLE_HOME/bin/emctl stop
      
      

      When prompted, enter the Enterprise Manager (EMD) password. This should shut down the Enterprise Manager Web site.

  2. Log in as the root user.

  3. Set the DISPLAY environment variable to a valid display.

  4. Using the following command, start the Rapid Configurator tool as the root user:

    # cd /admin/mwcc/ias/902
    # PATH=$PATH:/usr/ccs/bin; export PATH
    # ./config.sh -productcd
    
    

    The system might prompt you to enter the path for the Oracle9iAS CC ORACLE_HOME that you want to configure. If you have the environmental variable CC_ORACLE_HOME set prior to starting the configuration, then Rapid Configurator will not prompt you for this information, and will configure the ORACLE_HOME that you specified with the variable.

  5. The Welcome screen appears. Click Next.


    Note:

    Click the Help button to obtain further information about input fields for each configuration screen.

  6. The Oracle9iAS Instance Information screen appears. This screen prompts you to enter an instance name, and set the password for the instance.

    According to Oracle Outsourcing standards the Oracle9i Application Server instance name is xyyyys_infraoidsso. Each Oracle9i Application Server install is represented by a unique instance name. At the prompts, enter a name for this installation, and enter a password for the instance. The password must include at least one alphabetic and one numeric character, and it must be at least five characters long. Confirm the password by entering the same password again.

    After you enter the required information, click Next.

  7. The Oracle9iAS Infrastructure Deployment Type screen appears.

    Select Oracle Internet Directory and Single Sign-On Server. Click Next. The Associate with existing Oracle9iAS Infrastructure screen appears.

  8. Enter the required database connection information:

    • Hostname (with domain). Example: mycompany.mydomain.com

    • Oracle SID: Oracle database system identifier (SID), or the name of your database. Example: iasdb

    • Oracle9iAS Instance Password for the Metadata database: Enter the password for the Oracle9iAS instance.

  9. The Language Selection screen appears.

    Select one or more languages with which you want Oracle9iAS configured. You must select at least one language.

    After you enter the required information, click Next.


    Note:

    Oracle Corporation recommends that you select only languages that you plan to use. If you select all languages, the time required to complete configuration is greatly increased.

  10. The Summary screen appears. This screen shows the summary of information you entered on the previous configuration screens. A progress window appears, and indicates configuration progress. When the configuration is complete, the progress window displays "done" at the bottom of the window.

    If postconfiguration instructions appear above the "done" text in the progress window, then you need to complete the required steps listed in the instructions after you exit the Rapid Configurator. Refer to the section "Completing Postconfiguration Steps for Infrastructure" for details.

    You can view the configuration log by clicking on the Open Log button. Check the log for any errors. Click Close to close the configuration log, and click Exit to exit from the Rapid Configurator. The log file is in the directory, /admin/mwcc/logs/config.


    Note:

    Configuring Oracle9iAS CC Infrastructure takes 60 to 90 minutes to complete.

Completing Postconfiguration Steps for Infrastructure

Complete the following tasks:

  1. Verify that there is a network connection from the database-tier to the middle-tier system before starting configuration.

    When you configure SSO, the database-tier system initiates a connection to the OiD server running on the middle-tier system. Using the following command, ensure this connectivity from the database-tier to the OiD port on the middle-tier:

    # telnet hostname oidport#
    
    

    where the variable hostname represents the host name for the middle-tier system, and the variable oidport# represents the OiD port number.

    You should see the following response to the telnet command:

    Trying your_host_ip_address
    Connected to hostname
    Escape character is ’^]’
    
    

    In the response above, the variable your_host_ip_address is the IP host address of your middle-tier system.

    If you see this response, then it indicates that you can connect to the system and you can go on to the installation procedure.

    If you do not see this response, then you must contact your network administrator to troubleshoot the network connection.

  2. Log into the database-tier as the owner of the Oracle home for Infrastructure database-tier.

  3. Source the ora_cc_env file by using the following:

    $ . /etc/ora_cc_env
    
    
  4. Source the profile for this Oracle home and select the Infrastructure mid-tier Oracle home:

    $ . ~/profile.iascc_env
    
    
  5. Obtain the values for the following parameters on your system:

    • Fully qualified hostname where the infrastructure OiD/SSO server is running (mid-tier host name)

    • OiD port number (by default, 4032)

    • Oracle9iAS instance password for the Oracle9iAS metadata repository database

    • Oracle Net listener port number for the Oracle9iAS metadata repository database (1521)

  6. Using the following command, change directories to the Oracle9iAS CC scripts directory:

    $ cd $ORACLE_CC_ROOT/rct/infra/bin
    
    
  7. Enter the following command to run the script, infra_postconfig.sh:

    $ ./infra_postconfig.sh
    

    Note:

    For security reasons, the system will not echo a password.

  8. The script runs to completion and creates a log in the following directory:

    $ORACLE_CC_ROOT/logs/config/postconfig.log.<date-time-stamp> 
    
    

    Verify that the error log contains no significant errors. You can disregard the following errors:

    • Portal SMI: ERROR: Web DAV: /dav_portal/orasso could not be found.

    • Repository Access API throws exception

Verifying Configuration

Check the configuration log file located in the $ORACLE_CC_ROOT/logs/config directory for any errors.

To verify that you correctly installed and configured the Infrastructure, go to the URL, http://<hostname>.<domainname>:7777/oiddas. Log in as the orcladmin user with the password that you specified during configuration. The login should be successful.

Installing Oracle9i Application Server Mid-Tier Components on the Middle-Tier

Install Oracle9iAS middle-tier components on the middle-tier using the following steps:

  1. Log in as the root user.

  2. Change directories to the stage area using the following command:

    # cd /<stage area/Disk0
    
    
  3. Run the install.sh script with the following options:

    # PATH=$PATH:/usr/ccs/bin; export PATH
    # ./install.sh -productcd -custid=<4 letter customer id> -instancetype={t|d|p} -installtype=iasmt
    

Preconfiguration Validations

Set the DISPLAY environment variable to a valid X Server, and tune the kernel parameters as specified in Chapter 2, " Installing and Configuring Oracle9iAS CC Using the Gold Image". Otherwise, the preconfiguration validation will fail.

Configuring Oracle9iAS CC Mid-Tier

Complete the following tasks:

  1. Confirm Prerequisites

  2. Configure Oracle9iAS CC Mid-Tier

  3. Verifying Configuration

Confirm Prerequisites

Except for stand alone J2EE and Web Cache deployment, you must have Oracle9i Application Server Infrastructure configured and running.

Configure Oracle9iAS CC Mid-Tier

Complete the following procedure:

  1. If you have previous Oracle9iAS installations on your system, then ensure that Enterprise Manager Web site is shut down before starting configuration.

    Make sure that you shutdown the site if you previously installed and completed the configuration of Oracle9iAS Infrastructure for OiD and SSO server. If Enterprise Manager Web site is in any of the existing Oracle9iAS ORACLE_HOMEs, then use the following procedure to shut it down:

    1. Log in as the user who owns the ORACLE_HOME in which the Enterprise Manager Web site is running.

    2. Ensure that you set the ORACLE_HOME variable.

    3. Run the following command:

      $ $ORACLE_HOME/bin/emctl stop
      
      

      When prompted, enter the Enterprise Manager (EMD) password. This should shut down the Enterprise Manager Web site.

  2. As the root user, use the following command to start the Rapid Configurator tool:

    # cd /admin/mwcc/ias/902
    # PATH=$PATH:/usr/ccs/bin; export PATH
    # ./config.sh -productcd
    
    
  3. The Welcome screen appears. Click Next.


    Note:

    Click the Help button to obtain further information about input fields for each configuration screen.

  4. The Instance InformationOracle9iAS screen appears. This screen prompts you to enter an instance name, and set the password for the instance.

    A unique instance name represents each Oracle9iAS install. According to Oracle Outsourcing standards the Oracle9i Application Server instance name is xyyyyo_iasmt. At the prompts, enter a name for this installation, and enter a password for the instance. The password must include at least one alphabetic and one numeric character, and it must have at least five characters. Confirm the password by entering the same password again.

    After you enter the required information, click Next.

  5. The Oracle9iAS Deployment Type screen appears. Click the appropriate radio button to select the deployment type from the following options:

    • Business Intelligence and Forms

    • J2EE and Web Cache

    • Portal and Wireless

    After you enter the required information, click Next.

  6. If you select J2EE and Web Cache in step 5, then the J2EE and Web Cache Infrastructure Information screen appears. Select one of the following deployment modes:

    1. J2EE and Web Cache Associated with Infrastructure: To associate J2EE and Web Cache with an existing Oracle9iAS Infrastructure, click the Use the Oracle9iAS Infrastructure check box. Doing this opens the text boxes to enter the required infrastructure information. Enter the following:

      iAS SSO Server Host Name: Enter the host name of your Oracle9iAS Infrastructure instance.

      Single Sign-On Port: Enter the Single Sign-On (SSO) port number. You can obtain the SSO port number from the value for the OiD/SSO ORACLE_HOME in the file, $ORACLE_HOME/install/portlist.ini.

      OiD Administrator Login: Enter the database login identity for Oracle Internet Directory on the infrastructure. The default is orcladmin.

      OiD Administrator Password: Enter the password for the OiD login identity. The password is the instance password that you provided during Oracle9iAS metadata repository installation.

      After you enter the required information, click Next.


      Note:

      SSO, OiD, and the Oracle9iAS metadata repository database with its corresponding Net listener must be up and running on the infrastructure system.

      When you click Next, the Configurator validates infrastructure information you enter by connecting to the infrastructure instance. The system will not let you proceed if any invalid information is entered, or if any required processes are down.


    2. J2EE and Web Cache Deployment: If you do not want to associate the J2EE and Web Cache deployment with Oracle9i Application Server infrastructure, then click Next.

  7. If you selected Portal and Wireless, or Business Intelligence and Forms from the Oracle9iAS Deployment Type screen, then the Portal and Wireless Infrastructure Information screen appears.

    Provide the following infrastructure information:

    iAS SSO Server Host Name: Enter the host name of your Oracle9iAS Infrastructure instance.

    Single Sign-On Port: Enter the Single Sign-On (SSO) port number. You can obtain the SSO port number from the value for OiD/SSO ORACLE_HOME in the file $ORACLE_HOME/install/portlist.ini.

    OiD Administrator Login: Enter the database login identity for Oracle Internet Directory on the infrastructure. The default is orcladmin.

    OiD Administrator Password: Enter the password for the OiD login identity. The password is the instance password that you provided during Oracle9iAS metadata repository installation.


    Note:

    Single Sign-On, OiD, and the Oracle9iAS metadata repository database with its corresponding Net listener must be up and running on the infrastructure system.

    When you click Next, the Configurator validates infrastructure information you enter by connecting to the infrastructure instance. The system will not let you proceed if any invalid information is entered, or if any required processes are down.


  8. For all deployment types except J2EE and Web Cache, the Language Selection screen appears.

    Select one or more languages with which you want Oracle9i Application Server configured. You must select at least one language.

    After you enter the required information, click Next.

  9. The Summary screen appears. This screen shows the summary of information you entered on the previous configuration screens. A progress window appears, and indicates configuration progress. When the configuration is complete, Done appears at the bottom of the progress window.

    You can view the configuration log by clicking on the Open Log button. Check the log for any errors. Click Close to close the configuration log, and click Exit to exit from the Rapid Configurator. The log file is in the directory, /admin/mwcc/logs/config.


    Note:

    Configuring Oracle9iAS CC Middle-Tier takes up to 30 minutes, depending on deployment type.

Verifying Configuration

Check the configuration log file located in the $ORACLE_CC_ROOT/logs/config directory for any errors.

To verify that you correctly installed and configured Oracle9i Application Server J2EE component, go to the following URL and run OC4Jdcmn:

http://<hotsname>.<domainname>:7778/

To verify that you correctly installed and configured the Oracle9iAS middle-tier Portal component, go to the URL, http://<hostname>.<domainname>:7778/pls/portal. Click on the Login link and log in as portal with the password that you specified during configuration. The login should be successful.

Single-Tier Deployment

A single-tier deployment involves the deployment of the following components:

Installing Infrastructure on the Single-Tier

Install Infrastructure on the single-tier using the following steps:

  1. Log in as the root user on the single-tier.

  2. Change directories to the stage area using the following command:

    # cd /<stage area/Disk0
    
    
  3. Run the install.sh script with the following options:

    # PATH=$PATH:/usr/ccs/bin; export PATH
    # ./install.sh -productcd -custid=<4 letter customer id> -instancetype={t|d|p} -installtype=infraall
    

Preconfiguration Validations

Set the DISPLAY environment variable to a valid X Server, and tune the kernel parameters as specified in Chapter 1, " Installation Requirements". Otherwise, the preconfiguration validation will fail.

Configuring Infrastructure on the Single-Tier

Complete the following procedure to configure Oracle9iAS CC Infrastructure:

  1. If you have previous Oracle9iAS installations on your system, then ensure that Enterprise Manager Web site is shut down before starting configuration.

    Make sure that you shut down the site if you installed and completed the configuration of Oracle9iAS Infrastructure for OiD and SSO server. If Enterprise Manager Web site is in any of the existing Oracle9iAS ORACLE_HOMEs, then use the following procedure to shut it down:

    1. Log in as the user who owns the ORACLE_HOME in which the Enterprise Manager Web site is running.

    2. Ensure that the ORACLE_HOME variable is set properly.

    3. Run the following command:

      $ $ORACLE_HOME/bin/emctl stop
      
      

      When prompted, enter the Enterprise Manager (EMD) password. This should shut down the Enterprise Manager Web site.

  2. Log in as the root user.

  3. Set the DISPLAY environment variable to a valid display.

  4. Using the following command, start the Rapid Configurator tool as root:

    # cd /admin/mwcc/ias/902
    # PATH=$PATH:/usr/ccs/bin; export PATH
    # ./config.sh -productcd
    
    

    The system might prompt you to enter the path for the Oracle9iAS CC ORACLE_HOME that you want to configure. If you have the environmental variable CC_ORACLE_HOME set prior to starting the configuration, then Rapid Configurator will not prompt you for this information, and will configure the ORACLE_HOME that you specified with the variable.

  5. The Welcome screen appears. Click Next.


    Note:

    Click the Help button to obtain further information about input fields for each configuration screen.

  6. The Oracle9iAS Instance Information screen appears. This screen prompts you to enter an instance name, and set the password for the instance.

    According to Outsourcing standards the Oracle9i Application Server instance name should be xyyyys_infraall. Each Oracle9i Application Server install is represented by a unique instance name. At the prompts, enter a name for this installation, and enter a password for the instance. The password must include at least one alphabetic and one numeric character, and it must have at least five characters. Confirm the password by entering the same password again.

    After you enter the required information, click Next.

  7. The Oracle9iAS Infrastructure Deployment Type screen appears. Select Complete Oracle9iAS Infrastructure, then click Next.

  8. The Language Selection screen appears.

    Select one or more languages with which you want Oracle9iAS configured. You must select at least one language.

    After you enter the required information, click Next.


    Note:

    Oracle Corporation recommends that you select only languages that you plan to use. If you select all languages, the time required to complete configuration is greatly increased.

  9. The Summary screen appears. This screen shows the summary of information you entered on the previous configuration screens. A progress window appears, and indicates configuration progress. When the configuration is complete, the progress window displays "done" at the bottom of the window.

    You can view the configuration log by clicking on the Open Log button. Check the log for any errors. Click Close to close the configuration log, and click Exit to exit from the Rapid Configurator. The log file is in the directory, /admin/mwcc/logs/config.


    Note:

    Configuring Oracle9iAS CC Infrastructure takes 60 to 90 minutes to complete.

Verifying Configuration

Check the configuration log file located in the $ORACLE_CC_ROOT/logs/config directory for any errors.

To verify that the Infrastructure mid-tier is correctly installed and configured, go to the URL, http://<hostname>.<domainname>:7777/oiddas. Log in as the orcladmin user with the password as specified during configuration. The login should be successful.

Installing Oracle9i Application Server Middle-Tier Components on the Single-Tier

Install Oracle9i Application Server middle-tier components on the single-tier using the following steps:

  1. Log in as the root user on the single-tier.

  2. Change directories to the stage area using the following command:

    # cd /<stage area/Disk0
    
    
  3. Run the install.sh script with the following options:

    # PATH=$PATH:/usr/ccs/bin; export PATH
    # ./install.sh -productcd -custid=<4 letter customer id> -instancetype={t|d|p} -installtype=iasmt
    

Preconfiguration Validations

Set the DISPLAY environment variable to a valid X Server, and tune the kernel parameters as specified in Chapter 2, " Installing and Configuring Oracle9iAS CC Using the Gold Image". Otherwise, the preconfiguration validation will fail.

Configuring Oracle9iAS CC Mid-Tier

Complete the following tasks:

  1. Confirm Prerequisites

  2. Configure Oracle9iAS CC Mid-Tier

  3. Verifying Configuration

Confirm Prerequisites

Except for stand alone J2EE and Web Cache deployment, you must have Oracle9i Application Server Infrastructure configured and running.

Configure Oracle9iAS CC Mid-Tier

Complete the following procedure:

  1. If you have previous Oracle9iAS installations on your system, then ensure that Enterprise Manager Web site is shut down before starting configuration.

    Make sure that you shut down the site if you installed and completed the configuration of Oracle9iAS Infrastructure for OiD and SSO server. If Enterprise Manager Web site is in any of the existing Oracle9iAS ORACLE_HOMEs, then use the following procedure to shut it down:

    1. Log in as the user who owns the ORACLE_HOME in which the Enterprise Manager Web site is running.

    2. Ensure that the ORACLE_HOME variable is set properly.

    3. Run the following command:

      $ $ORACLE_HOME/bin/emctl stop
      
      

      When prompted, enter the Enterprise Manager (EMD) password. This should shut down the Enterprise Manager Web site.

  2. As the root user, use the following command to start the Rapid Configurator tool:

    # cd /admin/mwcc/ias/902
    # PATH=$PATH:/usr/ccs/bin; export PATH
    # ./config.sh -productcd
    
    
  3. The Welcome screen appears. Click Next.


    Note:

    Click the Help button to obtain further information about input fields for each configuration screen.

  4. The Instance InformationOracle9iAS screen appears. This screen prompts you to enter an instance name, and set the password for the instance.

    According to Outsourcing standards the Oracle9i Application Server instance name should be xyyyyo_iasmt. Each Oracle9iAS install is represented by a unique instance name. At the prompts, enter a name for this installation, and enter a password for the instance. The password must include at least one alphabetic and one numeric character, and it must be at least five characters long. Confirm the password by entering the same password again.

    After you enter the required information, click Next.

  5. The Oracle9iAS Deployment Type screen appears. Click the appropriate radio button to select the deployment type from the following options:

    • Business Intelligence and Forms

    • J2EE and Web Cache

    • Portal and Wireless

    After you enter the required information, click Next.

  6. If you select J2EE and Web Cache in step 5, then the J2EE and Web Cache Infrastructure Information screen appears. Select one of the following deployment modes:

    1. J2EE and Web Cache Associated with Infrastructure: To associate J2EE and Web Cache with an existing Oracle9iAS Infrastructure, click the Use the Oracle9iAS Infrastructure check box. Doing this opens the text boxes to enter the required infrastructure information. Enter the following:

      iAS SSO Server Host Name: Enter the host name of your Oracle9iAS Infrastructure instance.

      Single Sign-On Port: Enter the Single Sign-On port number. You can obtain the SSO port number from the value for OiD/SSO ORACLE_HOME in the file, $ORACLE_HOME/install/portlist.ini.

      OiD Administrator Login: Enter the database login identity for Oracle Internet Directory on the infrastructure. The default is orcladmin.

      OiD Administrator Password: Enter the password for the OiD login identity. The password is the instance password that you provided during Oracle9iAS metadata repository installation.

      After you enter the required information, click Next.


      Note:

      Single Sign-On, OiD, and the Oracle9iAS metadata repository database with its corresponding Net listener must be up and running on the infrastructure system.

      When you click Next, the Configurator validates infrastructure information you enter by connecting to the infrastructure instance. The system will not let you proceed if any invalid information is entered, or if any required processes are down.


    2. J2EE and Web Cache Deployment: If you do not want to associate the J2EE and Web Cache deployment with Oracle9iAS Infrastructure, then click Next.

  7. If you selected Portal and Wireless, Business Intelligence and Forms, or Unified Messaging from the Oracle9iAS Deployment Type screen, then the Portal and Wireless Infrastructure Information screen appears.

    Provide the following infrastructure information:

    iAS SSO Server Host Name: Enter the host name of your Oracle9iAS Infrastructure instance.

    Single Sign-On Port: Enter the Single Sign-On port number. You can obtain the SSO port number from the value for OiD/SSO ORACLE_HOME in the file $ORACLE_HOME/install/portlist.ini.

    OiD Administrator Login: Enter the database login identity for Oracle Internet Directory on the infrastructure. The default is orcladmin.

    OiD Administrator Password: Enter the password for the OiD login identity. The password is the instance password that you provided during Oracle9iAS metadata repository installation.


    Note:

    Single Sign-On, OiD, and the Oracle9iAS metadata repository database with its corresponding Net listener must be up and running on the infrastructure system.

    When you click Next, the Configurator validates infrastructure information you enter by connecting to the infrastructure instance. The system will not let you proceed if any invalid information is entered, or if any required processes are down.


  8. For all deployment types except J2EE and Web Cache, the Language Selection screen appears.

    Select one or more languages with which you want Oracle9i Application Server configured. You must select at least one language.

    After you enter the required information, click Next.

  9. The Summary screen appears. This screen shows the summary of information you entered on the previous configuration screens. A progress window appears, and indicates configuration progress. When the configuration is complete, Done appears at the bottom of the progress window.

    You can view the configuration log by clicking on the Open Log button. Check the log for any errors. Click Close to close the configuration log, and click Exit to exit from the Rapid Configurator. The log file is located in the directory /admin/mwcc/logs/config.


    Note:

    Configuring Oracle9iAS CC Middle Tier takes up to 30 minutes, depending on deployment type.

    The OC4J Demo instance is not started by default after the configuration is complete. To start the OC4J Demo instance, use the following procedure:

    1. Log in as oracle (or as the user who owns the Oracle9iAS ORACLE_HOME).

    2. To set the environment, use the following command to open the Oracle9iAS profile file:

      $ . $HOME/profile.iascc_env
      
      
    3. Select the ORACLE_HOME that has just been configured. Use the following command to start the OC4J Demos:

      $ $ORACLE_HOME/dcm/bin/dcmctl start -co OC4J_Demos
      

Verifying Configuration

Check the configuration log file located in the $ORACLE_CC_ROOT/logs/config directory for any errors.

To verify that the Oracle9iAS middle-tier Portal component is correctly installed and configured, go to the URL, http://<hostname>.<domainname>:7778/pls/portal. Click on the Login link and log in as portal with the password specified during configuration. The login should be successful.

Postconfiguration

This section provides information on patches and starting the Infrastructure database in archive log mode.

Mandatory Patches

Oracle integrated the following patches into the Gold Image. You must apply these patches during installation using the product CD-ROMs:

  • Oracle Forms and Reports Patch Set 9.0.2.2 (bug 2842923)

  • Oracle9i Application Server Patch Set 9.0.2.3 (bug 3038037)

Starting the Infrastructure Database in Archive Log Mode

Perform the following procedure to start the Infrastructure database in archive log mode:

  1. Stop all the instances.

  2. Log in as the user who owns the Oracle home that has the Infrastructure database.

  3. Use the following command to set the environment:

    $ . $ORACLE_HOME/profile.iascc_env
    
    
  4. Select the $ORACLE_HOME that has the Infrastructure database.

  5. Run the following commands:

    $ . sqlplus ’/as sysdba’
    SQL> startup mount;
    SQL> alter database archivelog;
    SQL> alter database opent;
    SQL> shutdown immediate;
    SQL> exit
    
    
  6. Start all the instances.

Handling Configuration Failures

See Appendix C, " Troubleshooting" for handling failures during configuration. If the failure requires you to reinstall the software, follow instructions in Appendix D, " Oracle9i Application Server Certified Configuration Deinstallation" to remove your existing installation.