Section - 5 : Installing the Docupresentment Client


You can install the Docupresentment Client on Windows by downloading it from the Internet. To download shared objects from the Internet, go to the Oracle Software Delivery Cloud site at:

https://edelivery.oracle.com/

After you download and save the Docupresentment Client installation to the proper location, start the Docupresentment Client setup wizard

ODDC12.6.2.####W32.exe (where #### represents the build number) as that is the name of the installer.

  1. Once the setup routine starts, follow the instructions which appear on your screen.

    Image represents welcome screen to setup wizard.
    Figure 2.5.1 - Welcome Screen
  2. Close all open applications then click Next to continue. The Select Destination Directory window appears.

  3. Click Browse to select the directory into which you want to install the Docupresentment Client and click Next to continue.

    The Select Components window appears.

    Image represents selecting setup directory.
    Figure 2.5.2 - Selecting Destination Directory
  4. Choose the components you want to install and click Next to continue.

    Image represents selecting components.
    Figure 2.5.3 - Selecting Components

The installation routine installs the Docupresentment Client, then shows the Select queuing System window. See Selecting a queuing Method for more information.

Selecting a queuing Method

Use the Select a queuing System window to optionally configure your Docupresentment Client queuing method. The wizard modifies the Docupresentment Client to communicate with one of these queuing systems:

  • HTTP
  • ActiveMQ
  • IBM MQ or WebSphere MQ or
  • MSMQ

Note: You can also choose to set up a queuing system other than the ones pre-defined in the installer. Be aware that if you choose this option, you must make sure the queuing system is accessible by the Docupresentment Client.

Choose the queuing method you want to use on the Select a queuing System window:

Image represents setting up queueing system.
Figure 2.5.4 - Setting up queuing system

Click Next.

A configuration wizard lets you enter queue-specific information for each queuingqueuing method. The default queue is HTTP.

Using HTTP

If chose HTTP queues, the Configure the HTTP queuing System window appears:

Image represents configuring HTTP queueing system
Figure 2.5.5 - Configuring HTTP Queueing System

For HTTP queues, enter the Server Address and Port Number of the Docupresentment Server and click Next.

Using ActiveMQ

If you chose ActiveMQ, the Configure the ActiveMQ queuing System window appears:

Image represents configuring ActiveMQ queueing system.
Figure 2.5.6 - Configuring ActiveMQ Queueing System

For ActiveMQ queues, enter the Input Queue and Output Queue for the ActiveMQ Server and click Next.

Using WebSphere MQ

If you chose WebSphere MQ, the Configure the WebSphere MQ queuing System window appears:

Image represents configuring WebSphere MQ queueing system.
Figure 2.5.7 - Configuring WebSphere MQ Queueing System

For WebSphere MQ queues, you can choose to use Bindings Mode.

To Then
Use Bindings Mode Make sure the Bindings Mode field is checked, then specify the Input Queue, Output Queue, and the Queue Manager for the WebSphere MQ Server.
Not use Bindings Mode Uncheck the Bindings Mode field and specify the Server Address, Port, Queue Channel, Input Queue, Output Queue, and the Queue Manager for the WebSphere MQ Server.

When finished entering the necessary fields, click Next.

Using MSMQ

If you chose MSMQ, the Configure the MSMQ queuing System window appears:

Image represents configuring MSMQ queueing system.
Figure 2.5.8 - Configuring MSMQ Queueing System

Setting up another queue

If you choose to set up another queuing system, the following message appears to remind you to take the steps necessary to make your queuing system accessible by the Docupresentment Client.

Image represents setup dialog.
Figure 2.5.9 - Setup Dialog

Testing Your Connection

To make sure the Docupresentment Client can connect to the Docupresentment Server, click the Test Connection button.

Image represents testing client connection screen.
Figure 2.5.10 - Testing Client Connection

Note: Docupresentment Server and the queuing system you chose have to be running to test the Docupresentment Client.

If the test is successful, the below message appears “connection to Docupresentment Server Successful”.

Image represents successful setup dialog.
Figure 2.5.11 - Successful Setup Dialog

This window indicates that the Docupresentment Client is configured correctly and is successfully communicating with the Docupresentment Server. Click Ok, then click Next.

The Complete Installation window appears. Click Finish to complete the installation.

Congratulations, you have installed the Docupresentment Server, Shared Objects, and Docupresentment Client Now proceed to the next topic, Testing Your Installation.

Image represents completed installation screen.
Figure 2.5.12 - Completed Installation