Export an On-Premises WebLogic Domain

Only Oracle Cloud at Customer This topic applies only to Oracle Cloud at Customer.

Use the AppToCloud Client to capture your on-premises WebLogic Server domain and applications, and move them to a cloud storage container that’s accessible to your Oracle Java Cloud Service environment.

The Export process captures a domain’s configuration and Java applications. It updates the archive file that was previously generated by the Health Check procedure, generates a JSON file, and uploads these AppToCloud artifacts to a storage container in the Oracle Cloud Infrastructure Object Storage Classic. If the machine hosting the AppToCloud tools does not have access to the Internet, you can manually upload the output files to your storage container after performing the Export.

The AppToCloud Client can be used to perform both the Health Check and Export tasks. Alternatively, you can perform these tasks from the command line or a script.

Determine the credentials used to access Oracle Cloud Infrastructure Object Storage Classic. This is often the same user that you use to access the Oracle Java Cloud Service console. Choose from one of these options:

  • Enter the credentials in the AppToCloud Client user interface.

  • Use the AppToCloud Client to store the credentials in a new Oracle Wallet file, or select credentials in an existing file.

If the source domain does not contain a cluster, the AppToCloud Client will prompt you to add the managed servers in the domain to a new cluster in the exported domain configuration. The original source domain is not modified. If there are multiple managed servers, the same resources and applications must be targeted to all of them.

If your source domain contains multiple clusters, the AppToCloud Client will prompt you to either export all of the clusters or a specific cluster. You can export all clusters only if your Oracle Cloud account includes Oracle Identity Cloud Service.

Any warnings or errors that the Export tool detects are written to a log, an HTML report, and the archive file.

To export a WebLogic Server domain:

  1. Launch the a2c-client and perform a Health Check if not done previously.
  2. Click Go to Export.

    The Export page is displayed.

    Another way to access the Export page is to click the menu icon in the top left corner and select Export.

    The values of the Oracle Home and Archive File fields are set automatically based on your previous Health Check parameters. Alternatively, use the Health Check output, report or log to identify the path and filename of the generated archive file. For example, /u01/jcs_a2c_output/domain1.zip. Use the folder icons to browse your local file system.

  3. Specify the top level Domain Directory.

    For example, /u01/domains/domain1.

  4. If you do not want the AppToCloud Client to upload the generated files to Oracle Cloud, clear the check box Upload to Cloud Storage and skip to step 11.
  5. Select Metered Storage if you have a metered subscription to Oracle Cloud Infrastructure Object Storage Classic. If you have a non-metered subscription, enter your storage Service Name.
  6. Provide the name of a cloud user that has access to Oracle Cloud Infrastructure Object Storage Classic. Select from these Authentication options:
    • Password: Enter your Cloud Storage User and Cloud Storage Password.
    • Wallet: Proceed to the next step.
  7. If you selected the Wallet authentication option:
    1. Click the folder icon next to Wallet Directory.

      The Change Wallet dialog is displayed.

    2. Choose to use an existing wallet or create a new one. Then click OK and follow the instructions:
      • Select an existing wallet: Select the folder containing the wallet. Enter a password if one is required.

      • Create a new wallet: Select a folder for your new wallet.

      • Create a new encrypted wallet: Select a folder for your new wallet and then enter a password.

    3. Click the user icon next to Cloud Storage User Alias.

      The Select Credential dialog is displayed.

    4. Select an existing credential in the wallet or click New to create a new one.

      For a new credential, enter its Alias, User and Password.

      Click OK to return to the main Export page.

  8. Enter your Oracle Cloud Identity Domain.
  9. Click the folder icon for Cloud Storage Container.

    The Select Cloud Storage Container dialog is displayed.

  10. Select an existing storage container from the list or click New to create a new one. Then click OK.
  11. Click Run Export.
  12. If the WebLogic Server domain contains multiple clusters, click Yes to export a specific cluster, or click No to export all clusters.

    If you clicked Yes, then select the cluster to export and click OK.

    Note:

    You can export all clusters only if your Oracle Cloud account includes Oracle Identity Cloud Service.
  13. Use the Progress, Report and Log tabs to verify that the Export completed successfully. Also note the name of the generated JSON file.

    An example Progress output:

    Discovering mail sessions for domain domainName
    Discovering Coherence clusters for domain domainName
    Discovering WLDF modules for domain domainName
    Discovering server classpath and system property settings for domain domainName
    End of the Environment discovery
    Adding application to the archive: myapp from /u01/apps/myapp.ear
    Sucessfully exported model and artifacts to outputDirectory/domainName.zip
    Overrides file written to outputDirectory/domainName.json
    Uploading override file to cloud storage from outputDirectory/domainName.json
    Uploading archive file to cloud storage from outputDirectory/domainName.zip
    Successfully exported model and artifacts to cloudStorageURL. Overrides file written to containerName/domainName.json 

    An example Log output:

    Activity Log for EXPORT
    
    Informational Messages:
    Other informational messages
    Uploaded override file to Oracle Cloud Storage container containerName
    Uploaded archive file to Oracle Cloud Storage container containerName
    
    Warning Messages:
    Any warning messages
    
    Error Messages:
    Any error messages
    
    Features Not Yet Implemented Messages
    Any messages about features not yet supported by the export tool
    
    An HTML version of this report can be found at outputDirectory/reports/reportFile
    
    Successfully exported model and artifacts to cloudStorageURL. Overrides file written to containerName/domainName.json
    
    a2c-export completed successfully (exit code = 0)
  14. Address any problems described in the Error Messages section of the Report or Log. Then click Run Export again.

    By default the Export will fail if the previous Health Check resulted in any errors. Alternatively, click the Settings icon and select the Force AppToCloud Export check box. However, Oracle strongly recommends that you only export domains that have successfully passed the Health Check.

    The tool will output a warning message if any of the servers in your source domain include the current directory (.) in its CLASSPATH. If this server has been started by using the WebLogic Node Manager, the Node Manager adds the current directory to the server’s CLASSPATH. Therefore you can ignore this warning message if using the Node Manager.

  15. If you did not use the AppToCloud Client to upload the generated files to Oracle Cloud Infrastructure Object Storage Classic, then manually upload these files as objects to an existing storage container:
    • outputDirectory/domainName.zip

    • outputDirectory/domainName.json

    See Creating Containers and Creating a Single Object in Using Oracle Cloud Infrastructure Object Storage Classic.

After exporting your domain and uploading the files to a storage container, you are ready to create an Oracle Java Cloud Service instance.

If the output from the Export includes messages about features that are not yet implemented, you will need to manually configure these features after creating your service instance.