Classic Migration Service Export CLI Tool

Extract and package application data with the Classic Migration Service export CLI tool.

To migrate Oracle Java Cloud Service and Oracle SOA Cloud Service applications running on Oracle Cloud Infrastructure Classic to Oracle WebLogic Cloud Service and Oracle SOA Suite on Marketplace applications on Oracle Cloud Infrastructure, use the Classic Migration Service export CLI tool.

The export tool is only necessary when the Classic Migration Service does not have direct access to the applications and, therefore, cannot import the data, directly. The export tool extracts the data and packages it into two files that you will upload to the corresponding applications through the Oracle Cloud Infrastructure Console, completing the migration process.

To migrate Oracle Java Cloud Service and Oracle SOA Cloud Service applications running on Oracle Cloud Infrastructure Classic to Oracle WebLogic Cloud Service and Oracle SOA Suite on Marketplace applications on Oracle Cloud Infrastructure, use the Classic Migration Service export CLI tool to extract and package data from the applications to import into the corresponding applications running on Oracle Cloud Infrastructure.

The export tool is only necessary when the Classic Migration Service does not have direct access to the applications and, therefore, cannot import the data, directly. The export tool extracts the data and packages it into two files that you will upload to the corresponding applications through the Oracle Cloud Infrastructure Console, completing the migration process.

Requirements

The export tool runs on the Oracle Cloud Infrastructure Classic WebLogic Server host instance and requires a Linux instance running either the Oracle Java Cloud Service or Oracle SOA Cloud Service applications.

Downloading the Export Tool

Describes how to download the Classic Migration Service CLI export tool.

To download the Classic Migration Service export tool:

  1. Open the navigation menu on the Oracle Cloud Infrastructure Console and click OCI Classic Services to list Oracle Cloud Infrastructure Classic services.
  2. Click Classic Migration to display the Classic Migration overview page.
  3. Choose your compartment from the Compartment drop-down.
  4. Click the Download Export Tool button in the Check Migration Prerequisites section to download the ams-export.linux.latest file.
  5. If the host instance is not accessible from your current device, then use a mobile storage device, such as a flash drive, to move the file onto a device which has access to the host instance.
  6. Optionally, check the authenticity of the file by comparing it to a hash of the tool, as follows:
    $ shasum -a 1 ams-export.linux.latest
    9c9504f1ce156b5689b84ca801d12caf47bec985 ams-export.linux.latest
    $ cat ams-export.linux.latest.sha1
    9c9504f1ce156b5689b84ca801d12caf47bec985

Exporting an Oracle Java Cloud Service Instance

To export an Oracle Java Cloud Service instance:

  1. Copy the ams-export.linux.latest file to the target Oracle Java Cloud Service instance, as follows:
    scp ams-export.linux.latest IP_of_JCS_instance
  2. Use SSH to connect to the target Oracle Java Cloud Service instance, as follows:
    ssh opc@IP_of_JCS_instance
  3. The export tool must be able to create and write to disk and, because the tool is run by the oracle user, it must be located in a directory where the oracle user has access. Oracle recommends that you save or move the export tool to the /u01 directory. Move the export tool, as follows:
    [opc@jcs ~]$ sudo mv ams-export.linux.latest /u01
    [opc@jcs ~]$ sudo su oracle
  4. Start the export process for the Oracle Java Cloud Service instance, as follows:
    Note

    If you do not specify a directory for the --export-dir flag, then the export tool creates a local directory in the form of export-dateTtime.
    [oracle@jcs ~]$ ./ams-export.linux.latest jcs --admin-user weblogic

    When the export tool completes, included in the export directory are two files: manifest.json and export.tar.gz.

    Display help text for the export tool, as follows:
    $ ./ams-export.linux.latest jcs --help

Exporting an Oracle SOA Cloud Service Instance

To export an Oracle SOA Cloud Service instance:

  1. Copy the ams-export.linux.latest file to the target Oracle SOA Cloud Service instance, as follows:
    scp ams-export.linux.latest IP_of_SOACS_instance
  2. Use SSH to connect to the target Oracle SOA Cloud Service instance, as follows:
    ssh opc@IP_of_SOACS_instance
  3. The export tool must be able to create and write to disk and, because the tool is run by the oracle user, it must be located in a directory where the oracle user has access. Oracle recommends that you save or move the export tool to the /u01 directory. Move the export tool, as follows:
    [opc@soacs ~]$ sudo mv ams-export.linux.latest /u01
    [opc@soacs ~]$ sudo su oracle
  4. Start the export process for the Oracle SOA Cloud Service instance, as follows:
    Note

    The following parameters are required when you export an Oracle SOA Cloud Service instance:
    • --cluster-type: Choose either MFT or B2B, depending on which type of cluster your Oracle SOA Cloud Service instance has.
    • --domain: Specify the domain from which to export. If you do not specify a domain, then the tool assumes the current domain.
    • --managed-server-name: Specify the domain name of the primary-managed domain that the host manages.
    • --managed-port: Specify the port on which the primary-managed domain listens.
    [oracle@soacs ~]$ ./ams-export.linux.latest soacs --admin-user weblogic

    When the export tool completes, included in the export directory are two files: manifest.json and export.tar.gz.

    Display help text for the export tool, as follows:
    $ ./ams-export.linux.latest soacs --help

Importing Information into the Target Application

Describes how to import information into a target application.

To import the extracted information to the target application, you must upload the export.tar.gz file to a bucket in Object Storage in Oracle Cloud Infrastructure and upload the manifest.json file directly to Classic Migration Service during the migration process.

Upload the export.tar.gz file to a bucket in Object Storage, as follows:

  1. Ensure that you can access the export.tar.gz and manifest.json files from the target Oracle Cloud Infrastructure.
  2. Open the navigation menu on the Oracle Cloud Infrastructure Console and click Storage to display the storage options.
  3. Choose a compartment from the Compartment drop-down, if you are not already in the correct compartment, to display a list of buckets in that compartment.

    Create a bucket (if you have not already done so) into which you upload the export.tar.gz file.

    See Managing Buckets for more information about creating buckets.

  4. Click the name of the bucket into which you want to upload the export.tar.gz file to display the details page for that bucket.
  5. Click the Upload button in the Objects section to display the Upload Objects dialog.
  6. (Optional) Specify a prefix in the Object Name Prefix field for the file you are uploading.
  7. Accept the default storage tier, Standard.
  8. Click the select files link in the Choose Files from your Computer section and navigate to and open the export.tar.gz file.
  9. Click the Upload button to add the file to your bucket.

    Complete the migration process, as follows:

    1. Open the navigation menu on the Oracle Cloud Infrastructure Console and click OCI Classic Services to list Oracle Cloud Infrastructure Classic services.
    2. Click Sources under Classic Migration to display the Sources in compartment details page.
    3. Click the Create Source button to open the Create Source dialog.
    4. Enter a name for the source in the Name field.
    5. In the Source type field, select Imported.
    6. Select the name of the bucket into which you uploaded the export.tar.gz file from the Name of the Bucket that contains the Source Information in compartment drop-down.
    7. Select the tar file from the Name of the Object that contains the Source Information drop-down.
    8. Click the select one... link in the Upload the Import Manifest section, and navigate to and open the manifest.json file.
    9. Click the Create button to display the details page for the new source.
    10. Click the Create Migration button to display the Create Migration dialog.
    11. Select the source application from the Application drop-down.

      Depending on the source application you choose, the system selects either Oracle SOA Suite on Marketplace or Oracle Java Cloud Service in the Target Instance Type section.

    12. Click the Create button to display the details page for the new migration.
    13. To configure the migration, see either Configure and Migrate Oracle SOA Cloud Service or Configure and Migrate Oracle Java Cloud Service to complete the migration process, depending on your target application.