# Installation Guide

# Installing the Software

This section covers the following topics:

- Before You Start
- Starting the Installation Program on Windows Platforms
- Starting the Installation Program on Linux Platforms
- Starting the Installation Program in Silent Mode
- What's Next?

## Before You Start

Before you start installing the software, please review the following information:

- Make sure that you are installing your software on a hardware/software configuration that is supported by your BEA Products software. See the BEA Products Supported Configurations documentation.
- Read Preparing for the Installation.

Note: | You cannot reinstall any BEA product on top of a previously installed version of the same product—in the same BEA Home directory or in the same file location. You can, however, add products and product components to an existing installation. For example, you can install WebLogic Server during one installation, and WLS-VE during a separate installation. However, to reinstall the same version of one of the products, you must first uninstall the previous installation, as described in Uninstalling the Software.

### Specifying WLS-VE Directory Locations

The GUI and console-based installation program for Windows and Linux will prompt you to specify the following three directory locations. Before proceeding, you should review the documentation for these locations.

- The BEA Home directory. See The BEA Home Directory.
- The product installation directory. See The WLS-VE Product Installation Directory.
- The ISO image installation directory. See The Installation Directory for the WLS-VE ISO Image.

### Specifying Optional Startup Settings

The following sections describe optional settings you can use when starting the WLS-VE installation program:

- Generating a Verbose Installation Log
- Specifying Temporary Disk Space

#### Generating a Verbose Installation Log

If you launch the installation from the command line or from a script, you can specify the `-log` option to generate a verbose installation log. The installation log stores messages about events that occur during the installation process, including informational, warning, error, and fatal messages.

Note: | You may see some warning messages in the installation log. However, unless a fatal error occurs, the installation program completes the installation successfully. The installation user interface indicates the success or failure of each installation attempt, and the installation log file includes an entry indicating that the installation was successful.

##### Syntax

To create a verbose log file during installation, include the `-log=``full_path_to_log_file` option in the command line. For example:

    server922ve11_win32.exe -log=C:\logs\server_install.log

The path must specify a file. You cannot create a folder simply by including a name for it in a pathname; your path should specify only existing folders. If your path includes a nonexistent folder when you execute the command, the installation program does not create the log file.

#### Specifying Temporary Disk Space

The BEA installation program uses a temporary directory into which it extracts the files necessary to install the software on the target system. During the installation process, your temporary directory must contain sufficient space to accommodate the compressed Java run-time environment (JRE) bundled with the installation program and an uncompressed copy of the JRE that is expanded into the temporary directory. The extracted files are deleted from the temporary directory at the end of the installation process.

By default, the installation program uses the following temporary directories:

- Windows platforms—directory referenced by the `TMP` system variable
- Linux platforms—system-dependent temporary directory

Note: | If you do not have enough temporary space to run the installation program, you are prompted to specify an alternate directory or exit the installation program.

To make sure that you have adequate temporary space, you may want to allocate an alternate directory for this purpose. To do so, follow the instructions provided in the following table.

Table 2-1 Setting Up Disk Space
On this platform . . . | Perform this step . . .
--- | ---
Windows | Do one of the following: Set the `TMP` system variable to a directory of your choice. If starting the installation program from the command line, include the `-Djava.io.tmpdir=``tmpdirpath` option, replacing `tmpdirpath` with the full path of the directory that you want to designate as a temporary storage area for the BEA Products installation program. For example: `server922ve11_win32.exe -mode=console -Djava.io.tmpdir=D:\Temp`
Linux | Enter the following option on the command line when you start the installation program: `-Djava.io.tmpdir=``tmpdirpath` Here, `tmpdirpath` is the full path of the directory that you want to designate as a temporary storage area for the BEA Products installation program.

## Starting the Installation Program on Windows Platforms

The following sections describe how to start the installation program on a Windows platform:

- Starting in Graphical Mode
- Starting in Console Mode

See Starting the Installation Program in Silent Mode for information about using the installation program in silent mode.

Note: | If you are installing the software on a Windows system that supports more than one monitor, you must disable all but one monitor before starting the installation program.

### Starting in Graphical Mode

Graphical-mode installation is an interactive, GUI-based method for installing your software. To start the graphical-mode installation process on a Windows platform, follow these steps:

1. Log into the Windows system.
2. From the directory where you have downloaded the installation program, double-click the installation file:

    server922ve11_win32.exe

The installation program begins to install the software.

3. After agreeing to the terms of the license agreement, the installation program prompts you to specify three directory locations for WLS-VE, as explained in Specifying WLS-VE Directory Locations.
4. Select the Windows shortcut entries. See The WLS-VE Windows Shortcuts.
5. Click Done to exit the installation program.
6. Perform post-installation steps, such as copying the ISO image to the ESX server, as described in Post-Installation Information.

### Starting in Console Mode

Console-mode installation is an interactive, text-based method for installing your software from the command line. To start the console-mode installation process on a Windows platform, follow these steps:

1. Log in to the target Windows system.
2. From the directory where you have downloaded the installation program, launch the installation by entering the following command:

    server922ve11_win32.exe -mode=console

Note: | You can also include the `-log=``full_path_to_log_file` option in the command line to create a verbose installation log. For example:

Note: | `server922ve11_win32.exe -mode=console -log=C:\logs\server_install.log`

Note: | For more information, see Generating a Verbose Installation Log.

After a few moments, a BEA Installer window opens and the installation program begins to install the software. 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.

3. After agreeing to the terms of the license agreement, the installation program prompts you to specify three directory locations for WLS-VE, as explained in Specifying WLS-VE Directory Locations.
4. Select the Windows shortcut entries. See The WLS-VE Windows Shortcuts.
5. Click Done to exit the installation program.
6. Perform post-installation steps, such as copying the ISO image to the ESX server, as described in Post-Installation Information.

## Starting the Installation Program on Linux Platforms

The following sections describe how to start the WLS-VE installation program on Linux platforms:

- Starting in Graphical-Mode
- Starting in Console-Mode

See Starting the Installation Program in Silent Mode for information about using the installation program in silent mode.

Note: | The WLS-VE installation program bundles its own JRE.

### Starting in Graphical-Mode

Graphical-mode installation is an interactive, GUI-based method for installing your software. To run graphical-mode installation, your console must support a Java-based GUI such as X-Windows and 8-bit color depth (256 colors).

If the installation program determines that your system cannot support graphical-mode installation, it automatically starts running in console mode. For details, see Starting in Console-Mode

To start the graphical-mode installation process, follow these steps:

1. Log in to the target Linux system.
2. Launch the installation by entering the following commands:

`chmod a+x server922ve11_linux32.bin
./server922ve11_linux32.bin`

Note: | You can also include the `-log=``full_path_to_log_file` option in the command line to create a verbose installation log. For example:

Note: | `server922ve11_linux32.bin -log=/home/logs/BEA_install.log`

Note: | For more information, see Generating a Verbose Installation Log.

The installation program begins to install the software.

3. After agreeing to the terms of the license agreement, the installation program prompts you to specify directory locations for the software, as explained in Specifying WLS-VE Directory Locations.
4. Click Done to exit the installation program.
5. Perform post-installation steps, such as copying the ISO image to the ESX server, as described in Post-Installation Information.

### Starting in Console-Mode

Console-mode installation is an interactive, text-based method for installing your software from the command line. To start the console-mode installation process, follow these steps:

1. Log in to the target Linux system.
2. Launch the installation by entering the following command:

`chmod a+x server922ve11_linux32.bin
./server922ve11_linux32.bin -mode=console`

Note: | You can also include the `-log=``full_path_to_log_file` option in the command line to create a verbose installation log. For example:

Note: | `server922ve11_linux32.bin -mode=console -log=/home/logs/BEA_install.log`

Note: | For more information, see Generating a Verbose Installation Log.

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.

3. After agreeing to the terms of the license agreement, the installation program prompts you to specify directory locations for the software, as explained in Specifying WLS-VE Directory Locations.
4. Click Done to exit the installation program.
5. Perform post-installation steps, such as copying the ISO image to the ESX server, as described in Post-Installation Information.

## Starting the Installation Program in Silent Mode

On either Linux or Windows, you can run the installation program in silent mode. During installation in silent mode, the installation program reads the settings for your configuration from an XML file that you create prior to beginning the installation. Silent mode eliminates the need to respond to prompts from the installation program. The installation program does not display any configuration options during the installation process. Silent-mode installation works on both Windows and UNIX systems. Using silent-mode installation implies that you consent to the BEA License Agreement. You neither see a copy of the BEA Software License Agreement nor have any means of accepting the terms of the agreement.

To run the installation program in silent mode:

1. Create a `silent.xml` file that defines the configuration settings required for the installation program. See Creating the silent.xml File.
2. Launch the installation program with this command on Windows:

    server922ve11_win32.exe -mode=silent -silent_xml=path_to_silent.xml

Or this command on Linux:

`chmod a+x server922ve11_linux32.bin
./server922ve11_linux32.bin -mode=silent -silent_xml=``path_to_silent.xml`

Here, `path_to_silent.xml` is the full pathname of the `silent.xml` file.

3. Configure WLS-VE, as described in Configuration Overview and Roadmap in WLS-VE Configuration and User Guide.

For more detailed information about silent mode installation, see Running the Installation Program in Silent Mode in the WebLogic Installation Guide.

#### Creating the silent.xml File

Your `silent.xml` file needs to define the configuration settings required for the installation program. The required information is included in a set of data-value elements in the `silent.xml` file, for example:

    <data-value name="BEAHOME" value="c:\bea">

The required settings are described in Table 2-2. For a sample `silent.xml` file, see Listing 2-1.

Table 2-2 Data-value Settings in silent.xml
data-value name Attribute | Description
--- | ---
`BEAHOME` | The BEA Home directory. See The BEA Home Directory.
`USER_INSTALL_DIR` | The product installation directory. See The WLS-VE Product Installation Directory.
`ISO_DIR` | The ISO image installation directory. See The Installation Directory for the WLS-VE ISO Image.

Listing 2-1 Sample silent.xml File for Silent Mode Installation

    <bea-installer>
      <input-fields>
        <data-value name="BEAHOME" value="c:\bea" />
        <data-value name="USER_INSTALL_DIR" value="c:\bea\weblogic92" />
        <data-value name="ISO_DIR" value="c:\wlsve_iso" />
      </input-fields>
    </bea-installer>

## What's Next?

Refer to Post-Installation Information, for information about post-installation steps, such as copying the ISO image to the ESX server and updating the license file, if appropriate.