Installing the Enterprise Gateway on Windows

Contents

Prerequisites

This document describes how to install the Enterprise Gateway on Windows platforms. Please see the System Requirements to ensure that the target machine is of a suitable specification. For details on Enterprise Gateway components and concepts, see the Oracle Enterprise Gateway Architecture.

Install Executable

Download the Enterprise Gateway install executable for Windows, and double-click to begin installing.

Introductory screen

After double clicking the install executable, you are presented with an introductory screen. Click Next to continue with the installation.

Choose Install Location

Click Browse to specify the directory where you wish to install the Enterprise Gateway. The default directory name is enterprisegateway.

Click Install to install in the specified directory.

Installing

When you click Install, a progress screen is displayed showing the progress of the installation.

Installation Complete

After the installer has finished, an Installation Complete screen is displayed. Click Finish to complete the installation.

Start the Enterprise Gateway

You can start the Enterprise Gateway in the following ways:

  • Console Mode - MS-DOS prompt is visible
  • Windows Services - run the Enterprise Gateway as a Windows Service

Console Mode
Select the following menu options:
Start > Programs > Oracle Enterprise Gateway > Start (console mode)

Windows Services
Select the following menu options:
Start > Programs > Oracle Enterprise Gateway > Service

Choose from the following:

  • Install - install the Enterprise Gateway as a service
  • Start - start the Enterprise Gateway as a service (requires install option to be run first)
  • Stop - stop the Enterprise Gateway as a service
  • Remove - remove the Enterprise Gateway as a service

Windows 7/Vista
On Windows 7 and Windows Vista, when logged in as administrator, you do not have administrator privileges for an application by default, due to Windows User Access Control. To run an application in administrator mode, you must right click the application icon, and select Run as an administrator.

To workaround this issue, you can open a command prompt as an administrator by right clicking the Command Prompt shortcut, and selecting Run as Administrator. If successful, the command prompt title is Administrator: Windows Command Processor. You can then install the service by running the mdce install command.

Important Note:
You can encrypt all sensitive Enterprise Gateway configuration data with an encryption passphrase. For example, you can specify this passphrase in your Enterprise Gateway configuration file, or on the command line when the Enterprise Gateway is starting up. For more details on configuring this passphrase, see Setting the Encryption Passphrase.

Start the Policy Studio

To start the Policy Studio, perform the following steps:

  1. Open a command prompt.
  2. Change to your Policy Studio installation directory.
  3. Start policystudio.

Making a Server Connection
When the Policy Studio starts up, click a link to a server session to display the Open Connection dialog. You can use this dialog to specify Connection Details (for example, host, port, user name, and password), or to specify Saved Sessions.

If you wish to connect to the server using a non-default URL, click Advanced, and enter the URL. The default Enterprise Gateway server URL is:

http://localhost:8090/configuration/deployments/DeploymentService

For more details on the settings in the Open Connection dialog, see Connection Details.