Managing Processes

Contents

Overview

You can manage Oracle server processes using the Oracle Enterprise Gateway Dashboard. Managed processes can include Enterprise Gateway, Policy Center, and Service Monitor processes. For example, you can view process details, change a process owner, edit its connection details, or apply tags. In addition, if the Policy Studio is connected to a Policy Center server, you can add and remove multiple Enterprise Gateways in the managed Process List.

Important Note:
To display the Policy Center server process in the Policy Studio, you must first enable the Show Management Services checkbox in the Policy Studio Preferences dialog. In the Policy Studio main menu, select Windows -> Preferences. For more details, see the topic on Policy Studio Preferences.

Viewing Process Details

In the Oracle Enterprise Gateway Dashboard, when you select a process in the list on the left, the process details are displayed in the following tabs on the right:

Summary Includes the process type, host, process status (for example, Up or Down), configuration status (for example, Deployed or Out of Sync), active tags (for example, DEFAULT_CONFIGURATION), version, last changed by, and owner. You can also click the Connection Details link at the bottom to view details such as the URL, user name, and password for the process.
Advanced Displays the component configuration stores that are deployed on the process (for example, Core Configuration, User Store, and Certificate Store). Details include revision number, created by, and log entry.

Adding a New Process

If Policy Studio is connected to the Policy Center server, you can add new processes to the list of deployed processes. You can not add new processes if Policy Studio is connected to the Enterprise Gateway or Service Monitor server.

When connected to a Policy Center server, to add a new process deployment, perform the following steps:

  1. Click the Add Process button at the top right of the Process List.
  2. In the Add a New Process dialog, complete the following fields:

    3. Host Specify the host to connect to in this field. The default is localhost.
    Port Specify the port to connect on in this field. The default Enterprise Gateway port is 8090. The default Enterprise Gateway port is 8060.
    Username Policy Studio must authenticate to the Process using HTTP basic authentication. Specify the user name for this purpose.
    Password Specify the password for this user.

  3. If you wish to explicitly set the URL on which the process is managed, click Advanced, and enter the URL for the process. The default URL for the Enterprise Gateway process is http://HOST:8090/runtime/management/ManagementAgent, where HOST is the IP address or hostname on which the Process is running. For more details, see Show Management Services.
  4. Click OK.

Removing a Process

You can remove a process from the list of deployed processes. To remove a process, perform the following steps:

  1. Select the process in the Process List.
  2. Right-click, and select Remove Process.
  3. Click Yes.

This removes the process from the Process List permanently. The process is no longer contacted, and continues to run with its most recently deployed configuration.

Changing a Process Owner

You can transfer ownership of a process to another user. To change a process owner, perform the following steps:

  1. On the Summary tab, beside the Owner field, click Change.
  2. In the Change Owner dialog, select a user from the drop-down list.
  3. Click OK.

Editing Connection Details

You can update the deployment URL and the user credentials used by the Enterprise Gateway to authenticate to the process. To edit the connection details, perform the following steps:

  1. On the Summary tab, click the Connection link, and specify your updates in the appropriate fields. For example, the default URL for the Enterprise Gateway process is http://localhost:8090/runtime/management/ManagementAgent. You might need to update this if you are using a different management port instead of 8090. For details on configuring these fields, see Adding a New Process.
  2. Click Save.

Versioning Process Configuration

If you have edited an active process configuration, and deployed updates to the server without versioning, the Configuration Status for the selected process is displayed as Out of Sync on the Summary tab.

Note:
By default, the entire process configuration is versioned as a single unit. You can also select to version the process configuration as individual components. For more details, see the Version Settings in the Policy Studio Preferences.

To version the configuration of a selected process, perform the following steps:

  1. Click the Version Configuration link on the right of the Summary tab. Alternatively, right-click the process in the Process List, and select Version Configuration.
  2. Enter a Comment to version the configuration in the Versioning dialog.
  3. If you selected to version the process configuration as individual components in the Policy Studio Preferences, select whether to apply this comment to all modified components (the default), or to apply individual comments to selected modified components.
  4. Click Yes to finish.

The Configuration Status for the selected process is now displayed as Deployed on the Summary tab, and the Version Configuration link is no longer displayed. On the Deployment Details tab, the Revision number of the components that were out of sync is updated to the latest version, and the Comment entered in the Versioning dialog is also displayed.

When editing an active process configuration, you can also version deployed updates directly by clicking the Version button in the toolbar (alternatively, press F7) to display the Versioning dialog.

Deploying Configuration to a Process

You can select a process and view the versions of the component configuration stores that are currently running on that process. You can also change the currently deployed versions, and deploy updates to a server process or multiple processes. For more details, see the topic on Managing Configuration Profiles.

Deploying Configuration Tags

A configuration tag is a label that specifies a collection of Enterprise Gateway component configuration versions. You can select a tag and deploy it on a Enterprise Gateway process. You can also deploy tags on selected component configuration versions only. For more details, see the topic on Deploying Configuration Tags.