Managing Processes

Contents

Overview

You can manage Oracle server processes using the 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, or edit its connection details. In addition, if Policy Studio is connected to a Policy Center server, you can add and remove Enterprise Gateways in the managed Processes 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 Policy Studio Preferences.

Viewing Process Details

In the 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 name, host, process status (for example, Up or Down), configuration status (for example, Deployed or Out of Sync), version, last changed by, and owner.
Deployment Details Displays the component configuration stores that are deployed on the process (for example, Core Configuration, User Store, and Certificate Store). Details include revision number, owner, last updated by, and log entry.
Connection Details Includes the URL, user name, and password for the process (for example, the default URL for the Enterprise Gateway process is http://localhost:8090/runtime/management/ManagementAgent).

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 Connection tab, specify your updates in the appropriate fields. For example, you might need to update the process URL if you are using a different management port instead of the default 8090. For details on the fields in the Connection tab, 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.

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. The Versioning dialog displays the list of Modified Components that are out of sync on the left (for example, Listener Configuration or Core Configuration).
  2. Enter a Comment to version the specified components in the text area on the right.
  3. You can select the relevant option to apply this comment to all modified components (the default), selected modified components, or all 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). This displays the Versioning dialog, which enables you to version the selected components.