# Installation Guide

# Running the Installation Program in Console Mode

The following sections describe how to run the installation program in console mode:

- Running Console-Mode Installation
- What's Next?

## Running Console-Mode Installation

Start the installation program in console mode as described in Starting the Installation Program.

To complete the console-mode installation process, respond to the prompts in each section by entering the number associated with your choice or by pressing Enter to accept the default. To exit the installation process, enter `exit` (or `x`, for short) in response to any prompt. To review or change your selection, enter `previous` (or `p`, for short) at the prompt. To proceed to the following window, enter next (or `n`, for short).

Note: | In the sample console text and directory pathnames provided in this section, Windows conventions (such as backslashes in pathnames) are used, for example, `C:\bea\realtime10`. When entering pathnames on a Linux system, be sure to use UNIX conventions, instead. For example, use forward slashes in pathnames, such as `/home/bea/realtime10`.

The following procedure steps you through the installation program. Use this procedure after you have started the installation program in console mode, as described in Starting the Installation Program.

1. At the `Welcome` prompt, type `next` (or `n` for short) or press Enter to continue with the installation process.

The BEA Systems License Agreement prompt is displayed.

2. Read the Agreement and indicate your acceptance or rejection of its terms by doing one of the following at the prompt:

- Type `1` to indicate your agreement with the terms of the license and proceed with the installation. To review the entire agreement, press Enter or type `Down` several times. Type `Up` to scroll back through sections previously displayed.
- Type `2` if you do not agree with the terms of the license. If you type `2`, the installation process terminates.

The `Choose BEA Home directory` prompt is displayed.

3. Specify the BEA Home directory that will serve as the central support directory for all WebLogic Real Time software installed on the target system. For details about the BEA Home directory, see Choosing a BEA Home Directory.

One of the following is displayed on your system:

- If you have existing BEA Home directories on your system, a list of the directories is displayed, as shown in the following example:

`Choose BEA Home Directory:
--------------------------
->1¦* Create a new BEA Home
2¦C:\bea
3¦C:\bea_prod
4¦C:\bea_qa
Enter index number to select OR [Exit][Previous][Next]>`

To use an existing BEA Home directory, type the number associated with the desired BEA Home directory.

To create a new BEA Home directory, type `1` or press Enter.

- If there are no BEA Home directories on your system, or you have selected to create a new BEA Home, the installation program displays the following prompt:

`Choose BEA Home Directory:
--------------------------
"BEA Home" = [Use default "C:\bea
Input BEA Home OR [Exit][Previous][Next]>`

Do one of the following:

- To use the default BEA Home directory, type `next` (or `n` for short), or press Enter.
- To create a new BEA Home directory, enter the full path of the BEA Home directory, for example `C:\beahome2`. If you specify a directory that does not exist, the installation program creates it for you.

The installation program displays the BEA Home directory you have specified, as shown in the following example:

`Choose BEA Home Directory:
--------------------------
"BEA Home" = [C:\beahome2]
Select Option:
1 - Input BEA Home
2 - Use default [C:\bea]
Enter option number to select OR [Exit][Previous][Next]>`

On the command line, press Enter to accept your selection. Otherwise, type `1` or 2 to return to the Choose BEA Home Directory panel, where you can modify your entry.

After you have selected your BEA Home directory and confirmed your selection, type `Next` or press Enter. One of the following occurs:

- If you are adding components to an existing installation, the `Choose Components to install` panel is displayed. Go to step 5.
- If you are performing an initial installation, the `Choose Install Type` prompt is displayed.

4. Specify the type of installation you want to perform by entering the number associated with the install type, as shown in the following text:

    Choose Install Type:
    --------------------

     ->1|Complete
        |Install the following software components and examples: WebLogic
         Real Time  WebLogic Server

       2|Custom Installation
        |Choose software components to install and perform optional
         configuration.

    Enter index number to select OR [Exit][Previous][Next]>

Do one of the following:

- Type `1` or press Enter to choose a Complete installation. Proceed to step 6.
- Type `2` to choose a Custom installation. The `Choose Components to install` prompt is displayed.

For more information about complete and custom installations, see Choosing the Type of Installation.

5. Select the components you want to install. The available components are displayed as follows:

    Choose Components to install:
    -----------------------------

        Release x.x.x.x
        +----WebLogic Real Time [1] v
        |    +----WebLogic Real Time [1.1] v
        +----WebLogic Server [1] v
        |    +----Server [1.1] v
        |    +----Server Examples [1.2] v
        |    +----Web Server Plug-Ins [1.3]

    Enter number exactly as it appears in brackets to toggle selection OR
    [Exit][Previous][Next]>

In an initial installation, only the Web Server Plug-ins are not selected; all other components are selected by default as indicated by the `x` (Linux systems) or check mark (Windows systems) at the end of each line. Selected components will be installed on your system. If, however, you want Web Server Plug-ins installed on your system, you must manually enter the appropriate numeric code for them. To deselect a component, type the numeric code for it on the command line, exactly as it appears within the brackets. For example, if you do not want to install the Server Examples, type `1.2` on the command line.

The word `Installed` is shown in brackets for any components you have already installed on your system.

When you are finished selecting components, press Enter or type `next` (or `n` for short).

WARNING: | You can clear the "WebLogic Real Time" component and proceed with only "WebLogic Server" selected. However, selecting only "WebLogic Server" will result in the installation of WebLogic Server with JRockit, but without the WebLogic Real Time sample scripts. If this occurs, run the Uninstall program and manually remove the remaining WebLogic Real Time files. Then repeat the installation procedure, making sure that "WebLogic Real Time" is selected.

The `Optional Tools` prompt is displayed.

6. Specify whether you want to install the Mercury profiling tools, as shown in the following display:

    Optional Tools

    Do you want to install Mercury profiling tools (development
    environment only)?

        1 - Yes, install Mercury profiling tools.
        2 - No, do not install.

    Enter a number or [Exit][Previous][Next]>

Note: | This panel is displayed only on platforms that support BEA JRockit.

Do one of the following:

- Type `1` if you want to install the Mercury profiling tools. In the next panel you are prompted to read and accept the Mercury Tools license agreement.
- Type `2` if you do not want to install the Mercury profiling tools. The `Choose Product Directory` prompt is displayed. Proceed to step 8.

Note: | For more information about the Mercury profiling tools, see WebLogic Real Time.

7. Read the License Agreement and indicate your acceptance or rejection of its terms. To review the entire agreement, press Enter or type `Down` several times. Type `Up` to scroll back through sections previously displayed. Do one of the following:

- If you agree with the terms of the license agreement, type `1` at the prompt to proceed with the installation. The `Choose Product Directory` prompt is displayed.
- If you do not agree with the terms of the license, you can either type `p` (for previous) to return to the Optional Tools panel where you can choose not to install the Mercury profiling tools, or you can type `2`. If you type `2`, the installation process terminates.

8. Specify the directory in which you want to install the software. You can accept the default product directory (`bea_home``\realtime10`) or create a new product directory.

Note: | If you are adding components to an existing installation, you are prompted to confirm the product installation directory.

If you specify a new directory, the installation program automatically creates it for you.

The following example shows the choices displayed in this section:

    Choose Product Directory:
    -------------------------
    Product Installation Directory= [Use default C:\beahome2\realtime10]

    Input Product Installation Directory OR [Exit][Previous][Next]>

Do one of the following:

- Press Enter or type `next` (or `n` for short) to accept the current selection.
- Enter the full path to the directory in which you want to install the software, and press Enter.

You are prompted to confirm your selection as shown in the following text:

    Choose Product Directory:
    -------------------------
       ->1| Yes, use this product directory [C:\beahome2\realtime10]
         2| No, select another product directory

    Enter index number to select OR [Exit][Previous][Next]>

Verify that your entry is correct, then type `1` or press Enter to proceed with the installation. Otherwise, type `2` to return to the `Choose Product Directory` panel, where you can modify your entry.

One of the following occurs:

- If you are performing an initial, custom installation on a Windows platform, and you have Administrator privileges, the Install Node Manager as a Windows Service panel is displayed. Proceed to step 9.

Node Manager is used to monitor, start, and stop server instances in a domain. See About Installing Node Manager as a Windows Service for more information.

- If you are performing a complete installation on a Windows platform, you are installing on a Windows platform and you do not have Administrator privileges, you are installing on a UNIX platform, or you are adding components to an existing installation, the installation program begins copying the components you specified to your system. Proceed to step 11.

Note: | It is normal for the installation program to pause for a fairly long time, especially toward the end. The installation program is still working when this occurs.

9. Specify whether you want to install Node Manager as a Windows service, as shown in the following text:

    Install Node Manager as a Windows Service

        1 - Yes, install now.
        2 - No, do not install now. See product documentation for
            post-install registration of Node Manager as a Windows
            Service.

    Enter a number or [Exit][Previous][Next]>

Do one of the following:

- Enter `1` to install Node Manager as a Windows Service. Then, at the prompt, enter the Node Manager Listen Port, or press Enter to accept the default (5556). If the Listen Port number you specify is currently being used by a running application, the installation program prompts you to enter a different Node Manager Listen Port number. You are prompted to confirm your selection.
- Enter `2` if you do not want to install Node Manager as a Windows service.

The `Choose Shortcut Location` prompt is displayed.

10. Specify the folder in which you want to create the Start menu shortcuts. Select the All Users folder or the local user's folder, as shown in the following sample text:

    Choose Shortcut Location:
    -------------------------
    *The installer creates shortcuts to BEA components, samples, and tools.
    *As a user with administrative privileges, you can specify where these
    *shortcuts are created.

     ->1¦"All Users" Start menu folder> (recommended)
        ¦If a user without administrative privileges uses the BEA
        ¦Configuration Wizard in this installation to create domains, the user
        ¦may have to create Start menu shortcuts manually. Refer to the
        ¦documentation for more information.

       2¦Local user's Start Menu folder
        ¦Select this option if you need to ensure that other profiles
        ¦registered on this machine will not have access to these shortcuts.

    Enter index number to select OR [Exit][Previous][Next]>

Do one of the following:

- Type `1` or press Enter to create Start menu shortcuts in the All Users folder. This provides all users registered on the machine with access to the installed software. However, only users with Administrator privileges can create shortcuts in the All Users folder. Therefore, if a user without Administrator privileges uses the Configuration Wizard to create domains, Start menu shortcuts to the domains are not created. In this case, users can manually create shortcuts in their local Start menu folders, if desired.
- Type 2 to create shortcuts in your local user's Start menu folder. If you do so, other users registered on this machine will not have access to the Start menu entries for this installation.

You are prompted to confirm your selection, as shown in the following text:

    Choose Shortcut Location:
    -------------------------
    *The installer creates shortcuts to BEA components, samples, and tools.
    *As a user with administrative privileges, you can specify where these
    *shortcuts are created.

     ->1¦"All Users" Start menu folder> (recommended)
        ¦If a user without administrative privileges uses the BEA
        ¦Configuration Wizard in this installation to create domains, the
        ¦user may have to create Start menu shortcuts manually. Refer to
        ¦the documentation for more information.

       2¦Go back to the previous screen and make another choice.

    Enter index number to select OR [Exit][Previous][Next]>

Verify that your entry is correct, then type `1` or press Enter to proceed with the installation. Otherwise, type `2` to return to the previous panel, where you can modify your entry.

After you have verified your selection, the installation program begins copying the components you specified to your system.

Note: | It is normal for the installation program to pause for a fairly long time, especially toward the end. The installation program is still working when this occurs.

When the installation is complete, the Installation Complete panel is displayed.

11. Press Enter or type `Exit` to exit the installation program.

## What's Next?

By default, WebLogic Platform uses the development license file installed in the BEA Home directory so that you can start using the product immediately. However for WebLogic Real Time 1.0, access to the BEA JRockit 5.0 Deterministic Garbage Collection option requires an additional evaluation or production license key to replace the empty license.bea file in the BEA_HOME/jrockit-realtime1.0_XXX/jre/ directory. For instructions on updating the BEA JRockit license file, see Updating Your BEA JRockit License for the Deterministic Garbage Collector.

The Spring 1.2.6 Framework for BEA is fully supported with WebLogic Platform 1.0 and can be downloaded from the WebLogic Platform Product download page. Spring 1.2.6 is also distributed with the WebLogic Platform CD-ROM kit when the media is ordered. For more information about Spring and WebLogic Real Time, see Introduction to WebLogic Real Time at`http://download.oracle.com/docs/cd/E13221_01/wlrt/docs10/wlrt_intro/understa.html`.

For additional post-installation information, such as using the Configuration Wizard to create a WebLogic Real Time domain, see Post-Installation Information.

For specific information about your software release, see the appropriate release notes:

- The features and capabilities of WebLogic Real Time, see Introduction to WebLogic Real Time at`http://download.oracle.com/docs/cd/E13221_01/wlrt/docs10/wlrt_intro/index.html`
- The features and capabilities of WebLogic Server, see Introduction to WebLogic Server and WebLogic Express at`http://download.oracle.com/docs/cd/E13222_01/wls/docs91/intro/index.html`
- The features and capabilities of BEA JRockit, see Introduction to JRockit JDK at `http://download.oracle.com/docs/cd/E13188_01/jrockit/geninfo/genintro/index.html`
- Operating systems and hardware supported by your software, see "WebLogic Real Time 1.0 Supported Configurations" at `http://download.oracle.com/docs/cd/E13221_01/wlrt/docs10/intro_wlrt/intro.html#wlrt_supported_configs`