31 Export and Import of Domain Partitions

This chapter provides an overview of exporting and importing Oracle WebLogic Domain Partitions. Oracle WebLogic Server supports WebLogic domain partition functionality. Partition functionality is introduced and supported through WebLogic Server Multitenancy feature. It consolidates applications into fewer domains with partition within domains and maintains secured isolation. It provides increased efficiency and reduced cost. For more information on WebLogic Server Multitenancy, see WebLogic Server Multitenant in the Oracle® Fusion Middleware Using WebLogic Server Multitenant guide. The WebLogic domain partition can be exported and imported between WebLogic Server domains. Export or import is also supported between domains residing on different Enterprise Manager deployments. In particular, this chapter covers the following:

31.1 About Exporting and Importing WebLogic Domain Partitions

A domain partition (partition for short) is an administrative and runtime slice of a WebLogic domain. Multi-Tenancy provides shared infrastructure for use by multiple organizations. These organizations are a conceptual grouping of tenants. Multiple tenants are supported in a single domain. It improves density and achieves more efficient use of resources and eliminates the following hurdles involved in sharing multiple applications:

  1. Runtime Cross-Application impact

  2. Security differences

  3. Data Co-Mingling

  4. Administrative challenges

A domain partition is an administrative portion of a domain that can be managed independently and can share runtime capacity in a domain, that is, the managed servers and clusters. Each domain partition has its own runtime copy of the applications and resources. It provides application isolation and efficiency. Multiple instances of an application can run in different domain partitions without modifying the application.

Domain partitions use fewer server and domain resources. This enables you to simplify the management of Software As a Service (SaaS) and Platform As a Service (PaaS) applications.

Oracle WebLogic Server supports WebLogic domain partition functionality. A single WebLogic domain can contain several partitions, each capable of having its own set of services like JDBC, JMS, SAF, applications, and security realm. Oracle WebLogic Multitenant Server provides resource isolation within a domain partition which is an administrative and runtime slice of a WebLogic domain. It runs application instances and related resources for a tenant. Domain partitions achieve greater density by allowing application instances and related resources to share the domain, WebLogic Server, Java virtual machine, and operating system While isolating Tenant-Specific application data, configuration, and runtime traffic.

A partition can contain one or more resource groups. These resource groups can be converted to templates. A domain partition can be exported and imported into a new or same domain. This export or import functionality moves the services and applications that are part of the partition. This functionality is primarily used in Enterprise Manager to provision partitions on demand. The key capabilities and limitations of the WebLogic domain partition functionality are:

  • Partition export or import is supported.

  • An empty partition cannot be created.

  • One partition can be exported at a time from a domain.

  • One partition can be imported into one domain at a time.

  • The applications and services running in the domain are cloned along with the partition. They can neither be deleted nor can new ones be added during provisioning.

See Also

31.2 Exporting WebLogic Domain Partition

Note:

Exporting WebLogic domain partition functionality is supported from WLS version 12.2.1.0.0 onwards.

To export a domain partition, follow these steps:

  1. From the Targets menu, select Middleware.
  2. Expand the Target Type and check the option against WebLogic to view a list of WebLogic targets.
  3. Right click on the WebLogic Domain target, and from the Provisioning menu, click Create Provisioning Profile and select By Exporting WebLogic Domain Partition option and click Next.
  4. Enter a profile name in the Name field under the Profile tab.

    Note:

    As part of the export process, the Enterprise Manager creates a profile of the partition and stores in the software library. The profile contains exported partition archive and some metadata that helps the Enterprise Manager in the importing process.

  5. Enter the description of the profile created in the Description field.
  6. In the WebLogic Domain Partition field select the partition.
  7. Verify the values in the fields Domain Home and Oracle Home.
  8. Select the values for the remaining fields Oracle Home Credential, WebLogic Administrator Credential, and Working Directory.

    Note:

    The temporary staging directory of the agent is used by default, to copy the script and generate archives. In case this directory does not have enough permissions or space, the user can specify another directory.

  9. In the Software Library Upload Location, select the Software Library storage details. Ensure to provide a valid storage type and upload location to update the profile.
  10. Click Create.

    Note:

    Exporting WebLogic Domain Partition operation can be performed using EMCLI verb create_partition_profile. See create_partition_profile in the Oracle® Enterprise Manager Command Line Interface.

You can view the profile created in the Middleware Provisioning page. The new profile will be shown in the Profiles table, select the name of the profile to view more details.

See Also

31.3 Importing WebLogic Domain Partition

Note:

Importing WebLogic domain partition functionality is supported from WLS version 12.2.1.0.0 onwards.

To import a domain partition into an existing WebLogic domain, follow these steps:

  1. From the Targets menu, select Middleware.
  2. Expand the Target Type and check the option against WebLogic to view a list of WebLogic targets.
  3. To import the WebLogic Domain Partition, right click on the domain where you want to import the partition.
  4. From the Provisioning menu, select Import WebLogic Domain Partition.

    You can also import WebLogic Domain Partition from the Middleware Provisioning page. From the Enterprise menu, select Provisioning and Patching and click Middleware Provisioning. Select a profile under the Profiles table and click Import Partition button. The profile must have been created by either exporting a domain or by exporting a partition

  5. Under the General tab, select a profile under the WebLogic Domain Partition Profile field.
  6. Click on the View icon to view the profile details.
  7. Upon selecting a profile, the values in the following fields are prefilled:

    • WebLogic Domain Partition

    • Virtual Targets

    • Database

    Note:

    The Database field is filled only if the source partition has data sources.

  8. The details of the profile can be viewed by clicking on the view icon available next to the WebLogic Domain Partition Profile field. The details include information on Data Sources, JMS Servers, Applications, and Virtual Targets.

    If you like to make an advanced configuration, click Use Custom JSON file and enter the location of custom well-formed JSON file in the JSON File Location field.

    Note:

    You can download the JSON file from Profile Viewer. Click the View icon next to the profile search icon and download it from the attachments table. You can then modify it and copy it to the Administration Server host of the domain and provide that location in the JSON File Location field.

  9. Enter the credentials in fields Oracle Home Credential and WebLogic Administrator Credential by using the search icon against the fields.
  10. Enter a unique name in the Partition Name field.
  11. Under the Virtual Targets tab, in the Targets field choose the virtual targets from the drop down menu. The host name specified must have DNS entries that resolve to the correct server or load balancer. If the host name is not specified then it is equivalent of wildcarding the host name to match all incoming requests.

    Note:

    Two virtual targets cannot be mapped to the same target in a partition.

  12. Choose a database under the Database tab against the Connection String field.

    Note:

    This is optional and has to be executed only if the source partition has data source. Ensure that the schema is already created, the database services are up and running and the database service has the same name mentioned in the data source.

    While selecting the target in the Select target window the following database types are available:

    • Cluster Database

    • Database Instance

    • Pluggable Database

  13. Enter a password in the Schema Password field.
  14. Click Next and confirm the changes.

Importing WebLogic Domain Partition operation can be performed using EMCLI verb too. Use the following steps.

  1. The generic submit_procedure EMCLI verb is used to import WebLogic Domain Partition. Launch the import partition user interface from the desired domain target.

  2. Enter all the required details.

  3. Navigate to the next page.

  4. Click Save.

  5. Enter the unique SAVED_CONFIG_NAME.

  6. Execute the following command:

    emcli describe_procedure_input -name=SAVED_CONFIG_NAME > input.properties

  7. Un-comment the secret variables like passwords and provide values for them.

  8. Submit the procedure by executing the following command:

    emcli submit_procedure -name=ProvisionPartition -input_file=data:input.properties [-instance_name=UNIQUE_SUBMISSION_NAME]

Note:

For more details on the verbs, see Deployment Procedure Verbs in the Enterprise Manager Command Line Interface.

See Also