CINXE.COM
Step 3: Create an Object Storage Bucket and Construct the Storage URL (If Not Using the Application Migration Service)
<!DOCTYPE html SYSTEM "about:legacy-compat"> <html xml:lang="en-us" lang="en-us"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta name="DC.Type" content="task"> <meta name="DC.Title" content="Step 3: Create an Object Storage Bucket and Construct the Storage URL (If Not Using the Application Migration Service)"> <meta name="abstract" content="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."> <meta name="description" content="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."> <meta name="DC.Creator" content="Oracle Corporation"> <meta name="DC.Publisher" content="August2021"> <meta name="DC.Format" content="XHTML"> <meta name="DC.Identifier" content="GUID-E9DBF294-2C30-4AC7-B498-74AA0958F89B"> <meta name="DC.Language" content="en-US"> <meta name="viewport" content="width=device-width, initial-scale=1"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="abstract" content="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."> <meta name="description" content="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."> <title>Step 3: Create an Object Storage Bucket and Construct the Storage URL (If Not Using the Application Migration Service)</title> <meta property="og:site_name" content="Oracle Help Center"> <meta property="og:title" content="Migrating Oracle Integration Classic Instances to Oracle Cloud Infrastructure"> <meta property="og:description" content="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."> <link rel="stylesheet" href="/sp_common/book-template/ohc-book-template/css/book.css"> <link rel="shortcut icon" href="/sp_common/book-template/ohc-common/img/favicon.ico"> <meta name="application-name" content="Migrating Oracle Integration Classic Instances to Oracle Cloud Infrastructure"> <meta name="generator" content="DITA Open Toolkit version 1.8.5 (Mode = doc)"> <meta name="plugin" content="SP_docbuilder HTML plugin release 18.2.2"> <link rel="alternate" href="migrating-oracle-integration-classic-instances-oracle-cloud-infrastructure.pdf" title="PDF File" type="application/pdf"> <meta name="robots" content="all"> <link rel="schema.dcterms" href="http://purl.org/dc/terms/"> <meta name="dcterms.created" content="2021-08-24T15:31:16-07:00"> <meta name="dcterms.title" content="Migrating Oracle Integration Classic Instances to Oracle Cloud Infrastructure"> <meta name="dcterms.dateCopyrighted" content="2019, 2021"> <meta name="dcterms.category" content="cloud"> <meta name="dcterms.identifier" content="F15345-21"> <meta name="dcterms.product" content="en/cloud/paas/integration-cloud"> <link rel="prev" href="step-2-create-user-group-and-policy.html" title="Previous" type="text/html"> <link rel="next" href="step-4-migrate-integrations-and-processes-application-migration-service.html" title="Next" type="text/html"> <script> document.write('<style type="text/css">'); document.write('body > .noscript, body > .noscript ~ * { visibility: hidden; }'); document.write('</style>'); </script> <script data-main="/sp_common/book-template/ohc-book-template/js/book-config" src="/sp_common/book-template/requirejs/require.js"></script> <script> if (window.require === undefined) { document.write('<script data-main="sp_common/book-template/ohc-book-template/js/book-config" src="sp_common/book-template/requirejs/require.js"><\/script>'); document.write('<link href="sp_common/book-template/ohc-book-template/css/book.css" rel="stylesheet"/>'); } </script> <script type="application/json" id="ssot-metadata">{"primary":{"category":{"short_name":"cloud","element_name":"Cloud","display_in_url":true},"suite":{"short_name":"paas","element_name":"Cloud Platform","display_in_url":true},"product_group":{"short_name":"integration-cloud","element_name":"Integration","display_in_url":false},"product":{"short_name":"integration-cloud","element_name":"Integration","display_in_url":true},"release":{"short_name":"latest","element_name":"Latest Cloud Release","display_in_url":false}}}</script> <meta name="dcterms.isVersionOf" content="INTEGRATION-CLASSIC-MIGRATION-TO-OCI-B"> <meta name="dcterms.release" content="Latest Cloud Release"> <script>window.ohcglobal || document.write('<script src="/en/dcommon/js/global.js">\x3C/script>')</script></head> <body> <div class="noscript alert alert-danger text-center" role="alert"> <a href="step-2-create-user-group-and-policy.html" class="pull-left"><span class="glyphicon glyphicon-chevron-left" aria-hidden="true"></span>Previous</a> <a href="step-4-migrate-integrations-and-processes-application-migration-service.html" class="pull-right">Next<span class="glyphicon glyphicon-chevron-right" aria-hidden="true"></span></a> <span class="fa fa-exclamation-triangle" aria-hidden="true"></span> JavaScript must be enabled to correctly display this content </div> <article> <header> <ol class="breadcrumb" vocab="http://schema.org/" typeof="BreadcrumbList"> <li property="itemListElement" typeof="ListItem"><a href="index.html" property="item" typeof="WebPage"><span property="name">Migrating Oracle Integration Classic Instances to Oracle Cloud Infrastructure</span></a></li> <li property="itemListElement" typeof="ListItem"><a href="migrate-your-oracle-integration-classic-instances-oracle-cloud-infrastructure.html" property="item" typeof="WebPage"><span property="name">Migrate Your Oracle Integration Classic Instances to Oracle Cloud Infrastructure</span></a></li> <li class="active" property="itemListElement" typeof="ListItem"> Step 3: Create an Object Storage Bucket and Construct the Storage URL (If Not Using the Application Migration Service)</li> </ol> <a id="GUID-E9DBF294-2C30-4AC7-B498-74AA0958F89B" name="GUID-E9DBF294-2C30-4AC7-B498-74AA0958F89B"></a> <h2 id="IMCOB-GUID-E9DBF294-2C30-4AC7-B498-74AA0958F89B" class="sect2"> Step 3: Create an Object Storage Bucket and Construct the Storage URL (If Not Using the <span>Application Migration Service</span>) </h2> </header> <div class="ind"> <div> <p>If you are <span class="italic">not</span> using the <span>Application Migration Service</span> 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 <span>Oracle Integration</span> instance. You must specify this URL later during the configuration process to migrate your instance. If you use the <span>Application Migration Service</span>, these tasks are automatically performed for you. </p> <div class="section"> <div class="infoboxnote" id="GUID-E9DBF294-2C30-4AC7-B498-74AA0958F89B__GUID-1BCD0E39-A8D8-41D4-9564-F0CD8AA93FBD"> <p class="notep1">Note:</p> <ul style="list-style-type: disc;" id="GUID-E9DBF294-2C30-4AC7-B498-74AA0958F89B__UL_TDM_BXF_HLB"> <li>If using the <span>Application Migration Service</span>, skip this section. </li> <li>Do <span class="italic">not</span> create a Classic Storage bucket. Classic Storage is not supported. </li> </ul> </div> <ol id="GUID-E9DBF294-2C30-4AC7-B498-74AA0958F89B__OL_WDW_J3T_1HB"> <li> <p>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.</p> </li> <li> <p>If the <span class="uicontrol bold">Compute</span> section is not displayed, select <img id="GUID-E9DBF294-2C30-4AC7-B498-74AA0958F89B__IMAGE_XDW_J3T_1HB" height="13" width="118" src="img/customize_dashboard.png" alt="Customize Dashboard button" title="Customize Dashboard button"> in the upper right corner of the My Services Dashboard. </p> <ol type="a" id="GUID-E9DBF294-2C30-4AC7-B498-74AA0958F89B__OL_YDW_J3T_1HB"> <li> <p>Click <span class="uicontrol bold">Show</span> in the <span class="uicontrol bold">Compute</span> section. This enables this service to appear on the My Services page. </p><br><img id="GUID-E9DBF294-2C30-4AC7-B498-74AA0958F89B__IMAGE_ZDW_J3T_1HB" height="73" width="543" src="img/show_compute.png" alt="Compute section with Automatic, Show, and Hide buttons to the right" title="Compute section with Automatic, Show, and Hide buttons to the right"><br></li> </ol> </li> <li> <p>Click <span class="uicontrol bold">Compute</span> to access the Oracle Cloud Infrastructure page. </p> </li> <li> <p>In the upper right corner, click <img id="GUID-E9DBF294-2C30-4AC7-B498-74AA0958F89B__IMAGE_A2W_J3T_1HB" height="27" width="142" src="img/open_console.png" alt="Open Service Console button" title="Open Service Console button">. </p> </li> <li> <p>In the upper left corner of the Oracle Cloud Infrastructure page, click <img id="GUID-E9DBF294-2C30-4AC7-B498-74AA0958F89B__IMAGE_B2W_J3T_1HB" height="11" width="14" src="img/compute_hamb_menu.png" alt="hamburger menu" title="hamburger menu">. </p> </li> <li> <p>Select <span class="uicontrol bold">Object Storage</span> > <span class="uicontrol bold">Object Storage</span>. </p> </li> <li> <p>Select the compartment in which to create the storage bucket. The compartment to use for exporting design-time metadata was created in <a href="step-1-configure-cloud-storage-compartment.html#GUID-6B7BFC00-6C29-4280-95B1-847B67489F35" title="Oracle Integration instances use the Oracle Cloud Infrastructure as their underlying infrastructure. To export design-time metadata into an Oracle Integration instance, you must first create a compartment (if one does not exist). This task is required regardless of the migration tool you use.">Step 1: Create a Cloud Storage Compartment or Use an Existing Compartment</a>. You can also click <span class="uicontrol bold">Learn more about Compartments</span> to find the appropriate compartment for your environment. </p> </li> <li> <p>After determining the compartment to use, click <span class="uicontrol bold">Create Bucket</span>. </p><br><img id="GUID-E9DBF294-2C30-4AC7-B498-74AA0958F89B__IMAGE_C2W_J3T_1HB" height="288" width="784" src="img/create_bucket.png" alt="Description of create_bucket.png follows" title="Description of create_bucket.png follows" longdesc="img_text/create_bucket.html"><br><a href="img_text/create_bucket.html">Description of the illustration create_bucket.png</a><br></li> <li> <p>In the <span class="uicontrol bold">Bucket Name</span> field, enter a name. </p> </li> <li> <p>In the <span class="uicontrol bold">Storage Tier</span> section, select <span class="uicontrol bold">Standard</span>. </p> </li> <li> <p>Click <span class="uicontrol bold">Create Bucket</span>. </p> <p>The new bucket is displayed in the list.<br><img id="GUID-E9DBF294-2C30-4AC7-B498-74AA0958F89B__IMAGE_D2W_J3T_1HB" height="210" width="575" src="img/created_bucket.png" alt="Buckets in Integration Compartment dialog with Create Bucket button at top and existing bucket named cloneRepo." title="Buckets in Integration Compartment dialog with Create Bucket button at top and existing bucket named cloneRepo."><br></p> </li> <li> <p>If you want to view bucket details, click the name (for this example, <span class="uicontrol bold">cloneRepo</span>). </p> <div class="infoboxnote" id="GUID-E9DBF294-2C30-4AC7-B498-74AA0958F89B__GUID-F2A42F5A-71A0-41D8-803E-7072B09F4532"> <p class="notep1">Note:</p>Ensure that you click the <span class="uicontrol bold">Public</span> button and deselect the <span class="uicontrol bold">Allow Users To List Objects From This Bucket</span> check box. This action ensures that the storage bucket you create is publicly visible. Otherwise, the export utility cannot see the storage. <br><div class="imageleft"><img class="imageleft" id="GUID-E9DBF294-2C30-4AC7-B498-74AA0958F89B__IMAGE_SGP_TCR_NKB" height="379" width="1010" src="img/edit_visibility.png" alt="Edit Visibility dialog with selections for Private and Public, and Save Changes and Cancel buttons at the bottom" title="Edit Visibility dialog with selections for Private and Public, and Save Changes and Cancel buttons at the bottom"></div><br></div> </li> <li> <p>In the upper left corner of the page, click <img id="GUID-E9DBF294-2C30-4AC7-B498-74AA0958F89B__IMAGE_E2W_J3T_1HB" height="11" width="14" src="img/compute_hamb_menu.png" alt="hamburger menu" title="hamburger menu">. </p> </li> <li> <p>Select <span class="uicontrol bold">Identity</span> > <span class="uicontrol bold">Users</span>. This opens the Oracle Identity Service Console to generate a password. </p> </li> <li> <p>Select the appropriate user.</p> </li> <li> <p>From the <span class="uicontrol bold">Resources</span> list on the left side of the page, select <span class="uicontrol bold">Auth Tokens</span>. </p> </li> <li> <p>Click <img id="GUID-E9DBF294-2C30-4AC7-B498-74AA0958F89B__IMAGE_F2W_J3T_1HB" height="14" width="77" src="img/generate_token.png" alt="Generate Token button" title="Generate Token button">. </p> </li> <li> <p>Provide a token description and click <img id="GUID-E9DBF294-2C30-4AC7-B498-74AA0958F89B__IMAGE_G2W_J3T_1HB" height="14" width="77" src="img/generate_token.png" alt="Generate Token button" title="Generate Token button">. </p> <p>This token is used as part of your JSON payload when upgrading.</p> </li> <li> <p>Copy and save the generated token.</p> <div class="p">a. The storage payload format is as follows with object storage bucket details:<pre class="pre codeblock"><code>{"storageInfo": { "storageUrl":"https://swiftobjectstorage.<span class="italic">region</span>.oraclecloud.com/v1/ <span class="italic">namespace</span>/<span class="italic">bucket</span>", "storageUser":"my.email@oracle.com", "storagePassword":"<span class="italic">generated_token</span>" } }</code></pre></div> <div class="p">For example:<pre class="pre codeblock"><code>{ "storageInfo": { "storageUrl":"https://swiftobjectstorage.us-ashburn-1.oraclecloud. com/v1/paasdevoic/cloneRepo", "storageUser":"my.email@oracle.com", "storagePassword":"<span class="italic">generated_token</span>" } }</code></pre></div> </li> <li> <div class="p">Construct the storage URL using the following example. You must specify the URL later during the configuration process to migrate your instance. <div class="tblformal" id="GUID-E9DBF294-2C30-4AC7-B498-74AA0958F89B__TABLE_ALZ_FG5_5FB"> <table cellpadding="4" cellspacing="0" class="Formal" title summary="Construct the storage URL as
 follows:" frame="hsides" border="1" rules="rows"> <thead> <tr align="left" valign="top"> <th align="left" valign="bottom" width="0%" id="d4388e255">Step</th> <th align="left" valign="bottom" width="0%" id="d4388e257">Description</th> <th align="left" valign="bottom" width="0%" id="d4388e259">Example</th> </tr> </thead> <tbody> <tr align="left" valign="top"> <td align="left" valign="top" width="0%" id="d4388e263" headers="d4388e255 ">1</td> <td align="left" valign="top" width="0%" headers="d4388e263 d4388e257 ">Enter the Swift API as the base for the URL because you are dealing with object storage.</td> <td align="left" valign="top" width="0%" headers="d4388e263 d4388e259 "><code class="codeph">https://swiftobjectstorage</code></td> </tr> <tr align="left" valign="top"> <td align="left" valign="top" width="0%" id="d4388e271" headers="d4388e255 ">2</td> <td align="left" valign="top" width="0%" headers="d4388e271 d4388e257 ">Enter a required data center. To find a data center, navigate to <span class="uicontrol bold">Menu</span> > <span class="uicontrol bold">Administration</span> > <span class="uicontrol bold">Tenancy</span> <span class="uicontrol bold">Details</span> > <span class="uicontrol bold">Home Region</span> (for example: <code class="codeph">us-ashburn-1</code>). </td> <td align="left" valign="top" width="0%" headers="d4388e271 d4388e259 "><code class="codeph">https://swiftobjectstorage.us-ashburn-1</code></td> </tr> <tr align="left" valign="top"> <td align="left" valign="top" width="0%" id="d4388e298" headers="d4388e255 ">3</td> <td align="left" valign="top" width="0%" headers="d4388e298 d4388e257 ">Enter the domain name. This is typically <code class="codeph">oraclecloud.com</code>. </td> <td align="left" valign="top" width="0%" headers="d4388e298 d4388e259 "><code class="codeph">https://swiftobjectstorage.us-ashburn-1.oraclecloud.com</code></td> </tr> <tr align="left" valign="top"> <td align="left" valign="top" width="0%" id="d4388e309" headers="d4388e255 ">4</td> <td align="left" valign="top" width="0%" headers="d4388e309 d4388e257 ">Enter the version: <code class="codeph">v1</code>. </td> <td align="left" valign="top" width="0%" headers="d4388e309 d4388e259 "><code class="codeph">https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1</code></td> </tr> <tr align="left" valign="top"> <td align="left" valign="top" width="0%" id="d4388e320" headers="d4388e255 ">5</td> <td align="left" valign="top" width="0%" headers="d4388e320 d4388e257 ">Enter the automatically generated object storage namespace. Open the <span class="uicontrol bold">User</span> menu and click <span class="uicontrol bold">Tenancy</span>: <span class="bold"><span class="italic">your_tenancy_name</span></span>. The namespace string is listed under <span class="uicontrol bold">Object Storage Settings</span>. See <a href="https://docs.cloud.oracle.com/iaas/Content/Object/Tasks/understandingnamespaces.htm" target="_blank">Understanding Object Storage Namespaces</a>. </td> <td align="left" valign="top" width="0%" headers="d4388e320 d4388e259 "><code class="codeph">paasdevoic</code> </td> </tr> <tr align="left" valign="top"> <td align="left" valign="top" width="0%" id="d4388e346" headers="d4388e255 ">6</td> <td align="left" valign="top" width="0%" headers="d4388e346 d4388e257 ">Enter the bucket name as the last part of the URL.</td> <td align="left" valign="top" width="0%" headers="d4388e346 d4388e259 "><code class="codeph">https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/paasdevoic/<span class="codeinlineitalic">BUCKET_NAME</span></code></td> </tr> </tbody> </table> </div> <!-- class="inftblhruleinformal" --> </div> <div class="p">Examples of the full storage URL to use later in the payload are as follows:<pre class="pre codeblock"><code>https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/paasdevoic/cloneRepo</code></pre><pre class="pre codeblock"><code>https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/paasdevoic/migrationartifacts_bucket-20190717-1223</code></pre></div> </li> </ol> </div> <!-- class="section" --> </div> </div> </article> </body> </html>