Previous  Next          Contents   Library Product

Oracle Workflow Server Installation

Attention: If you already have a previous Release 2.0.3 or 2.5 version of Oracle Workflow installed, do not use these steps to perform a fresh install. If you do a fresh install, your server will not be correctly upgraded. Instead, follow the steps to upgrade your server to Release 2.5.2. See: Oracle Workflow Server Upgrade.

Note: We use the following typeface to represent commands that you enter, where any variable input is enclosed in brackets and is italicized:

			cd <workflow_top_directory>

Step 1. Install Oracle Workflow Server using the Oracle Universal Installer.

Run the Oracle Universal Installer to create your database, install Oracle Net8, and install Oracle Workflow. Refer to the Oracle8i Installation Guide for your platform for detailed instructions on running the Oracle Universal Installer.

To install Oracle Workflow with the Oracle Universal Installer, select the product Oracle8i Management and Integration Infrastructure. Then select the Oracle Integration Server installation type. Oracle Workflow is included in this installation type.

Note: When you choose the Oracle Integration Server installation type, Oracle Workflow is installed in US and in the Installer's base language. You can also choose the Custom installation type and select Oracle Workflow from the available product components. When you choose the Custom installation type, you can specify a separate language for the installation by clicking the Product Languages button, and Oracle Workflow will be installed in that language if it is available.

The Oracle Universal Installer automatically creates an Oracle Workflow database account to which the Oracle Workflow database objects are installed. The new account has the following properties:

Attention: Oracle Workflow is only installed automatically if you install it at the same time as you create your database. If you run the Oracle Universal Installer to install Oracle Workflow on an existing database, then the Oracle Universal Installer only copies the Oracle Workflow files to your file system; it does not automatically run those files to perform the installation. You must manually run an installation/upgrade script to complete the installation. This precaution helps ensure that any previous installation of Oracle Workflow in an existing database is upgraded correctly. See: Oracle Workflow Server Upgrade.

To verify the status of your Oracle Workflow installation after running the Oracle Universal Installer, you can run a script called wfver.sql. This script is located in the admin/sql subdirectory of the Workflow directory within your ORACLE_HOME. Connect to your Workflow database account (OWF_MGR) using SQL*PLUS to run the script. Refer to the Workflow Administration Scripts chapter in the Oracle Workflow Guide for more information.

You can also verify your installation by checking the log file called workflow.log in the Workflow directory within your ORACLE_HOME.

Note: If you are installing Oracle Workflow into multiple accounts or databases from the same Workflow home, use the installation/upgrade script to perform these installations. In this way you can ensure that any patches or customizations you have applied to your Workflow home are included in subsequent installations.

You can run the script to complete the installation of Oracle Workflow on an existing database in two ways: either as an operating system script or as a Java program.

To run the installation script as an operating system script, use the following commands:

On UNIX:

$ORACLE_HOME/wf/install/inst252 <wf_account_name> <wf_password> <wf_home> <sys_password> <system_password> <INSTALL|UPGRADE>

On Windows NT:

\<ORACLE_HOME>\wf\install\inst252.bat <wf_account_name> <wf_password> <wf_home> <sys_password> <system_password> <INSTALL|UPGRADE>

Replace the variables with your parameters as follows:

When you install Oracle Workflow at the same time as you create your database, the Oracle Universal Installer uses the following parameters to automatically complete the installation:

To run the installation script as a Java program, use the following commands:

On UNIX:

$ORACLE_HOME/wf/install/inst252j

On Windows NT:

\<ORACLE_HOME>\wf\install\inst252j.bat

The script prompts you to enter the installation type you want to perform. Enter INSTALL to perform a fresh installation of Oracle Workflow or UPGRADE to upgrade an existing installation of Oracle Workflow.

Note: If you want to upgrade a previous installation of Oracle Workflow, enter UPGRADE as the installation type and follow the instructions to perform an upgrade. See: Oracle Workflow Server Upgrade.

Step 2. Edit the database init.ora parameter file.

Before you begin using Oracle Workflow, you must enable the time manager process in Oracle8 Advanced Queues by adding the following line to the init.ora parameter file:

	AQ_TM_PROCESSES=1

Restart your database to make this change effective.

The time manager process is required by Oracle Workflow to monitor delay events in queues, as in the case of the Oracle Workflow standard Wait activity.

Step 3. Install and configure your Web server.

Oracle Workflow Option requires that you integrate with one of three possible Web server options: Oracle WebDB 2.0 or higher, Oracle Application Server 4.0.7 or higher, or Oracle Web Application Server 3.0.1 or higher. These Web server options are available separately from Oracle Corporation. Each product includes its own installation and reference documentation. Your Web server installation must be able to access the Oracle Workflow java area, the Oracle Workflow icon area, and the Oracle Workflow HTML help area.

Refer to the instructions pertaining to the Web server option of your choice to perform the appropriate installation steps:

Step 4. Verify your base URL.

To invoke Oracle Workflow's web services, you simply append the appropriate procedure and arguments to your base URL. Once you define your web security and web users, you can verify your base URL by connecting as a valid user to the Oracle Workflow home page:

		http://<server_name>[:<portID>]/<virtual_path>/wfa_html.home

If you are using Oracle WebDB, you can authenticate yourself with a database username and password. When you install Oracle Workflow and its demonstration workflow processes, you also install a demonstration data model that seeds a set of demonstration users in the directory service and creates these same users as database accounts. The users are: sysadmin, wfadmin, blewis, cdouglas, kwalker, and spierson. Their passwords are the same as their usernames.

With Oracle WebDB, you can authenticate your connection to an Oracle Workflow web page with any of these database user names and passwords. Public grants and synonyms were created so that these database accounts have full access to Oracle Workflow's web-based user interface.

Step 5. Set up the Oracle Workflow Monitor and HTML help.

Before you can use the Oracle Workflow Monitor and the Oracle Workflow HTML help, you must extract the help files and add some virtual directory mappings to your web listener. Refer to the following instructions to perform the appropriate installation steps:


         Previous  Next          Contents   Library Product