bea.com | products | dev2dev | support | askBEA

Download Docs | Site Map | Glossary
Search

Configuration Wizard Template Reference

WLS Petstore Domain Template

The following WebLogic Server (WLS) Petstore template topics are discussed in this section:

- Template Description

- Creating a Domain Based on the WLS Petstore Template

- Security Compatibility

- Configuration and Supporting Files

- Applications and Resources

Template Description

The WebLogic Server Petstore template is a domain template that creates a WebLogic Server domain configured to be used for building and deploying applications similar to Petstore. This template is available upon installation of WebLogic Server and includes the scripts to run the Petstore sample application.

Purpose

The WebLogic Server Petstore template is intended for initial development of WebLogic Server applications. The WebLogic Server Petstore template creates the environment and start scripts necessary for starting the Petstore sample application in this domain. This will provide a comparable domain directory and configuration to the Petstore sample application and allow for extending the sample application. This directory structure, user_projects/domain, will allow for development of applications outside of the samples directory structure. This will reduce the possibility of this domain directory being overwritten when applying WebLogic Platform maintenance.

Creating a Domain Based on the WLS Petstore Template

This section describes how to create a functional domain based on the WebLogic Server Petstore template. It includes the following topics:

- Process Overview

- Deploying Applications

Process Overview

The following table provides an overview of the steps required to create a domain based on the WebLogic Server Petstore template.

Task | Refer to...
--- | ---
1. Initiate the Configuration Wizard to create a new domain. | Using the Configuration Wizard at the following URL: http://edocs.bea.com/platform/docs70/confgwiz/index.html
2. Select the WLS Petstore template and respond to the prompts to create a new domain. | Using the Configuration Wizard at the following URL: http://edocs.bea.com/platform/docs70/confgwiz/index.html
3. Set up optional domain definitions for network connections, node manager, database connection pools, clusters, etc. Note: This is an optional step depending on your domain requirements. | Creating and Configuring WebLogic Domains at the following URL: http://edocs.bea.com/wls/docs70/admin_domain/index.html and Using WebLogic Server Clusters at the following URL: http://edocs.bea.com/wls/docs70/cluster/index.html
4. Start WebLogic Server. | "Starting and Stopping WebLogic Servers" in the BEA WebLogic Server Administration Guide at the following URL: http://edocs.bea.com/wls/docs70/adminguide/startstop.html

Deploying Applications

The mode under which the server is running will determine the method of deploying applications in this domain. The modes for deploying applications are:

- Development and Testing

When the server is running in development mode, applications or modules in this domain directory are deployed automatically.

- Production

When the server is running in production mode, applications or modules in this domain directory are not deployed automatically. This is the default behavior of the domain.

Deploying Applications Automatically

One of the following actions allow applications in this domain to be deployed automatically:

- Start the server in development mode.

- Place the exploded directory structure or archive file in the domain directory.

When you deploy the applications automatically, the server automatically adds an entry for your application or module to the config.xml file for the domain. You do not need to manually edit the config.xml file.

Security Compatibility

The default security mode for the WebLogic Server Petstore template is the new LDAP security mode. For applications that are only using WebLogic Server and WebLogic Workshop, LDAP security is recommended.

Note: If you are developing WebLogic Server applications that will use either WebLogic Integration or WebLogic Portal components or both components, you must use the realm-based security model.

For more information about WebLogic Platform security, refer to Introduction to WebLogic Platform 7.0 Security at the following URL:

http://edocs.bea.com/platform/docs70/secintro/index.html

Configuration and Supporting Files

The WebLogic Server Petstore template creates various directories and scripts under the user_projects/domain directory, where domain is the name of the WebLogic Server Petstore domain. The scripts and files vary depending on the configuration selected (standalone or clustered). The following table is a list of some of the basic directories and files that are installed with the domain. These scripts and files must be configured properly for the server to boot in the domain.

Note: The following table is not a complete list of all directories and files. The list varies depending on the configuration selected.

Directory | Files | Purpose
--- | --- | ---
user_projects/domain/applications | readme.txt | The readme.txt file provides general information about the WebLogic Server Petstore domain. The application directory provides a location for a customized WebLogic Server application.
user_projects/domain/logs | weblogic.log | Location for log files generated for the domain.
user_projects/domain | config.xml | The configuration information for the Administration Server for the WebLogic Server Petstore domain.
user_projects/domain | fileRealm.properties | Specifies the security properties, such as the User, Group, and ACL objects for the domain. Note: LDAP is the default security mode. Realm-based security is available for compatibility purposes.
user_projects/domain | startPetstore.cmd, startPetstore.sh | Starts the Administration Server for the WebLogic Server Petstore custom domain.
user_projects/domain | startManagedWebLogic.cmd, startManagedWebLogic.sh | Starts a Managed Server in a custom domain.
user_projects/domain | demokey.pem, democert.pem | Provides sample SSL protocol support for servers in the domain.

For additional information about configuring your WebLogic Server Petstore domain, refer to Creating and Configuring WebLogic Domains at the following URL:

>     http://edocs.bea.com/wls/docs70/admin_domain/index.html

For information about configuring WebLogic Server clusters, refer to Using WebLogic Server Clusters at the following URL:

>     http://edocs.bea.com/wls/docs70/cluster/index.html

Applications and Resources

This template creates a comparable configuration to that of the Pet Store sample domain. This domain supports an environment that can be extended to develop and deploy additional applications other than Pet Store.

After creating a domain with the WebLogic Server Petstore template, you can start the server. When you start the server, a Pointbase database connection is initiated for the domain.

Types of Applications to Deploy

The WebLogic Server Petstore domain supports the following types of applications or files:

- J2EE application EAR file

- WAR, EJB, JAR, RAR, or CAR archived modules

- Exploded directory structure or archive file