Creating Extension Templates by Using the Domain Template Builder

Creating Templates By Using the Domain Template Builder

Creating Extension Templates by 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 are not prompted to configure the administration server, assign an administrator username and password, or specify Start menu entries, because these domain settings are already defined in the domain to be extended.
The following topics describe the steps for creating an extension template:

Create a New Template
Select a Template Domain Source
Describe the Template
Add or Omit Applications
Add Files
Add SQL Scripts
Configuring Security Options
Prepare Scripts and Files
Review the Extension Template Settings
Create Your Extension Template

Create a New Template

The Create a New Template window is displayed when you start the Domain Template Builder as described in Starting the Domain Template Builder.
Select Create an Extension Template and click Next.
The Select a Template Domain Source window is displayed.

Select a Template Domain Source

The Select a Template Domain Source window prompts you to 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:

Select the Select a Template tab.
From the list of templates displayed in the Templates pane, select a template.
The templates are grouped by category.
The extension templates displayed for selection are located in the directory specified in the Locate Additional Templates pane. If you want to change the directory, click Browse, and then navigate to the appropriate directory or enter the path manually.
Click Next.
The Describe the Template window is displayed.

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

Select the Select a Domain tab.
Navigate to the domain directory from which you want to create an extension template and select the desired domain.
Valid domain directories are indicated by a icon.
Click Next.
The Describe the Template window is displayed.

Describe the Template

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

The description that you provide here will be displayed in the Select a Template pane of the Select a Template Domain Source window.

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 domain. Then, click Next.
If you selected a 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 window, see Table 2-2.
The Add or Omit Applications window is displayed.

Add or Omit Applications

In this window, you can do the following:

Review the list of applications that are currently defined in your template source.
Review the pathnames 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 window 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. In the Add Files window, 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 window is displayed.

Add SQL Scripts

In the Add SQL Scripts window, you can add SQL scripts for each database that you expect to be used with the 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 window is displayed.

Configuring Security Options

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

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 that 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 that determine access privileges for system administration operations: Admin, Deployer, Operator, and Monitor.

WARNING: 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).

In the Security Configuration Options window, 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 domain.
If you choose Yes, you are prompted, in subsequent windows, to configure the security as described in Table 3-1.
Table 3-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 a number of 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

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 domain.
If you want to, 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 Domain Template window is displayed.

Review the Extension Template Settings

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

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.

You can limit the type of information displayed in the Template Summary window by using the View drop-down list.
Click Next.
The Create an Extension Template window is displayed.

Create Your Extension Template

The Create an Extension Template window prompts you to specify the name and directory for the extension template, and launch the process that creates it.

Specify a name for the template JAR file in the Template jar name field.
Make sure that the Template location field contains the name of the directory in which you want the template to reside.
You can change the location either by clicking Browse and navigating to the appropriate directory or by entering the path manually.
The template directory can be located anywhere in your system. By default, it resides in BEA_HOME\user_templates, where BEA_HOME is the directory that contains the product installation (by default, on Windows, this directory is c:\bea).
After verifying the information displayed in the window, click Create.
The Creating Template window 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.
Click Done in the Creating Template window.

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 a number of 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.