From the Oracle Cloud console navigation menu, select
Streaming, and then Stream
Pools.
On the Stream Pools page, select your pool to view its details.
On the Stream Pool details page, under
Resources, click Kafka Connection
Settings.
Copy the username for SASL Connection Strings.
Note:
If you're using Oracle Identity Cloud service, you must add
OracleIdentityCloudService to your user name.
For example,
<tenancy-name>/OracleIdentityCloudService/<username>/<streampool-ocid>
Create an Auth token:
In the Oracle Cloud console global header, click
Profile, and then select User
settings.
On the User Details page, under Resources, click
Auth Tokens, and then click
Generate Token.
In the Generate Token dialog, enter a description, and then click
Generate Token.
Copy the auth token from the dialog to a secure location from where you
can retrieve it later, and then click
Close.
The Stream Pool username and Auth token will be entered for the Stream
connection's username and password.
Create the source
connection
To create a source OCI Streaming connection:
From the OCI GoldenGate Overview page, click
Connections.
You can also click Create Connection under the
Get started section and skip to step 3.
On the Connections page, click Create Connection.
On the Create Connection page, complete the fields as follows:
For Name, enter a name for the connection.
(Optional) For Description, enter a description that helps
you distinguish this connection from others.
For Compartment, select the compartment in which to create
the connection.
From the Type dropdown,
select OCI Streaming.
For Stream pool details, you can choose:
Select a stream pool
Select a stream pool from the dropdown, or
click Change compartment to select one in a
different compartment.
For Network connectivity, select a Traffic
routing method:
Shared endpoint, to share an endpoint with
the assigned deployment. You must allow connectivity from the deployment's ingress
IP.
Dedicated endpoint, for network traffic
through a dedicated endpoint in the assigned subnet in your VCN. You must allow
connectivity from this connection's ingress IPs.
Note:
If a dedicated connection remains unassigned for seven days, then the
service converts it to a shared connection.
Enter stream pool information to
manually enter the stream pool information.
Under Bootstrap servers, select a
Traffic routing method:
Shared endpoint, to share an endpoint with
the assigned deployment. You must allow connectivity from the deployment's ingress
IP.
Dedicated endpoint, for network traffic
through a dedicated endpoint in the assigned subnet in your VCN. You must allow
connectivity from this connection's ingress IPs.
Note:
If a dedicated connection remains unassigned for seven days, then the
service converts it to a shared connection.
If you enter a private IP, then OCI GoldenGate rewrites the private IP in the format,
ip-10-0-0-0.ociggsvc.oracle.vcn.com.
For Username, enter the
Stream Pool username copied from the SASL
Connection Settings in the prerequisite steps
above.
For Password, enter the OCI Streaming password.
Note:
To use password secrets, ensure that you select Use secrets in
vault in the Settings tab under Advanced Options, located at the bottom of this
form.
Expand Show advanced options. You can configure the following
options:
Security
Select Use Oracle-managed encryption key to leave all
encryption key management to Oracle.
Select Use customer-managed encryption key to select a
specific encryption key stored in your OCI Vault to encrypt your connection
credentials.
Settings
Select Use vault secrets to use a password secret for
your connection.
To capture from OCI Streaming, create a
consumer.properties file with one of the following
deserializers or converters, and then drag and
drop the file to Consumer
properties:
After the connection is created, it appears in the
Connections list. Ensure that you assign the connection to a deployment to use it as a source
or target in a replication.
Create the target
connection
To create a target OCI Streaming connection:
From the OCI GoldenGate Overview page, click
Connections.
You can also click Create Connection under the
Get started section and skip to step 3.
On the Connections page, click Create Connection.
On the Create Connection page, complete the fields as follows:
For Name, enter a name for the connection.
(Optional) For Description, enter a description that helps
you distinguish this connection from others.
For Compartment, select the compartment in which to create
the connection.
From the Type dropdown,
select OCI Streaming.
For Stream pool details, you can choose:
Select a stream
pool
Select a stream pool from the
dropdown, or click Change compartment to
select one in a different compartment.
For Network connectivity, select
a Traffic routing method:
Shared endpoint, to share an endpoint with
the assigned deployment. You must allow connectivity from the deployment's ingress
IP.
Dedicated endpoint, for network traffic
through a dedicated endpoint in the assigned subnet in your VCN. You must allow
connectivity from this connection's ingress IPs.
Note:
If a dedicated connection remains unassigned for seven days, then the
service converts it to a shared connection.
Enter stream pool
information to manually enter the stream pool
information.
Under Bootstrap servers, select a
Traffic routing method:
Shared endpoint, to share an endpoint with
the assigned deployment. You must allow connectivity from the deployment's ingress
IP.
Dedicated endpoint, for network traffic
through a dedicated endpoint in the assigned subnet in your VCN. You must allow
connectivity from this connection's ingress IPs.
Note:
If a dedicated connection remains unassigned for seven days, then the
service converts it to a shared connection.
After the connection is created, it appears in the
Connections list. Ensure that you assign the connection to a deployment to use it as a source
or target in a replication.