2 Using the Domain Template Builder to Create Domain Templates

This chapter describes how to create a domain template using the Domain Template Builder.

2.1 Starting the Domain Template Builder

The console for the machine on which the product installation resides must support Java-based GUIs. All Windows-based consoles support Java-based GUIs; only a subset of UNIX-based consoles support Java-based GUIs.

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

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

Windows: ORACLE_HOME\oracle_common\common\bin

UNIX: ORACLE_HOME/oracle_common/common/bin
Execute the following command:

Windows: config_builder.cmd

UNIX: config_builder.sh

Note:

When you run the config_builder.cmd or config_builder.sh command, the following error message might be displayed 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.

2.2 Creating Domain Templates Using the Domain Template Builder

To create a new domain template using the Domain Template Builder in graphical mode, 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. For more information, see 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 on each screen, refer to 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. If necessary, click Back to return to a previous screen and make 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.

2.3 Porting Security Provider Data to a New Domain

Because it is an offline utility, the Template Builder does not export security provider data, such as embedded LDAP data, into a domain template. After using the domain template to create the new domain, you must manually port the security provider data to the new domain. To do so:

If necessary, start the Administration Server for the original domain and log in to the original domain's Administration Console.
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.
If necessary, start the Administration Server for the new domain and log in to the new domain's Administration Console.
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.