4 Outsourcing Automation Platform

When you have followed the instructions in Chapter 2 to configure and verify the system, use the instructions in this chapter to configure the system to start additional Outsourcing Automation Platform software.

This chapter contains the following topics:

Oracle Enterprise Manager Intelligent Agent Configuration
Patch Tracking System Client Configuration
Unified Serviceability Interface

Oracle Enterprise Manager Intelligent Agent Configuration

Oracle Enterprise Manager Intelligent Agent monitors databases, and other services on a node, for registered events and scheduled jobs. Intelligent Agents function independently of databases and services. Independent operation enables the Intelligent Agents to perform such tasks as starting up and shutting down a database. Even when other parts of the system are down, Intelligent Agents remain operational.

The following tasks describe how to configure Oracle Enterprise Manager Intelligent Agent to run on Oracle E-Business Suite Certified Configuration software:

Add an entry to the /etc/oratab file for the instance to be monitored by the Oracle Intelligent Agent. The following is an example of an entry:
```
SID:/mount_point/oracle/product/817:N
```
In the preceding example, SID is the system identifier, and mount_point is the mount point for the environment.
Log on as the oemadm user. The default password is oemadm.
Using the following command, start the Intelligent Agent:
```
$ agentctl start agent
```
To stop the Oracle Intelligent Agent, use the following command:
```
$ agentctl stop agent
```

Patch Tracking System Client Configuration

Oracle E-Business Suite Certified Configuration includes the Patch Tracking System (PTS) 2.10.0 client, which is used for Oracle Outsourcing customers. PTS is a Web-based tool that helps Oracle Applications administrators complete the following tasks:

Apply patches
Automatically apply patches, and notify the administrator
Check patch status
Generate reports and log files
Track the patch levels for all Oracle Applications environments

See Also:

For more information about PTS, refer to the Quick Start Guide at the following URL:

http://PTS_SERVER:WEBDB_PORT/cgi-bin/PTS

In the preceding URL, PTS_SERVER is the name of the PTS server, and WEBDB_PORT is its port number.

Patch Tracking System Client File Modification

Before applying a patch, you must modify the PTS client files for the environment.

Before modifying the PTS client files, you must have completed the following tasks:

Defined an environment on the PTS server.
Submitted a patch request on the server.

Use the following procedure to modify the files, and to apply a patch:

Modify the files as shown in the following table:

Table 4-1 PTS Client FIles

File Modification

File	Modification
/admin/pts_home/client_\ 2.10.0/tnsnames.ora	Create this file and add an entry for the ARU database, the PTS server database, and each database associated with the installation of Oracle Applications 11i.
/pts_home/client_2.10.0\ /lib/pts.conf	Create the file by copying the following to the `pts.conf` file: /admin/pts_home/client_2.10.0/lib/pts.conf.default Set the following variables to the corresponding values: LOCAL_CONNECT - `username`/`password`@`PTS_server_database` PTS_HOME - /admin/pts_home/client_2.10.0 PTS_LIB - /admin/pts_home/client_2.10.0/lib PTS_BIN - /admin/pts_home/client_2.10.0/bin TNS_ADMIN - /admin/pts_home/client_2.10.0 SSH_TOP - `ssh_dir` ORACLE_HOME - /admin/pts_home/client_2.10.0/techstack/2.0/ORACLE_HOME LD_LIBRARY_PATH - /admin/pts_home/client_2.10.0/techstack/2.0/ORACLE_HOME/lib `PERL5LIB` - `/admin/pts_home/client_2.10.0/techstack/2.0/lib`
$APPL_TOP/APPSORA.env	Add the environment variables `ORACLE_HOME` and `LD_LIBRARY_PATH`, and export them using the following commands: ORACLE_HOME=/`mount_point`/product/806 LD_LIBRARY_PATH=$LD_LIBRARY_PATH: /admin/pts_home/client_2.10.0/lib export ORACLE_HOME LD_LIBRARY_PATH

/admin/pts_home/client_\
2.10.0/tnsnames.ora

Create this file and add an entry for the ARU database, the PTS server database, and each database associated with the installation of Oracle Applications 11i.

/pts_home/client_2.10.0\
/lib/pts.conf

Create the file by copying the following to the pts.conf file:

/admin/pts_home/client_2.10.0/lib/pts.conf.default

Set the following variables to the corresponding values:

LOCAL_CONNECT - username/password@PTS_server_database
PTS_HOME - /admin/pts_home/client_2.10.0
PTS_LIB - /admin/pts_home/client_2.10.0/lib
PTS_BIN - /admin/pts_home/client_2.10.0/bin
TNS_ADMIN - /admin/pts_home/client_2.10.0
SSH_TOP - ssh_dir
ORACLE_HOME - 
/admin/pts_home/client_2.10.0/techstack/2.0/ORACLE_HOME
LD_LIBRARY_PATH - /admin/pts_home/client_2.10.0/techstack/2.0/ORACLE_HOME/lib
PERL5LIB - /admin/pts_home/client_2.10.0/techstack/2.0/lib

$APPL_TOP/APPSORA.env

Add the environment variables ORACLE_HOME and LD_LIBRARY_PATH, and export them using the following commands:

ORACLE_HOME=/mount_point/product/806

LD_LIBRARY_PATH=$LD_LIBRARY_PATH: /admin/pts_home/client_2.10.0/lib

export ORACLE_HOME LD_LIBRARY_PATH

File Modification

File	Modification
/admin/pts_home/client_2.10.0\ /tnsnames.ora	Create this file; add an entry for the ARU database, the PTS server database, and each database associated with the installation of Oracle Applications Release 11i (11.5.9).
/admin/pts_home/client_2.10.0\ /lib/pts.conf	Create the file by copying the following text to the `pts.conf` file: /pts_home/client_/lib/pts.conf/lib/\ pts.conf.default Set the following variables to the corresponding values: LOCAL_CONNECT - `username`/`password`@`PTS_server_database` PTS_HOME - /admin/pts_home/client_2.10.0 PTS_LIB - /admin/pts_home/client_2.10.0/lib PTS_BIN - /admin/pts_home/client_2.10.0/bin TNS_ADMIN - /admin/pts_home/client_2.10.0 SSH_TOP - `ssh_dir` ORACLE_HOME - /admin/pts_home/client_2.10.0/techstack/2.0/ORACLE_HOME LD_LIBRARY_PATH - /admin/pts_home/client_2.10.0/techstack/2.0/ORACLE_HOME/lib `PERL5LIB` - `/admin/pts_home/client_2.10.0/techstack/2.0/lib`
$APPL_TOP/APPSORA.env	Add the environment variables `ORACLE_HOME` and `LD_LIBRARY_PATH`; use the following command syntax to export them: ORACLE_HOME=/`mount_point`/product/806 LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/admin/pts_home/client_2.10.0\ /lib export ORACLE_HOME LD_LIBRARY_PATH

/admin/pts_home/client_2.10.0\
/tnsnames.ora

Create this file; add an entry for the ARU database, the PTS server database, and each database associated with the installation of Oracle Applications Release 11i (11.5.9).

/admin/pts_home/client_2.10.0\
/lib/pts.conf

Create the file by copying the following text to the pts.conf file:

/pts_home/client_/lib/pts.conf/lib/\
pts.conf.default

Set the following variables to the corresponding values:

LOCAL_CONNECT - username/password@PTS_server_database
PTS_HOME - /admin/pts_home/client_2.10.0
PTS_LIB - /admin/pts_home/client_2.10.0/lib
PTS_BIN - /admin/pts_home/client_2.10.0/bin
TNS_ADMIN - /admin/pts_home/client_2.10.0
SSH_TOP - ssh_dir
ORACLE_HOME - 
/admin/pts_home/client_2.10.0/techstack/2.0/ORACLE_HOME
LD_LIBRARY_PATH - /admin/pts_home/client_2.10.0/techstack/2.0/ORACLE_HOME/lib
PERL5LIB - /admin/pts_home/client_2.10.0/techstack/2.0/lib

$APPL_TOP/APPSORA.env

Add the environment variables ORACLE_HOME and LD_LIBRARY_PATH; use the following command syntax to export them:

ORACLE_HOME=/mount_point/product/806

LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/admin/pts_home/client_2.10.0\
/lib

export ORACLE_HOME LD_LIBRARY_PATH

After configuring the files, log in as the apps user on the PTS client machine.

Using the following command syntax, apply a patch:

$ cd /admin/pts_home/client_2.10.0/bin
$ ./process_request.sh -environment=environment -action=patch

Unified Serviceability Interface

The Unified Serviceability Interface is a GUI that enables you to run a variety of tools that automate basic administration tasks.

When you start the Unified Serviceability Interface, the Login page appears. Perform the following steps to run the administration tools:

Log in with your user name and password.
Click Next. The window Change instance appears.
Select the target instance from the list.

The instance that you select appears in the upper left hand corner or each window.

Note:
You can change the instance at any time by using the Change Instance tab.
Click the Tools tab.
In the Tools window, select one of the following tool categories:
- DB Tier
- Apps Tier
- System Tier
- Bookmarks
In the choice boxes, select the tools that you want to run. The tools start running as soon as you make your selection.

Some tools generate graphs as part of their output. The tools that require additional information display a series of choices on screen. Refresh your browser to generate or update the output for long reports.

If the report is long, then the buttons Next and Prev appear. Use the buttons as needed to view all of the report pages.

Unified Serviceability Interface Tabs

Table 4-2 describes the function of each tab.

Table 4-2 Unified Serviceability Interface Tabs

Tab	Description
Login	Enables you to log in using your username and password.
Use Tool	Enables you to select one of the following categories of tools that you want to use: DB Tier - Tools that give you information about the database. Apps Tier - Tools that give you information about the applications. System Tier - Tools that give you information about the operating system Bookmarks - Tool that enables you to add a list of important bookmarks. These can include links to other tools and resources. Bookmarks are not specific to a particular user. All users can view these bookmarks. Oracle Corporation does not audit the bookmarks that you select.
View Status	Enables you to sort tool report information in one of the following ways: By Date - Shows audit trail of reports, sorted chronologically. By Machine - Sorts by machine. By Tool - Sorts by all executions of a given tool. All - Shows a complete history, with the last execution shown first.
Admin	Enables you to perform the following administration tasks for the Unified Serviceability Interface: Modify Passwords - Modify your password. Add Users - Adds users, creating new user names and passwords. When creating a new user, administrators can restrict users to certain tools. By default, users have access to all tools. Administrators can restrict users by selecting tools form a list. The tool asks for the administrative password for security. View Server Log - Administrators can view a server log which shows starting and stopping events and other activities. Maintain Bookmarks - Administrators can maintain bookmarks (these bookmarks are added to all user accounts).
Change Instance	Enables you to change the instance against which you want to run the tools.
Logout	Log out.