bea.com | products | dev2dev | support | askBEA

Download Docs | Site Map | Glossary
Search

Configuration Wizard Template Reference

WebLogic Workshop Domain Template

The following WebLogic Workshop Domain template topics are discussed in this section:

- Template Description

- Creating a Domain Based on the WebLogic Workshop Template

- Configuration and Supporting Files

- Applications and Resources

Template Description

The WebLogic Workshop template is a domain template that creates a WebLogic Server domain configured to be used for building WebLogic Workshop applications. This template is available upon installation of WebLogic Server.

Purpose

The WebLogic Workshop template is intended for initial development and experimentation of WebLogic Workshop applications. The WebLogic Workshop template creates the environment and start scripts necessary for starting a server in this domain.

Creating a Domain Based on the WebLogic Workshop Template

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

- Process Overview

- Deploying Applications

- Security Compatibility

- Switching Databases

Process Overview

The following table provides an overview of the steps required to create a domain based on the WebLogic Workshop 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 WebLogic Workshop 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. Set up your domain for a clustered environment. Note: This is an optional step depending on your configuration requirements. | "How Do I: Deploy a Workshop Application to a Cluster?" in the BEA WebLogic Workshop Help at the following URL: http://edocs.bea.com/workshop/docs70/help/guide/deployment/howClusterDeployment.html
5. 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 and "How Do I: Start WebLogic Workshop?" in the BEA WebLogic Workshop Help at the following URL: http://edocs.bea.com/workshop/docs70/help/guide/howdoi/HowDoIStartWebLogicWorkshop.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

This domain is intended primarily for initial development and experimentation of applications that involve WebLogic Workshop applications. The applications in this domain, by default, are in development mode.

- Production

For information regarding deploying applications in production mode, refer to the BEA WebLogic Workshop Help at the following URL:

>     http://edocs.bea.com/workshop/docs70/help/guide/howdoi/howDeployWebLogicWorkshopWebServicestoaProductionServer.html

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.

Deploying Applications in a Cluster

After initiating the server, review the various component consoles to determine what applications are deployed.

Note: WebLogic Workshop applications can easily be deployed on WebLogic Server cluster environments. For information on how to deploy these applications, refer to the BEA WebLogic Workshop documentation at the following URL:

http://edocs.bea.com/workshop/docs70/index.html

In this version of WebLogic Workshop, applications that use a JMS message queue rely on the services of a single JMS server and connection factory. This includes applications that use JMS as a transport protocol, the message-buffer property, or timer controls. Future versions of WebLogic Workshop will use the distributed JMS destination capability in WebLogic Server to reduce the dependency on a single JMS server in a clustered environment.

Security Compatibility

The default security mode for the WebLogic Workshop domain 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 Workshop 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

Switching Databases

The default database available with WebLogic Server is Pointbase. To switch to another database, refer to the procedures in the BEA WebLogic Workshop Help at the following URL:

>     http://edocs.bea.com/workshop/docs70/help/guide/howdoi/howConnectaDatabaseControltoaDifferentDatabaseSQLServerOracle.html

Configuration and Supporting Files

The WebLogic Workshop domain template creates various directories and scripts under the user_projects/domain directory, where domain is the name of the WebLogic Workshop 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/ DefaultWebApp/ Web-inf | web.xml, weblogic.xml, weblogic-jws-config.xml | Default application for WebLogic Workshop support.
user_projects/domain/applications/ DefaultWebApp | index.html | Default index page for the WebLogic Workshop sample application. Replace this file with a new page for customized applications.
user_projects/domain/logs |  | Location for log files generated for the domain.
user_projects/domain | config.xml | The configuration information for this WebLogic Workshop domain Administration Server.
user_projects/domain | *.properties | Various properties files to provide information for setting up your database, security, and runtime configuration guidelines for WebLogic Workshop.
user_projects/domain | pointbase.ini | Sets the default configuration for the Pointbase database to run when WebLogic Server is started.
user_projects/domain | startWebLogic.cmd, startWebLogic.sh | Starts the Administration Server for a custom domain.
user_projects/domain | stopWebLogic.cmd, stopWebLogic.sh | Stops the Administration Server for a 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

For information about configuring WebLogic Workshop-enabled WebLogic Server domain, refer to Deployment and Administration information in the WebLogic Workshop documentation at the following URL:

>     http://edocs.bea.com/workshop/docs70/index.html

Applications and Resources

The WebLogic Workshop domain template supports a single JVM or cluster domain configuration. This template creates a shell of a configuration with a sample Web application provided. It supports an environment that can be configured to deploy WebLogic Workshop applications.

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