Install and Configure the Recipe

On your Oracle Integration instance, install the recipe package to deploy and configure the integration and associated resources.

1. On the Oracle Integration Home page, scroll to the Accelerators & Recipes section.
2. Click Search All.
   The list of available recipes appears.
3. Select the recipe you want to install, and click Install .
   A confirmation message informing that the recipe was successfully installed appears, and the recipe now displays the Installed tag.
4. Click Configure to configure the following resources using the Configuration Editor.
   • Configure the Oracle Apache Kafka Connection
   • Configure the Oracle REST Amazon S3 Connection
   • Configure the Integration

Configure the Oracle Apache Kafka Connection

You have to configure the connection details for the Oracle Apache Kafka connection.

1. On the Configuration Editor page, select Oracle Apache Kafka Connection.
2. Click Edit .
   The Oracle Apache Kafka Connection window appears.
3. In the Bootstrap Servers field, enter the Bootstrap Server URL you obtained earlier while configuring Apache Kafka.
   See Configure Apache Kafka.
4. In the Security Policy field, select SASL PLAIN Over SSL.
5. In the SASL Username and SASL Password fields, enter the Apache Kafka API Key and Secret that you obtained earlier while configuring Apache Kafka.
   See Configure Apache Kafka.
6. Complete the following:
   1. Upload the truststore file in the TrustStore field.
   2. Upload the keystore file in the KeyStore field.
   3. Enter the truststore password in the Truststore password field.
   4. Enter the keystore passowrd in the KeyStore password field.
   See Configure Apache Kafka.
7. Click Save.
8. Click Test to ensure that your connection is successfully configured. In the dialog that displays, click Test again. You get a confirmation message if your test is successful.
9. Click Back to return to the Configuration Editor page.

Configure the Oracle REST Amazon S3 Connection

You have to configure the connection details for the Oracle REST Amazon S3 connection.

1. On the Configuration Editor page, select Oracle REST AmazonS3 Connection.
2. Click Edit .
   The Oracle REST AmazonS3 Connection window appears.
3. Under the Connection Properties section, do the following:
   1. In the Connection Type field, select REST API Base URL from the drop-down list.
   2. In the Connection URL field, enter https://s3.<your-bucket-region>.amazonaws.com/. Where your-bucket-region is the region in which you had set up your Amazon S3 bucket.
      For example, https://s3.eu-central-1.amazonaws.com/.
   See Configure Amazon S3.
4. In the Security section, do the following:
   1. In the Security Policy field, select AWS Signature Version 4 from the drop-down list.
   2. Enter the access key and the secret key that you obtained earlier while configuring Amazon S3 in the Access Key and Secret Key fields.
   3. In the AWS Region field, select the AWS region where you have created the Amazon S3 bucket. For example, eu-central-1.
   4. In the Service Name field, select Amazon Simple Storage Service (Amazon S3).
   See Configure Amazon S3.
5. Click Save.
6. Click Test to ensure that your connection is successfully configured. In the dialog that displays, click Test again. You get a confirmation message if your test is successful.
7. Click Back to return to the Configuration Editor page.

Configure the Integration

You have to configure the Apache Kafka adapter endpoint properties in the integration.

1. On the Configuration Editor page, select the Oracle Kafka Amazon S3 Scheduled JSON Object Export integration.
2. Open the integration in the Integration editor.
3. In the integration canvas, select the LoadTopicMessages invoke, and then click the Edit icon.
   The Apache Kafka Endpoint Configuration Wizard with its Basic Info page appears.
4. Click Next in the Basic Info page.
5. In the Operation page that appears, click Next again.
   The Topic & Partition page appears.
6. Configure the following in the Topic & Partition page.
   1. In the Select a Topic list, choose the Apache Kafka topic from which you want to query and fetch messages.
   2. Select a partition from the Specify the Partition list, or use the Default selection.
   3. Specify the consumer group to use in the Consumer Group field.
   4. Select the Read latest option under Specify the option for consuming messages.
   5. In the Maximum Number of Records to be fetched field, specify the number of messages to be read.
   6. In the Do you want to specify the message structure? field, select No.
   7. In the Do you want to specify the headers for the message? field, select No.
   8. Click Next and then click Done.
   See Add the Kafka Adapter Connection to an Integration in Using the Apache Kafka Adapter with Oracle Integration.
7. On the Integration editor, click Save.
8. Click Close to return back to the Configuration Editor.