|
Oracle® BPEL Process Analytics Installation Guide
10g Release 2 (10.1.2) for Solaris Operating Environment (SPARC), Linux x86, and Microsoft Windows B19186-01 |
|
 Previous |
 Next |
|
Oracle® BPEL Process Analytics Installation Guide
10g Release 2 (10.1.2) for Solaris Operating Environment (SPARC), Linux x86, and Microsoft Windows B19186-01 |
|
|
Previous |
Next |
Installation Guide
10g Release 2 (10.1.2) for Solaris Operating Environment (SPARC), Linux x86, and Microsoft Windows
B19186-01
July 2005
This document provides the requirements and procedures for installing Oracle BPEL Process Analytics.
This document contains the following topics:
Oracle BPEL Process Analytics provides business analysts with real-time access to critical business performance indicators within and across Oracle Application Server e-business integration products within an enterprise.
Oracle BPEL Process Analytics components reside in the following locations:
Oracle Application Server middle tier
Oracle BPEL Process Analytics must be installed in the same Oracle home directory as the J2EE and Web Cache installation type of Oracle Application Server 10g Release 2 (10.1.2). The J2EE and Web Cache installation type provides a Web server that enables you to develop and deploy Java 2 Enterprise Edition (J2EE) applications and accelerate Web site performance with Oracle Application Server Web Cache.
Oracle Application Server Metadata Repository
Oracle Application Server Metadata Repository database schema are stored in the Oracle Application Server Metadata Repository.
|
See Also: Oracle BPEL Process Analytics User's Guide for more details about Oracle BPEL Process Analytics components |
Figure 1 shows Oracle BPEL Process Analytics components.
Oracle BPEL Process Analytics can be configured with Oracle Application Server and Oracle Database 10g, or Oracle9i Database release 9.2.0.5.0 or later.
Oracle Database is configured to use the Oracle BPEL Process Analytics schemas (which are prefixed with the string BAM), by running the Integration Repository Creation Assistant (IRCA) described in "Run the Integration Repository Creation Assistant (IRCA)".
Table 1 provides an overview of installation tasks to perform, and provides references to procedures for performing these tasks.
Table 1 Installation Overview
| When Installing... | Follow These Steps... | See Also... |
|---|---|---|
| Oracle Database 10g (10.1) or Oracle9i Database release 9.2.0.5.0 |
|
Oracle Database Installation Guide 10g, or
Oracle Database Installation Guide 9i for your platform |
|
|
|
"Run the Integration Repository Creation Assistant (IRCA)"
|
| Oracle Application Server 10g release 10.1.2 |
|
Oracle Application Server Installation Guide for your operating system, and
Oracle Application Server Upgrade and Compatibility Guide |
|
|
|
"Installation Tasks for Oracle BPEL Process Analytics"
|
Table 2 describes the system requirements for Oracle BPEL Process Analytics.
Table 2 Oracle BPEL Process Analytics System Requirements
| Element | Requirements |
|---|---|
| Operating system |
|
| Disk space |
|
| Temp space | 150 MB |
| Memory | 512 MB RAM minimum (1 GB preferred) |
| Swap space | 1535 MB minimum |
| Monitor | Configured to display at least 256 colors |
| Large display settings | If you configure your Microsoft Windows environment to use display settings of large fonts and large-size DPI settings (120 DPI), then you must configure Oracle BPEL Process Analytics after installation. This ensures that all user interface elements correctly display in Oracle BPEL Process Analytics. |
|
Note: Throughout this chapter, Sun SPARC Solaris and Red Hat Enterprise Linux AS/ES are collectively referred to as Unix. Similarly, Microsoft Windows 2000, Microsoft Windows XP, and Microsoft Windows Server 2003 are collectively referred to as Microsoft Windows. |
To install Oracle BPEL Process Analytics, the following products must be installed:
Oracle Database 10g, or Oracle9i Database release 9.2.0.5.0 or later
Oracle Application Server 10g Release 2 (10.1.2)
|
See Also: "Preinstallation Tasks for Oracle BPEL Process Analytics" for notes about these installations |
Table 3 lists the supported Web browsers for using the Oracle BPEL Process Analytics Console.
Table 3 Supported Web Browsers
| Operating System | Supported Browser |
|---|---|
| Unix | Netscape 7.0 |
| Microsoft Windows | Internet Explorer 6.0 |
You must complete the preinstallation tasks described in the following sections before installing Oracle BPEL Process Analytics.
Install Oracle Database 10g or Oracle9i Database release 9.2.0.5.0 or later from the Oracle Database CD-ROM. The database can be on the same host, or a different host from where you intend to install Oracle BPEL Process Analytics.
Run the Integration Repository Creation Assistant (IRCA) to create the database user and schemas as described in this section.
|
Note:
|
Copy ircabpa.zip to the host where Oracle Database is installed.
Extract ircabpa.zip to a temp directory on the host system, being sure to preserve the path information.
From a command window or xterm, run ircabpa.bat on Microsoft Windows or ircabpa.sh on Unix.
IRCA starts and prompts you for information.
Provide the database details, as shown in the following table, when prompted:
| Prompt | Description | Example |
|---|---|---|
| Enter Database Oracle Home: | Your ORACLE_HOME
|
C:\OraHome_1\
|
Enter JDK 1.4 location <default path>:
|
Accept the default path for the Oracle Database. Otherwise, if you downloaded JDK 1.4 separately, then give its location. | C:\oracle\product\10.1.0\Db_1\jdk
|
| Enter database host [localhost]: | The full name or IP address of your database host. | hr1-pc.us.acme.com
or
|
| Enter database port [1521] | The database listener port. | 1521
|
| Enter database service name [orcl] | The service name that you specified when you installed the database.
Note that this is not the SID. If you are not sure, then run the SQL*Plus command |
orcl
or
|
| Enter sys password: | The database sys user password. | 8x9cv55
|
Install Oracle Application Server 10g Release 2 (10.1.2).
|
Important: Use Oracle Application Server 10g Release 2 (10.1.2) software only. |
You must install the Oracle Application Server 10g Release 2 (10.1.2) on the same host where you intend to install the Oracle BPEL Process Analytics.
Select Oracle Application Server from the Select a Product to Install screen of the installation.
Be sure to note the port number at which you can access the Oracle Application Server main page. This information is presented at the end of the Oracle Application Server installation.
|
See Also: Oracle Application Server Installation Guide for more information on this installation procedure |
The following steps describe how to install Oracle BPEL Process Analytics:
Ensure that all preinstallation tasks and requirements described in "Preinstallation Tasks for Oracle BPEL Process Analytics" have been completed.
Log on to the host on which you installed the J2EE and Web Cache installation type of Oracle Application Server.
Insert the Oracle BPEL Process Analytics CD-ROM.
Start the Oracle Universal Installer from the root of the CD-ROM or from the Disk1 directory:
| On... | Do This... |
|---|---|
| Unix | Enter the following command at the operating system prompt:
|
| Microsoft Windows | Click setup.exe.
|
The Welcome screen appears.
Click Next.
Note: If your host is detected to be part of a cluster, the Specify Hardware Cluster Installation Mode screen appears. Select Noncluster Installation. This installs Oracle BPEL Process Analytics on this node only, and not as part of a cluster node. Do not select Cluster Installation.
The Specify File Locations screen appears.
In the Destination fields, select the Oracle home name and directory path where Oracle Application Server 10.1.2 J2EE and Web Cache is located.
Do not accept the default Name and Path. The installer looks for the Oracle Application Server 10.1.2 J2EE and Web Cache instance. (The Dependencies alert will appear, if you specify an incorrect path.) An example is:
Name: oracleas1 Path: $/OraHome_1
Do not change the directory path in the Source field. This is the location of Oracle BPEL Process Analytics installation files.
Click Next.
The Specify Instance Repository Information screen appears.
In the Specify Instance Repository Information screen, provide the information as described in the following table:
| Information | Example |
|---|---|
| Password for Oracle BPA Schema (BAM): | bam
|
| Hostname:Port | my-pc.acme.com:1521
or
|
| Service Name: | orcl
|
| ias_admin Password: | *******
|
The ias_admin password is the password for the Oracle Application Server middle tier in which you are installing Oracle BPEL Process Analytics. You specified this password when you installed Oracle Application Server with J2EE and Web Cache.
Click Next. (Note that it takes a few minutes for the database schema to load.)
The Summary screen appears.
|
Note: If you receive the following error when you click Next, it may be because the system account is locked. You can unlock the system account by connecting to the instance repository asSYSDBA and issuing the SQL ALTER USER SYSTEM ACCOUNT UNLOCK command.
|
Click Install.
The Installation Progress screen appears for a few seconds, and then the Configuration Assistants screen appears and lists the following configuration assistants:
Oracle BPA Configuration Assistant
OPMN Configuration Assistant
Register DCM Plug Ins with EM
Enterprise Manager Agent Configuration Assistant
Enterprise Manager Web Site Configuration Assistant
When the configuration assistants have succeeded, the End of Installation screen appears.
Click Exit and Yes.
For the full log of installation details, see the file named installActionsdate_time.log file, where date_time is the date and time at which the log file was created, and is specified as yyyy-mm-dd_hr-mm-ss.
This file is located in one of the following directories, where C: is the Microsoft Windows system drive and UserHomeDirectory is the Unix user home directory:
On Microsoft Windows:
C:\Program Files\Oracle\Inventory
On Unix:
$UserHomeDirectory/Oracle/oraInventory/logs
This completes the installation procedures. You should now verify the installation, as described in "Postinstallation Verification Tasks for Oracle BPEL Process Analytics".
This section describes how to verify the Oracle BPEL Process Analytics installation. The steps vary slightly, depending on the operating system used. See one of the following sections for details:
Postinstallation Verification Tasks for Installations on Microsoft Windows
Postinstallation Verification Tasks for Installations on Unix
Verify that you can access Oracle BPEL Process Analytics components by following the steps in this section. Oracle BPEL Process Analytics components can also be started from Oracle Enterprise Manager 10g Grid Control Console.
Check the Oracle home directory, as follows:
If you installed Oracle BPEL Process Analytics into an Oracle Application Server middle tier directory, then check that there is a bam subdirectory. For example:
C:\OraHome_1\integration\bam
If you installed Oracle BPEL Process Analytics into a Database Client or Database home, then check that there is a bam subdirectory. For example:
C:\Oracle\product\10.2.0\Client_1\integration\bam
or
C:\Oracle\product\10.2.0\Db_1\integration\bam
Open the desktop Start menu, click All Programs, choose Oracle - OracleAS home name, and then ensure that there is an entry for Oracle BPEL Process Analytics and that this entry has these options:
BPA Console
BPA Quick Start Guide
BPA User's Guide
Setup BPA Samples
Start BPA Server
Stop BPA Server
Ensure that you can start the Oracle BPEL Process Analytics Server as follows:
On the desktop Start menu, choose All Programs, then Oracle - OracleAS home name, then Oracle BPEL Process Analytics, and then click Start BPA Server.
When the Start BPA Server command window closes, startup is complete.
Ensure that you can open the Oracle BPEL Process Analytics Console and log in as follows:
On the desktop Start menu, choose All Programs, then Oracle - OracleAS home name, then Oracle BPEL Process Analytics, and then click BPA Console.
Your default Web browser opens and displays the login page.
Enter Administrator for the Username and Password and click Login.
Click Logout.
Ensure that you can stop the Oracle BPEL Process Analytics Server, as follows:
On the desktop Start menu, choose All Programs, then Oracle - OracleAS home name, then Oracle BPEL Process Analytics, and then click Stop BPA Server.
|
Note: Use the Oracle Application Server Java Authentication and Authorization Service (JAAS) Provider (JAZN) Administration tool to modify the Administrator password. Do not leaveAdministrator as the default password.
|
Verify that you can access Oracle BPEL Process Analytics components by following the steps in this section. Oracle BPEL Process Analytics components can also be started from Oracle Enterprise Manager 10g Grid Control Console.
Check the Oracle home directory, as follows:
If you installed Oracle BPEL Process Analytics into an Oracle Application Server middle tier directory, then check that there is a bam subdirectory. For example:
OraHome_1/integration/bam
If you installed Oracle BPEL Process Analytics into a Database Client or Database home, then check that there is a bam subdirectory. For example:
Oracle/product/10.2.0/Client_1/integration/bam
or
Oracle/product/10.2.0/Db_1/integration/bam
Ensure that you can start the Oracle BPEL Process Analytics Server as follows:
From the Oracle Process Manager and Notification Server (OPMN) bin directory in the Oracle home where you installed Oracle BPEL Process Analytics, issue the opmnctl startall command.
Ensure that you can open the Oracle BPEL Process Analytics Console and log in as follows:
Open a Web browser and enter the following URL, where system is the system on which you installed Oracle BPEL Process Analytics and port is the Oracle HTTP Server port for Oracle BPEL Process Analytics:
http://system:port/bam/pages/login.uix
The login page opens.
Enter Administrator for the Username and Password and click Login.
Click Logout.
Ensure that you can stop the Oracle BPEL Process Analytics Server, as follows:
Set the current directory to the Oracle Process Manager and Notification Server (OPMN) bin directory in the Oracle home where you installed Oracle BPEL Process Analytics.
Issue the opmnctl stopall command.
|
Note: Use the Oracle Application Server Java Authentication and Authorization Service (JAAS) Provider (JAZN) Administration tool to modify the Administrator password. Do not leaveAdministrator as the default password.
|
Oracle BPEL Process Analytics is installed into the bam subdirectory under the integration directory of your Oracle home (C:\OAS_Home1\integration\bam on Microsoft Windows, for example). Table 4 lists the directories within the bam subdirectory.
Table 4 Directories Within the bam Subdirectory
Follow these instructions to deinstall Oracle BPEL Process Analytics.
Stop Oracle BPEL Process Analytics.
Start Oracle Universal Installer.
Click Deinstall Products and in the Installed Products screen, scroll to the Oracle home where Oracle BPEL Process Analytics is installed, and expand the structure.
Select the check box for Oracle BPEL Process Analytics.
Click Remove.
Click Yes when prompted.
Delete the bam directory in the following location, where ORACLE_HOME is the directory specification for the Oracle home where you installed Oracle Application Server:
On Microsoft Windows:
ORACLE_HOME\integration\bam
On Unix
ORACLE_HOME/integration/bam
If any of the following Oracle BPEL Process Analytics processes is running, stop it.
businessProcessMap
contentAgent
eris
KPIOffline
KPIOnline
logService
managedFastStore
metadataService
notify
squirrel
tiancontentservice
tns
usermanager
wsd
This completes the deinstallation procedures for Oracle BPEL Process Analytics.
Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Accessibility standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For more information, visit the Oracle Accessibility Program Web site at http://www.oracle.com/accessibility/.
Accessibility of Code Examples in Documentation
Screen readers may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, some screen readers may not always read a line of text that consists solely of a bracket or brace.
Accessibility of Links to External Web Sites in Documentation
This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.
TTY Access to Oracle Support Services
Oracle provides dedicated Text Telephone (TTY) access to Oracle Support Services within the United States of America 24 hours a day, seven days a week. For TTY support, call 800.446.2398.
Oracle BPEL Process Analytics Installation Guide, Volume 1, 10g Release 2 (10.1.2) for Solaris Operating Environment (SPARC), Linux x86, and Microsoft Windows
B19186-01
Copyright © 2005, Oracle. All rights reserved.
The Programs (which include both the software and documentation) contain proprietary information; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the Programs, except to the extent required to obtain interoperability with other independently created software or as specified by law, is prohibited.
The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. This document is not warranted to be error-free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose.
If the Programs are delivered to the United States Government or anyone licensing or using the Programs on behalf of the United States Government, the following notice is applicable:
U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the Programs, including documentation and technical data, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement, and, to the extent applicable, the additional rights set forth in FAR 52.227-19, Commercial Computer Software—Restricted Rights (June 1987). Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065
The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and we disclaim liability for any damages caused by such use of the Programs.
Oracle, JD Edwards, PeopleSoft, and Retek are registered trademarks of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.
The Programs may provide links to Web sites and access to content, products, and services from third parties. Oracle is not responsible for the availability of, or any content provided on, third-party Web sites. You bear all risks associated with the use of such content. If you choose to purchase any products or services from a third party, the relationship is directly between you and the third party. Oracle is not responsible for: (a) the quality of third-party products or services; or (b) fulfilling any of the terms of the agreement with the third party, including delivery of products or services and warranty obligations related to purchased products or services. Oracle is not responsible for any loss or damage of any sort that you may incur from dealing with any third party.
