10 Importing and Exporting Oracle Service Bus Resources

This chapter provides instructions for importing and exporting Service Bus projects and resources using Fusion Middleware Control.

This chapter includes the following topics:

• About Importing and Exporting Oracle Service Bus Resources

• Exporting Oracle Service Bus Resources in Fusion Middleware Control

• Importing Oracle Service Bus Resources in Fusion Middleware Control

10.1 About Importing and Exporting Oracle Service Bus Resources

In Fusion Middleware Control, you can import a full configuration JAR file or just a subset of the resources included in the JAR file. You can also export full configuration JAR files from the console.

A configuration JAR file contains projects or resources that were previously exported from a Service Bus instance. If a resource you are importing already exists in the importing system, that resource is updated. Resources are only scheduled for deletion when the JAR file being imported contains full projects and there are resources located in the same projects in Fusion Middleware Control that are not present in the imported JAR file. Resources in other projects are not deleted.

At the same time you import Service Bus resources, you can also import a configuration file that defines environment values specific to the domain in which you are working. Environment values can include URLs for services, file locations for certain transports, host names, port numbers, and so on. They can also include operational settings at the global and service levels, as well as updates to resource references. For more information about configuration files, see Customizing Oracle Service Bus Environments.

The import and export features also apply to JDeveloper and the Oracle JDeveloper and the Oracle Service Bus Console. For information and instructions, see Importing and Exporting Resources and Configurations in Developing Services with Oracle Service Bus. That chapter also provides information about the import and export processes, including how resources are created, updated, or deleted during the import, and how security settings and operational settings are handled. It also includes information on improving the performance of large imports by using the oracle.osb.config.parallelism system property.

10.2 Exporting Oracle Service Bus Resources in Fusion Middleware Control

You can export Service Bus projects or individual resources from projects. The export feature lets you select the projects or resources you want to export from a list of all projects and resources on the server.

When you export from the project level, you can expand the list to view all resources, but you can only select at the project level. For resource-level exports, Service Bus gives you the option of automatically including any resources referenced by the resources you select in the exported file . This way, you can avoid conflicts caused by broken references when you re-import the file.

You cannot export the users, groups, or roles associated with the projects and resources to export. Credential maps or other security-provider data created in the WebLogic Server Administration Console are also not exported. Instead, use the WebLogic Server Administration Console to export this data. See Migrating Security Data in Oracle Fusion Middleware Securing Oracle WebLogic Server.

When you export projects or resources, you can enter a passphrase to encrypt the user name and password included service account, service key provider, UDDI Registry, JNDI Provider, or SMTP provider resources. When you re-import the JAR file, you need to specify the passphrase again. The following figure shows the Export Resources page.

Figure 10-1 Export Resources Page

Description of "Figure 10-1 Export Resources Page"

To export Oracle Service Bus resources:

1. In the Target Navigator in Fusion Middleware Control, expand SOA and expand the Service Bus server from which you want to export resources.
2. Right-click the name of the Service Bus server or project in the server and select Export.

   Tip:

   You can also select Export from the Service Bus or Service Bus Project menu.

3. On the Export Resources page, select Projects to export complete projects or select Resources to export individual resources.
4. For a resource-level export, select Include Resource Dependencies to export any additional resources referenced by the selected resources. Clear the check box to only export the resources you select.
5. Expand the list of resources, and make sure only the ones you want to export are selected.
6. To encrypt sensitive data in the exported resources, enter the password to unlock the file in the Pass-phrase and Confirm Pass-phrase fields.

   For more information, see "Data Encryption During Export" in Developing Services with Oracle Service Bus.

7. Click Export.
8. On the Processing:Export Projects dialog, click Save.
9. On the File Download dialog, click Save, specify a location and filename for the configuration JAR file and click Save again.

   Service Bus generates the configuration JAR file in the location you specified.

10. To close the Processing: Export Projects dialog, click the "X" in the upper right corner of the dialog.

10.3 Importing Oracle Service Bus Resources in Fusion Middleware Control

Use the Fusion Middleware Control import feature to import Service Bus projects or resources that were previously exported from a Service Bus instance. Be sure to verify the import summary to be sure you are only updating or deleting the correct resources.

The configuration JAR file you import excludes users, groups, roles, and certificates from the original projects. If these existed in the original projects, recreate them when you import an exported configuration. Importing a project can also update the operational settings.

If the configuration JAR file you are importing was exported with a passphrase, meaning any authentication information contained in the resources was encrypted, you need to specify that same passphrase when you import the JAR file. You can import any unencrypted resources if you do not know the passphrase. When you import a configuration JAR file, you also have the option to import a configuration file to set environment values for the imported resources. For more information, see Using Configuration Files to Update Environment Values and Operational Settings.

The following figure shows the Import Resources page.

Figure 10-2 Import Resources Page

Description of "Figure 10-2 Import Resources Page"

To import Oracle Service Bus resources:

1. In the Target Navigator in Fusion Middleware Control, expand SOA and expand the Service Bus server to which you want to import resources.
2. Do one of the following:

   • To import a project at the domain level, right-click the name of the Service Bus server and select Import.

   • To import Service Bus resources into a Service Bus project, right-click the name of the project and select Import.

   Tip:

   You can also select Import from the Service Bus or Service Bus Project menu.

3. On the Import Resources page, click Browse next to the Jar Source field to navigate to and select the JAR file to import.
4. Optionally, click Browse next to the Configuration File field to navigate to and select a configuration file to import.
5. Click Next.

   A list of resources included in the selected source appears, along with the type of operation (create, update, or delete) to be performed on each.

6. Expand the list of resources, and make sure only the ones you want to import are selected.

   Caution:

   Make sure that you want to delete any existing resources that are marked for deletion in the list. If you do not want them to be deleted, clear their check boxes.

7. If a resource references other resources, the number of references appears in the References column. Click the number to view details about the referenced resources.
8. For a resource-level import, select Include Dependencies to automatically import any dependent resources.
9. If the imported source is password protected, enter the password in the Pass-phrase field.
10. Select any of the advanced settings to keep in the imported resources.

    For information about these settings see the online help and "Preserving Security Configuration During Import" in Developing Services with Oracle Service Bus.

11. Click Finish.

    The selected resources are imported and a summary of the import process appears.