Skip navigation.
Downloads | Product Documentation | Support

Installing WebLogic Platform

# Installing WebLogic Platform Using Console-Mode Installation

The following sections describe how to install WebLogic Platform using console-mode installation:

- Before You Start
- Starting Console-Mode Installation on Windows Systems
- Starting Console-Mode Installation on UNIX Systems
- Running Console-Mode Installation
- What's Next?

# Before You Start

Before you start installing WebLogic Platform, please review the following information:

- Make sure that the hardware/software configuration on which you plan to install the product is supported by WebLogic Platform. A complete list of supported configurations can be found at `http://e-docs.bea.com/platform/suppconfigs/index.html`.
- Read Preparing to Install WebLogic Platform, specifically, the following sections:

- Installation Prerequisites
- Choosing a Type of Installation
- Selecting Directories for the WebLogic Platform Installation

Note: If you are installing WebLogic Platform on an operating system other than Windows, Solaris, or HP-UX, you may need to follow special installation instructions. Before launching the installation program, check "Installation Information" in Supported Configurations for WebLogic Platform 8.1 at `http://e-docs.bea.com/platform/suppconfigs/configs81/81_over/install_info.html`.

- If you plan to install the TIBCO Rendezvous Control and Event Generator subcomponent of WebLogic Integration 8.1, you must install and configure TIBCO Rendezvous on your machine before you install WebLogic Integration 8.1.

Note: Information about obtaining and installing a licensed copy of TIBCO Rendezvous is available at the following URL:

`http://www.tibco.com`

By simply following the installation instructions provided by TIBCO for this product, you can install TIBCO Rendezvous correctly so that it is ready to be used later with WebLogic Integration. For information about using the TIBCO Rendezvous Control and Event Generator, see the TIBCO Rendezvous Control and Event Generator User Guide at the following URL:

`http://e-docs.bea.com/wli/docs81/tibcorv/index.html`

- You cannot reinstall WebLogic Platform components on top of a previously installed version of the same component. You can, however, add components to an existing installation. For example, you can install WebLogic Server during one installation, and WebLogic Integration or WebLogic Portal during a separate installation. However, to reinstall the same version of one of the product components, you must first uninstall the component, as described in Uninstalling WebLogic Platform. Alternatively, you can install the new version in another location.

If you are adding components to an existing installation of WebLogic Platform, you should shut down any running servers before starting the installation.

- All WebLogic Platform components installed in a BEA product directory (for example, `/bea/weblogic81`) must be at the same version level. If you attempt to install additional components at a higher version than those that are already installed in that directory, the installation program prompts you to upgrade your existing components before you can proceed with the installation. For details on upgrading your installation, see Installing Service Packs and Rolling Patches.

# Starting Console-Mode Installation on Windows Systems

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

To start the installation in console mode on a Windows system:

1. Log in to the target Windows system.
2. Open an MS-DOS command prompt window.
3. If you are installing WebLogic Platform from CD-ROM, go to step 4. If you are installing WebLogic Platform from a Web download, complete the following procedure:

1. Download the software as described in WebLogic Platform Distribution Methods.
2. Go to the directory in which you downloaded the installation program.
3. Launch the installation by entering one of the following commands:

`net_platform` `XXX``_win32.exe -mode=console` (net installer)

`platform` `XXX``_win32.exe -mode=console` (WebLogic Platform package installer)

`server` `XXX``_win32.exe -mode=console` (WebLogic Server package installer)

In these filenames, `XXX` represents the version number of the software you are installing.

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:

`platform` `XXX``_win32 -mode=console -log=C:\logs\platform_install.log`

In this example, `XXX` represents the version number of the software you are installing. For more information, see Generating a Verbose Installation Log.

The installation program begins to install WebLogic Platform.

4. Proceed to Running Console-Mode Installation.

4. If installing WebLogic Platform from CD-ROM:

1. Insert the WebLogic Platform CD-ROM into the CD-ROM drive.
2. Open an MS-DOS command prompt window.
3. Go to the CD-ROM directory and navigate to the folder for the installation program for your platform.
4. Invoke the installation procedure by entering the following command:

`platform` `XXX``_win32.exe -mode=console` (package installer)

In this filename, `XXX` represents the version number of the software you are installing.

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:

`platform` `XXX``_win32.exe -mode=console -log=D:\logs\platform_install.log`

In this example, `XXX` represents the version number of the software you are installing. For more information, see Generating a Verbose Installation Log.

5. Proceed to Running Console-Mode Installation.

# Starting Console-Mode Installation on UNIX Systems

The WebLogic Platform installation program requires a Java run-time environment (JRE) to run. A JRE is bundled in the Windows installation program, and in some UNIX installation programs (those with filenames ending in `.bin`). For other UNIX platforms, the WebLogic Platform installation program does not include the JRE. Filenames for these installation programs end in `.jar`. To run the `.jar` installation programs, you must have an appropriate version of a Java 2 SDK installed on your system, and include the `bin` directory of the Java 2 SDK at the front of the `PATH` system variable.

Note: It is important that you use an SDK because the installation process sets the `JAVA_HOME` and related variables to point to this directory. All scripts installed with WebLogic Platform use this SDK by default, including scripts to start sample applications, the Configuration Wizard, and other WebLogic development tools.

## Starting Console-Mode Installation for .bin Installation Files

If you have an installation program for UNIX platforms with a filename that ends in `.bin`, complete the following steps to start the installation in console mode:

1. Log in to the target UNIX system.
2. If you are installing WebLogic Platform from CD-ROM, go to step 3. If you are installing WebLogic Platform from a Web download, complete the following procedure:

1. Download the software as described in Web Distribution.
2. Go to the directory where you downloaded the installation program.
3. Launch the installation by entering the following commands:

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

Here `filename``.bin` is the name of the WebLogic Platform installation program specific to your platform.

Filenames for the net installer are preceded by `net_`, for example, `net_platform` `XXX``_solaris.bin`, where `XXX` represents the version number of the software you are installing.

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:

`platform` `XXX``_solaris.bin -mode=console -log=/home/logs/platform_install.log`

In this example, `XXX` represents the version number of the software you are installing. For more information, see Generating a Verbose Installation Log.

4. Proceed to Running Console-Mode Installation.

3. If you are installing WebLogic Platform from CD-ROM:

1. Insert the WebLogic Platform CD-ROM into the CD-ROM drive.
2. Go to the CD-ROM directory and navigate to the folder for the installation program for your platform.
3. Launch the installation procedure by entering the following commands:

`chmod a+x` `filename``.bin`

`./``filename``.bin -mode=console`

Here, `filename``.bin` is the name of the WebLogic Platform installation program specific to your platform, for example `platform` `XXX``_solaris.bin`, where `XXX` represents the version number of the software you are installing.

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:

`./platform` `XXX``_solaris.bin -mode=console -log=/home/logs/platform_install.log`

For more information, see Generating a Verbose Installation Log.

4. Proceed to Running Console-Mode Installation.

## Starting Console-Mode Installation for .jar Installation Files

Note: If you are installing WebLogic Platform on an operating system other than Windows, Solaris, or HP-UX, you may need to follow special installation instructions. Before launching the installation program, check "Installation Information" in Supported Configurations for WebLogic Platform 8.1 at `http://e-docs.bea.com/platform/suppconfigs/configs81/81_over/install_info.html`.

If you have an installation program for UNIX platforms with a filename that ends in `.jar`, follow these steps to start the installation in console mode:

1. Log in to the target UNIX system.
2. Add the `bin` directory of the appropriate SDK to the beginning of the `PATH` variable definition on the target system. For example:

`PATH=``JAVA_HOME``/bin:$PATH
export PATH`

Here `JAVA_HOME` represents the full path to the SDK directory.

3. Do one of the following:

- Download the software as described in Web Distribution.
- If you are installing from CD-ROM, insert the WebLogic Platform CD-ROM into the CD-ROM drive and go to the CD-ROM directory.

Note: To ensure that the hardware/software configuration on which you are installing the product is supported by WebLogic Platform, see WebLogic Platform Supported Configurations at `http://e-docs.bea.com/platform/suppconfigs/index.html`.

4. Go to the directory that contains the installation file and invoke the installation procedure by entering the following command:

`java -jar` `filename``.jar -mode=console`

Here, `filename``.jar` is the name of the WebLogic Platform installation file, for example `pj_platform` `XXX``_generic.jar`. Filenames for the net installer are preceded by `net_`, for example, `net_pj_platform` `XXX``_generic.jar`. In these filenames, `XXX` represents the version number of the software you are installing.

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:

`java -jar` `pj_platform` `XXX``_generic.jar``` `-mode=console
-log=/home/logs/platform_install.log`

For more information, see Generating a Verbose Installation Log.

5. Proceed to Running Console-Mode Installation.

# Running Console-Mode Installation

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: The sample console text and directory pathnames in this section use Windows conventions (backslashes) for pathnames, for example `C:\bea\weblogic81`. When entering pathnames on a UNIX system, use the UNIX convention (forward slashes) in pathnames, for example, `/home1/bea/weblogic81`.

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 the previous sections.

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 BEA products installed on the target system. For details about the BEA Home directory, see Choosing a BEA Home Directory.

The installation program displays the following prompt:

>     Choose BEA Home Directory:
>     --------------------------
>        *BEA home choice

>       1¦Create a new BEA Home [C:\bea]
>     ->2¦Use an existing BEA Home [D:\beahome1]

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

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.

Do one of the following:

- To use an existing BEA Home directory, type `2` or `next` (or `n` for short), or press Enter. If you have more than one BEA Home directory on your system, an additional prompt will display the directories. Type the number associated with the desired BEA Home directory.
- To create a new BEA Home directory, type `1`, then at the prompt, 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.

Whether you accept the existing BEA Home directory or choose to create a new BEA Home directory, you are prompted to confirm your selection, as shown in the following sample:

>     Choose BEA Home Directory:
>     --------------------------

>         *BEA home choice

>      ->1¦Yes, Use this BEA home directory [C:\bea]
>        2¦No, return to BEA home directory selection

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

On the command line, type `1` or press Enter to accept your selection. Otherwise, type `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, 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 complete BEA WebLogic Platform.

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

If you are using the net installer (filename preceded by `net_`), the Specify Download Options prompt is displayed. Go to step 6.

If you are installing from CD-ROM or using the package installer, the Choose Product Directory prompt is displayed. Go to step 7.

- Type `2` to choose a Custom installation. The Choose Components prompt is displayed.

For more information about typical and custom installations, see Choosing a Type of Installation.

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

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

>         Release 8.1.x.0
>         +----WebLogic Server [1] v
>         ¦    +----Server [1.1] v
>         ¦    +----Server Examples [1.2] v
>         +----WebLogic Workshop [2] v
>         ¦    +----Workshop Runtime Framework [2.1] v
>         ¦    +----WebLogic Workshop Application Developer Edition [2.2] v
>         ¦    +----Workshop Samples [2.3] v
>         +----WebLogic Integration [3] v
>         ¦    +----Integration Server [3.1] v
>         ¦    +----WebLogic Workshop Integration Extension [3.2] v
>         ¦    +----Integration Examples [3.3] v
>         ¦    +----BPEL Import and Export Tools [3.4]
>         ¦    +----TIBCO Rendezvous(TM) Control and Event Generator [3.5]
>         +----WebLogic Portal [4] v
>         ¦    +----Portal Server [4.1] v
>         ¦    +----WebLogic Workshop Portal Extension [4.2] v
>         ¦    +----Portal Examples [4.3] v
>         +----Platform Samples and Utilities [5] v
>              +----Platform Tour [5.1] v

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

Note: If you are using the WebLogic Server installer, only the WebLogic Server and WebLogic Workshop components are displayed.

Selected components are installed by default, as indicated by a symbol at the end of each line: an `x` on UNIX systems or check mark on Windows systems. If a component, such as the `BPEL Import and Export Tools`, is not selected, then it will not be installed on your system. To select a component to be installed, type the numeric code for the component on the command line. To deselect a component, type the numeric code for the component on the command line exactly as it appears within the brackets. For example, if you do not want to install the Server Examples for WebLogic Server, type `1.2` on the command line.

Note: 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). You are prompted to confirm your selection. On the command line, type `1` or press Enter to accept your selection. Otherwise, type `2` to return to the Choose Components panel where you can modify your selections.

Note: When you select or deselect components to install, the installation program checks for dependencies between components and automatically modifies the list of selected components. For example, if you deselect the WebLogic Server component, the remaining components are also deselected, since they require the WebLogic Server to run.

If you are using the package installer, the Choose Product Directory prompt is displayed. Go to step 7.

If you are using the net installer (installation program filenames beginning with `net_`), the Specify Download Options prompt is displayed.

6. Indicate your preferences for downloading the software. The installation program prompts you to select one of the following options:

>     SPECIFY DOWNLOAD OPTIONS

>     1- Modify Storage directory (c:\tmp)
>     2- Modify Remove download files after installation (No)
>     3- Modify Proxy Host (none)
>     4- Modify Proxy Port (none)
>     5- Modify Username (none)
>     6- Modify Password (none)

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

Note: If you have previously installed WebLogic Platform and specified a storage directory during the installation process, the full pathname for that directory is displayed as the default. If you have not specified a storage directory, the installer specifies the system's temporary directory as the default. Make sure that your temporary directory has sufficient space to accommodate the archive files and the installation program. For more information about temporary space required by the installation program, see Temporary Disk Space Requirements.

To accept the defaults, type `next` (or `n` for short) or press Enter. If you have not specified a download storage directory in a previous installation and you want to save the files to be downloaded, you need to specify a directory before you can proceed with the installation.

To modify any of the options, do the following:

- Type `1` to specify a storage directory to which you want to download the software components. When prompted, type the full pathname for the desired directory. If the directory does not exist, the installation program creates it for you.
- Type `2` if you want the downloaded files deleted after the installation is complete. If you do so, the download options are displayed again, and the `Modify Remove download files after installation` option is set to `Yes`. If you accept the default for this option `(No)`, the downloaded files are saved in the storage directory you specified.
- Indicate whether you want to use an HTTP Proxy server for the download by providing values for the Modify Host and Modify Port options as follows:

Type `3` to specify a host. At the prompt, enter the name or IP address of the proxy server.

Type `4` to specify a port. At the prompt, enter the port number of the proxy server.

- Specify the username and password required by the HTTP Proxy server, if required, as follows:

Type `5` to specify a username. At the prompt, enter a valid username for the proxy server.

Type `6` to specify a password. At the prompt, enter a valid password for the user.

For additional information about downloading the software, see Web Distribution.

After you indicate your preferences, the files begin downloading to the specified storage directory. When the download is complete, the installation program verifies that the component archive files downloaded successfully. If the installation program cannot verify the integrity of the download, the following message is displayed:

>     The required installation files could not be verified.You
>     may download them from BEA or select different components.

When the verification is complete, the Choose Product Directory prompt is displayed.

7. Specify the directory in which you want to install the WebLogic Platform software. Select the default product directory (`bea_home``\weblogic81`) or create a new product directory.

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

The choices displayed in this section are as follows:

>     Choose Product Directory:
>     -------------------------
>         Product Installation Directory= [C:\bea\weblogic81]

>     Input new 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 WebLogic Platform 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:\bea\weblogic81]
>          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.

8. If you are installing on a Windows platform, you have not previously installed a Node Manager as a Windows service, and you are performing a custom installation, the Install Node Manager as a Windows Service panel is displayed. The Node Manager is used to monitor, start, and stop the managed servers in a domain.

The following text is displayed:

>     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]>

Enter `1` or press Enter to install the Node Manager as a Windows Service. See Installing the Node Manager as a Windows Service for more information. Enter `2` if you do not want to install the Node Manager as a Windows service.

At this point, the installation program installs the files to the directory you specified.

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. Press Enter or type `Exit` to exit the installation program.

# What's Next?

You can start using the product immediately after installing it for the first time because, by default, WebLogic Platform uses the development license that is installed in BEA Home directory. We recommend that you use the QuickStart application to familiarize yourself with the software, take the WebLogic Platform Tour (if you installed the complete WebLogic Platform), and execute the samples provided. For additional information, see Performing Post-Installation Tasks.

Note: QuickStart is not invoked automatically for console or silent-mode installations. You can launch QuickStart from the Start Menu (Windows), or from the command line (Windows and UNIX.) For instructions, see Using QuickStart.

For specific information about Release 8.1 of WebLogic Platform and WebLogic Server, see the appropriate release notes:

- BEA WebLogic Platform Release Notes at `http://e-docs.bea.com/platform/docs81/relnotes/index.html`
- BEA WebLogic Server and WebLogic ExpressTM Release Notes at `http://e-docs.bea.com/wls/docs81/notes/index.html`