{"id":48141,"date":"2026-11-09T07:22:12","date_gmt":"2026-11-09T06:22:12","guid":{"rendered":"https:\/\/www.dbi-services.com\/blog\/?p=48141"},"modified":"2026-11-09T07:22:27","modified_gmt":"2026-11-09T06:22:27","slug":"goldengate-distribution-path-profile-in-23-26-4-0-0","status":"publish","type":"post","link":"https:\/\/www.dbi-services.com\/blog\/goldengate-distribution-path-profile-in-23-26-4-0-0\/","title":{"rendered":"GoldenGate distribution path profile in 23.26.4.0.0"},"content":{"rendered":"\n

In a previous post about updating the profiles of all extracts and replicats at once<\/a>, I wrote that a profile does not apply to distribution paths. With GoldenGate 23.26.4.0.0<\/code>, that is no longer true<\/strong>. When looking at the help of ADD DISTPATH<\/code> in the adminclient<\/code>, it shows a new PROFILE<\/code> clause:<\/p>\n\n\n\n

OGG (http:\/\/oggall:7809 ogg_test_01) 2> HELP ADD DISTPATH\n\nADD DISTPATH\n\nSyntax:\n| ADD DISTPATH <path-name>\n|          SOURCE <source-uri>\n|          TARGET <target-uri> [ TARGETTYPE ( MANAGER | COLLECTOR | RECVSRVR ) ]\n|                  [ AUTHENTICATION (  OAUTH \n|                                   | ( CERTIFICATE <certificate-name> ) \n|                                   | ( USERIDALIAS <alias> [ DOMAIN <domain> ] ) \n|                                   ) \n|                  ] \n|          [ ENCRYPTIONPROFILE <encryption-profile> ]\n|          [ PROFILE <profile-name> ]<\/code><\/pre>\n\n\n\n
A distribution path or a receiver path can now take a managed process profile for its auto-restart settings. The REST property is called managedPathSettings<\/code>, and its value is the profile name. An extract uses managedProcessSettings<\/code> with a prefixed name, so the two properties are not the same. The client argument managed_path_settings<\/code> arrived with oggrestapi<\/code> 1.0.4<\/a>. The profile itself is the same object: a path, an extract and a replicat read it from the same ogg:managedProcessSettings<\/code> object. In this blog, I test this new feature in the REST API, the adminclient<\/code> and the web UI.<\/p>\n\n\n\n
Before: 23.26.3.0.0<\/code> refuses a profile on a path<\/h2>\n\n\n\n
On a deployment running 23.26.3.0.0<\/code>, a path only takes explicit auto-restart options. The REST API rejects the new property. I create the profile with oggrestapi.py<\/code><\/a>, then create a new path that uses it.<\/p>\n\n\n\n
import json\n\nfrom oggrestapi import OGGRestAPI\n\nclient = OGGRestAPI(\n    url='http:\/\/oggall:7809',\n    username='ogg',\n    password='ogg',\n    deployment='ogg_test_01',\n    auto_discovery=True,\n)\n\ntemplate = client.get_distribution_path('path5')\nsource, target = template['source'], template['target']\nbegin = {'sequence': 0, 'offset': 0}\n\nclient.create_managed_process_profile(\n    'PathProfile',\n    auto_restart=True,\n    restart_delay=30,\n    restart_retries=5,\n)\n\nclient.create_distribution_path(\n    'path1',\n    source=source,\n    target=target,\n    begin=begin,\n    status='stopped',\n    managed_path_settings='PathProfile',\n)<\/code><\/pre>\n\n\n\n
The server answers with a 400<\/code> error, OGG-12108<\/code>.<\/p>\n\n\n\n
RuntimeError: ERROR (code 400) - http:\/\/oggall:7811\/services\/v2\/sources\/path1: JSON element '\/' has an invalid additional property, 'managedPathSettings'<\/code><\/pre>\n\n\n\n
The adminclient<\/code> of the same release has no PROFILE<\/code> clause either. With the ADD DISTPATH<\/code> command:<\/p>\n\n\n\n
ADD DISTPATH path4 SOURCE trail:\/\/vmogg1:7811\/services\/v2\/sources?trail=dl TARGET ws:\/\/vmogg2:7812\/services\/v2\/targets?trail=dq AUTHENTICATION USERIDALIAS recv02 DOMAIN OracleGoldenGate PROFILE PathProfile<\/code><\/pre>\n\n\n\n
It answers with an error.<\/p>\n\n\n\n
OGG> ADD DISTPATH path4 SOURCE trail:\/\/vmogg1:7811\/services\/v2\/sources?trail=dl TARGET ws:\/\/vmogg2:7812\/services\/v2\/targets?trail=dq AUTHENTICATION USERIDALIAS recv02 DOMAIN OracleGoldenGate PROFILE PathProfile\n\nError: Unexpected value 'PROFILE PathProfile'.<\/code><\/pre>\n\n\n\n
The web UI has the same limit. Edit Managed Options<\/strong> on a path shows Autorestart Retries<\/code> and an Autorestart Delay<\/code> in minutes, with no profile selector.<\/p>\n\n\n
\n
\"\"<\/figure>\n<\/div>\n\n\n
Starting with 26.4<\/code>: paths accept profiles<\/h2>\n\n\n\n
After the patch, the same call succeeds. The response of a successful call is long, so I only show its messages<\/code>.<\/p>\n\n\n\n
>>> client.create_distribution_path(\n...     'path1',\n...     source=source,\n...     target=target,\n...     begin=begin,\n...     status='stopped',\n...     managed_path_settings='PathProfile',\n... )['messages']\n[{'$schema': 'ogg:message', 'title': \"The path 'path1' has been added.\", 'code': 'OGG-08511', 'severity': 'INFO', 'issued': '2026-10-25T16:12:42Z', 'type': 'https:\/\/docs.oracle.com\/en\/middleware\/goldengate\/core\/23.26\/error-messages\/'}]\n\n>>> print(json.dumps(client.get_distribution_path('path1'), indent=2))\n{\n  \"$schema\": \"ogg:distPath\",\n  \"source\": {\n    \"uri\": \"trail:\/\/vmogg1:7811\/services\/v2\/sources?trail=dl\"\n  },\n  \"target\": {\n    \"uri\": \"ws:\/\/vmogg2:7812\/services\/v2\/targets?trail=dq\",\n    \"authenticationMethod\": {\n      \"domain\": \"OracleGoldenGate\",\n      \"alias\": \"recv02\"\n    }\n  },\n  \"begin\": {\n    \"sequence\": 0,\n    \"offset\": 0\n  },\n  \"status\": \"stopped\",\n  \"managedPathSettings\": \"PathProfile\",\n  \"name\": \"path1\",\n  \"encryptionProfile\": \"LocalWallet\",\n  \"options\": {\n    \"autoRestart\": {\n      \"retries\": 5,\n      \"delay\": {\n        \"delaySeconds\": 30\n      }\n    }\n  }\n}<\/code><\/pre>\n\n\n\n
The path stores the profile name<\/strong> and reads the restart settings from the profile. The options.autoRestart<\/code> object of the response is the profile as the path uses it. The profile delay is in seconds, so the path now reports delaySeconds<\/code>.<\/p>\n\n\n\n
What the REST API accepts and refuses<\/h2>\n\n\n\n
A profile and explicit options exclude each other<\/h3>\n\n\n\n
A path takes either a profile or explicit auto-restart options. A request with both is refused with OGG-30812<\/code>, and an unknown profile name with OGG-08122<\/code>. The delay of explicit options is still an integer in minutes.<\/p>\n\n\n\n
>>> common = {'source': source, 'target': target, 'begin': begin, 'status': 'stopped'}\n>>> options = {'autoRestart': {'retries': 3, 'delay': 1}}\n\n>>> client.create_distribution_path('path2', options=options, **common)['messages']\n[{'$schema': 'ogg:message', 'title': \"The path 'path2' has been added.\", 'code': 'OGG-08511', 'severity': 'INFO', 'issued': '2026-10-25T16:12:42Z', 'type': 'https:\/\/docs.oracle.com\/en\/middleware\/goldengate\/core\/23.26\/error-messages\/'}]\n\n>>> client.create_distribution_path(\n...     'path3',\n...     options=options,\n...     managed_path_settings='PathProfile',\n...     **common,\n... )\nRuntimeError: ERROR (code 400) - http:\/\/oggall:7811\/services\/v2\/sources\/path3: Cannot specify both a managed settings profile and explicit auto-restart option values.\n\n>>> client.create_distribution_path('path3', managed_path_settings='NoSuchProfile', **common)\nRuntimeError: ERROR (code 400) - http:\/\/oggall:7811\/services\/v2\/sources\/path3: The managed process settings profile 'NoSuchProfile' does not exist.<\/code><\/pre>\n\n\n\n
An existing path with explicit options takes the profile through an update. The restart options of the path then become the ones of the profile.<\/p>\n\n\n\n
>>> d = client.get_distribution_path('path2')\n>>> (d.get('managedPathSettings'), d['options'])\n(None, {'autoRestart': {'retries': 3, 'delay': 1}})\n\n>>> client.update_distribution_path('path2', managed_path_settings='PathProfile')['messages']\n[{'$schema': 'ogg:message', 'title': \"The path 'path2' has been updated.\", 'code': 'OGG-08512', 'severity': 'INFO', 'issued': '2026-10-25T16:12:43Z', 'type': 'https:\/\/docs.oracle.com\/en\/middleware\/goldengate\/core\/23.26\/error-messages\/'}]\n\n>>> d = client.get_distribution_path('path2')\n>>> (d.get('managedPathSettings'), d['options'])\n('PathProfile', {'autoRestart': {'retries': 5, 'delay': {'delaySeconds': 30}}})<\/code><\/pre>\n\n\n\n
A change of the profile applies to every path that uses it<\/h3>\n\n\n\n
As expected, changing the profile applies to all paths following the profile.<\/p>\n\n\n\n
new = {\n    '$schema': 'ogg:managedProcessSettings',\n    'autoStart': {'enabled': False},\n    'autoRestart': {'enabled': True, 'retries': 7, 'delay': 11, 'window': 60, 'disableOnFailure': True},\n}\n\nclient.update_config_value(\n    type='ogg:managedProcessSettings',\n    value='ogg:managedProcessSettings:PathProfile',\n    data=new,\n)\n\nd = client.get_distribution_path('path1')\n(d.get('managedPathSettings'), d['options'])\n\nd = client.get_distribution_path('path2')\n(d.get('managedPathSettings'), d['options'])<\/code><\/pre>\n\n\n\n
>>> d = client.get_distribution_path('path1')\n>>> (d.get('managedPathSettings'), d['options'])\n('PathProfile', {'autoRestart': {'retries': 7, 'delay': {'delaySeconds': 11}}})\n\n>>> d = client.get_distribution_path('path2')\n>>> (d.get('managedPathSettings'), d['options'])\n('PathProfile', {'autoRestart': {'retries': 7, 'delay': {'delaySeconds': 11}}})<\/code><\/pre>\n\n\n\n
A profile in use cannot be deleted<\/h3>\n\n\n\n
The deletion of a profile that a path uses is refused, and the message names the path.<\/p>\n\n\n\n
>>> client.delete_managed_process_profile('PathProfile')\nRuntimeError: ERROR (code 500) - http:\/\/oggall:7810\/services\/v2\/config\/types\/ogg:managedProcessSettings\/values\/ogg:managedProcessSettings:PathProfile: The managed process settings profile 'PathProfile' is used by distpath 'path1'.<\/code><\/pre>\n\n\n\n
Explicit options replace the profile without a warning<\/h3>\n\n\n\n
An update with explicit auto-restart options on a path that uses a profile succeeds, and the profile is gone<\/strong>. A request with both is refused with OGG-30812<\/code>, but sending only the explicit options is not. managedPathSettings<\/code> is then None<\/code>.<\/p>\n\n\n\n
>>> client.update_distribution_path('path1', options={'autoRestart': {'retries': 2}})['messages']\n[{'$schema': 'ogg:message', 'title': \"The path 'path1' has been updated.\", 'code': 'OGG-08512', 'severity': 'INFO', 'issued': '2026-10-25T16:12:43Z', 'type': 'https:\/\/docs.oracle.com\/en\/middleware\/goldengate\/core\/23.26\/error-messages\/'}]\n\n>>> d = client.get_distribution_path('path1')\n>>> (d.get('managedPathSettings'), d['options'])\n(None, {'autoRestart': {'retries': 2}})<\/code><\/pre>\n\n\n\n
There is no way to clear the property with a null<\/code> or an empty string, as the two next requests show, even when the same request also contains the explicit options. Sending the explicit options alone is the only way back.<\/p>\n\n\n\n
>>> client.update_distribution_path(\n...     'path1',\n...     data={\n...         'managedPathSettings': None,\n...         'options': {'autoRestart': {'retries': 2}},\n...     },\n... )\nRuntimeError: ERROR (code 400) - http:\/\/oggall:7811\/services\/v2\/sources\/path1: JSON element '\/managedPathSettings' is the incorrect type\n\n>>> client.update_distribution_path(\n...     'path1',\n...     data={\n...         'managedPathSettings': '',\n...         'options': {'autoRestart': {'retries': 2}},\n...     },\n... )\nRuntimeError: ERROR (code 400) - http:\/\/oggall:7811\/services\/v2\/sources\/path1: JSON string '\/managedPathSettings' does not meet the minimum required length of 1<\/code><\/pre>\n\n\n\n
Explicit options can now express the delay in seconds, with a delaySeconds<\/code> object, where it used to be an integer in minutes.<\/p>\n\n\n\n
>>> client.update_distribution_path(\n...     'path1',\n...     options={'autoRestart': {'retries': 4, 'delay': {'delaySeconds': 45}}},\n... )['messages']\n[{'$schema': 'ogg:message', 'title': \"The path 'path1' has been updated.\", 'code': 'OGG-08512', 'severity': 'INFO', 'issued': '2026-10-25T16:12:43Z', 'type': 'https:\/\/docs.oracle.com\/en\/middleware\/goldengate\/core\/23.26\/error-messages\/'}]\n\n>>> d = client.get_distribution_path('path1')\n>>> (d.get('managedPathSettings'), d['options'])\n(None, {'autoRestart': {'retries': 4, 'delay': {'delaySeconds': 45}}})<\/code><\/pre>\n\n\n\n
Receiver paths<\/h3>\n\n\n\n
A receiver path created by the target, with target_initiated<\/code> set to true, takes the same argument. OGG-30812<\/code> applies to it too.<\/p>\n\n\n\n
>>> client.create_receiver_path(\n...     'path6',\n...     target_initiated=True,\n...     source={\n...         'uri': 'ws:\/\/vmogg1:7811\/services\/v2\/sources?trail=dl',\n...         'authenticationMethod': {'domain': 'OracleGoldenGate', 'alias': 'recv02'},\n...     },\n...     target={'uri': 'trail:\/\/vmogg2:7812\/services\/v2\/targets?trail=rp'},\n...     begin=begin,\n...     status='stopped',\n...     managed_path_settings='PathProfile',\n... )['messages']\n[{'$schema': 'ogg:message', 'title': \"The path 'path6' has been added.\", 'code': 'OGG-08511', 'severity': 'INFO', 'issued': '2026-10-25T16:12:43Z', 'type': 'https:\/\/www.rfc-editor.org\/rfc\/rfc9110.html#name-status-codes'}]\n\n>>> d = client.get_receiver_path('path6')\n>>> (d['managedPathSettings'], d['options'])\n('PathProfile', {'autoRestart': {'retries': 7, 'delay': {'delaySeconds': 11}}})\n\n>>> client.create_receiver_path(\n...     'path7',\n...     target_initiated=True,\n...     source={\n...         'uri': 'ws:\/\/vmogg1:7811\/services\/v2\/sources?trail=dl',\n...         'authenticationMethod': {'domain': 'OracleGoldenGate', 'alias': 'recv02'},\n...     },\n...     target={'uri': 'trail:\/\/vmogg2:7812\/services\/v2\/targets?trail=rp'},\n...     begin=begin,\n...     status='stopped',\n...     managed_path_settings='PathProfile',\n...     options={'autoRestart': {'retries': 2, 'delay': {'delaySeconds': 5}}},\n... )\nRuntimeError: ERROR (code 400) - http:\/\/oggall:7812\/services\/v2\/targets\/path7: Cannot specify both a managed settings profile and explicit auto-restart option values.<\/code><\/pre>\n\n\n\n
adminclient<\/code> syntax<\/h2>\n\n\n\n
The PROFILE<\/code> clause is available in ADD DISTPATH<\/code>, ALTER DISTPATH<\/code> and ADD RECVPATH<\/code>. INFO DISTPATH<\/code> shows it as Settings Profile<\/code>.<\/p>\n\n\n\n
ADD DISTPATH path4 SOURCE trail:\/\/vmogg1:7811\/services\/v2\/sources?trail=dl TARGET ws:\/\/vmogg2:7812\/services\/v2\/targets?trail=dq AUTHENTICATION USERIDALIAS recv02 DOMAIN OracleGoldenGate PROFILE PathProfile\nINFO DISTPATH path4\nALTER DISTPATH path4 PROFILE NoSuchProfile\nALTER DISTPATH path2 PROFILE RestartFast\nINFO DISTPATH path2<\/code><\/pre>\n\n\n\n
OGG> ADD DISTPATH path4 SOURCE trail:\/\/vmogg1:7811\/services\/v2\/sources?trail=dl TARGET ws:\/\/vmogg2:7812\/services\/v2\/targets?trail=dq AUTHENTICATION USERIDALIAS recv02 DOMAIN OracleGoldenGate PROFILE PathProfile\n\n13:44:28Z  INFO    OGG-08511  The path 'path4' has been added.\n\nOGG> INFO DISTPATH path4\n\n Path Name: path4\n Status: stopped\n Source URI: trail:\/\/vmogg1:7811\/services\/v2\/sources?trail=dl\n Target URI: ws:\/\/vmogg2:7812\/services\/v2\/targets?trail=dq\n Authentication Method: USERIDALIAS recv02 domain OracleGoldenGate\n Settings Profile: PathProfile\n Encryption Profile: LocalWallet\n\nOGG> ALTER DISTPATH path4 PROFILE NoSuchProfile\n\n13:44:28Z  ERROR   OGG-08122  The managed process settings profile 'NoSuchProfile' does not exist.\n\nOGG> ALTER DISTPATH path2 PROFILE RestartFast\n\n13:44:28Z  INFO    OGG-08512  The path 'path2' has been updated.\n\nOGG> INFO DISTPATH path2\n\n Path Name: path2\n Status: stopped\n Source URI: trail:\/\/vmogg1:7811\/services\/v2\/sources?trail=dl\n Target URI: ws:\/\/vmogg2:7812\/services\/v2\/targets?trail=dq\n Authentication Method: USERIDALIAS recv02 domain OracleGoldenGate\n Settings Profile: RestartFast\n Encryption Profile: LocalWallet<\/code><\/pre>\n\n\n\n
PROFILE<\/code> cannot be combined with OPTIONS AUTORESTART<\/code> in the same command, which matches OGG-30812<\/code>. With ALTER DISTPATH path4 OPTIONS AUTORESTART RETRIES 1 PROFILE PathProfile<\/code>, the adminclient<\/code> answers Error: Unexpected value 'PROFILE PathProfile'.<\/code><\/p>\n\n\n\n
Web UI: create a profile, then assign it<\/h2>\n\n\n\n
The Edit Managed Options<\/strong> panel of a path has a Profile Name<\/code> selector in 23.26.4.0.0<\/code>. Here is the state before creating a profile. The field shows Custom<\/code>, which is the explicit options of the path, and the list below it has the existing profiles.<\/p>\n\n\n
\n
\"\"<\/figure>\n<\/div>\n\n\n
Let\u2019s create a profile in the Managed Process Profiles<\/strong> page, with 3 retries, a retry delay of 20 seconds and a window of 2 minutes. The text of the panel still says that the profile is for extracts and replicats, but a path accepts it.<\/p>\n\n\n
\n
\"\"<\/figure>\n<\/div>\n\n\n
The new profile appears in the Profile Name<\/code> list of the path, after PipeProfile<\/code>.<\/p>\n\n\n
\n
\"\"<\/figure>\n<\/div>\n\n\n
Select SlowRestart<\/code> and submit. Path Information<\/strong> now shows the profile name, with the auto-restart settings of the profile:<\/p>\n\n\n
\n
\"\"<\/figure>\n<\/div>\n\n\n
The REST API returns the same state.<\/p>\n\n\n\n
>>> d = client.get_distribution_path('path8')\n>>> (d.get('managedPathSettings'), d['options'])\n('SlowRestart', {'autoRestart': {'retries': 3, 'delay': {'delaySeconds': 20}}})<\/code><\/pre>\n\n\n\n
Can I use the same profile for an extract, a replicat and a distribution path?<\/h2>\n\n\n\n
Yes.<\/strong> There is one list of profiles, and only the property that names the profile changes. In the transcript below, SharedProfile<\/code> is created once, then assigned to the extract EXTSHR<\/code>, the replicat REPSHR<\/code> and the path DPSHR<\/code>. The extract and the replicat take the name with its ogg:managedProcessSettings:<\/code> prefix, while the path takes the name without prefix. The variables source<\/code>, target<\/code> and begin<\/code> are the ones used in the previous sections.<\/p>\n\n\n\n
>>> client.create_managed_process_profile(\n...     'SharedProfile',\n...     auto_restart=True,\n...     restart_delay=15,\n...     restart_retries=4,\n... )['messages']\n[]\n\n>>> profile = 'ogg:managedProcessSettings:SharedProfile'\n\n>>> client.create_extract(\n...     'EXTSHR',\n...     begin='now',\n...     config=[\n...         'EXTRACT EXTSHR',\n...         'USERIDALIAS oggadmin_pdb1 DOMAIN OracleGoldenGate',\n...         'EXTTRAIL sh',\n...         'TABLE OGGADMIN.SMK264;',\n...     ],\n...     source='tranlogs',\n...     credentials={'alias': 'oggadmin_pdb1', 'domain': 'OracleGoldenGate'},\n...     targets=[{'name': 'sh'}],\n...     registration={'optimized': False},\n...     status='stopped',\n...     managed_process_settings=profile,\n... )['messages']\n[{'$schema': 'ogg:message', 'title': 'Integrated Extract added.', 'code': 'OGG-08100', 'severity': 'INFO', 'issued': '2026-10-25T10:08:49Z', 'type': 'https:\/\/docs.oracle.com\/en\/middleware\/goldengate\/core\/23.26\/error-messages\/'}, {'$schema': 'ogg:message', 'title': 'Extract group EXTSHR successfully registered with database at SCN 224857171.', 'code': 'OGG-02003', 'severity': 'INFO', 'issued': '2026-10-25T10:08:50Z', 'type': 'https:\/\/docs.oracle.com\/en\/middleware\/goldengate\/core\/23.26\/error-messages\/'}, {'$schema': 'ogg:message', 'title': 'Parameter file EXTSHR.prm passed validity check.', 'code': 'OGG-10183', 'severity': 'INFO', 'issued': '2026-10-25T10:08:50Z', 'type': 'https:\/\/docs.oracle.com\/en\/middleware\/goldengate\/core\/23.26\/error-messages\/'}]\n\n>>> client.create_replicat(\n...     'REPSHR',\n...     config=[\n...         'REPLICAT REPSHR',\n...         'USERIDALIAS oggadmin_pdb2 DOMAIN OracleGoldenGate',\n...         'MAP OGGADMIN.SMK264, TARGET OGGADMIN.SMK264;',\n...     ],\n...     mode={'type': 'integrated'},\n...     source={'name': 'sh'},\n...     credentials={'alias': 'oggadmin_pdb2', 'domain': 'OracleGoldenGate'},\n...     checkpoint={'table': 'OGGADMIN.CHECKPOINT'},\n...     status='stopped',\n...     managed_process_settings=profile,\n... )['messages']\n[{'$schema': 'ogg:message', 'title': 'Integrated Replicat added.', 'code': 'OGG-08100', 'severity': 'INFO', 'issued': '2026-10-25T10:08:51Z', 'type': 'https:\/\/docs.oracle.com\/en\/middleware\/goldengate\/core\/23.26\/error-messages\/'}, {'$schema': 'ogg:message', 'title': 'Parameter file REPSHR.prm passed validity check.', 'code': 'OGG-10183', 'severity': 'INFO', 'issued': '2026-10-25T10:08:51Z', 'type': 'https:\/\/docs.oracle.com\/en\/middleware\/goldengate\/core\/23.26\/error-messages\/'}]\n\n>>> client.create_distribution_path(\n...     'DPSHR',\n...     source=source,\n...     target=target,\n...     begin=begin,\n...     status='stopped',\n...     managed_path_settings='SharedProfile',\n... )['messages']\n[{'$schema': 'ogg:message', 'title': \"The path 'DPSHR' has been added.\", 'code': 'OGG-08511', 'severity': 'INFO', 'issued': '2026-10-25T10:08:51Z', 'type': 'https:\/\/docs.oracle.com\/en\/middleware\/goldengate\/core\/23.26\/error-messages\/'}]\n\n>>> client.get_extract('EXTSHR')['managedProcessSettings']\n'ogg:managedProcessSettings:SharedProfile'\n\n>>> client.get_replicat('REPSHR')['managedProcessSettings']\n'ogg:managedProcessSettings:SharedProfile'\n\n>>> d = client.get_distribution_path('DPSHR')\n\n>>> (d['managedPathSettings'], d['options'])\n('SharedProfile', {'autoRestart': {'retries': 4, 'delay': {'delaySeconds': 15}}})\n\n>>> new = client.get_config_value(\n...     type='ogg:managedProcessSettings',\n...     value=profile,\n... )\n\n>>> new['autoRestart'].update(retries=9, delay=25)\n\n>>> client.update_config_value(\n...     type='ogg:managedProcessSettings',\n...     value=profile,\n...     data=new,\n... )['messages']\n[]\n\n>>> d = client.get_distribution_path('DPSHR')\n\n>>> (d['managedPathSettings'], d['options'])\n('SharedProfile', {'autoRestart': {'retries': 9, 'delay': {'delaySeconds': 25}}})\n\n>>> client.delete_managed_process_profile('SharedProfile')\nRuntimeError: ERROR (code 500) - http:\/\/localhost:7810\/services\/v2\/config\/types\/ogg:managedProcessSettings\/values\/ogg:managedProcessSettings:SharedProfile: The managed process settings profile 'SharedProfile' is used by distpath 'DPSHR'.<\/code><\/pre>\n\n\n\n
The three objects report the same profile. After the retries of the profile are set to 9<\/code> and its delay to 25<\/code> seconds, the path reports the new values without being touched<\/strong>. The deletion of the profile is refused while it is in use, and the message names the path.<\/p>\n\n\n\n
Summary<\/h2>\n\n\n\n
    \n
  • A distribution path or a receiver path takes a managed process profile in GoldenGate 23.26.4.0.0<\/code>. The previous release answers OGG-12108<\/code> in the REST API and Unexpected value<\/code> in the adminclient<\/code>.<\/li>\n\n\n\n
  • The REST property is managedPathSettings<\/code>, a profile name. A request with both a profile and explicit auto-restart options returns OGG-30812<\/code>, and an unknown profile returns OGG-08122<\/code>.<\/li>\n\n\n\n
  • The path follows the profile. A change of the profile applies to every path that uses it, and the deletion of a profile in use is refused.<\/li>\n\n\n\n
  • An update with explicit options replaces the profile without an error<\/strong>, and no request clears the property. The explicit options of a path are in minutes, unless the delay is a delaySeconds<\/code> object.<\/li>\n\n\n\n
  • The profile is shared. The same profile can be used by an extract, a replicat and a path<\/strong>, and a change applies to all of them.<\/li>\n\n\n\n
  • The adminclient<\/code> has a PROFILE<\/code> clause in ADD DISTPATH<\/code>, ALTER DISTPATH<\/code> and ADD RECVPATH<\/code>, and INFO DISTPATH<\/code> shows it. The web UI has a Profile Name<\/code> list in Edit Managed Options<\/strong>.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
    In a previous post about updating the profiles of all extracts and replicats at once, I wrote that a profile does not apply to distribution paths. With GoldenGate 23.26.4.0.0, that is no longer true. When looking at the help of ADD DISTPATH in the adminclient, it shows a new PROFILE clause: A distribution path or […]<\/p>\n","protected":false},"author":152,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[3787,59],"tags":[3804,4273,979,4299,328,3730,1775,1089,4255,4244],"type_dbi":[3823,4276,3801,4300,3740,3881,3932,3768,4261],"class_list":["post-48141","post","type-post","status-publish","format-standard","hentry","category-goldengate","category-oracle","tag-26ai","tag-adminclient","tag-api","tag-distribution-path-2","tag-goldengate","tag-ogg","tag-profile","tag-python","tag-rest-api-2","tag-web-ui","type-26ai","type-adminclient","type-api","type-distribution-path-3","type-goldengate","type-ogg","type-profile","type-python","type-rest-api-3"],"acf":[],"yoast_head":"\nGoldenGate distribution path profile in 23.26.4.0.0 - dbi Blog<\/title>\n<meta name=\"description\" content=\"A GoldenGate distribution path profile in 23.26.4.0.0 sets the auto-restart of a path from the REST API, adminclient or web UI.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.dbi-services.com\/blog\/goldengate-distribution-path-profile-in-23-26-4-0-0\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"GoldenGate distribution path profile in 23.26.4.0.0\" \/>\n<meta property=\"og:description\" content=\"A GoldenGate distribution path profile in 23.26.4.0.0 sets the auto-restart of a path from the REST API, adminclient or web UI.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.dbi-services.com\/blog\/goldengate-distribution-path-profile-in-23-26-4-0-0\/\" \/>\n<meta property=\"og:site_name\" content=\"dbi Blog\" \/>\n<meta property=\"article:published_time\" content=\"2026-11-09T06:22:12+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-11-09T06:22:27+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2026\/10\/001_distpath-profile-before-edit-managed-options.png\" \/>\n\t<meta property=\"og:image:width\" content=\"730\" \/>\n\t<meta property=\"og:image:height\" content=\"340\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Julien Delattre\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Julien Delattre\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"6 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/goldengate-distribution-path-profile-in-23-26-4-0-0\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/goldengate-distribution-path-profile-in-23-26-4-0-0\\\/\"},\"author\":{\"name\":\"Julien Delattre\",\"@id\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/#\\\/schema\\\/person\\\/812297b963933317cfcbbf006a273eec\"},\"headline\":\"GoldenGate distribution path profile in 23.26.4.0.0\",\"datePublished\":\"2026-11-09T06:22:12+00:00\",\"dateModified\":\"2026-11-09T06:22:27+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/goldengate-distribution-path-profile-in-23-26-4-0-0\\\/\"},\"wordCount\":960,\"commentCount\":0,\"image\":{\"@id\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/goldengate-distribution-path-profile-in-23-26-4-0-0\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/wp-content\\\/uploads\\\/sites\\\/2\\\/2026\\\/10\\\/001_distpath-profile-before-edit-managed-options.png\",\"keywords\":[\"26ai\",\"adminclient\",\"api\",\"distribution path\",\"GoldenGate\",\"ogg\",\"profile\",\"Python\",\"rest api\",\"web ui\"],\"articleSection\":[\"GoldenGate\",\"Oracle\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/goldengate-distribution-path-profile-in-23-26-4-0-0\\\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/goldengate-distribution-path-profile-in-23-26-4-0-0\\\/\",\"url\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/goldengate-distribution-path-profile-in-23-26-4-0-0\\\/\",\"name\":\"GoldenGate distribution path profile in 23.26.4.0.0 - dbi Blog\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/goldengate-distribution-path-profile-in-23-26-4-0-0\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/goldengate-distribution-path-profile-in-23-26-4-0-0\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/wp-content\\\/uploads\\\/sites\\\/2\\\/2026\\\/10\\\/001_distpath-profile-before-edit-managed-options.png\",\"datePublished\":\"2026-11-09T06:22:12+00:00\",\"dateModified\":\"2026-11-09T06:22:27+00:00\",\"author\":{\"@id\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/#\\\/schema\\\/person\\\/812297b963933317cfcbbf006a273eec\"},\"description\":\"A GoldenGate distribution path profile in 23.26.4.0.0 sets the auto-restart of a path from the REST API, adminclient or web UI.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/goldengate-distribution-path-profile-in-23-26-4-0-0\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/goldengate-distribution-path-profile-in-23-26-4-0-0\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/goldengate-distribution-path-profile-in-23-26-4-0-0\\\/#primaryimage\",\"url\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/wp-content\\\/uploads\\\/sites\\\/2\\\/2026\\\/10\\\/001_distpath-profile-before-edit-managed-options.png\",\"contentUrl\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/wp-content\\\/uploads\\\/sites\\\/2\\\/2026\\\/10\\\/001_distpath-profile-before-edit-managed-options.png\",\"width\":730,\"height\":340},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/goldengate-distribution-path-profile-in-23-26-4-0-0\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Accueil\",\"item\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"GoldenGate distribution path profile in 23.26.4.0.0\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/#website\",\"url\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/\",\"name\":\"dbi Blog\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/#\\\/schema\\\/person\\\/812297b963933317cfcbbf006a273eec\",\"name\":\"Julien Delattre\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/a97d00e680bbf237126e24b65281cbcb66cd20bd1ed2d14bf928991b2bf68eb5?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/a97d00e680bbf237126e24b65281cbcb66cd20bd1ed2d14bf928991b2bf68eb5?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/a97d00e680bbf237126e24b65281cbcb66cd20bd1ed2d14bf928991b2bf68eb5?s=96&d=mm&r=g\",\"caption\":\"Julien Delattre\"},\"url\":\"https:\\\/\\\/www.dbi-services.com\\\/blog\\\/author\\\/juliendelattre\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"GoldenGate distribution path profile in 23.26.4.0.0 - dbi Blog","description":"A GoldenGate distribution path profile in 23.26.4.0.0 sets the auto-restart of a path from the REST API, adminclient or web UI.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.dbi-services.com\/blog\/goldengate-distribution-path-profile-in-23-26-4-0-0\/","og_locale":"en_US","og_type":"article","og_title":"GoldenGate distribution path profile in 23.26.4.0.0","og_description":"A GoldenGate distribution path profile in 23.26.4.0.0 sets the auto-restart of a path from the REST API, adminclient or web UI.","og_url":"https:\/\/www.dbi-services.com\/blog\/goldengate-distribution-path-profile-in-23-26-4-0-0\/","og_site_name":"dbi Blog","article_published_time":"2026-11-09T06:22:12+00:00","article_modified_time":"2026-11-09T06:22:27+00:00","og_image":[{"width":730,"height":340,"url":"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2026\/10\/001_distpath-profile-before-edit-managed-options.png","type":"image\/png"}],"author":"Julien Delattre","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Julien Delattre","Est. reading time":"6 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.dbi-services.com\/blog\/goldengate-distribution-path-profile-in-23-26-4-0-0\/#article","isPartOf":{"@id":"https:\/\/www.dbi-services.com\/blog\/goldengate-distribution-path-profile-in-23-26-4-0-0\/"},"author":{"name":"Julien Delattre","@id":"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/812297b963933317cfcbbf006a273eec"},"headline":"GoldenGate distribution path profile in 23.26.4.0.0","datePublished":"2026-11-09T06:22:12+00:00","dateModified":"2026-11-09T06:22:27+00:00","mainEntityOfPage":{"@id":"https:\/\/www.dbi-services.com\/blog\/goldengate-distribution-path-profile-in-23-26-4-0-0\/"},"wordCount":960,"commentCount":0,"image":{"@id":"https:\/\/www.dbi-services.com\/blog\/goldengate-distribution-path-profile-in-23-26-4-0-0\/#primaryimage"},"thumbnailUrl":"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2026\/10\/001_distpath-profile-before-edit-managed-options.png","keywords":["26ai","adminclient","api","distribution path","GoldenGate","ogg","profile","Python","rest api","web ui"],"articleSection":["GoldenGate","Oracle"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.dbi-services.com\/blog\/goldengate-distribution-path-profile-in-23-26-4-0-0\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.dbi-services.com\/blog\/goldengate-distribution-path-profile-in-23-26-4-0-0\/","url":"https:\/\/www.dbi-services.com\/blog\/goldengate-distribution-path-profile-in-23-26-4-0-0\/","name":"GoldenGate distribution path profile in 23.26.4.0.0 - dbi Blog","isPartOf":{"@id":"https:\/\/www.dbi-services.com\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.dbi-services.com\/blog\/goldengate-distribution-path-profile-in-23-26-4-0-0\/#primaryimage"},"image":{"@id":"https:\/\/www.dbi-services.com\/blog\/goldengate-distribution-path-profile-in-23-26-4-0-0\/#primaryimage"},"thumbnailUrl":"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2026\/10\/001_distpath-profile-before-edit-managed-options.png","datePublished":"2026-11-09T06:22:12+00:00","dateModified":"2026-11-09T06:22:27+00:00","author":{"@id":"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/812297b963933317cfcbbf006a273eec"},"description":"A GoldenGate distribution path profile in 23.26.4.0.0 sets the auto-restart of a path from the REST API, adminclient or web UI.","breadcrumb":{"@id":"https:\/\/www.dbi-services.com\/blog\/goldengate-distribution-path-profile-in-23-26-4-0-0\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.dbi-services.com\/blog\/goldengate-distribution-path-profile-in-23-26-4-0-0\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.dbi-services.com\/blog\/goldengate-distribution-path-profile-in-23-26-4-0-0\/#primaryimage","url":"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2026\/10\/001_distpath-profile-before-edit-managed-options.png","contentUrl":"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2026\/10\/001_distpath-profile-before-edit-managed-options.png","width":730,"height":340},{"@type":"BreadcrumbList","@id":"https:\/\/www.dbi-services.com\/blog\/goldengate-distribution-path-profile-in-23-26-4-0-0\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Accueil","item":"https:\/\/www.dbi-services.com\/blog\/"},{"@type":"ListItem","position":2,"name":"GoldenGate distribution path profile in 23.26.4.0.0"}]},{"@type":"WebSite","@id":"https:\/\/www.dbi-services.com\/blog\/#website","url":"https:\/\/www.dbi-services.com\/blog\/","name":"dbi Blog","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.dbi-services.com\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/812297b963933317cfcbbf006a273eec","name":"Julien Delattre","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/a97d00e680bbf237126e24b65281cbcb66cd20bd1ed2d14bf928991b2bf68eb5?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/a97d00e680bbf237126e24b65281cbcb66cd20bd1ed2d14bf928991b2bf68eb5?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/a97d00e680bbf237126e24b65281cbcb66cd20bd1ed2d14bf928991b2bf68eb5?s=96&d=mm&r=g","caption":"Julien Delattre"},"url":"https:\/\/www.dbi-services.com\/blog\/author\/juliendelattre\/"}]}},"_links":{"self":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/posts\/48141","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/users\/152"}],"replies":[{"embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/comments?post=48141"}],"version-history":[{"count":5,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/posts\/48141\/revisions"}],"predecessor-version":[{"id":48363,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/posts\/48141\/revisions\/48363"}],"wp:attachment":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/media?parent=48141"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/categories?post=48141"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/tags?post=48141"},{"taxonomy":"type","embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/type_dbi?post=48141"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}