My Oracle Support Banner

HTTP Status: 500 and Error Code 102 When Deploying Policies (Doc ID 1645852.1)

Last updated on JULY 21, 2023

Applies to:

Oracle API Gateway
Information in this document applies to any platform.


This document applies to Oracle API Gateway (OAG) and newer. It does not apply to Oracle Enterprise Gateway and earlier.
This document applies to any scenario where policies are deployed, including actions such as changing the passphrase.

Problem Statement

When deploying policies to one or several Gateway instances, the Node Manager reports an ERROR HTTP 500 and Error code 102 after 120 seconds.

Example error reported in Policy Studio's trace file:

ERROR   <TIMESTAMP> [<THREAD ID>] java exception:
com.vordel.api.nm.NodeManagerAPIException: Node Manager error: Error occurred on call from Node Manager on '<HOSTNAME>' to https:/<HOST>:<PORT> for URL '/api/configuration' and 'PUT'

HTTP status: 500.
Error code: 102.
at com.vordel.api.nm.NodeManagerClient.handleError(
at com.vordel.api.deployment.client.DeploymentClient.deploy(
at com.vordel.client.gui.policystudio.wizards.deploy.SummaryPage$


Example error reported in the Local Node Manager's trace file:

ERROR   <TIMESTAMP> [<THREAD ID>] Error occurred on call from Node Manager on '<HOSTNAME>' to https://<HOSTNAME.DOMAINNAME>:<PORT>' for URL '/api/configuration' and 'PUT'

ERROR   <TIMESTAMP> [<THREAD ID>] Failed to deploy to gateway 'instance-X'. Error: Error: Error occurred on call from Node Manager on '<HOSTNAME>' to https://<HOSTNAME.DOMAINNAME>:<PORT>' for URL '/api/configuration' and 'PUT'
Code: 102.


Example error reported in the Admin Node Manager's trace file:

ERROR   <TIMESTAMP> [<THREAD ID>] Failed to update the passphrase on remote Node Manager 'Node Manager on <HOSTNAME>' 'nodemanager-X' for group '<MYGROUP>' [group-Y]'. Please ensure Node Manager is running. Remote Node Manager returned HTTP status: 500. Remote Node Manager error details: Error: error occurred on call from Node Manager on 'oagtest1' to http://<HOSTNAME.DOMAINNAME>:<PORT>' for URL '/api/deployment/passphrase/local/group/group-X and 'PUT' Code: 102.


Related messages which may occur in the Gateway instance's trace file:

ERROR   <TIMESTAMP> [<THREAD ID>] java exception running circuit:
java.lang.RuntimeException: send failed
at com.vordel.dwe.http.ServerTransaction.sendResponse(Native Method)
at com.vordel.dwe.http.HTTPPlugin.invokeDispose(
at com.vordel.dwe.http.HTTPPlugin.invoke(

These messages indicate that the Gateway instance lost the connection to the Node Manager, most likely because the Node Manager closed the connection when the Node Manager's active timeout was reached.

Potential Causes

  1. Deployment was started successful, but took longer than the configured Node Manager timeout.
    Default Node Manager timeout in and is 120 seconds.
    From the Node Manager timeout alone, it cannot be concluded whether deployment was successful, is still in progress, or was unsuccessful.
  2. Start of deployment was delayed because the Gateway instance was still processing requests.
  3. Deployment failed. For example, in, but not in and newer, policy deployment might fail if any one of the local Node Managers in the domain in down.
  4. Any problem which impacted the connection between Node Manager and Gateway instance
  5. If storing metrics in database is enabled, problems with the connection to the reporting database or slow database response times will increase policy deployment times

Troubleshooting Steps

To view full details, sign in with your My Oracle Support account.

Don't have a My Oracle Support account? Click to get started!

In this Document
 Problem Statement
 Potential Causes
Troubleshooting Steps
 Troubleshooting steps
 Additional information: Policy deployment times

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.