Skip navigation.

Creating WebLogic Domains Using the Configuration Wizard

  Previous Next vertical dots separating previous/next from contents/index/pdf Contents View as PDF   Get Adobe Reader

Customizing Existing JDBC and JMS Settings

When you are creating or extending a domain using the Configuration Wizard, you have the option to modify JDBC data source and JMS file store settings if they were previously defined in your domain or template.

The following topics describe the steps required to change the JDBC and JMS file store settings in your domain:


Configure JDBC Data Sources

A JDBC data source contains a pool of database connections that are created when the data source instance is created—when it is deployed or targeted, or at server startup. Applications look up a data source on the JNDI tree, and then request a connection. When finished with the connection, the application returns the connection to the connection pool in the data source.

The Configure JDBC Data Sources window prompts you to configure the JDBC data sources defined in your domain source. This step is optional. If desired, you can also test the connections to the database using the Test Connections button.

Note: The values that you specify for your database in this window must match the actual configuration of the database. For example, if you change the name of the PointBase database for a preconfigured domain in the DBMS name field, there must be an actual PointBase database configured with that name.

To configure JDBC data sources:

  1. Review the current list of JDBC data sources. Each data source is represented by a tab. You can view the information for a particular data source by selecting the corresponding tab. Default values may vary, based on the domain source you selected earlier.
  2. Add or modify entries as required by your domain, using the guidelines provided in the following table. When you finish updating your settings, do one of the following:

Related Topics

"Configuring JDBC Data Sources" in Configuring and Managing WebLogic JDBC at


Test Data Source Connections

The Test Data Source Connections window allows you to test the connection to the database for each of the data sources defined in your domain, using the JDBC URL defined for the database. This window is only displayed if you clicked Test Connections on the Configure JDBC Data Sources window.

A list of the data sources and the associated JDBC URLs is displayed.

To test the connections to the database:

  1. Make sure that the database to which you want to test the connections is running.
  2. Click Test for the data source connection that you want to test.
  3. Note: When you press Test for a data source, the button changes to Cancel. You can press Cancel at any time to cancel the test. Once a test is in progress, all other Test buttons are disabled.

    If the status field is empty, the test has not been initiated.

  4. Review the results of the test in the Connection Result Log pane.
  5. Repeat for each data source, as desired.
  6. Click OK to return to the Configure JDBC Data Sources window.


Run Database Scripts

The Run Database Scripts window prompts you to set up the database content for each of the data sources defined in your domain using pre-existing SQL or database loading files. A domain template may contain a set of SQL files organized by database type. This window is displayed only if the domain template contains one or more SQL files.

Notes: If you are using the default PointBase database, you do not need to start the database server before running the scripts. For all other databases, your database server must be running to execute the SQL scripts.

To set up the database content:

  1. In the Available JDBC Data Sources pane, select the data source for which you want to run the scripts. The scripts that will be executed are displayed in the Available SQL Files and Database Loading Options.
  2. Select the database version from the DB Version drop-down menu.
  3. Click Run Scripts.
  4. All the scripts displayed in the Available SQL Files and Database Loading Options pane for the selected data source are executed, and the results are displayed in the Results pane. If you prefer to capture test output in a log file, select the Log File check box and manually enter the location of the log file or click Browse to navigate to the name of the desired log file.

  5. Repeat steps 1 through 3 for each data source for which you want to execute SQL scripts.
  6. Click Next to proceed to the next configuration window.


Configure JMS File Stores

A JMS file store is a disk-based file in which persistent messages can be saved.

The Configure JMS File Stores window allows you to modify JMS file stores that are configured in your domain. This step is optional.

To configure JMS file stores:

  1. Review the current list of JMS file stores. Default values may vary based on the domain source you selected earlier.
  2. Note: The wizard provides two display modes: a concise tabular view of all the defined components, and an individual view, in which each component is represented by a tab, and you view a particular component by selecting the corresponding tab. To toggle the display mode between table and tab formats, click Switch Display.

  3. Modify entries, as required by your domain, using the guidelines provided in the following table. When you finish updating your settings, click Next.
  4. In this field . . .

    Do the following . . .

    Note: Fields marked with an asterisk are required.


    Enter a name for the JMS file store: a string of characters that can include spaces.

    The name of the JMS file store must be unique among all component names within the domain.


    Enter the pathname of the directory on the file system where the JMS file store is kept. This directory must reside on your system.

    Synchronous write policy

    From the drop-down list, select one of the following synchronous write policies to determine how the file store writes data to disk:

    • Cache-Flush—specifies that transactions cannot be completed until all their write operations have been flushed down to disk.

    • Disabled—specifies that transactions are complete as soon as their writes are cached in memory. When this policy is active, the completion of transactions does not depend on waiting for writes to reach the disk.

    • Direct-Write—specifies that write operations are performed directly to disk. This policy is supported on Solaris and Windows. If this policy is active on an unsupported platform, the file store automatically switches to the Cache-Flush policy.

    • Unspecified (default)

    This parameter setting affects performance, scalability, and reliability.

    Note: Although the use of the Direct-Write policy is transactionally reliable on Solaris systems, Windows systems may leave transaction data in the on-disk cache without writing it to disk immediately. This is not considered to be transactionally reliable, since a power failure can cause loss of on-disk cache data—possibly resulting in lost and/or duplicate messages. For reliable writes using Direct-Write on Windows, either disable all write caching for the disk (enabled by default), or use a disk with a battery-backed cache. Some file systems, however, do not allow this value to be changed (for example, a RAID system that has a reliable cache).

    Note: If the JMS file store is used exclusively for paging non-persistent messages to disk, the synchronous write policy is ignored.


Related Topics

"Creating a Custom (User-Defined) File Store" in Configuring WebLogic Server Environments at


Review the Domain Settings

The Review WebLogic Domain window allows you to review the detailed configuration settings of your domain before the Configuration Wizard creates it.

To review the domain settings:

  1. Select an item in the Domain Summary pane on the left and review the associated details in the Details pane on the right. You can make limited adjustments by clicking Previous to return to a prior window.
  2. Note: You can limit the type of information displayed in the Domain Summary pane by selecting a filter from the View drop-down list

  3. Click Next to proceed to the next configuration window, Create the WebLogic Domain.


Skip navigation bar  Back to Top Previous Next