4 Creating Extension Templates by Using the Domain Template Builder

This chapter describes how to create an extension template using the Domain Template Builder. The process for creating an extension template is similar to the process for creating a domain template, except that you do not 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.

This chapter includes the following sections:

Create a New Template

The Create a New Template screen is displayed when you start the Domain Template Builder as described in Chapter 2, "Starting the Domain Template Builder."

Select Create an Extension Template and click Next.

The Select a Template Domain Source screen is displayed.

Select a Template Domain Source

The Select a Template Domain Source screen lets you choose the application template or domain directory from which you want to create an extension template.

To select an extension template as the source for the new extension template

  1. Select the Select a Template tab.

  2. Select a template from the Templates list.

    The templates are grouped by category.

    The extension templates displayed in the list are located in the directory specified in the Locate Additional Templates pane. If you want to change the directory, either enter the path, or click Browse and then navigate to the appropriate directory.

  3. Click Next. A Progress dialog box is displayed while the template is being prepared.

    When this process completes, the Describe the Template screen is displayed. Proceed to the next section.

To select a WebLogic domain as the source for the new extension template

  1. Select the Select a Domain tab.

  2. Navigate to the domain directory from which you want to create an extension template and select the desired WebLogic domain.

    Valid domain directories are indicated by a Domain directory folder icon.

  3. Click Next. A Progress dialog box is displayed while the template is being prepared.

    When this process completes, the Describe the Template screen is displayed.

Describe the Template

The Describe the Template screen prompts you to provide a description for the template.

Note:

The description that you provide here is displayed in the Select a Template pane of the Select a Template Domain Source screen.
  • If you selected a template as the source for the new template, information about the selected template is displayed. Review the information, and, if necessary, change it to suit the requirements of your WebLogic domain. Then, click Next.

  • If you selected a WebLogic domain as the source for the new template, enter the information required for the domain, and click Next.

For information about the fields in the Describe the Template screen, see Table 3-2.

The Add or Omit Applications screen is displayed.

Specify Template JAR Name and Location

From the Specify Template JAR Name and Location screen, you can accept the provided default template JAR file name and directory location, or you change them.

For more information on these fields, see Table 3-3.

When done, click Next.

Add or Omit Applications

On the Add or Omit Applications screen, you can

  • Review the list of applications that are currently defined in your template source

  • Review the path names of the current and imported applications

  • If necessary, change the relative directory into which applications are imported

  • If necessary, omit applications from the list of files to be imported.

For more information, see Add or Omit Applications.

After performing the required steps, click Next. The Add Files screen is displayed.

Add Files

By default, the Domain Template Builder includes files from the domain or extension template that you specified as the source for the new extension template. On the Add Files screen, you can review, add, and remove files in the template.

For more information, see Add Files.

After performing the required steps, click Next. The Add SQL Scripts screen is displayed.

Add SQL Scripts

On the Add SQL Scripts screen, you can add SQL scripts for each database that you expect to be used with the WebLogic domains that you extend using this template. You can also specify the order in which the scripts should be executed. For more information, see Add SQL Scripts.

After performing the required steps, click Next. The Security Configuration Options screen is displayed.

Security Configuration Options

Optionally, you can configure security parameters for the application resources within the WebLogic domain. You can use the following security features to provide security for an application resource:

  • Users and groups: Classification of individuals and groups of individuals who may be granted a security role. Typically, a group is a collection of users who share a role or function within a company, such as working in the same department.

  • Global security roles: Dynamically computed privileges that are used to restrict access to WebLogic resources. These privileges are granted to or withheld from users according to the roles to which they are assigned.

    For example, to leverage individual skills, many Web development teams divide system administration responsibilities into distinct roles. A team may then assign a different level of permission to each role. Each project might give only one or two team members permission to deploy components, but allow all team members to view the WebLogic Server configuration.

    WebLogic Server supports such role-based development by providing four default global roles: Admin, Deployer, Operator, and Monitor. These roles determine access privileges for system administration operations.

    Note:

    Do not make the default global security roles for administrative and server resources more restrictive. If you eliminate any existing security roles, you risk degrading WebLogic Server operation. You can, however, make the default security roles more inclusive (for example, by adding new security roles).

On the Security Configuration Options screen, you can set security options for your application.

  • If you choose No, the security settings for the new extension template are the same as the settings defined in the source template or WebLogic domain.

  • If you choose Yes, additional screens are displayed to let you configure the security options, as described in Table 4-1.

    Table 4-1 Security Configuration Options Window - Parameters

    Task Description

    Configure users, groups, and global roles

    Define users, groups, and global roles for authentication purposes. For instructions, see Configure Users, Groups, and Global Roles.

    Assign users to groups

    Assign users to groups. Groups allow you to manage multiple users at the same time. This is generally more efficient than managing each user individually. For instructions, see Assign Users to Groups.

    Assign groups to groups

    Designate a group as a subgroup of another group, to add further granularity to security management. For instructions, see Assign Groups to Groups.

    Assign users and groups to global roles

    Assign users and groups to predefined WebLogic Server global security roles. For instructions, see Assign Users and Groups to Global Roles.


Prepare Scripts and Files with Replacement Variables

The Domain Template Builder automatically updates any standard scripts included in a template, such as start scripts, by replacing hard-coded values for various domain environment settings with variables. The Configuration Wizard can later replace these variables with new hard-coded values during the configuration of a new WebLogic domain.

If you want, you can prepare additional files to be included with your template by manually inserting replacement variables. For more information, see Prepare Scripts and Files with Replacement Variables.

After performing the required steps, click Next. The Review WebLogic Extension Template screen is displayed.

Review WebLogic Extension Template Settings

In the Review WebLogic Extension Template screen, you can review the settings for the new extension template before it is created.

  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 need to change any settings that you defined in previous windows, select Previous to return to the required configuration window.

    Note:

    You can use the View drop-down list to limit the type of information displayed on the Template Summary screen.
  2. Click Create.

  3. The Create an Extension Template screen is displayed.

Creating Template

The Creating Template screen displays status messages during the template creation process. The Domain Template Builder generates a JAR file that contains only the applications and services specified in the extension template.

When the process completes, click Done to exit the Domain Template Builder.