ADD DISTPATH

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

ADD DISTPATH dpe  SOURCE trail://localhost:9002/services/v2/sources?trail=ea 
                    TARGET wss://localhost:9003/services/v2/targets?trail=ea 

The target trail must specify the directory that contains your trail files. The default dirdat directory is used in this example.

ADD DISTPATH dpe  SOURCE trail://localhost:9002/services/v2/sources?trail=ea 
                    TARGET ogg://localhost:9003/services/v2/targets?trail=dirdat/eb 
                    TARGETTYPE MANAGER

A fully-qualified DBLOGIN USERIDALIAS.

ADD DISTPATH dpe SOURCE ... TARGET ws://recvsrvr-host:recvsrvr-port ...
AUTHENTICATION USERIDALIAS target-dblogin-useridalias DOMAIN target-domain 

A DBLOGIN USERIDALIAS from a default domain.

ADD DISTPATH dpe SOURCE ... TARGET wss://recvsrvr-host:recvsrvr-port ... 

An exmaple of this implementation is:

ADD DISTPATH dpe SOURCE ... TARGET wss://recvsrvr-host:recvsrvr-port ...
AUTHENTICATION USERIDALIAS ggeast DOMAIN OracleGoldenGate

You can alternatively choose to run the command with base64-encoded user:password for authenticating with the USERIDALIAS that is managed in the credential store.

ADD DISTPATH dpe SOURCE ... TARGET ws://webuser:webpass@recvsrvr-host:recvsrvr-port...

In this example, webuser is the user and webpass is the password.