1 Introduction

This chapter provides an overview of how to create templates by using the Domain Template Builder.

Topics include:

Overview of the Domain Template Builder

You can create WebLogic domains by using domain and extension templates that contain the key attributes and files required for building or extending a WebLogic domain. To create domain or extension templates, you use the Domain Template Builder, which is a standalone Java application that guides you through the process. This process is illustrated in Figure 1-1.

Figure 1-1 Domain Template Builder

Description of Figure 1-1 follows
Description of "Figure 1-1 Domain Template Builder"

The Domain Template Builder is designed to be used off-line in graphical mode. It is not supported in console mode. Therefore, the console attached to the machine on which you are using the Domain Template Builder must support Java-based GUIs. All consoles for Windows systems support Java-based GUIs; some UNIX-based consoles support Java-based GUIs.

Your product installation includes a set of predefined domain and extension templates. This set of templates includes the WebLogic Server Base Domain template, and various extension templates that allow you to add product features and samples to the base domain. For more information on the templates that are available for various products, see the Domain Template Reference.

After you create your domain and add new resources and applications to it, you can use the Domain Template Builder to create a custom domain template. You can also use the Domain Template Builder to customize an existing template. For example, you may want to remove applications or add SQL scripts for additional databases. To do so, select the existing domain or template as the source for your new custom template. When your custom domain templates are complete, you can use them to create domains by using the Configuration Wizard, WLST Offline, or the unpack command. For more information about these tools, see Additional Tools for Creating Templates.

About Domain and Extension Templates

In the context of the Domain Template Builder, the term template refers to a Java Archive (JAR) file. A template JAR contains the files and scripts that are needed to create or extend a WebLogic domain. The types of templates that can be used by the Configuration Wizard to create or extend domains include:

  • Domain template—defines the full set of resources within a WebLogic domain, including infrastructure components, applications, services, security options, and general environment and operating system options. You can create this type of template from an existing domain by using the Domain Template Builder or the pack command. You can then create a domain based on the template.

    The product distribution includes the WebLogic Server Base Domain template. This template defines the core set of resources within a domain, including an Administration Server and basic configuration information, infrastructure components, and general environment and operating system options. It does not include sample applications. You can use this template to create a basic WebLogic Server domain, which you can then extend with applications and services, or additional product component functionality.

  • Extension template—defines applications and services that can provide additional features, such as applications, or JDBC resources, JMS components, or deployed libraries. This type of template can be used to update an existing WebLogic domain.

  • Managed Server template—defines the subset (within a domain) of resources that are required to create a Managed Server domain on a remote machine. This type of template can be created using the pack command.

Your product installation includes a set of predefined domain and extension templates. This set includes the WebLogic Server Base Domain template and various extension templates that allow you to add component features and samples to the base domain. For more information about these templates and how they relate to each other, see the Domain Template Reference.

Overview of Creating Domain Templates by Using the Domain Template Builder

To create a custom domain template by using the Domain Template Builder, select the domain or domain template from which you want to create your new domain template. You then have the option to modify the following:

  • Basic template information

  • Application and domain directory contents

  • SQL scripts for database configuration

  • Administration Server and user configuration

  • Basic security configuration, such as creating users, groups, and global roles and their assignments

  • Start menu entries (Windows only)

  • Customized scripts and variables

Table 1-1 summarizes the steps for creating a domain template by using the Domain Template Builder. These steps are described in detail in Chapter 3, "Using the Domain Template Builder to Create Domain Templates."

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

In This Step You Perform This Action

Create a New Template

Choose Create a Domain Template to create a domain template.

Select a Template Domain Source

Select the domain template or the WebLogic domain directory from which you want to create a domain template.

Describe the Template

Specify a description for the template.

Add or Omit Applications

Review and, if necessary, modify the list of applications to be included in the template.

Add Files

Review and, if necessary, modify the files to be included in the template.

Add SQL Scripts

Add SQL scripts for each database that you expect to be used with the domains created from this template, and specify the order in which the scripts are executed.

Configure the Administration Server

Define the Administration Server settings, such as listen port and whether or not SSL is enabled.

Configure Administrator Username and Password

Specify the username and password for the Administration Server. Optionally, you can also configure additional security features by defining users and groups and assigning them to global security roles.

Specify Start Menu Entries

Optionally, define entries for the Windows Start menu.

"Prepare Scripts and Files with Replacement Variables"

Replace specific paths, filenames, and other domain environment settings with replacement variables in text files contained in the template. The Configuration Wizard later replaces the variables with exact strings to set up a specific WebLogic domain.

Review WebLogic Domain Template

Review the settings defined in your template.

Creating Template

Specify the name and directory for the domain template, and launch the process that creates it.


Overview of Creating Extension Templates by Using the Domain Template Builder

The process of creating an extension template is similar to the process of creating a domain template, except that you are not prompted to configure the Administration Server, assign an administrator username and password, or specify Start menu entries. These domain settings are already defined in the domain you are extending.

To create an extension template, you select a domain or extension template to use as the basis for the extension template. You then have the option to modify:

  • Basic template information, such as name and description

  • Application directory contents and location

  • Files to be included in the template

  • SQL scripts for database configuration

  • Additional security, such as creating users, groups, and global roles

  • Customized scripts and variables

The Domain Template Builder creates an extension template (JAR file) that can be used to extend an existing WebLogic domain.

Table 1-2 summarizes the steps for creating an extension template. These steps are described in detail in Chapter 4, "Creating Extension Templates by Using the Domain Template Builder."

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

In this step You

Create a New Template

Choose Create an Extension Template to create an extension template.

Select a Template Domain Source

Choose an extension template or a WebLogic domain directory from which you want to create the extension template.

Describe the Template

Enter a description for the template. If you select an existing template as your source, the description for that template is displayed. Review the description, and modify it if necessary.

Add or Omit Applications

Review and, if necessary, modify the list of applications to be included in your extension template.

Add Files

Review and, if necessary, modify the list of files to be included in your extension template.

Add SQL Scripts

Add SQL scripts for each database that you expect to be used with the domains created from this template and specify the order in which the scripts are executed.

Security Configuration Options

Optionally, create users, groups, and roles; then, assign them to groups and global roles.

Prepare Scripts and Files with Replacement Variables

Replace specific paths, filenames, and other environment-specific strings with replacement variables in text files contained in the template. Later, when a specific WebLogic domain is being created, the Configuration Wizard replaces these variables with exact strings.

Review WebLogic Extension Template Settings

Review the settings defined in your template.

Creating Template

Enter a name and directory for the extension template, and launch the process that creates it.


Additional Tools for Creating Templates

As described earlier, you can create custom domain and extension templates by using the Domain Template Builder. You can also use the following tools to create templates:

  • pack

    This command enables you to create a template archive (JAR file) that contains a snapshot of either an entire WebLogic domain or a subset of a WebLogic domain. You can use a template that contains a subset of a domain to create a Managed Server domain directory hierarchy on a remote machine.

    For more information, see Creating Templates and Domains Using the Pack and Unpack Commands.

  • WebLogic Scripting Tool (WLST):

    WLST is a command-line scripting interface, which you can use to interact with and configure WebLogic Server instances and domains. When WLST is offline, you can create a WebLogic domain or update an existing WebLogic domain without connecting to a running WebLogic Server—supporting the same functionality as the Configuration Wizard.

    For more information, see Oracle WebLogic Scripting Tool and WebLogic Scripting Tool Command Reference.