Use ADD DISTPATH to create a distribution path. Distribution paths are created to link the Distribution Service of one deployment to the Receiver Service of another deployment, in order to send trails from the source to that target deployment.

Syntax

ADD DISTPATH path-name
         SOURCE source-uri 
         TARGET target-uri|
         [TARGETTYPE ( MANAGER | COLLECTOR | RECVSRVR )] | 
         AUTHENTICATION ( OAUTH
                        | (CERTIFICATE certificate-name) 
                        | (USERIDALIAS alias [DOMAIN domain]) 
                        | [ENCRYPTIONPROFILE encryption-profile-name ]

path-name

The unique name of the distribution path you want to add.

source-uri

Specifies the source URI after the source keyword to indicate where the data is originated. The format of this URI contains the protocol (only supports trail), hostname, port number of the Distribution Service, and location of the source trail files.

target-uri

Specifies the target URI after the target keyword to indicate where the data will be sent to. The format of this URI is:

a supported protocol, udt, ogg, web socket ws, or secure web socket wss

a hostname,

the port number of the Receiver Service,

and the location of the target trail files.

TARGETTYPE

Specifies the target type in case the distribution path uses the legacy protocol. This argument is only valid if the target URI schema is ogg://.

Choose MANAGER if the target is a legacy deployment with a manager running.

Choose COLLECTOR if the target is a legacy deployment with a static collector running.

Choose RECVSRVR if the target is an Microservices Architecture deployment with a Receiver Service running.

AUTHENTICATION OAUTH

Use this option if you are using external Identity Provider (IDCS) authorization profile. This will set up the flow from the Distribution Service to the Receiver Service.

Note:

If your deployment is enabled for IDCS, you can still choose to authentication using other authentication options.

AUTHENTICATION CERTIFICATE certificate-name

Identifier of distribution path-specific client certificate uploaded and managed in Administration Service.

AUTHENTICATION USERIDALIAS

(Alternative to certificate authentication,) you can associate each distribution path with a target DBLOGIN USERIDALIAS.

ENCRYPTIONPROFILE

Specifies the name of the encryption profile for the distribution path.

Examples

ALTER DISTPATH dpns SOURCE ENCRYPTION  ALGORITHM AES256

A DBLOGIN USERIDALIAS from a default domain and base64-encoded user:password for authenticating with the USERIDALIAS that is managed in the credential store.. Following is an example of this implementation:

ALTER DISTPATH dpns TARGET AUTHENTICATION USERIDALIAS ggnet DOMAIN OracleGoldenGate