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.
-
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.
-
If the Compute section is not displayed, select in the upper right corner of the My Services Dashboard.
-
Click Show in the Compute section. This enables this service to appear on the My Services page.
-
-
Click Compute to access the Oracle Cloud Infrastructure page.
-
In the upper right corner, click .
-
In the upper left corner of the Oracle Cloud Infrastructure page, click .
-
Select Object Storage > Object Storage.
-
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.
-
After determining the compartment to use, click Create Bucket.
Description of the illustration create_bucket.png -
In the Bucket Name field, enter a name.
-
In the Storage Tier section, select Standard.
-
Click Create Bucket.
The new bucket is displayed in the list.
-
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. -
In the upper left corner of the page, click .
-
Select Identity > Users. This opens the Oracle Identity Service Console to generate a password.
-
Select the appropriate user.
-
From the Resources list on the left side of the page, select Auth Tokens.
-
Click .
-
Provide a token description and click .
This token is used as part of your JSON payload when upgrading.
-
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" } }
-
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