Skip navigation.
Downloads | Product Documentation | Support

Installing WebLogic Platform

# Installing WebLogic Platform Using Graphical-Mode Installation

The following sections describe how to install WebLogic Platform using a graphical user interface:

- Before You Start
- Starting the Installation Program in Graphical Mode on Windows Platforms
- Starting the Installation Program in Graphical Mode on UNIX Platforms
- Running the Installation Program
- 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 separate installations. 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 the Installation Program in Graphical Mode on Windows Platforms

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 graphical mode on a Windows system:

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

1. Download the software as described in WebLogic Platform Distribution Methods.
2. Go to the directory where you downloaded the installation program and double-click the installation file:

`net_platform` `XXX``_win32.exe` (net installer)

`platform` `XXX``_win32.exe` (WebLogic Platform package installer)

`server` `XXX``_win32.exe` (WebLogic Server package installer)

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

The installation program begins to install WebLogic Platform.

Proceed to Running the Installation Program.

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

1. Insert the WebLogic Platform CD-ROM into the CD-ROM drive.
2. If the installation program does not start automatically, open Windows Explorer and double-click the CD-ROM icon.
3. Navigate to the folder for the Windows installation and double-click the installation file for your platform:

`platform` `XXX``_win32.exe` (package installer)

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

The installation program begins to install WebLogic Platform.

4. Proceed to Running the Installation Program.

# Starting the Installation Program in Graphical Mode on UNIX Platforms

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 a 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 beginning of your `PATH` system variable.

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

To run graphical-mode installation, your console must support a Java-based GUI. If the installation program determines that your system cannot support a Java-based GUI, it automatically starts running in console-mode. For details, see Installing WebLogic Platform Using Console-Mode Installation.

## Starting Graphical-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 graphical 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 from a Web download, complete the following procedure:

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

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

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:

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

For more information, see Generating a Verbose Installation Log.

The installation program begins to install WebLogic Platform.

4. Proceed to Running the Installation Program.

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

1. Insert the WebLogic Platform CD-ROM into the CD-ROM drive and go to the CD-ROM directory.
2. Navigate to the folder that contains the installation program for your platform.
3. Invoke the installation procedure by entering the following command:

`./``filename``.bin`

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:

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

For more information, see Generating a Verbose Installation Log.

4. Proceed to Running the Installation Program.

## Starting Graphical-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 graphical 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: On the CD-ROM, the installation file is located in the `weblogic_platform` `XXX` directory, where `XXX` represents the version number of the software you are installing.

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

`java -jar` `filename``.jar`

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

5. Proceed to Running the Installation Program.

# Running the Installation Program

The installation program prompts you to enter specific information about your system and configuration. For instructions on responding to the prompts during installation, see the following table.

In this window . . . | Perform the following action . . .
--- | ---
Welcome | Click Next to proceed with the installation. You may cancel the installation at any time by clicking Exit.
BEA License Agreement | Read the BEA Software License Agreement and indicate your acceptance of the terms of the agreement by selecting Yes. To continue with the installation, you must accept the terms of the license agreement and then click Next.
Choose BEA Home Directory | Specify the BEA Home directory that will serve as the central support directory for all BEA products installed on the target system. If you already have a BEA Home directory on your system, you can select that directory (recommended) or create a new BEA Home directory. If you choose to create a new directory, the WebLogic Platform installation program automatically creates the directory for you. For details about the BEA Home directory, see Choosing a BEA Home Directory.
Choose Install Type | Select the option button for the type of installation you want to perform: Complete—all the software components provided with WebLogic Platform or WebLogic Server, including sample files, are installed on your system. Sample domains are preconfigured for use with the PointBase database during installation allowing you to execute the samples when the installation is complete. Custom—you select software components to be installed. On Windows systems, you also have a choice between installing the WebLogic Platform Node Manager as a Windows service, and not doing so. For additional information about the installation types, see Choosing a Type of Installation.
Choose Components Note: This window is displayed only if you selected Custom installation in the Choose Install Type window. | Specify the components to be installed by selecting or clearing the appropriate check boxes. This window displays a tree-view of all the components available for installation. In an initial installation, all components are selected. When you select or clear a component at the folder level, all subcomponents are selected or cleared accordingly. If any components are already installed on your system, the check boxes for them are grayed out. 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 accordingly. For example, if you clear the WebLogic Server component check box, the boxes for the remaining components are cleared because those components cannot be run without WebLogic Server. For details about the components available for installation on your system, see WebLogic Platform Software Components.
Specify Download Options Note: This window is displayed only if you are using the net installer. | Indicate your preferences for downloading the software as follows: Storage Directory—specify a storage directory to which you want to download the software components. The installation program downloads an archive file to your system for each component that you choose to install. You can choose any location on your system for these files. The directory you choose does not need to be collocated with the installation setup file, or with the installed software. Note: If you have already specified a storage directory, that directory name is displayed. 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. Remove downloaded files when installer exits—select this option if you want the installation program to delete the downloaded files after the installation is complete. If you do not select this option, the downloaded files are saved to the storage directory you specified. Use HTTP Proxy—select this option if you want to use an HTTP Proxy server for the download. To use an HTTP Proxy server, you must provide the following information: Host—enter the name or IP address of the proxy server Port—enter the port number of the proxy server Use Authentication—select this option if the HTTP Proxy server you are using requires server-side authentication. If you select this option, you must provide the following information: Username—enter a valid username required by the proxy server Password—enter a valid password for the user
Downloading Archive Information Note: This window is displayed only if you are using the net installer. | No action required. This window is displayed briefly while preliminary archive information is downloaded to your system, then the Archive Download window is displayed.
Archive Download Note: This window is displayed only if you are using the net installer. | Indicate whether you want to proceed with the installation automatically after the download is complete by selecting or clearing the appropriate check box. This check box is selected by default. If you clear it, you need to click Next when the download is complete to proceed with the installation. Click Pause if you need to interrupt the download for any reason. If you do so, the download is discontinued and the Pause button is replaced by a Resume button. Click Resume when you are ready to proceed with the download.
Archive Integrity Check Note: This window is displayed only if you are using the net installer. | No action required. This window is displayed while the installation program verifies that the component archive files have been downloaded successfully.
Choose Product Directory Note: This window is not displayed if you are performing a Custom installation and you have selected a `BEA_HOME` directory that contains previously installed WebLogic Platform components. In that case, the selected components are installed in the Product Directory you specified during the initial installation. | Specify the directory in which you want to install the WebLogic Platform software and click Next. You can accept the default product directory (`weblogic81`) or create a new product directory. For additional information, see Choosing a Product Installation Directory. If you choose to create a new directory, the installation program automatically creates the directory for you. When you click Next, one of the following occurs: If a Node Manager is already installed as a Windows service, the installation program begins copying the components you specified to your system. If a Node Manager is not installed as a Windows service, the Install Node Manager as a Windows Service is displayed.
Install Windows Services Note: This window is displayed only if you are installing on a Windows platform and you select Custom installation in the Choose Install Type window. | Choose whether you want to install the Windows services indicated, specifically the WebLogic Server Node Manager service. The Node Manager is used to monitor, start, and stop managed servers in a domain. For more information, see Installing the Node Manager as a Windows Service.
Status | Read the information displayed about BEA products and services. When the installation program has finished copying the specified files to your system, click Next.
Install Complete | Specify whether you want to run the QuickStart application. QuickStart, designed to assist first-time users in evaluating, learning, and using WebLogic Platform, provides quick access to the WebLogic Platform Tour and other samples, other development tools, and the online documentation. Clear the check box for this option if you do not want to launch QuickStart. Click Done to exit the installation program and launch QuickStart, if selected.

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

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`