2 System Configuration and Verification

This chapter describes the tasks needed to configure and verify Oracle E-Business Suite Certified Configuration. Make sure that you complete these tasks before users access the system.

This chapter contains the following topics:

Account Information
System Configuration
System Verification
Integrating Oracle Internet Directory with Oracle Applications 11i

Account Information

Before setting up Oracle E-Business Suite Certified Configuration, provide the following information to Oracle Support Services:

Contact information
Hardware configuration
Software configuration
System serial number
Software and operating system version

This information is essential for establishing an account with Oracle Support, and for accessing Oracle Support Services. To provide the information, submit the Service Initialization Form that you received with the Welcome e-mail message. If you are unable to locate the form, then contact Oracle Support at 1.800.376.9079.

System Configuration

This section provides instructions on how to use the Oracle E-Business Suite Certified Configuration cloning utility to configure the system. You can run the cloning utility from the command line.

The cloning utility enables you to manipulate environments on an Oracle E-Business Suite Certified Configuration system. This includes cloning from a Source environment to a Target environment, restoring a fresh environment from the original zip archives, changing the identity of an existing environment, and deleting environments. The cloning utility supports both VERITAS Volume Manager 3.2 and NetApps storage options.

Command Line Configuration Wizard

The command line interface allows you to run the Oracle E-Business Suite Certified Configuration wizard with commands. This section describes the details of the underlying components of the cloning utility.

There are three main phases in a cloning process. Each phase is handled by a script. Table 2-1 describes each phase, and its corresponding script.

Table 2-1 Cloning Phases

Phases	Script
Phase 1: Create and mount a set of partitions for the new environment, and create the corresponding owners.	$EBSO_HOME/admin/cfgmntpt.sh
Phase 2: Copy files from environment A to environment B.	$EBSO_HOME/admin/wizard.sh
Phase 3: Update the new environment with a new identity.	$EBSO_HOME/admin/wizard.sh $EBSO_HOME/admin/wizard.sh $EBSO_HOME/admin/wizard.sh

Normally, it is not necessary to run these scripts individually. The wrapper script $EBSO_HOME/admin/wizard.sh enables you to run all three scripts at once. Make sure that you run the script wizard.sh as the root user. Only run the scripts in Table 2-1 if there is a need for manual intervention. An example of when this may be necessary is during database recovery.

The task to update Oracle Applications 11i environments is based on AutoConfig technology. Updating ensures that the resulting environment is compliant with the Oracle E-Business Suite Outsourcing conventions.

Note:

For more information on AutoConfig, refer to OracleMetalink document 165195.1. It is available at the following Web site:

http://metalink.oracle.com

The following table contains some examples of how to use the cloning utility. These examples assume that the environments are locally attached disks. If you use network-attached storage, then you must add an additional parameter, fstype=nfs, to the command.

Before running the commands in Table 2-2, make sure that you have completely shut down the environment.

Table 2-2 Examples of Using the wizard.sh Script

Example	Syntax
Cloning a single-node Oracle Applications 11i environment.	# ./wizard.sh mode=clone src_mntpt=pabcdi dest_mntpt=dabcdi src_host=ple-bol0 tier=all
Configuring a single-node Oracle Applications 11i environment.	# ./wizard.sh mode=config src_mntpt=pabcdi dest_mntpt=dabcdi src_host=ple-bol0 tier=all
Cloning a multinode Oracle Applications 11i environment.	First run the following command on the database tier: # ./wizard.sh mode=clone src_mntpt=pabcdi dest_mntpt=dabcdi src_host=ple-bol0 tier=oracle mnode=config Then run the following command on the applications tier: # ./wizard.sh mode=clone src_mntpt=pabcdi dest_mntpt=dabcdi src_host=ple-bol0 tier=apps mnode=config
Configuring a multinode Oracle Applications 11i environment.	First run the following command on the database tier: # ./wizard.sh mode=config src_mntpt=pabcdi dest_mntpt=dabcdi src_host=ple-bol0 tier=oracle mnode=config Then run the following command on the applications tier: # ./wizard.sh mode=config src_mntpt=pabcdi dest_mntpt=dabcdi src_host=ple-bol0 tier=apps mnode=config
Cloning an Oracle Internet Directory environment.	# ./wizard.sh mode=clone src_mntpt=pabcds src_host=ple-bol0 dest_mntpt=tabcds tier=ldap
Configuring an Oracle Internet Directory environment.	# ./wizard.sh mode=config src_mntpt=pabcds src_host=ple-bol0 dest_mntpt=tabcds tier=ldap
Cloning an Oracle OLAP environment.	# ./wizard.sh mode=clone src_mntpt=pabcds src_host=ple-bol0 dest_mntpt=tabcds tier=olap apps_serv_host=ple-bol1 apps_mntpt=pabcdi
Configuring an Oracle OLAP environment.	# ./wizard.sh mode=config src_mntpt=pabcds src_host=ple-bol0 dest_mntpt=tabcds tier=olap apps_serv_host=ple-bol1 apps_mntpt=pabcdi

To delete environments, first make sure that you shut down the environment, and then run the script cfgmntpt.sh for each environment, using the following command syntax:

# ./cfgmntpt.sh -d mount_point -i local

System Verification

After updating the environment information, use Oracle Applications Release 11i (11.5.9) to verify that the environment and the system are functioning correctly.

The first time that you access the application, it will prompt you to download JInitiator. After you install the software, restart the browser, and proceed with the login procedure to verify the system:

Start the Web browser.
Enter the URL for the environment. The Oracle Applications Rapid Install portal window appears.

See Also:
The URL depends on the environment. For more information about URLs, refer to the section "URLs for Oracle Applications 11i" in .
Click the Apps Logon Links option. The window Logon Information for the instance appears.
Click Personal Home Page. The window Oracle Applications Logon appears.
Enter sysadmin for the user name and password.
Click Connect. The window Self-Service System Administrator appears.
Click System Administrator.
Select Manager from the Concurrent menu.
Select Administer from the Manager list.
Verify that the values in the Actual column match the values in the Target column. If the values match, then the Concurrent Manager processes are running correctly.
Select Run from the Requests menu.
Select Single Request from the Run list.
Enter Active Users in the name field of the request form. This field is case-sensitive.
Click Submit. The Requests form will appear.
Click Refresh Data to update the Phase column for the request.
Click View Log... when the Phase column lists the request as complete.
Verify that the log file appears in the Report Review Agent display.
Click the question mark icon in the top navigation bar. If the environment and system are functioning correctly, then the Applications Help window will appear.
Select Exit from the File menu to exit Oracle Applications Release 11i (11.5.9).

Integrating Oracle Internet Directory with Oracle Applications 11i

After you install the Oracle Internet Directory component successfully, complete the steps illustrated in the following procedure to configure the Login Server in your Oracle Applications 11i environment to use Oracle Internet Directory (OID) for user authentication. In the following example, the OID environment, TABCDS, is configured against the Oracle Applications 11i environment, TABCDI.

Go to the Oracle Applications 11i environment.
As the oracle user, ortabcdi, use the following commands to install the LDAP packages:
```
$ cd $ORACLE_HOME/rdbms/admin
$ sqlplus ‘/ as sysdba’ @catldap.sql
```

As the apps user, aptabcdi, use the following commands to enable OID authentication:

$ cd $IAS_TOP/portal30/admin/plsql/sso
$ sqlplus portal30_sso/portal30_sso @ssooid.sql

Enter the following information when prompted:
- Host: oid_host.domain
- Port: oid_server_port
- Search Base: cn=Login Server (portal30_sso)
- Unique Attribute: cn
- Bind DN: cn=orcladmin
- Bind Password: welcome
As the apps user, aptabcdi, use the following commands to generate an Oracle Applications 11i user list, users.ldif, to be loaded into the LDAP directory:
```
$ cd $IAS_TOP/portal30/admin/plsql/sso
$ sqlplus portal30_sso/portal30_sso @ssoldif.sql
```
Enter a file location that is in the utl_file_dir directory path (Example: /usr/tmp).
Go to the OID environment.
As the oracle user, ortabcds, start up the OID server if it is not already running.
Load the Oracle Applications 11i users list that you created in step 5, using the following commands:
```
$ ldapadd -h <oid_host> -p <oid_server_port> -D cn=orcladmin -w welcome -f\
 users.ldif
```
Go to the Oracle Applications 11i environment.
Open a Web browser, and go to the OracleMetalink Web site:
```
http://metalink.oracle.com
```
Locate and open OracleMetaLink Note 150832.1, Implementing Single Sign-On for Oracle Applications 11i with Login Server Authentication Using Oracle Internet Directory.
As the apps user, aptabcdi, apply OID synchronization patch 2499306, using the directions provided in step 1 of OracleMetaLink Note 150832.1.
To synchronize the OID user data and FND_USER on an ongoing basis, as the apps user, aptabcdi, review OracleMetaLink Note 150832.1. Perform as required the remaining configuration steps 2 through 6.