2 Creating a WebLogic Domain

This chapter describes how to create a new WebLogic domain by using the Configuration Wizard in graphical mode. It contains the following sections:

Before You Begin
Domain Creation Process
Starting the Configuration Wizard in Graphical Mode
Creating a WebLogic Domain in Graphical Mode
Starting the Administration Server

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 domain 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.

You might 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.

Figure 2-1 summarizes the Configuring Wizard steps for creating a WebLogic domain. The steps indicated in boxes with dashed lines are relevant only when you create WebLogic domains that contain specific products, such as those that use RCU and those that require JDBC data sources.

Figure 2-1 Creating a WebLogic Domain

Description of "Figure 2-1 Creating a WebLogic Domain"

Starting the Configuration Wizard in Graphical Mode

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.

Note:

If you attempt to start the Configuration Wizard in graphical mode on a system that cannot support graphical display, the Configuration Wizard automatically starts in console mode.

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 > Programs > Oracle WebLogic > WebLogic Server > 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: WLHOME\common\bin
  
  On UNIX: WLHOME/common/bin
  
  where WLHOME is the directory in which WebLogic Server is installed.
4. Execute the following command:
  
  On Windows: config.cmd
  
  On UNIX: sh config.sh
  
  Note:
  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.
  
  The Welcome 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 in Graphical Mode.

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 Oracle WebLogic Scripting Tool.

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 4, "Configuration Wizard Screens," or click the link in the Screen column.

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

No.	Screen	When Does This Screen Appear?	Perform the Following Action
1	Welcome	Always	Select Create a new WebLogic domain. Click Next to continue.
2	Select Domain Source	Always	Do one of the following: Select Generate a domain configured automatically to support the following products, and then select the check box for each product to include in the domain. Select Base this domain on an existing template, and then use the Browse button to locate the template on your local drive or network. Click Next to continue.
3	Specify Domain Name and Location	Always	Specify the name and directory location of the domain. Click Next to continue.
4	Configure Administrator User Name and Password	Always	Specify the username and password for the domain's administrator account. Click Next to continue.
5	Configure Server Start Mode and JDK	Always	Select the startup mode to use. Select the JDK(s) to use in the domain. Click Next to continue.
6-8	Schema configuration	Only if the domain includes components (such as SOA) that require the use of the Oracle Fusion Middleware Repository Creation Utility (RCU) to load database schemas	See Configuring Schemas, for information about these screens.
9-12	Data source configuration	Only if the domain includes components that require JDBC data sources or Oracle RAC multi data sources	See Configuring Data Sources, for information about these screens.
13	Configure Keystore Credentials	Only if the domain includes a product that requires a keystore password	For each set of password fields, enter and confirm the password you want to use for the keystore. Click Next to continue.
14	Select Optional 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.
15	Configure Administration Server	Only if you selected Administration Server on the Select Optional Configuration screen	Change the settings for the Administration Server as needed. Click Next to continue.
16	Select JMS Distributed Destination Type	Only if you selected JMS Distributed Destination on the Select Optional Configuration screen	For each JMS system resource, select the distributed destination type. Click Next to continue.
17	Configure Managed Servers	Only if you selected Managed Servers, Clusters, and Machines on the Select Optional Configuration screen	Add, delete, or reconfigureManaged Servers as needed. Click Next to continue.
18	Configure Clusters	Only if you selected Managed Servers, Clusters, and Machines on the Select Optional Configuration screen	Add, delete, or reconfigure clusters as needed. Click Next to continue.
19	Assign Servers to Clusters	Only if you selected Managed Servers, Clusters, and Machines on the Select Optional 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.
20	Create HTTP Proxy Applications	Only if you selected Managed Servers, Clusters, and Machines on the Select Optional 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.
21	Configure Machines	Only if you selected Managed Servers, Clusters, and Machines on the Select Optional Configuration screen.	Add, delete, or reconfigure machines as needed. Click Next to continue.
22	Assign Servers to Machines	Only if you selected Managed Servers, Clusters, and Machines on the Select Optional 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.
23	Target Deployments to Clusters or Servers	Only if you selected Deployments and Services on the Select Optional 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.
24	Target Services to Clusters or Servers	Only if you selected Deployments and Services on the Select Optional 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.
25	Configure JMS File Stores	Only if you selected JMS File Store on the Select Optional 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.
26	Configure RDBMS Security Store Database	Only if you selected RDMBS Security Store on the Select Optional Configuration screen	Specify the settings for your Relational Database Management System (RDBMS). Click Next to continue.
27	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.
28	Creating Domain	Always	Shows the progress of the domain creation. When the process completes, click Done.

Configuring Schemas

The screens described in this section are displayed in the Configuration Wizard only if the domain includes components (such as SOA) that require the use of the Oracle Fusion Middleware Repository Creation Utility (RCU) to load database schemas. Table 2-2 lists the sequences of schema-related screens. For more information on each screen, refer to the related section in Chapter 4, "Configuration Wizard Screens," or click the link in the Screen column.

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

Table 2-2 Schema Configuration Screens

No.	Screen	When Does This Screen Appear?	Perform the Following Action
6	Configure JDBC Component Schema	Only if the domain includes components (such as SOA) that require the use of the Oracle Fusion Middleware Repository Creation Utility (RCU) to load database schemas	Configure the schema owner and password for each component schema listed on this screen. Changes to any of the fields on this screen are applied to all selected component schemas in the table. For example, if all of your schemas reside on the same database, select all of the schemas in the table, then specify the appropriate database values for the schemas (DBMS/Service, Host Name, and Port). If, for example, you have a different password for each schema, then you must select each schema individually and specify the password for the selected schema only. Click Next to continue.
7	Configure RAC Multi Data Source Schema	Only if the domain includes components (such as SOA) that require the use of the Oracle Fusion Middleware Repository Creation Utility (RCU) to load database schemas, and you selected the Configured selected component schemas as RAC multi data source schemas option	Configure the schema owner and password for each component schema listed on this screen. Changes to any of the fields on this screen are applied to all selected component schemas in the table. For example, if all of your schemas reside on the same database, select all of the schemas in the table, then specify the appropriate database values for the schemas (Service Name, Host Name, Instance Name, and Port). If, for example, you have a different password for each schema, then you must select each schema individually and specify the password for the selected schema only. Click Next to continue.
8	Test Component Schema	Only if the domain includes components (such as SOA) that require the use of the Oracle Fusion Middleware Repository Creation Utility (RCU) to load database schema	Test the configurations that you specified for the data sources in the previous screen. Click Next to continue.

No.

Screen

When Does This Screen Appear?

Perform the Following Action

Configure JDBC Component Schema

Only if the domain includes components (such as SOA) that require the use of the Oracle Fusion Middleware Repository Creation Utility (RCU) to load database schemas

Configure the schema owner and password for each component schema listed on this screen. Changes to any of the fields on this screen are applied to all selected component schemas in the table.

For example, if all of your schemas reside on the same database, select all of the schemas in the table, then specify the appropriate database values for the schemas (DBMS/Service, Host Name, and Port).

If, for example, you have a different password for each schema, then you must select each schema individually and specify the password for the selected schema only.

Click Next to continue.

Configure RAC Multi Data Source Schema

Only if the domain includes components (such as SOA) that require the use of the Oracle Fusion Middleware Repository Creation Utility (RCU) to load database schemas, and you selected the Configured selected component schemas as RAC multi data source schemas option

Configure the schema owner and password for each component schema listed on this screen. Changes to any of the fields on this screen are applied to all selected component schemas in the table.

For example, if all of your schemas reside on the same database, select all of the schemas in the table, then specify the appropriate database values for the schemas (Service Name, Host Name, Instance Name, and Port).

If, for example, you have a different password for each schema, then you must select each schema individually and specify the password for the selected schema only.

Click Next to continue.

Test Component Schema

Only if the domain includes components (such as SOA) that require the use of the Oracle Fusion Middleware Repository Creation Utility (RCU) to load database schema

Test the configurations that you specified for the data sources in the previous screen.

Click Next to continue.

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-3 lists the sequences of schema-related screens. For more information on each screen, refer to the related section in Chapter 4, "Configuration Wizard Screens," or click the link in the Screen column.

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

Table 2-3 Data Source Configuration Screens

No.	Screen	When Does This Screen Appear?	Perform the Following Action
9	Configure JDBC Data Source	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 Configure selected data sources as RAC multi data sources option Click Next to continue.
10	Configure Oracle RAC Multi Data Sources	Only if the domain includes components that require JDBC data sources, and you selected the Configure selected data sources as RAC multi data sources option for at least on 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.
11	Test JDBC Data Sources	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.
12	Run 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.

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 Managing Server Startup and Shutdown for Oracle WebLogic Server.