4 Domain Template Builder Screens

The Domain Template Builder helps you create domain and extension templates. During the process, it takes you through a sequence of screens where you capture specific information about the domain or extension template.

• Template Type
  In the Template Type screen, first specify whether you want to create a domain template or an extension template, and then specify the source and destination for the new template.
• Template Information
  Use the Template Information screen to provide basic information about the template. The information you specify here is stored in the template-info.xml file that is generated for the domain or extension template. It is also stored in the config.xml file for the domain.
• Services Selection
  The Services Selection screen is available only if you are creating an extension template. You can use this screen to review the custom applications and services in the configuration, and then select the ones you want to include in the extension template.
• Topology Selection
  The Topology Selection screen is available only if you are creating an extension template. You can use this screen to review the topology elements in the configuration and select the elements you want to include in the extension template.
• Template Summary
  The Template Summary screen provides a summary of the settings for the new template. Review the information before you proceed to create the template.
• Configuration Progress
  The Configuration Progress screen displays status messages during the template creation process.
• End of Configuration
  The End of Configuration screen displays the final configuration message, depending on the success or failure of the template creation process.

Template Type

In the Template Type screen, first specify whether you want to create a domain template or an extension template, and then specify the source and destination for the new template.

Option	Description
Create Domain Template	Select this option to create a new domain template that defines the full set of resources within a WebLogic domain. The resources include infrastructure components, applications, services, security options, and general environment and operating system parameters. You can use the template that you create as the basis for creating a WebLogic domain, by specifying the template in the Configuration Wizard, WebLogic Scripting Tool (WLST), or the unpack command.
Create Extension Template	Select this option to create a template that defines applications and services that can be used to extend existing WebLogic domains. You can import applications and services stored in extension templates into an existing WebLogic domain by using the Configuration Wizard. For information about the Configuration Wizard, see Updating WebLogic Domains in Creating WebLogic Domains Using the Configuration Wizard.

• Creating a Domain Template From an Existing Domain
  
• Creating an Extension Template From an Existing Domain
  
• Creating a Domain Template From an Existing Template
  
• Creating an Extension Template From an Existing Template
  

Creating a Domain Template From an Existing Domain

To create a domain template from an existing domain directory:

1. Select Create Domain Template.
2. Select Use Domain as a Source.
3. Enter the full path of the source domain directory in the Source Location field, or use the Browse button to navigate to the domain directory (for example, C:\domains\mydomain).
4. In the Template Location field, enter the full path and JAR file name for the new template, or use the Browse button to navigate to an existing directory. Ensure that you include the JAR file name. For example, C:\templates\domains\mynewtemplate.jar.
5. Click Next.

Creating an Extension Template From an Existing Domain

To create an extension template from an existing domain directory:

1. Select Create Extension Template.
2. Select Use Domain as a Source.
3. Enter the full path of the source domain directory in the Source Location field, or use the Browse button to navigate to the domain directory (for example, C:\domains\mydomain).
4. In the Template Location field, enter the full path and JAR file name for the new template, or use the Browse button to navigate to an existing directory. Ensure that you include the JAR file name. For example, C:\templates\domains\mynewtemplate.jar.
5. Click Next.

Creating a Domain Template From an Existing Template

To create a domain template from an existing template:

1. Select Create Domain Template.
2. Select Use Template as a Source.
3. Enter the full path of the source domain JAR file in the Source Location field, or use the Browse button to navigate to the domain directory and select the JAR file (for example, C:\domains\mydomain.jar).

   Note:

   Ensure that you do not select a product template when you use a template as the source for creating domain templates. If you select a product template, an error message appears when you click Next.

4. In the Template Location field, enter the full path and JAR file name for the new template, or use the Browse button to navigate to an existing directory. Ensure that you include the JAR file name, for example, C:\templates\domains\mynewtemplate.jar.
5. Click Next.

Creating an Extension Template From an Existing Template

To create an extension template from an existing template:

1. Select Create Extension Template.
2. Select Use Template as a Source.
3. Enter the full path of the source application JAR file in the Select Source Location field, or use the Browse button to navigate to the application directory and select the jar file (for example, C:\applications\myapplication.jar).

   Note:

   Ensure that you do not select a product template when you use a template as the source for creating extension templates. If you select a product template, an error message appears when you click Next.

4. In the Select Template Location field, enter the full path and JAR file name for the new template, or use the Browse button to navigate to an existing directory. Ensure that you include the JAR file name. For example, C:\templates\applications\mynewapplication.jar.
5. Click Next.

Template Information

Use the Template Information screen to provide basic information about the template. The information you specify here is stored in the template-info.xml file that is generated for the domain or extension template. It is also stored in the config.xml file for the domain.

When you select a domain or a template as the source for the new domain or extension template, information about the selected template is displayed. Review the information and modify, if necessary, and then click Next.

Field	Description
Name	Enter a valid name for the template. The name must be a string of characters, and can include spaces.
Version	Enter a version number for the template. The version number can be anything you want, as long as it contains four or five digits, for example, 12.1.2.0 or 12.1.2.0.0.
Author	(Optional) Enter the name of the author of the template.
Description	(Optional) Enter a detailed description of the template. The description must be a string of characters, and can include spaces.

Services Selection

The Services Selection screen is available only if you are creating an extension template. You can use this screen to review the custom applications and services in the configuration, and then select the ones you want to include in the extension template.

By default, the Domain Template Builder includes only the custom applications and services from the WebLogic domain or the template that you specified as the source for the extension template.

Expand each application or service to view its contents. Select an item from the list and review the associated details on the Description pane on the right. After reviewing, select the elements you want to include in the extension template, and then click Next.

Topology Selection

The Topology Selection screen is available only if you are creating an extension template. You can use this screen to review the topology elements in the configuration and select the elements you want to include in the extension template.

By default, the Domain Template Builder includes all the topology elements from the WebLogic domain or template you specified as the source for the extension template.

Expand each topology element to view its contents. Select an element from the list and review the associated details on the Description pane on the right. After reviewing, select the files you want to include in the extension template, and then click Next.

Template Summary

The Template Summary screen provides a summary of the settings for the new template. Review the information before you proceed to create the template.

To review the settings for the new template:

1. Select an item in the Template Summary pane on the left and review the associated details in the Details pane on the right. If you want to change any settings that you defined in previous windows, click Back to return to the required configuration window.

   Note:

   You can limit the type of information displayed in the Template Summary screen by using the View drop-down list.

2. Click Create.

   The Configuration Progress screen is displayed.

Configuration Progress

The Configuration Progress screen displays status messages during the template creation process.

The Domain Template Builder generates a JAR file that contains all the components required to generate a new WebLogic domain, including the template settings that you have provided.

When the process completes, click Finish.

The files that are included in a template vary, depending on the WebLogic domain or template on which the template is based.

End of Configuration

The End of Configuration screen displays the final configuration message, depending on the success or failure of the template creation process.

• If the template was created successfully, a link to the template JAR file is provided under Template Location.

• If the template was not created successfully, an error message and an error code is displayed. In this case, try to determine the cause of the failure from the message and correct the issue.