Fusion Middleware Documentation
Advanced Search


Creating WebLogic Domains Using the Configuration Wizard
Close Window

Table of Contents

Show All | Collapse

2 Creating a WebLogic Domain

This chapter describes how to create a new WebLogic domain by using the Configuration Wizard in graphical mode. It also describes how to start the domain and the Administration Server.

It includes the following sections:

Before You Begin

Prior to running the Configuration Wizard to create a domain on a UNIX or Linux operating system, if you have not already done so, set the CONFIG_JVM_ARGS environment variable to the following value:

-Djava.security.egd=file:/dev/urandom

This decreases the amount of time it takes for the Configuration Wizard to create or update a domain.

Domain Creation Process

The Configuration Wizard guides you through the process of creating a WebLogic domain for your target environment by selecting the product components to include in your domain, or by selecting template JAR files. If necessary, you can also customize the domain to suit your environment by adding and configuring Managed Servers, clusters, and machine definitions, or customizing predefined JDBC data sources and JMS file store directories.

Table 2-1 shows the sequence of screens that are presented by the Configuration Wizard. The screens that you see depend on your domain requirements and whether or not you need to customize your domain.

You may want to customize your domain in the following circumstances:

  • To create a multi-server or clustered domain when using the default settings. All the predefined WebLogic Server templates (those delivered with WebLogic Server) create single-server domains.

  • To use a database that is different from the default database in the domain or extension template. In this case, you must customize the JDBC settings to point to the appropriate database.

  • To customize the listen port and the SSL port.

  • To create a test environment by using a domain template that you received, and to modify the domain configuration to work in the test environment based on your requirements.

Starting the Configuration Wizard

The console for the machine on which the product installation resides must support Java-based GUIs. All Windows-based consoles support Java-based GUIs; only a subset of UNIX-based consoles support Java-based GUIs.

You can start the Configuration Wizard in graphical mode from either the Windows Start menu or from the command line.

  • To start the Configuration Wizard in graphical mode on a Windows platform, choose Start > All Programs > Oracle > Oracle Home > WebLogic Server version > Tools > Configuration Wizard.

  • To start the Configuration Wizard in graphical mode from a Windows command prompt or on UNIX systems:

    1. Log in to the system on which the product is installed.

    2. Open an MS-DOS command prompt window (on Windows) or a command shell (on UNIX).

    3. Go to the following directory:

      On Windows: MWHOME\oracle_common\common\bin

      On UNIX: MWHOME/oracle_common/common/bin

      Replace MWHOME with the Fusion Middleware home directory.

    4. Execute the following command:

      On Windows: config.cmd

      On UNIX: sh config.sh

      Notes:

      When you run the config.cmd or config.sh command, the following error message might be displayed to indicate that the default cache directory is not valid:

      *sys-package-mgr*: can't create package cache dir

      You can change the cache directory by including the -Dpython.cachedir=valid_directory option in the command line.

      To create a log file of the Configuration Wizard session, include the -log=config.log -log_priority=debug parameter in the command. You can specify any file name for the log file, such as config_today.log. The log file is stored in the logs directory of the Oracle Middleware home directory.

      The Configuration Type screen is displayed.

Creating a WebLogic Domain in Graphical Mode

To create a new WebLogic Domain by using the Configuration Wizard in graphical mode, start the Configuration Wizard as described in Starting the Configuration Wizard.

Note:

In situations where you cannot run the Configuration Wizard in GUI mode, Oracle recommends that you use a WLST script to create or extend a domain. For more information, see "Creating and Using a Domain Template (Offline)" in Understanding the WebLogic Scripting Tool.

If your installation includes Fusion Middleware products, refer to Chapter 4, "Configuring Fusion Middleware Domains," for instructions. Fusion Middleware product configuration includes additional Configuration Wizard screens that are not included in the workflow in this chapter.

The Configuration Wizard displays a sequence of screens, in the order listed in Table 2-1. For more information on each screen, refer to the related section in Chapter 5, "Configuration Wizard Screens," or click the link in the Screen column.

Table 2-1 Configuration Screens for Creating a New WebLogic Domain

Screen When Does This Screen Appear? Perform the Following Action

Configuration Type

Always

Select Create a new domain.

In the Domain Location box, enter the path to the new domain, or click Browse to create the domain directory.

Click Next to continue.

Templates

Always

Select the appropriate option:

  • Select Create Domain Using Product Templates, and then select the check box for each product to include in the domain.

  • Select Create Domain Using Custom Template, and then click Browse to locate the domain template on your local drive or network.

Click Next to continue.

Application Location

Only if one or more of the selected templates define an application.

Specify the directory in which the domain's applications are to be stored.

Click Next to continue.

Administrator Account

Always

Specify the username and password for the domain's administrator account.

Click Next to continue.

Domain Mode and JDK

Always

Select the startup mode to use.

Select the JDK to use in the domain or click Browse to navigate to the JDK you want to use.

Click Next to continue.

Data source configuration

Only if the domain includes components that require JDBC data sources, GridLink data sources, or Oracle RAC multi data sources

See Configuring Data Sources, for information about these screens.

Database Scripts

Only if the selected products or template includes a set of SQL files organized by database type

Select the data sources for which you want to run the database scripts.

Select the database version.

Click Run Scripts.

After running all necessary scripts, click Next to continue.

Advanced Configuration

Always

Select the check box for each category (if any) for which you want to perform advanced configuration tasks

The available check boxes depend on the resources that are configured in the selected products or template.

Click Next to continue.

See Advanced Configuration, for the screens that are displayed if you select all available options.

Configuration Summary

Always

Review the configuration for your domain by selecting a Summary View, and then selecting individual items in the list for that view.

If the domain is configured as you want it, click Create to create the domain.

If you need to make changes to the configuration, click Previous to return to the appropriate screen for the settings you want to change.

Configuration Progress

Always

Shows the progress of the domain creation.

When the process completes, click Next.

Configuration Success

Always

Review the domain creation results.

Click Finish to exit the Configuration Wizard.


Configuring Data Sources

The screens described in this section are displayed in the Configuration Wizard only if the domain includes components that require JDBC data sources or Oracle RAC multi data sources. Table 2-2 lists the sequences of data source screens. For more information on each screen, refer to the related section in Chapter 5, "Configuration Wizard Screens," or click the link in the Screen column.

After configuring the screens described in this section, return to Table 2-1.

Table 2-2 Data Source Configuration Screens

Screen When Does This Screen Appear? Perform the Following Action

JDBC Data Sources

Only if the domain includes components that require JDBC data sources

Select a data source to configure, and then do one of the following:

  • Configure the fields for the data source

  • Select the Convert to GridLink option

  • Select the Convert to RAC multi data source option

Click Next to continue.

GridLink Oracle RAC Data Sources

Only if the domain includes components that require JDBC data sources, and you selected the Convert to GridLink option for at least one data source on the Configure JDBC Data Source screen

Configure the fields for the Gridlink RAC data source, including the Service Name, Service Instance, ONS Host, wallet file, and wallet password.

Click Next to continue.

Oracle RAC Multi Data Sources

Only if the domain includes components that require JDBC data sources, and you selected the Convert to RAC multi data source option for at least one data source on the Configure JDBC Data Source screen

Configure the fields for the Oracle RAC multi data source, including the Oracle RAC host name, instance name, and port.

Click Next to continue.

JDBC Data Sources Test

Only if the domain includes components that require JDBC data sources

Select the data sources to test, and click Test Connection. Wait for the connection test(s) to complete.

Note: In order to test connections, the database to which you are trying to connect must be running.

If you do not want to test connections at this time, deselect all data sources.

Click Next to continue.


Advanced Configuration

This section describes the sequence of screens that is displayed if you select the options listed on Advanced Configuration screen.

Table 2-3 Advanced Configuration Screens

Screen When Does This Screen Appear? Perform the Following Action

Administration Server

Only if you selected Administration Server on the Advanced Configuration screen

Change the settings for the Administration Server as needed.

Click Next to continue.

Node Manager

Only if you selected Node Manager on the Advanced Configuration screen

Select the Node Manager Type.

Enter the username and password for accessing the Node Manager.

Click Next to continue.

Managed Servers

Only if you selected Managed Servers, Clusters, and Coherence on the Advanced Configuration screen

Add, delete, clone, or reconfigure Managed Servers as needed.

Click Next to continue.

Clusters

Only if you selected Managed Servers, Clusters, and Coherence on the Advanced Configuration screen

Add, delete, or reconfigure clusters as needed.

Click Next to continue.

Assign Servers to Clusters

Only if you selected Managed Servers, Clusters, and Coherence on the Advanced Configuration screen, and your domain includes at least one cluster

Add servers to or remove servers from the clusters in your domain.

Click Next to continue.

HTTP Proxy Applications

Only if you selected Managed Servers, Clusters, and Coherence on the Advanced Configuration screen, and your domain includes at least one cluster, and at least one Managed Server that is not assigned to a cluster

For each cluster, specify whether or not you want to create an HTTP proxy application for the cluster. If you select the Create HTTP Proxy check box for a cluster, select the proxy server to use for that cluster. a

Click Next to continue.

Coherence Clusters

Only if you selected Managed Servers, Clusters, and Coherence on the Advanced Configuration screen, and Coherence is installed with WebLogic Server

Accept the default cluster name or type a new name for the Coherence cluster.

Enter the port number to use as the Coherence cluster listen port.

Click Next to continue.

Machines

Only if you selected Managed Servers, Clusters, and Coherence on the Advanced Configuration screen

Select the Machine tab (Windows) or Unix Machine tab (UNIX).

Add machines as needed.

Configure the settings for each machine.

Click Next to continue.

Assign Servers to Machines

Only if you selected Managed Servers, Clusters, and Coherence on the Advanced Configuration screen, and there is at least one machine configured in the domain

Assign the Administration Server and Managed Servers to the appropriate machines.

Click Next to continue.

Deployments Targeting

Only if you selected Deployments and Services on the Advanced Configuration screen, and a selected product or template contains J2EE applications or libraries

Select the target server or cluster on which you want to deploy applications or libraries.

Select the check box for each application or library you want to deploy on the selected target.

Click Next to continue.

Services Targeting

Only if you selected Deployments and Services on the Advanced Configuration screen

Select the target server or cluster.

Select the check box for each service you want to target to it.

Click Next to continue.

JMS File Stores

Only if you selected JMS File Store on the Advanced Configuration screen

Change the settings for each JMS file store as needed, and select the synchronous write policy for each file store.

Click Next to continue.


Starting the Administration Server

When you finish creating your domain, you can start the Administration Server. For more information on the various methods you can use to start the Administration Server, see "Starting and Stopping Servers" in Administering Server Startup and Shutdown for Oracle WebLogic Server.

Running the Quick Start Configuration Wizard

The Quick Start Configuration Wizard can be used only to:

  • Configure the various sample domains, such as MedRec and the Examples Server, in your WebLogic Server installation. In this case, to run the wizard, select the Automatically Launch Quick Start Configuration Wizard option on the Installation Complete screen of the WebLogic Server installer.

  • Configure Fusion Middleware product domains, only if you want to use the Derby (JavaDB) database driver for the domain. In this case, run the wizard manually as described in this section. Schema JARs that are provided with the product will be used to populate a domain_home/common/db directory.

Note:

The Quick Start Configuration Wizard supports only the Derby (JavaDB) database driver. If you are using another database, you cannot use the Quick Start Configuration Wizard to create your domain.

Prior to manually running the Configuration Wizard in Quick Start mode, you must set the CONFIG_JVM_ARGS environment variable to specify the full path and JAR file name for each template that you want to use for the domain. For the location and filename of templates provided by Oracle for WebLogic Server and other Fusion Middleware products, see the Domain Template Reference.

Windows

To set CONFIG_JVM_ARGS on a Windows system:

set CONFIG_JVM_ARGS="-DuserTemplates=template1,template2,template3, ..., templaten"

The following example uses the WebLogic Server base domain template and the Web Services JAX-WS template to create the domain:

set CONFIG_JVM_ARGS="-DuserTemplates=C:/Oracle/Middleware/wlserver/common/
templates/wls/wls.jar,C:/Oracle/Middleware/wlserver/common/templates/
wls/wls_webservice_jaxws.jar"

To run the Configuration Wizard in Quick Start mode on Windows systems, enter the following commands, where ORACLE_HOME is your Oracle home directory:

cd ORACLE_HOME/oracle_common/common/bin
config.cmd -target=config-oneclick

UNIX

To set CONFIG_JVM_ARGS on a UNIX or Linux system:

export CONFIG_JVM_ARGS="-DuserTemplates=template1,template2,template3, ..., templaten"

The following example uses the WebLogic Server base domain template and the Web Services JAX-WS template to create the domain:

export CONFIG_JVM_ARGS="-DuserTemplates=/Oracle/Middleware/wlserver/common/
templates/wls/wls.jar,/Oracle/Middleware/wlserver/common/templates/
wls/wls_webservice_jaxws.jar"

To run the Configuration Wizard in Quick Start mode on UNIX systems, enter the following commands, where ORACLE_HOME is your Oracle home directory:

cd ORACLE_HOME/oracle_common/common/bin
config.sh -target=config-oneclick

shows the sequence of screens that are presented by the Quick Start Configuration Wizard:

Table 2-4 Quick Start Configuration Screens

No. Screen When Does This Screen Appear? Perform the Following Action

1

Configuration

Always

Complete all fields and selections, and then click Create.

2

Configuration Progress

Always

Shows the progress of the domain creation.

When the process completes, click Next.

3

Configuration Success

Always

Review the domain creation results.

Click Finish to exit the Configuration Wizard.


Using Quick Start to Create the WebLogic Sample Domains

If you included the WebLogic samples during the WebLogic installation, but did not select the option to run the Quick Start Wizard at the end of the installation to create the three sample domains, you can create the sample domains at a later time by running the Quick Start Wizard from the command line.

In this case, you must create the sample domains one at a time. This requires you to run the Quick Start Wizard three times to create all three domains.

Refer to Table 2-5 for the templates that you must include in the CONFIG_JVM_ARGS variable to create each domain. For example, to create the WebLogic Server Examples domain, enter the following commands, substituting your WebLogic Server home directory for WL_HOME:

set CONFIG_JVM_ARGS="-DuserTemplates=WL_HOME/common/
templates/wls/wls.jar,WL_HOME/common/templates/wls/wls_default.jar,
WL_HOME/common/templates/wls/wls_examples_jaxws.jar"

cd ORACLE_HOME/oracle_common/common/bin
config.sh -target=config-oneclick

Table 2-5 Templates Required for WebLogic Sample Domains

To create this domain ... Include these templates ...

MedRec (Avitek Medical Records Sample Domain)

WL_HOME/common/templates/wls/wls.jar

WL_HOME/common/templates/wls/medrec.jar

MedRec Spring (Avitek Medical Records Sample Domain for Spring)

WL_HOME/common/templates/wls/wls.jar

WL_HOME/common/templates/wls/medrec_spring.jar

WebLogic Server Examples

WL_HOME/common/templates/wls/wls.jar

WL_HOME/common/templates/wls/wls_default.jar

WL_HOME/common/templates/wls/wls_examples.jar