23 WebLogic Server Domain Partitions

This chapter describes the tasks you can perform to monitor, control, and configure a domain partition. A domain partition is an administrative and runtime slice of a WebLogic Server domain that is dedicated to running application instances and related resources.

Domain partitions achieve greater density by allowing application instances and related resources to share the domain, WebLogic Server itself, the Java virtual machine, and the operating system while isolating tenant-specific application data, configuration, and runtime traffic. Each domain partition has its own runtime copy of the applications and resources. Changes in how WebLogic Server handles class loading provide both application isolation and efficiency. Deploying to multi-tenant environments requires no changes to your applications. For example, you could run multiple instances of a payroll application in different domain partitions without modifying the application.

For more information on WebLogic Server domain partitions, see Using WebLogic Server MT.

Note:

If you are logged into a domain partition, navigate from the Domain Partition menu.

This chapter includes the following sections:

Creating domain partitions: prerequisites

Before you can create a domain partition, you must satisfy the following prerequisites:

  1. If you have not already done so, then create the domain you plan to use.

    Use the Oracle Enterprise Manager - Restricted JRF template to create the domain. This template automatically includes several other necessary templates.

    The best practice is to create a new domain.

    If you plan to upgrade an existing domain, then you must still create a new security realm.

  2. If you are using OTD for load balancing, then configure the OTD runtime configuration. See Configuring Oracle Traffic Director in Using WebLogic Server MT for the steps to follow.

  3. If you have not already done so, then create one or more virtual targets. See WebLogic Server Virtual Targets for the steps to follow.

  4. If you want to use a resource group template with this domain partition, then create the resource group template first. See WebLogic Server Resource Group Templates for the steps to follow.

  5. If you have not already done so, then create the security realm for the domain partition. Each domain partition must have a security realm. The security realm can be unique to this domain partition, or shared by multiple domain partitions. See WebLogic Server Security for the steps to follow.

Create domain partitions

To create a domain partition:

  1. From the WebLogic Domain menu, select Environment, then select Domain Partitions.

    The Domain Partitions summary table displays information about the state of each domain partition that has been configured in the current WebLogic Server domain.

  2. In the summary of domain partitions table, click Create.
  3. Enter the domain partition name. The domain partition name must be unique within the domain.
  4. From the Security Realm dropdown, select the security realm for this domain partition.

    The security realm can be unique to this domain partition, or shared by multiple domain partitions.

  5. You can leave the Primary Identity Domain field blank to accept the default. See Configuring Security in Using WebLogic Server MT for additional information.
  6. If you are using OTD for load balancing, then select the OTD runtime configuration.
  7. Click Next.
  8. Select one or more existing virtual targets to be available for this domain partition to use. Multiple domain partitions cannot use the same virtual target. You can use a virtual target either with one domain partition or at the domain level.
  9. Select Set As Default to use this virtual target with any resource group that does not explicitly set one.
  10. Click Next.
  11. Create the resource group. You can create the resource group in two ways:

    • Create a new resource group. When you finish creating the domain partition you must then edit this resource group as needed.

      Enter the resource group name. The resource group name must be unique within the domain partition.

    • Create the new resource group based on a resource group template. The configuration is copied from the template to the new resource group.

      Enter the resource group name. The resource group name must be unique within the domain.

      Enter the resource group name. The resource group name must be unique within the domain.

  12. Select the virtual targets that this resource group will use and move them from the Available Targets list to Selected Targets.
  13. Click Next.
  14. Click Next.
  15. Click Create.
  16. If this is the first partition you have created in this domain, and the domain is running in production mode, then restart the WebLogic Server Administration Server. This step is needed only for the first partition you create for a domain, and only when the domain is running in production mode.
  17. In the summary of domain partitions table, select the domain partition you created and click Start.
  18. If you did not create the resource group from a resource group template, then the initial resource group configuration is a basic shell and you must configure it before you can use it.

    You perform most of the configuration required for a domain partition when you configure the resource group or resource group overrides. The tasks include configuring JDBC system data sources, JMS servers and resources, foreign JNDI providers, and so forth.

    These tasks are described in WebLogic Server Resource Groups and WebLogic Server Resource Overrides, respectively.

Configure domain partitions

This section describes how to configure your domain partition. This section focuses on the management tasks you perform on the domain partition itself, and not on the associated resource groups.

The following topics are described:

Configure domain partition general properties

To configure general properties for a domain partition:

  1. From the Domain Partition menu, select Administration, then select General Properties.
  2. On the General Properties page, define the following settings for the domain partition:

    • Security Realm

    • File System Root

    • Create on Demand

    • Preserved

    • JTA Timeout Seconds

  3. Click Save.

For more information about these fields, see Configuration Options.

Configure domain partition virtual targets

To select virtual targets to use with this domain partition:

  1. From the Domain Partition menu, select Administration, then select Available Targets.
  2. From the Available Targets page, you can select the virtual targets that will be available to use with this domain partition. Virtual targets can be used only by one domain partition, so only available virtual targets are listed.
  3. Select the Set As Default control to use this domain partition with a resource group that does not explicitly set a virtual target.
  4. Click Save.

See Configuration Options.

Configure domain partition resource groups

To view and configure the resource groups in the domain partition:

  1. From the Domain Partition menu, select Administration, then select Resource Groups.

    The Resource Groups summary table displays information about the resource groups that has been configured in the current domain partition, such as:

    • Name

    • Resource Group Template

    • State

    • Targets

    • Notes

    See Configuration Options.

  2. To create a new resource group for this domain partition, click Create. See Create resource groups.
  3. To delete an existing resource group, click Delete.
  4. To migrate a resource group to a new target, click Migrate. When you migrate a resource group, you transfer all deployed resources of the resource group from one physical target (cluster/ server) to another. After migration, the virtual target points to the new physical target (cluster / server).

Configure load balancer configuration

You must first configure the OTD runtime configuration before you can use it with a domain partition. See Configuring Oracle Traffic Director in Using WebLogic Server MT for the steps to follow.

To configure the load balancer configuration:

  1. From the Domain Partition menu, select Administration, then select Load Balancing Configuration.
  2. Click Use OTD for Load Balancing.
  3. From the OTD Runtime dropdown, select the OTD runtime configuration.
  4. Click Save.

See Configuration Options.

Configure domain partition resource overrides

To override properties for resources in this domain partition:

  1. From the Domain Partition menu, select Administration, then select Resource Overrides.

    The Resource Overrides page displays information about the resources in the domain partition, such as:

    • Name

    • Resource Type

    • Resource Group

    • Has Overrides

    • Edit Overrides

    See Configuration Options.

  2. To override properties or edit existing overrides for a resource, select the resource and click the Edit Overrides icon. See WebLogic Server Resource Overrides.
  3. Enter the override values and click OK.

Configure domain partition resource sharing

To configure resource sharing policies for this partition:

  1. From the Domain Partition menu, select Administration, then select Resource Sharing.
  2. Select an existing, domain-level Partition Work Manager to use in this partition or define Partition Work Manager attributes for use in this domain partition only.

    Note that domain-level Partition Work Managers can be used in more than one domain partition. However, a domain partition can be associated with only one Partition Work Manager.

    See Create Partition Work Managers.

  3. Create a Resource Manager configuration, or select an existing Resource Manager to use.

    You can create the Resource Manager configuration in two ways:

    • Specify the Resource Manager policies on this page.

      Enter the Resource Manager name. The Resource Manager name must be unique within the domain partition.

      Click Create.

      Specify the policy type, action limits, and fair share.

    • Select a Resource Manager that is already defined for this domain.

See Configuration Options.

Configure domain partition Coherence caches

To add or delete Coherence caches in the domain partition:

  1. From the Domain Partition menu, select Administration, then select Coherence Caches.

    The Coherence Caches summary table displays information about the domain partition caches that has been configured in the current domain partition, such as:

    • Name

    • Cache Name

    • Application Name

    • Shared

    • Override Properties

    • Edit Overrides

    See Configuration Options.

  2. To add a new Coherence cache for this domain partition, click Add.

    Define the properties for the new partition cache and click Save.

  3. To delete an existing Coherence cache, click Delete.
  4. To override properties or edit existing overrides for a Coherence cache, select the Coherence cache and click the Edit Overrides icon.

    Enter the override values and click OK.

Create domain partition notes

To create notes for domain partition configuration:

  1. From the Domain Partition menu, select Administration, then select Notes.
  2. On the Notes page, enter your notes.
  3. Click Save.

See Configuration Options.

Monitor domain partitions

This section includes the following tasks:

Monitor domain partitions

To monitor the domain partitions created in the domain:

  1. From the WebLogic Domain menu, select Environment, then select Domain Partitions.

    The Domain Partition table displays information about the domain partitions in this domain, such as:

    • Name

    • Status

    • State

    • OTD Partition

    • Realm

    • Default Targets

    • Available Targets

    • Resource Groups

    For more information about these fields, see Configuration Options.

    Optionally, select View on any page to access the following table options:

    • Columns: add or remove the columns displayed in the table

    • Detach: detach the table (viewing option)

    • Sort: sort the columns in ascending or descending order

    • Reorder: change the order of the columns displayed

    • Query by Example

  2. Select the name of the domain partition for which you want to view configuration information.

Monitor domain partition deployments

To monitor the status of all deployments in a domain partition:

  1. From the Domain Partition menu, select Monitoring, then select Deployments.

    The Deployments (Monitoring) Summary page is displayed.

    The Deployments table displays information about the applications in this domain partition, such as:

    • Name

    • Status

    • State

    • Health

    • Type

    • Deployment Order

    • Resource Group

    • Tags

    • Targets

    For more information about these fields, see Configuration Options.

    To monitor specific deployments in the domain partition, select the appropriate pages:

    • Web Applications: monitor Web applications; includes information such as the machine and server instance on which the Web application is deployed and statistics about the number of servlets and sessions associated with the Web application

      See Configuration Options.

    • Resource Adapters: monitor the status of the current state of message listener endpoints and outbound connection pools for resource adapters

      See Configuration Options.

    • EJBs: monitor statistics about stateless, stateful, singleton, entity, and message driven EJBs

      See Configuration Options.

    • Web Services: monitor all the Web services in this domain partition

      See Configuration Options.

    • Web Service Clients: monitor all Web service clients in this domain partition

      See Configuration Options.

    • JAX-RS Applications: monitor the JAX-RS applications running in this domain partition

      See Configuration Options.

    • Workload: view statistics for the Work Managers, constraints, and policies that are configured for application deployments in this domain partition

      See Configuration Options.

    Optionally, select View on any page to access the following table options:

    • Columns: add or remove the columns displayed in the table

    • Detach: detach the table (viewing option)

    • Sort: sort the columns in ascending or descending order

    • Reorder: change the order of the columns displayed

    • Query by Example

Monitor domain partition JDBC data sources

To monitor the status of all JDBC data sources created in a domain partition:

  1. From the Domain Partition menu, select Monitoring, then select JDBC Data Sources.

    The JDBC Data Sources table lists the JDBC data sources that have been created in the domain partition and displays related status information, such as:

    • Name

    • Partition

    • Type

    • Resource

    • Scope

    • Server

    • Instances

    • ONS

    • State

    For more information about these fields, see Configuration Options.

    Optionally, select View to access the following table options:

    • Columns: add or remove the columns displayed in the table

    • Detach: detach the table (viewing option)

    • Sort: sort the columns in ascending or descending order

    • Reorder: change the order of the columns displayed

    • Query by Example

  2. To create a new JDBC data source in the domain partition, click Create. See Create JDBC data sources.
  3. To delete an existing JDBC data source, click Delete.

Monitor domain partition JMS servers

To monitor JMS servers created in this domain partition:

  1. From the Domain Partition menu, select Monitoring, then select Messaging and JMS Servers.

    The JMS Server summary table displays information about the state of each JMS server that has been configured in the current domain partition, such as:

    • Name

    • Resource Group

    • Health

    • Target

    • Current Target

    • Running On

    • Production Paused

    • Consumption Paused

    • Insertion Paused

    • Messages Current

    • Messages Pending

    • Messages Received

    • Messages Paged Out Total

    • Bytes Current

    For more information about these fields, see Configuration Options.

    Optionally, select View to access the following table options:

    • Columns: add or remove the columns displayed in the table

    • Detach: detach the table (viewing option)

    • Sort: sort the columns in ascending or descending order

    • Reorder: change the order of the columns displayed

    • Query by Example

  2. In the table, select the name of the JMS server you want to monitor.

    You can choose from the following action menus:

    • Production

    • Consumption

    • Insertion

Monitor domain partition Store-and-Forward agents

To monitor Store-and-Forward agents created in this domain partition:

  1. From the Domain Partition menu, select Monitoring, then select Messaging and Store-and-Forward Agents.

    The Store-and-Forward Agents summary table displays information about the state of each Store-and-Forward agent that has been configured in the current domain partition, such as:

    • Name

    • Resource Group

    • Agent Type

    • Remote Endpoints Current

    • Remote Endpoints High

    • Remote Endpoints Total

    • Conversations Current

    • Conversations High

    • Conversations Total

    • Paused for Incoming

    • Paused for Forwarding

    • Paused for Receiving

    For more information about these fields, see Configuration Options.

    Optionally, select View to access the following table options:

    • Columns: add or remove the columns displayed in the table

    • Detach: detach the table (viewing option)

    • Sort: sort the columns in ascending or descending order

    • Reorder: change the order of the columns displayed

    • Query by Example

  2. In the table, select the name of the Store-and-Forward agent for which you want to view configuration information.

    You can choose from the following action menus:

    • Incoming

    • Forwarding

    • Receiving

Monitor domain partition JMS resources and modules

This section includes the following topics:

Monitor domain partition JMS resources

You can view all the resources from all the JMS system modules created in the current domain partition. You can also view monitoring information, including the resource's system module, JNDI name, targeted subdeployment resources, and the resource group on which the resource is targeted.

For certain resources, you can monitor detailed statistical information or perform control operations.

To monitor all JMS system resources in the domain partition:

  1. From the Domain Partition menu, select Monitoring, then select Messaging.
  2. Select JMS Resources.

    The JMS Resources table lists all the resources that are defined as part of all JMS system modules configured in the domain partition:

    From the JMS Resources table, you can monitor information about each JMS system module resource, such as:

    • Name

    • Type

    • JMS Module Name

    • JNDI Name

    • Subdeployment

    • Resource Group

    For more information about these fields, see Configuration Options.

    Optionally, select View to access the following table options:

    • Columns: add or remove the columns displayed in the table

    • Detach: detach the table (viewing option)

    • Sort: sort the columns in ascending or descending order

    • Reorder: change the order of the columns displayed

    • Query by Example

  3. In the table, select the name of the JMS system resource for which you want to view additional monitoring information.
  4. To create a new JMS resource in the domain partition, click Create. See Create JMS resources.
  5. To delete an existing JMS resource, click Delete.

Monitor domain partition JMS modules

You can monitor the JMS system modules created for the domain partition. The table specifies which resource types are part of each module, as well as the number of assigned resource types.

To monitor JMS modules:

  1. From the Domain Partition menu, select Monitoring, then select Messaging.
  2. Select JMS Modules.

    The JMS Modules table lists the resource group for all the JMS system modules configured in the domain partition and displays the number of JMS system resource types configured for each module, such as:

    • Resource Group

    • Queues

    • Topics

    • Connection Factories

    • Distributed Queues

    • Distributed Topics

    For more information about these fields, see Configuration Options.

    Optionally, select View to access the following table options:

    • Columns: add or remove the columns displayed in the table

    • Detach: detach the table (viewing option)

    • Sort: sort the columns in ascending or descending order

    • Reorder: change the order of the columns displayed

    • Query by Example

  3. In the table, select the name of the JMS module for which you want to view additional monitoring information.
  4. To create a new JMS module in the domain partition, click Create. See Create JMS modules.
  5. To delete an existing JMS module, click Delete.

Monitor domain partition path services

To monitor path services created in this domain partition:

  1. From the Domain Partition menu, select Messaging, then select Path Services.

    The Path Services summary table displays information about the state of each path service that has been configured in the current domain partition, such as:

    • Name

    • Target

    • Persistent Store

    • Resource Group

    For more information about these fields, see Configuration Options.

    Optionally, select View to access the following table options:

    • Columns: add or remove the columns displayed in the table

    • Detach: detach the table (viewing option)

    • Sort: sort the columns in ascending or descending order

    • Reorder: change the order of the columns displayed

    • Query by Example

  2. In the table, select the name of the path service for which you want to view configuration information.
  3. To create a new path service in the domain partition, click Create. See Create path services.
  4. To delete an existing path service, click Delete.

Monitor domain partition messaging bridges

To monitor the messaging bridge instances that have been configured for the domain partition:

  1. From the Domain Partition menu, select Monitoring, then select Messaging.
  2. Select Messaging Bridges to display information about the messaging bridge instances that have been configured in the current domain partition, such as:

    • Name

    • Resource Group

    • Server

    • State

    • Description

    For more information about these fields, see Configuration Options.

    Optionally, select View to access the following table options:

    • Columns: add or remove the columns displayed in the table

    • Detach: detach the table (viewing option)

    • Sort: sort the columns in ascending or descending order

    • Reorder: change the order of the columns displayed

    • Query by Example

Monitor domain partition JMS bridge destinations

To monitor JMS bridge destinations created in this domain partition:

  1. From the Domain Partition menu, select Messaging, then select JMS Bridge Destinations.

    The JMS Bridge Destinations summary table displays information about the state of each JMS bridge destination that has been configured in the current domain partition, such as:

    • Name

    • Adapter JNDI Name

    • Resource Group

    For more information about these fields, see Configuration Options.

    Optionally, select View to access the following table options:

    • Columns: add or remove the columns displayed in the table

    • Detach: detach the table (viewing option)

    • Sort: sort the columns in ascending or descending order

    • Reorder: change the order of the columns displayed

    • Query by Example

  2. In the table, select the name of the JMS bridge destination for which you want to view configuration information.
  3. To create a new JMS bridge destination in the domain partition, click Create. See Create JMS bridge destinations.
  4. To delete an existing JMS bridge destination, click Delete.

Monitor domain partition asynchronous tasks

This page allows you to monitor the completion status of all tasks. To monitor asynchronous tasks created in this domain partition:

  1. From the Domain Partition menu, select Monitoring, then select Asynchronous Tasks.

    The Asynchronous Tasks summary table displays information about the state of asynchronous tasks, such as:

    • Description

    • Type

    • Status

    • Begin Time

    • End Time

    • Targets

    For more information about these fields, see Configuration Options.

    Optionally, select View to access the following table options:

    • Columns: add or remove the columns displayed in the table

    • Detach: detach the table (viewing option)

    • Sort: sort the columns in ascending or descending order

    • Reorder: change the order of the columns displayed

    • Query by Example

  2. In the table, select a task's description to view additional information.
  3. Click Cancel to cancel a task.

Monitor Coherence caches

This section includes the following topics:

Monitor domain partition caches

To monitor domain partition caches:

  1. From the Domain Partition menu, select Coherence Caches, then select Domain Partition Caches

    The Coherence Caches summary table displays information about the state of each cache that has been configured in the current domain partition, such as:

    • Name

    • Service

    • Tier

    • Objects

    • Gets

    • Hits

    • Misses

    • Reads

    • Writes

    For more information about these fields, see CacheMBean in Managing Oracle Coherence

    Optionally, select View to access the following table options:

    • Columns: add or remove the columns displayed in the table

    • Sort: sort the columns in ascending or descending order

    • Reorder: change the order of the columns displayed

    • Query by Example

  2. From the table, select a cache.

    Cache performance data are displayed in the Cache Details region and are available in both graph and table view. Use the region to monitor how well a Coherence cache is performing.

Monitor shared caches

To monitor shared caches

  1. From the Domain Partition menu, select Coherence Caches, then select Shared Caches

    The Coherence Caches summary table displays information about the state of each cache that has been configured in the current domain partition, such as:

    • Name

    • Service

    • Tier

    • Objects

    • Gets

    • Hits

    • Misses

    • Reads

    • Writes

    For more information about these fields, see CacheMBean in Managing Oracle Coherence

    Optionally, select View to access the following table options:

    • Columns: add or remove the columns displayed in the table

    • Detach: detach the table (viewing option)

    • Sort: sort the columns in ascending or descending order

    • Reorder: change the order of the columns displayed

    • Query by Example

  2. From the table, select a shared cache.

    Cache performance data are displayed in the Cache Details region and are available in both graph and table view. Use the region to monitor how well a shared Coherence cache is performing.

Monitor Coherence services

To monitor Coherence services:

  1. From the Domain Partition menu, select Coherence Caches, then select Coherence Services.

    The Coherence Caches summary table displays information about the state of each service that has been configured in the current domain partition, such as:

    • Name

    • Type

    • Status

    • Thread Count

    • Idle Thread Count

    • Tasks Backlog

    • Hung Tasks

    • Average Request Duration

    For more information about these fields, see ServiceMBean in Managing Oracle Coherence

    Optionally, select View to access the following table options:

    • Columns: add or remove the columns displayed in the table

    • Detach: detach the table (viewing option)

    • Sort: sort the columns in ascending or descending order

    • Reorder: change the order of the columns displayed

    • Query by Example

  2. From the table, select a Coherence service.

    Service performance data are displayed in the Service Details region and are available in both graph and table view. Use the region to monitor how well a Coherence service is performing.

Monitor diagnostic images

The diagnostic image functionality provided by the WebLogic Server Diagnostic Service gathers the most common sources of key server state used in diagnosing problems and packages that state into a single file, or "diagnostic image." You can specify the default destination directory where diagnostic images for a server are saved, and you can initiate an immediate capture of an image for a server.

To monitor the diagnostic images in a domain partition:

  1. From the Domain Partition menu, select Diagnostics, then select Diagnostic Images.

    The Diagnostic Images table displays information about the diagnostic images captured in the domain partition, such as:

    • Name

    • Type

    For more information about these fields, see Configuration Options.

    Optionally, select View to access the following table options:

    • Columns: add or remove the columns displayed in the table

    • Sort: sort the columns in ascending or descending order

    • Reorder: change the order of the columns displayed

Capture diagnostic images

To capture a diagnostic image:

  1. From the Domain Partition menu, select Diagnostics, then select Diagnostic Images.

    The Diagnostic Images table displays information about the diagnostic images captured in the domain partition.

  2. Select a server instance in the table and click Capture Image.
  3. On the Capture Diagnostic Image page, enter the following information for this image:

    • Destination Directory

    • Timeout

    For more information about these fields, see Configuration Options.

  4. Click Capture Image.

Download captured diagnostic images

To download a captured diagnostic image:

  1. From the Domain Partition menu, select Diagnostics, then select Diagnostic Images.

    The Diagnostic Images table displays information about the diagnostic images captured in the domain partition.

  2. Select a server instance in the table and click Download Captured Images.
  3. On the Download Captured Images page, select the image you want to download and click Download.

Control domain partitions

This section includes the following tasks

Start and stop domain partitions

To start and stop domain partitions:

  1. From the WebLogic Domain menu, select Environment, then select Domain Partitions.

    The Domain Partition table displays information about the domain partitions in this domain.

  2. In the summary of domain partitions table, select the domain partition you want to control:

    1. To start a partition, from the Control menu, select Start.

      All of the resource groups—and all of the applications deployed to those resource groups—are started.

    2. To suspend a running partition, from the Control menu, select Suspend and select whether to suspend the partition gracefully (When work completes) or forcibly (Force suspend now).

      The suspend operation transitions the partition from the RUNNING to ADMIN state.

    3. To resume a suspended partition, from the Control menu, select Resume.

      The resume operation transitions the partition from the ADMIN to RUNNING state.

    4. To shut down a partition:

      From the Control menu, select Stop and select whether to shut down the partition gracefully (When work completes) or forcibly (Force stop now).

      Optionally, from the Control menu, select Halt. When a partition is in the HALTED state, all resource groups in the partition are shutdown and the partition is fully shutdown on all targets.

See About Partition Lifecycle States and Transitions in Using WebLogic Server MT.

Export domain partitions

Exporting a domain partition creates a partition backup and stores it in an archived format. You can easily move the archived partition from one domain to another, including the applications that are deployed to the partition.

Before you begin:

Prior to exporting a domain partition, you must first have created or imported one. See Create domain partitions and Import domain partitions.

To export a domain partition:

  1. From the WebLogic Domain menu, select Environment, then select Domain Partitions.

    The Domain Partition table displays information about the domain partitions in this domain.

  2. In the table, select the row with the domain partition you want to export.
  3. Click Export.
  4. Select or enter the full path to the directory in which to save the partition archive.

    Each domain partition should be located in its own directory. The domain partition archive will be overwritten if it already exists in the specified location. Other files in the directory may be overwritten as well.

    The archive file will be named <partition-name>.zip.

  5. (Optional) Select the Include application bits in the zip archive check box if you want to include the installed application and library binaries in the exported partition archive.
  6. (Optional) In the Full path to the key file used to encrypt attributes text box, enter the full path to a file containing a string to use as the encryption key to encrypt attributes in the partition archive.

    If you do not provide your own key, then a new secret key will be generated and stored in the expPartSecret file in the exported <Partition-name>.zip file.

  7. Click OK.

Import domain partitions

While importing a partition archive, you may need to update the dependencies on the domain (like targets and security realms) and also optionally update other attributes in the partition configuration to make it valid. See Exporting and Importing Partitions in Using WebLogic Server MT.

Before you begin:

Prior to importing a domain partition:

  • You must have previously exported a domain partition (the source domain) to a partition archive file. See Export domain partitions.

  • The server instance must already have a domain configured (the target domain).

To import a domain partition:

  1. From the WebLogic Domain menu, select Environment, then select Domain Partitions.

    The Domain Partition table displays information about the domain partitions in this domain.

  2. Click Import.
  3. Select or enter the full path to the partition archive file you want to import.
  4. (Optional) Select the Overwrite existing resource group templates check box if the resource group template already exists in the target domain and you want to create a new one using a new name.

    All resource group templates used by the source domain partition are contained in the partition archive and are imported along with the partition into the target domain.

    If the resource group template already exists in the target domain and you do not specify overwrite existing resource group templates, then the import operation will fail.

  5. (Optional) In the Override domain partition name field, enter the name to use for the partition when it is created in the target domain. This defaults to the original name of the partition.
  6. (Optional) In the Enter the full path to the key file used to decrypt attributes text box, enter the full path to a file containing the key to decrypt attributes in the partition archive.
  7. Click OK.

Delete domain partitions

To delete a domain partition from the domain:

  1. From the WebLogic Domain menu, select Environment, then select Domain Partitions.

    The Domain Partition table displays information about the domain partitions in this domain.

  2. In the table, select the row with domain partition you want to delete, and click Delete.
  3. Click OK.

Control domain partition JDBC data sources

To control all JDBC data sources created in a domain partition:

  1. From the Domain Partition menu, select Control, then select JDBC Data Sources.
  2. You can perform the following actions:

    • Start

    • Stop

    • Resume

    • Suspend

    • Shrink

    • Reset

    • Clear Statement Cache

  3. The JDBC Data Sources table lists the JDBC data sources that have been created in the domain partition and displays related status information, such as:

    • Name

    • Partition

    • Type

    • Resource

    • Scope

    • Server

    • Instances

    • ONS

    • State

    For more information about these fields, see Configuration Options.

    Optionally, select View to access the following table options:

    • Columns: add or remove the columns displayed in the table

    • Detach: detach the table (viewing option)

    • Sort: sort the columns in ascending or descending order

    • Reorder: change the order of the columns displayed

    • Query by Example

Control domain partition JMS servers

To control JMS servers created in this domain partition:

  1. From the Domain Partition menu, select Control, then select Messaging and JMS Servers.

    The JMS Server summary table displays information about the state of each JMS server that has been configured in the current domain partition, such as:

    • Name

    • Resource Group

    • Health

    • Target

    • Current Target

    • Running On

    • Production Paused

    • Consumption Paused

    • Insertion Paused

    • Messages Current

    • Messages Pending

    • Messages Received

    • Messages Paged Out Total

    • Bytes Current

    For more information about these fields, see Configuration Options.

    Optionally, select View to access the following table options:

    • Columns: add or remove the columns displayed in the table

    • Detach: detach the table (viewing option)

    • Sort: sort the columns in ascending or descending order

    • Reorder: change the order of the columns displayed

    • Query by Example

  2. In the table, select the name of the JMS server you want to control.

    You can choose from the following action menus:

    • Production

    • Consumption

    • Insertion

Control domain partition Store-and-Forward agents

To control Store-and-Forward agents created in this domain partition:

  1. From the Domain Partition menu, select Control, then select Messaging and Store-and-Forward Agents.

    The Store-and-Forward Agents summary table displays information about the state of each Store-and-Forward agent that has been configured in the current domain partition, such as:

    • Name

    • Resource Group

    • Agent Type

    • Remote Endpoints Current

    • Remote Endpoints High

    • Remote Endpoints Total

    • Conversations Current

    • Conversations High

    • Conversations Total

    • Paused for Incoming

    • Paused for Forwarding

    • Paused for Receiving

    For more information about these fields, see Configuration Options.

    Optionally, select View to access the following table options:

    • Columns: add or remove the columns displayed in the table

    • Detach: detach the table (viewing option)

    • Sort: sort the columns in ascending or descending order

    • Reorder: change the order of the columns displayed

    • Query by Example

  2. In the table, select the name of the Store-and-Forward agent for which you want to view configuration information.

    You can choose from the following action menus:

    • Incoming

    • Forwarding

    • Receiving

Control domain partition JMS resources and modules

This section includes the following topics:

Control domain partition JMS resources

You can view all the resources from all the JMS system modules created in the current domain partition. You can also view monitoring information, including the resource's system module, JNDI name, targeted subdeployment resources, and the resource group on which the resource is targeted.

For certain resources, you can monitor detailed statistical information or perform control operations.

To control all JMS system resources in the domain partition:

  1. From the Domain Partition menu, select Control, then select Messaging.
  2. Select JMS Resources.

    The JMS Resources table lists all the resources that are defined as part of all JMS system modules configured in the domain partition:

    From the JMS Resources table, you can monitor information about each JMS system module resource, such as:

    • Name

    • Type

    • JMS Module Name

    • JNDI Name

    • Subdeployment

    • Resource Group

    For more information about these fields, see Configuration Options.

    Optionally, select View to access the following table options:

    • Columns: add or remove the columns displayed in the table

    • Detach: detach the table (viewing option)

    • Sort: sort the columns in ascending or descending order

    • Reorder: change the order of the columns displayed

    • Query by Example

  3. In the table, select the name of the JMS system resource for which you want to view additional monitoring information.
  4. To create a new JMS resource in the domain partition, click Create. See Create JMS resources.
  5. To delete an existing JMS resource, click Delete.

Control domain partition JMS modules

You can control the JMS system modules created for the domain partition. The table specifies which resource types are part of each module, as well as the number of assigned resource types.

To control JMS modules:

  1. From the Domain Partition menu, select Control, then select Messaging.
  2. Select JMS Modules.

    The JMS Modules table lists the resource group for all the JMS system modules configured in the domain partition and displays the number of JMS system resource types configured for each module, such as:

    • Resource Group

    • Queues

    • Topics

    • Connection Factories

    • Distributed Queues

    • Distributed Topics

    For more information about these fields, see Configuration Options.

    Optionally, select View to access the following table options:

    • Columns: add or remove the columns displayed in the table

    • Detach: detach the table (viewing option)

    • Sort: sort the columns in ascending or descending order

    • Reorder: change the order of the columns displayed

    • Query by Example

  3. In the table, select the name of the JMS module for which you want to view additional monitoring information.
  4. To create a new JMS module in the domain partition, click Create. See Create JMS modules.
  5. To delete an existing JMS module, click Delete.
  6. To Restart a JMS module, click Restart.

Control domain partition application deployments

You can start, stop, deploy, redeploy, and undeploy applications deployed to resource groups in the domain partition. You can also fetch deployment plans and override the application configuration defined in a resource group template.

This section includes the following tasks:

Start applications in a partition

Starting an application makes it available to WebLogic Server clients. Before you can start an application, you must first deploy it. See Deploy applications to a partition resource group.

To start an application on a partition resource group:

  1. From the Domain Partition menu, select Deployments.
  2. In the Deployments table, select the row of the deployment you want to start.

    The control options are displayed above the table.

  3. Click Start.

    By default, all requests will be serviced by the application. To start servicing only administration requests to the application, select Start, then Servicing only administration requests.

  4. Click Yes to confirm your decision.

Stop applications in a partition

Stopping a running application makes it unavailable to WebLogic Server clients.

To stop an application on a partition resource group:

  1. From the Domain Partition menu, select Deployments.
  2. In the Deployments table, select the row of the deployment you want to stop.

    The control options are displayed above the table.

  3. Click Stop.

    By default, the deployment will be stopped when work completes. To force the deployment to stop immediately, select Stop, then Force stop now. To stop servicing client requests but continue servicing administration requests, select Stop, then Stop, but continue servicing administration requests.

  4. Click Yes to confirm your decision.

Deploy applications to a partition resource group

Deploying an application makes its physical file or directory known to WebLogic Server. After you have deployed the application, you can start it so that users can begin using it. See Start applications in a partition.

To deploy an application to a partition resource group:

  1. From the Domain Partition menu, select Deployments.
  2. Click Deploy to open the Deploy Java EE Application Assistant.
  3. On the Select Archive page, in Scope, select Resource Group in Domain Partition and select the resource group on which to deploy the application.
  4. Locate the application you want to deploy and choose whether to upload a deployment plan or create a new deployment plan.
  5. Click Next.
  6. On the Select Target page, select the server instances and clusters to which you want to deploy the application.
  7. Click Next.
  8. On the Application Attribute page, update the application attributes as desired. These attributes include:

    • Application Name

    • Distribution

    • Source Accessibility

  9. Click Next to update the deployment settings or Deploy to complete deployment of this application.
  10. Optionally, on the Deployment Settings page, you can complete common tasks before deploying the application and update deployment settings.
  11. Click Deploy to complete deployment of this application.

Redeploy applications to a partition resource group

Redeploying an application redeploys the archive file or exploded directory. Redeploy an application if you have made changes to it and want to make the changes available to WebLogic Server clients.

To redeploy an application or module to a partition resource group:

  1. From the Domain Partition menu, select Deployments.
  2. In the Deployments table, select the row of the deployment you want to redeploy.

    The control options are displayed above the table.

  3. Click Redeploy to open the Redeploy Java EE Application Assistant.
  4. On the Select Application page, select the application you want to redeploy.
  5. Click Next.
  6. On the Select Archive page, locate the application you want to deploy and choose whether to upload a deployment plan or create a new deployment plan.
  7. Click Next.
  8. On the Application Attribute page, update the application attributes as desired. These attributes include:

    • Application Name

    • Distribution

    • Source Accessibility

  9. Click Next to update the deployment settings or Redeploy to complete redeployment of this application.
  10. Optionally, on the Deployment Settings page, you can complete common tasks before deploying the application and update deployment settings.
  11. Click Redeploy to complete deployment of this application.

Undeploy applications from a partition resource group

Undeploying an application removes it from every target of the domain to which the application is deployed. Once you undeploy an application from the domain, you must deploy it again if you want to make it available to WebLogic Server clients. To temporarily make applications unavailable to WebLogic Server clients, you can stop them instead of undeploying them.

Before you begin

Before you can undeploy an application, you must stop it to ensure that it is not servicing client applications. See Stop applications in a partition.

To undeploy an application from a partition resource group:

  1. From the Domain Partition menu, select Deployments.
  2. In the Deployments table, select the row of the application you want to undeploy.

    The control options are displayed above the table.

  3. Click Undeploy.
  4. On the Undeploy Java EE Application: Confirmation page, click Undeploy to confirm your decision and remove the application.

    If you later want to deploy the removed application, see Deploy applications to a partition resource group.

Override application configuration

When a resource group references a resource group template, you can override the default application configuration for applications and modules defined to the resource group template by specifying a different deployment plan. The application or module is then redeployed using the new deployment plan for its application configuration.

To override the configuration for an application or module:

  1. From the Domain Partition menu, select Deployments.
  2. In the Deployments table, select the row containing the application or which you want to override configuration.

    The control options are displayed above the table.

  3. Click Override.
  4. On the Application Override page, choose a new deployment plan to override the application configuration by selecting one of the following options:

    • Deployment plan is on the machine where this Web browser is running. Click Choose File to select the deployment plan file.

    • Deployment plan is on the server where Enterprise Manager is running. Click Browse to select the deployment plan file.

  5. Click Override.

Remove application configuration overrides

To remove an existing application override:

  1. From the Domain Partition menu, select Deployments.
  2. In the Deployments table, select the row containing the application for which you want to remove the existing override.

    The control options are displayed above the table.

  3. Click Remove Override.

Fetch deployment plans

A deployment plan is a file that contains the deployment settings as well as post-deployment configuration changes of an application. You can fetch and save the deployment plan of an application, and then deploy or redeploy that application later using the saved deployment plan.

To fetch a deployment plan for an application:

  1. From the Domain Partition menu, select Deployments.
  2. In the Deployments table, select the row of the application for which you want to fetch the deployment plan.

    The control options are displayed above the table.

  3. Click Fetch Deployment Plan.
  4. On the Fetch Deployment Plan page, select the machine on which you want to save the deployment plan: Machine where this Web browser is running or Machine where Enterprise Manager is running.
  5. Click Fetch.

View the JNDI tree

The JNDI browser is a central location where you can find the JNDI names of all the WebLogic Server resources. Typically, while writing WLS client programs, you would search the JNDI browser for JNDI names. The JNDI browser displays a tree of resources in the domain, a server, or a partition. Selecting a node or an object in the tree, displays JNDI information including Binding Name, Object Class, Object Hash Code, and Object to String Results entries.

To view objects in a domain partition's JNDI tree:

  1. From the Domain Partition menu, select JNDI Browser.
  2. Use the left pane to navigate the JNDI tree.

    For a selected node or object, the details appear in the right pane.

For more information about JNDI, see Understanding WebLogic JNDI in Developing JNDI Applications for Oracle WebLogic Server.