# Installation Guide

# Post-Installation Information

This section covers the following topics:

- Starting the Configuration Wizard
- Creating a New WebLogic Real Time Domain
- Understanding the Windows Shortcuts
- Understanding the Product Directory Structure

## Starting the Configuration Wizard

This section describes how to invoke the Configuration Wizard in graphical and console modes. Topics include:

- Starting in Graphical Mode
- Starting in Console Mode

### Starting in Graphical Mode

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.

- To start the Configuration Wizard in graphical mode on a Windows platform, choose the Configuration Wizard option from the BEA program group in the Windows Start Menu:

StartProgramsBEA ProductsToolsConfiguration Wizard

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

1. Log in to the target system on which the product installation resides.
2. Open an MS-DOS command prompt window (on Windows) or a command shell (on UNIX).
3. Go to the `\common\bin` subdirectory of the product installation directory. For example:

    cd c:\bea\realtime10\common\bin

4. Invoke one of the following scripts to start the Configuration Wizard in graphical mode:

Windows: `config.cmd`

UNIX: `sh config.sh`

### Starting in Console Mode

When run in console mode, the Configuration Wizard is executed in a text-based environment.

To start the Configuration Wizard in console mode:

1. Log in to the target system on which the product installation resides.
2. Open a command-line shell.
3. Go to the `\common\bin` subdirectory of the product installation directory. For example:

    cd c:\bea\realtime10\common\bin

4. Invoke one of the following scripts:

- Windows: `config.cmd -mode=console`
- UNIX: `sh config.sh -mode=console`

Note: | The command and arguments must be entered in lower-case.

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.

## Creating a New WebLogic Real Time Domain

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:

- Create or Extend a Domain
- Select a Domain Source
- Configure an Administrator Username and Password
- Specify the Server Start Mode and JDK
- Customize Environment and Services Settings
- Create the WebLogic Domain
- Creating Domain

### Create or Extend a Domain

The Welcome window prompts you to choose whether you want to create a new domain or extend an existing one.

Table 7-1 Welcome Window Prompts
Choose this option . . . | When you want to . . .
--- | ---
Create a new WebLogic domain | Create a new domain that is configured to meet your requirements. Begin by selecting the product components you want to include in your domain, or a domain template to be used as the basis for your domain. Then modify settings as required.
Extend an existing WebLogic domain | 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`.

### Select a Domain Source

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:

- Generate a domain configured automatically to support the following BEA products:

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.

- Base this domain on an existing template

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

### Configure an Administrator Username and Password

The Configure Administrator Username and Password window prompts you to specify a username and password to be used for starting the Administration Server.

1. Enter a valid value in the Username field. This name is used to boot the Administration Server and connect to it.

Do not use commas or any characters in the following comma-separated list: `\t`, `< >`, `#`, `|`, `&`, `?`, `( )`, `{ }`. User names are case sensitive.

2. Enter a valid value in the User password field: a string of at least 8 case-sensitive characters. The password value is encrypted.

Note: | Do not use the name/password combination `weblogic/weblogic` in a production environment.

3. Reenter the password in the Confirm user password field.
4. Optionally, enter a login description for this username.
5. Click Next to proceed to the next configuration window.

### Specify the Server Start Mode and JDK

The Configure Server Start Mode and JDK window prompts you to specify the:

- Startup mode for your domain
- JDK to be used for the domain

#### Choose the Startup Mode

Specify the startup mode for your domain as shown in the following table.

Table 7-2 Startup Mode Prompts
Choose this mode . . . | When . . .
--- | ---
Development | You are creating your applications. In this mode, the configuration of security is relatively relaxed, allowing you to auto-deploy applications.
Production | Your application is running in its final form. In this mode, security is fully configured.
Note: | Before putting a domain into production, BEA recommends that you familiarize yourself with the content of Ensuring the Security of Your Production Environment at `http://download.oracle.com/docs/cd/E13222_01/wls/docs91/lockdown/practices.html.`

#### Differences Between Domain Startup Modes

The following table describes the differences between development and production modes in terms of key functions.

Table 7-3 Differences Between Development and Production Modes
Function | In development mode . . . | In production mode . . .
--- | --- | ---
SSL | You can use the demonstration digital certificates and the demonstration keystores provided by the WebLogic Server security services. With these certificates, you can design your application to work within environments secured by SSL. For more information about managing security, see "Configuring SSL" in Securing WebLogic Server at the following URL: `http://download.oracle.com/docs/cd/E13222_01/wls/docs91/secmanage/ssl.html` | You should not use the demonstration digital certificates and the demonstration keystores. If you do so, a warning message is displayed.
Deploying Applications | WebLogic Server instances can automatically deploy and update applications that reside in the `domain_name``/autodeploy` directory (where `domain_name` is the name of a domain). It is recommended that this method be used only in a single-server development environment. For more information, see "Auto-Deploying Applications in Development Domains" in Deploying Applications to WebLogic Server at the following URL: `http://download.oracle.com/docs/cd/E13222_01/wls/docs91/deployment/deploy.html#autodeploy` | The auto-deployment feature is disabled, so you must use the WebLogic Server Administration Console, the `weblogic.Deployer` tool, or the WebLogic Scripting Tool (WLST). For more information, see Deploying Applications to WebLogic Server at the following URL: `http://download.oracle.com/docs/cd/E13222_01/wls/docs91/deployment/index.html`
Log File Rotation | When you start a server, the server automatically renames (rotates) its local server log file as `server-name``.log.``n`. For the remainder of the server session, the server rotates its local log file whenever the size of the file reaches 500 kilobytes. | A server rotates its local log file after the size of the file reaches 500 kilobytes.
JDBC System Resource | The default capacity is 15 connections. | The default capacity is 25 connections.

#### Select the JDK for the Domain

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.

1. Select the JRockit JDK supplied by WebLogic Real Time.

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.

2. Click Next to proceed to the next configuration window.

### Related Topics

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

### Customize Environment and Services Settings

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.

#### Customize the Environment

You can customize the environment of your domain as follows:

- Change the configuration of the Administration Server, including listen address and listen ports
- Add or delete Managed Servers, or change the configuration of existing Managed Servers defined in the selected template
- Group the Managed Servers into clusters, which allows multiple Managed Servers to operate as a single unit to host applications and resources. To group the Managed Servers into clusters, you have the option of performing the following steps:

- Add or delete clusters, or change the configuration of existing clusters
- Assign the Managed Servers to a cluster in the domain
- Create an HTTP proxy for each cluster within the domain

- Assign WebLogic Server instances to host machines. In a domain, machine definitions identify a particular, physical piece of hardware and are used to associate a computer with the Managed Servers it hosts. To map WebLogic Server instances to host machines, you have the option of performing the following steps:

- Add or delete machines, or change the configuration of existing machines
- Assign each instance of WebLogic Server to the machine on which it runs.

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

#### Customize Existing JDBC and JMS Settings

If the domain source on which you are basing your domain contains a database configuration, you have the option to do the following:

- Modify JDBC Data Source settings, including database type and drivers
- Test the connections to the database
- Load the database

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

### Create the WebLogic Domain

The Create WebLogic Domain window prompts you to specify the name and pathname for the domain, and initiate its creation.

1. Make sure that the Domain Name field contains the name of the required domain. If you need to change the value in this field, click within the field and modify the string displayed there.
2. Make sure that the Domain Location field contains the name of the required domain directory. If you need to change the value in this field:

1. Click Browse to invoke the Select a WebLogic Domain Directory dialog box.
2. In the dialog box, navigate to the appropriate directory or manually enter its pathname in the Location field. Click OK.

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.

3. Click Create.

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.

### Creating Domain

The Creating Domain window displays status messages during the domain creation process. When the process is complete, the new domain is ready for use.

Table 7-4 Create Domain Tasks
On this platform . . . | Perform the following task . . .
--- | ---
UNIX and Linux | Click Done.
Windows | Do one of the following: If you want to start the server immediately, select the Start Admin Server check box and click Done. If you do not want to start the server at this time, click Done.

## Understanding the Windows Shortcuts

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.

Figure 7-1 BEA Products Start Menu

- User Projects—WebLogic Real Time domains created with the Configuration Wizard.
- Examples—contains a folder for each component installed on your system that contains shortcuts for launching the examples and associated tools for the component.
- Tools—contains shortcuts for launching the Configuration Wizard, Domain Template Builder, Domain Upgrade Wizard, Node Manager, WebLogic Scripting Tool.
- Online Documentation—provides a link to the online documentation on the e-docs Web site.
- Smart Update—launches the Smart Update program, which checks for any updates available for installed BEA products, and installs the updates as required.
- Uninstall BEA Products—launches the uninstallation program. For more information, see Uninstalling the Software.
- WebLogic Server 9.1—contains a shortcut for launching the default WebLogic Server domain. This domain allows you to run pre-built WebLogic Server code samples, deploy J2EE applications, and quickly serve JSPs or HTML pages. You can also use this domain as a place to test your applications during development.

## Understanding the Product Directory Structure

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.

Table 7-5 Product Installation Directory Structure
This directory . . . | Contains . . .
--- | ---
`realtime10` | Folders for files shared by all product components.
`beehive` | Apache Beehive program files, including samples and user documentation.
`common` | Files shared by product components, including scripts used for setting environment attributes common to all WebLogic domains running on the machine, template JAR files used by the Configuration Wizard and WLST offline when creating domains, and evaluation software from third-party vendors.
`javelin` | A 100% Java/JSP compiler that is used by the component products for compiling .`java` and other source files generated by development tools.
`samples` | Sample code, resources, and preconfigured sample domains designed to help you learn how to develop your own applications using the product software. Sample domains are organized by components installed on the system. For example, the `server` folder contains the source code for `examples` and `medrec` sample applications.
`server` | WebLogic Server program files
`uninstall` | Code required to uninstall the BEA Products software