Oracle Cloud Infrastructure Documentation

Task 6: Configure Connectivity between the AWS VPC and the ODB Network for Oracle Database@AWS

This topic explains the required steps to configure connectivity between the AWS Virtual Private Cloud (VPC) and the ODB Network for Oracle Database@AWS.

Note

Before you start to configure the connectivity between the AWS VPC and the ODB network for Oracle Database@AWS, you must download the AWS CLI version 2 . For detailed documentation, see Download the AWS CLI version 2.

You can add security rules, update the route table, and configure DNS to allow App VPC to communicate with Exadata VM Cluster over the ODB network. For detailed documentation, see Configuring the network in Oracle Database@AWS.

Download the AWS CLI version 2

These are steps to download the AWS CLI version 2.

You can install the AWS CLI version 2 by using one of the following methods.
  • Install AWS CLI version 2 , and then apply the EC2 CLI update for the ODB network
  • Build and install the AWS CLI version 2 from the source.
  • Use Docker Image to install the AWS CLI version 2.
Note

These following methods have 2-step processes:
  • Installing the AWS CLI version 2 with the ODB network access.
  • Adding an additional access to EC2 to create-route API for the -odb-network-arn parameter.

Method 1:

  1. Follow the steps to install AWS CLI version 2, and apply the EC2 CLI update for the ODB network.
    1. To learn how to install the Linux x86 or Linux ARM installers, and Windows MSI preview artifacts, see Installing or updating to the latest version of the AWS CLI.
    2. Verify the installation by running aws --version command, and testing the new or updated installation.
    3. If your operating system is Linux, use the following script to configure environment variable for the AWS CLI. For more information, see Configure the AWS CLI. 
      $ export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
$ export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
$ export AWS_DEFAULT_REGION=us-east-1 
$ export AWS_CLI_FILE_ENCODING=UTF-8
    4. If your operating system is Windows, use the following script to configure environment variable for the AWS CLI. 
      $ set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
$ set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
$ set AWS_DEFAULT_REGION=us-east-1 
$ set AWS_CLI_FILE_ENCODING=UTF-8
    5. Use the following command to download the ec2-service-2.json file.
      $ aws s3 cp s3://odb-preview-builds/odb-preview-sdks/12-17-2024/odb-cli-v2/ec2-service-2.json ~/Downloads/
    6. After the AWS CLI installation and downloading the ec2-service-2.json file, apply the EC2 CLI update by running the following command using the ec2-service-2.json that is provided.
      $ aws configure add-model --service-model file://<path-to-ec2-service-json>/ec2-service-2.json --service-name ec2
  2. Verify your ODB access with AWS CLI.
    1. Use the following command to verify your access to the --odb-network-arn parameter for the EC2 CLI.
      $ aws ec2 create-route help
    2. Check to see [--odb-network-arn <value>] within the help description for the create-route API.
      create-route
[--destination-prefix-list-id <value>]
[--vpc-endpoint-id <value>]
[--transit-gateway-id <value>]
[--local-gateway-id <value>]
[--carrier-gateway-id <value>]
[--core-network-arn <value>]
[--odb-network-arn <value>]

Method 2:

  1. Follow the steps to build and install the AWS CLI version 2 from the source.
    Note

    This method includes EC2 CLI update for the ODB network, and ODB service CLI.
  1. Use the following command to list all of the available SDK options. 
    $ aws s3 ls --recursive s3://odb-preview-builds/odb-preview-sdks/12-17-2024/
  2. Download the AWS CLI version 2 source distribution artifact that is compatible with your operation system. The file is awsCliDist.zip.
    $ aws s3 cp s3://odb-preview-builds/odb-preview-sdks/12-17-2024/odb-cli-v2/awsCliDist.zip
    /Downloads/

For more information, see Building and installing the AWS CLI from source.

Method 3:

  1. Follow the steps to use Docker Image to install AWS CLI version 2.
  2. Use the following command to download Docker image artifact from S3.
    $ aws s3 cp s3://odb-preview-builds/odb-preview-sdks/12-17-2024/odb-cli-v2/awsCliX86DockerImage.zip ~/Downloads/
  3. Use the following command to unzip the Docker image artifact.
    $ unzip awsCliX86DockerImage.zip
  4. Use the following command to load the image.
    $ docker load -i aws-cli-docker.tar
  5. To verify if the image is available, run the following command.
    $ docker image ls
  6. Apply the EC2 CLI update by running the following command using the ec2-service-2.json provided.
    $ aws configure add-model --service-model file://<path-to-ec2-service-json>/ec2-service-2.json --service-name ec2

For more information, see ECR Public repository for the AWS CLI v2 .