Step 3: Create an Object Storage Bucket and Construct the Storage URL (If Not Using the Application Migration Service)

If you are not using the Application Migration Service for migration, you must create a storage bucket (if one does not already exist) and construct the storage URL to specify in order to export design-time metadata into an Oracle Integration instance. You must specify this URL later during the configuration process to migrate your instance. If you use the Application Migration Service, these tasks are automatically performed for you.

Note:

  • If using the Application Migration Service, skip this section.
  • Do not create a Classic Storage bucket. Classic Storage is not supported.
  1. Log in to the My Services Console with the user that the administrator added to the group for exporting design-time metadata. You must have the admin role to access this page.

  2. If the Compute section is not displayed, select Customize Dashboard button in the upper right corner of the My Services Dashboard.

    1. Click Show in the Compute section. This enables this service to appear on the My Services page.


      Compute section with Automatic, Show, and Hide buttons to the right
  3. Click Compute to access the Oracle Cloud Infrastructure page.

  4. In the upper right corner, click Open Service Console button.

  5. In the upper left corner of the Oracle Cloud Infrastructure page, click hamburger menu.

  6. Select Object Storage > Object Storage.

  7. Select the compartment in which to create the storage bucket. The compartment to use for exporting design-time metadata was created in Step 1: Create a Cloud Storage Compartment or Use an Existing Compartment. You can also click Learn more about Compartments to find the appropriate compartment for your environment.

  8. After determining the compartment to use, click Create Bucket.


    Description of create_bucket.png follows
    Description of the illustration create_bucket.png
  9. In the Bucket Name field, enter a name.

  10. In the Storage Tier section, select Standard.

  11. Click Create Bucket.

    The new bucket is displayed in the list.
    Buckets in Integration Compartment dialog with Create Bucket button at top and existing bucket named cloneRepo.

  12. If you want to view bucket details, click the name (for this example, cloneRepo).

    Note:

    Ensure that you click the Public button and deselect the Allow Users To List Objects From This Bucket check box. This action ensures that the storage bucket you create is publicly visible. Otherwise, the export utility cannot see the storage.
    Edit Visibility dialog with selections for Private and Public, and Save Changes and Cancel buttons at the bottom

  13. In the upper left corner of the page, click hamburger menu.

  14. Select Identity > Users. This opens the Oracle Identity Service Console to generate a password.

  15. Select the appropriate user.

  16. From the Resources list on the left side of the page, select Auth Tokens.

  17. Click Generate Token button.

  18. Provide a token description and click Generate Token button.

    This token is used as part of your JSON payload when upgrading.

  19. Copy and save the generated token.

    a. The storage payload format is as follows with object storage bucket details:
    {"storageInfo":
           {
                 "storageUrl":"https://swiftobjectstorage.region.oraclecloud.com/v1/
    namespace/bucket",
                 "storageUser":"my.email@oracle.com",
                 "storagePassword":"generated_token"
                }
    }
    For example:
    {
          "storageInfo":
                {
                      "storageUrl":"https://swiftobjectstorage.us-ashburn-1.oraclecloud.
    com/v1/paasdevoic/cloneRepo",
                      "storageUser":"my.email@oracle.com",
                      "storagePassword":"generated_token"
                }
    }
  20. Construct the storage URL using the following example. You must specify the URL later during the configuration process to migrate your instance.
    Step Description Example
    1 Enter the Swift API as the base for the URL because you are dealing with object storage. https://swiftobjectstorage
    2 Enter a required data center. To find a data center, navigate to Menu > Administration > Tenancy Details > Home Region (for example: us-ashburn-1). https://swiftobjectstorage.us-ashburn-1
    3 Enter the domain name. This is typically oraclecloud.com. https://swiftobjectstorage.us-ashburn-1.oraclecloud.com
    4 Enter the version: v1. https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1
    5 Enter the automatically generated object storage namespace. Open the User menu and click Tenancy: your_tenancy_name. The namespace string is listed under Object Storage Settings. See Understanding Object Storage Namespaces. paasdevoic
    6 Enter the bucket name as the last part of the URL. https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/paasdevoic/BUCKET_NAME
    Examples of the full storage URL to use later in the payload are as follows:
    https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/paasdevoic/cloneRepo
    https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/paasdevoic/migrationartifacts_bucket-20190717-1223