This section covers the following topics:
This section describes how to invoke the Configuration Wizard in graphical and console modes. Topics include:
When run in graphical mode, the Configuration Wizard is executed in a graphical environment. The console for the machine on which the product installation resides must support a Java-based GUI. 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 a 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.
StartProgramsBEA ProductsToolsConfiguration Wizard
\common\bin
subdirectory of the product installation directory. For example:
cd c:\bea\realtime10\common\bin |
When run in console mode, the Configuration Wizard is executed in a text-based environment.
To start the Configuration Wizard in console mode:
To finish creating your domain, respond to the prompts in each section by entering the number associated with your choice, pressing Enter, or typing next
(or n
) to accept the current selection. The arrow ( ) indicates the value currently selected. To quit the Configuration Wizard, enter Exit
in response to any prompt. To review or change your selection, enter Previous
at the prompt.
Note: | Instead of typing complete words when you want to enter [Exit] , [Previous] , and [Next] , you can use the following one-letter shortcuts: x , p , and n , respectively. |
Before you can develop and run WebLogic-based applications, you must first create a domain. The Configuration Wizard guides you through the process of creating a new domain quickly and easily, by selecting the product components you want to include in your domain, or by using domain templates.
The following topics describe the steps required to create a new domain using the Configuration Wizard:
The Welcome window prompts you to choose whether you want to create a new domain or extend an existing one.
Add product component functionality or support for additional applications and services to an existing domain. Begin by selecting the directory of the domain that you want to update. Then specify the product components you want to add, or identify the extension template you want to use for adding applications and services. You then have the option of customizing the JDBC connections to your database and the WebLogic file store, if defined. To learn more, see "Extending Domains" in the Creating WebLogic Domains Using the Configuration Wizard at
http://download.oracle.com/docs/cd/E13222_01/wls/common/docs91/configwiz/exten.html .
|
The Select a Domain Source window prompts you to select the source from which to create the domain. You can select the product components to include in your domain.
Choose one of the following options for selecting the source for your domain:
WebLogic Real Time is required for this option and is selected by default. You can also select the check boxes associated with the other components you want to include, such as Apache Beehive, and then click Next to continue.
The pathname for the WebLogic Real Time template, wlrt.jar
, is selected by default, and is required to create a valid WebLogic Real Time domain. To use this option, click Next.
Optionally, you can manually enter the full pathname to a template in the Template location field and click Next, or click Browse to navigate to the directory containing the desired template. Select the domain template that contains the settings you want to use as the basis for your domain.
Note: | While using the Configuration Wizard or WLST Offline to create or extend a clustered domain with a template that has applications containing application-scoped JDBC and/or JMS resources, you may need to perform additional steps (after the domain is created or extended) to make sure that the application and its application-scoped resources are targeted and deployed properly in a clustered environment. For more information on the targeting and deployment of application-scoped modules, see "Deploying Applications and Modules" in Deploying Applications to WebLogic Server at the following URL:
http://download.oracle.com/docs/cd/E13222_01/wls/docs91/deployment/deploy.html . |
The Configure Administrator Username and Password window prompts you to specify a username and password to be used for starting the Administration Server.
Do not use commas or any characters in the following comma-separated list: \t
, < >
, #
, |
, &
, ?
, ( )
, { }
. User names are case sensitive.
Note: | Do not use the name/password combination weblogic/weblogic in a production environment. |
The Configure Server Start Mode and JDK window prompts you to specify the:
Specify the startup mode for your domain as shown in the following table.
|
The following table describes the differences between development and production modes in terms of key functions.
The JDK Selection pane prompts you to select the J2SE Development Kit (JDK) for the startup mode you selected in the WebLogic Domain Startup Mode pane. The Configuration Wizard presents the BEA JRockit JDK supplied by WebLogic Real Time and installed with the product.
You must use the BEA JRockit JDK to use the Deterministic Garbage Collector option. When you select the BEA JRockit JDK, the Configuration Wizard will create server startup scripts that will automatically configure the Deterministic Garbage Collector option.
Caution: | To use a JDK that is not installed with the product, select Other JDK, click Browse, and navigate to the appropriate directory. However, the Configuration Wizard does not configure the start scripts to use this type of JDK. You must change the start scripts manually. |
For information on changing the run-time mode after you have created a domain, see "Change to production mode" in the WebLogic Server Administration Console Online Help at
http://download.oracle.com/docs/cd/E13222_01/wls/docs91/ConsoleHelp/taskhelp/domainconfig/ChangeRuntimeModes.html
.
The Customize Environment and Services Settings window gives you the option to change the distribution of your domain across servers, clusters, and machines, and to modify existing JDBC and JMS file store settings.
If you choose not to customize any environment or services settings by accepting the default (No), you proceed directly to creating the domain.
The following topics summarize the settings you can change.
You can customize the environment of your domain as follows:
For more information, see "Customizing the Environment" in the Creating WebLogic Domains Using the Configuration Wizard at
http://download.oracle.com/docs/cd/E13222_01/wls/common/docs91/configwiz/custom.html
.
If the domain source on which you are basing your domain contains a database configuration, you have the option to do the following:
If a WebLogic file store has been defined in the domain source for JMS, you can also change the file store definition.
For more information, see "Customizing Existing JDBC and JMS Settings" in the Creating WebLogic Domains Using the Configuration Wizard at
http://download.oracle.com/docs/cd/E13222_01/wls/common/docs91/configwiz/service.html
.
The Create WebLogic Domain window prompts you to specify the name and pathname for the domain, and initiate its creation.
The domain directory can be located anywhere on your system. By default, it resides in BEA_HOME
\user_projects\domains\
domain
, where BEA_HOME
is the directory that contains the product installation, and domain
is the name of the domain directory defined by the selected domain template.
Note: | You cannot overwrite an existing domain. If a domain with the name you specify already exists in the selected location, you must either delete the existing domain, or specify a different name or location for this domain. |
The Creating Domain window is opened to display status messages during the domain creation process.
The Configuration Wizard stores the config.xml
file and all other generated components in the domain directory that you specify.
The Creating Domain window displays status messages during the domain creation process. When the process is complete, the new domain is ready for use.
When you install your BEA Products software on a Windows system, the installation program automatically creates shortcut entries on the Start Menu.
Note: | If the user performing the installation has Administrator privileges, the shortcut entries can be created in the All Users Start menu folder or in the user's local Start menu folder. For more information, see Administrator Privileges. |
Options on the Start Menu vary, according to the components you choose to install.
The BEA Products folder (StartProgramsBEA Products) contains the shortcut files shown in the following figure.
During the product installation, you are asked to select or create a BEA Home directory and a product installation directory. For information about the BEA Home directory, see Choosing a BEA Home Directory. For a complete installation, the installation program creates a dedicated directory structure for the BEA Products software. It may or may not reside in the BEA Home directory. The following diagram shows the directory tree structure for a complete product installation.
Table 7-5 describes the contents of each directory.
Note: | The installation program does not create directories for components that are not installed. For example, if you choose to perform a component installation and select "WebLogic Real Time" without "WebLogic Server", then only the common and uninstall directories are created. |