2 Using the Domain Template Builder to Create Domain Templates

You can create a domain template by using the Domain Template Builder in the graphical mode. The template creation process takes you through a sequence of screens for capturing specific information about the template.

This chapter includes the following sections:

Starting the Domain Template Builder

Before you start the Domain Template Builder, ensure that the console for the machine on which the product installation resides supports Java-based GUIs. All Windows-based consoles support Java-based GUIs; only a subset of UNIX-based consoles supports Java-based GUIs.

You can start the Domain Template Builder in graphical mode from the command line.

  1. Log in to the system on which the product is installed.
  2. Open a command prompt window (on Windows) or a command shell (on UNIX).
  3. Go to the following directory, where ORACLE_HOME is the Oracle home directory that you specified when installing WebLogic Server:

    On Windows: ORACLE_HOME\oracle_common\common\bin

    On UNIX: ORACLE_HOME/oracle_common/common/bin

  4. Execute the following command:

    On Windows: config_builder.cmd

    On UNIX: config_builder.sh

    Note:

    When you run the config_builder.cmd or config_builder.sh command, the following error message appears to indicate that the default cache directory is not valid:

    *sys-package-mgr*: can't create package cache dir

    You can change the cache directory by including the -Dpython.cachedir=valid_directory option in the command line.

    The Template Type screen is displayed.

Creating Domain Templates Using the Domain Template Builder

You can use the Domain Template Builder in the graphical mode to create domain templates. The process takes you through a sequence of screens where you capture specific information about the template that you want to create.

Start the Domain Template Builder as described in Starting the Domain Template Builder.

Note:

In situations where you cannot run the Domain Template Builder in GUI mode, Oracle recommends that you use a WLST script to create the domain template as described in Creating and Using a Domain Template (Offline) in Understanding the WebLogic Scripting Tool.

The Domain Template Builder displays a sequence of screens, in the order listed in Table 2-1. For more information about each screen, refer the related section in Domain Template Builder Screens, or click the link in the Screen column.

Table 2-1 summarizes the steps for creating a domain template by using the Domain Template Builder.

Table 2-1 Steps for Creating a Domain Template by Using the Domain Template Builder

Screen When Does This Screen Appear? You Perform This Action

Template Type

Always

Choose Create a Domain Template to create a domain template.

Specify the source for the domain template and the location of the source.

Specify the destination JAR file for the domain template.

Click Next to continue.

Template Information

Always

Fill in each template information field.

Click Next to continue.

Template Summary

Always

Review the template summary. You can use the View drop-down list to restrict the view to a specific part of the template.

Click Back to return to a previous screen if you want to make any changes.

Click Create to continue.

Configuration Progress

Always

Wait for the template to be generated, and then click Next.

End of Configuration

Always

Click Finish to exit the Domain Template Builder.

Porting Security Provider Data to a New Domain

The Domain Template Builder is an offline utility, and hence does not export security provider data, such as embedded LDAP data, into a domain template. After you use the domain template to create the new domain, you must manually port the security provider data to the new domain.

To manually port the security provider data to the new domain:

  1. If necessary, start the Administration Server for the original domain and log in to its Administration Console.
  2. Export the data from the original domain, as described in Export data from a security provider in the Oracle WebLogic Server Administration Console Online Help.
  3. If necessary, start the Administration Server for the new domain and log in to the Administration Console of the new domain .
  4. Import the data into the new domain, as described in Import data into a security provider in the Oracle WebLogic Server Administration Console Online Help.