This topic applies only to Oracle Cloud at Customer.
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:
- Launch the
a2c-clientand perform a Health Check if not done previously.
- 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.
- Specify the top level Domain Directory.
- 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.
- 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.
- 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.
- If you selected the Wallet authentication option:
- Click the folder icon next to Wallet Directory.
The Change Wallet dialog is displayed.
- 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.
- Click the user icon next to Cloud Storage User Alias.
The Select Credential dialog is displayed.
- 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.
- Click the folder icon next to Wallet Directory.
- Enter your Oracle Cloud Identity Domain.
- Click the folder icon for Cloud Storage Container.
The Select Cloud Storage Container dialog is displayed.
- Select an existing storage container from the list or click New to create a new one. Then click OK.
- Click Run Export.
- 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.
- 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)
- 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.
- 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:
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.