bea.com | products | dev2dev | support | askBEA

Download Docs | Site Map | Glossary
Search

Installing WebLogic Platform

Installing WebLogic Platform Using Graphical-Mode Installation

The following sections describe how to install WebLogic Platform using the graphical user interface (graphical) mode installation on both Windows and UNIX systems:

- 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

- Using the Configuration Wizard

- What's Next?

Before You Start

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

- Ensure you are installing the product on a supported platform. A complete list of supported platforms can be found at the following URL:

>     http://e-docs.bea.com/platform/docs70/support/index.html

- You should read Preparing to Install WebLogic Platform, specifically, the following sections:

- Installation Prerequisites

- Choosing the Type of Installation

- Selecting Directories for the WebLogic Platform Installation

- 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, or install 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/weblogic700) 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 example, if you installed WebLogic Server and WebLogic Integration 7.0 Service Pack 1, and later attempt to install WebLogic Portal 7.0 Service Pack 2, you are required to upgrade the other components to Service Pack 2 before you can install WebLogic Portal. For details on upgrading your installation, see Installing Service Packs and Rolling Patches.

Starting the Installation Program in Graphical Mode on Windows Platforms

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 Web Distribution of WebLogic Platform.

   2. Go to the directory where you downloaded the installation program and double-click the installation file:

   net_platform XXX_win32.exe (net installer file with Sun Java 2 SDK)

   platform XXX_win32.exe (package installer with Sun Java 2 SDK)

   platform XXX_jrockit_win32.exe (package installer with WebLogic JRockit Java 2 SDK)

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

   The installation program begins to install WebLogic Platform.

   3. Proceed to Running the Installation Program.

3. If installing WebLogic Platform from the CD-ROM:

   1. Insert the WebLogic Platform CD-ROM into the CD-ROM drive.

   2. If the installation program does not start automatically, open the 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 with Sun Java 2 SDK)

   platform XXX_jrockit_win32.exe (package installer with WebLogic JRockit Java 2 SDK)

   In these filenames, XXX is 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 Java 2 Software Development Kit (SDK), which includes 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 Java 2 SDK. Filenames for these installation programs end in .jar. To run the .jar installation programs, you must have the appropriate version of the Java 2 SDK installed on your system, and include the bin directory of the SDK at the front of the PATH variable. It is important that you use an SDK because the installation process sets the JAVA_HOME and related variables to point to this directory.

Note: 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, follow these steps to start the installation in graphical mode:

1. Log in to the target UNIX system.

2. Open a command-line shell.

3. If you are installing WebLogic Platform from CD-ROM, go to step 4. If you are installing from a Web download, complete the following procedure:

   1. Download the software as described in Web Distribution of WebLogic Platform.

   2. Go to the directory in which you downloaded the installation program and invoke the installation procedure 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.

   Note: Filenames for the net installer are preceded by net_, for example, net_platform XXX_solaris.bin, where XXX is the version number of the software you are installing.

   The installation program begins to install WebLogic Platform.

   3. Proceed to Running the Installation Program.

4. If you are installing WebLogic Platform from the 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. 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 platformXXX_solaris.bin, where XXX is the version number of the software you are installing.

5. Proceed to Running the Installation Program.

Starting Graphical-Mode Installation for .jar Installation Files

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. Open a command-line shell.

3. Include the bin directory of the appropriate SDK at the beginning of the PATH variable on the target system. For example:

   PATH=JAVA_HOME/bin:$PATH
   export PATH

   where JAVA_HOME is the full path to the SDK directory.

4. Do one of the following:

   - Download the software as described in Web Distribution of WebLogic Platform.

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

5. Go to the directory that contains the installation file and invoke the installation procedure as described in the following table.

   Note: On the CD-ROM, the installation file is located in the weblogic_platform XXX directory, where XXX is the version number of the software you are installing.

   If you are . . . | Enter the following command . . .
   --- | ---
   Installing on a UNIX platform other than AIX | java -jar filename.jar
   Installing on an AIX platform | java -classpath filename.jar com.bea.installer.BEAInstallController

   In both cases, 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 is the version number of the software you are installing.

   Note: Platform support sometimes varies by service pack release. To ensure you are installing the product on a supported platform, see the Supported Platforms page at the following URL:

   http:/e-docs.bea.com/platform/docs70/support/index.html

6. 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: Typical—in a typical installation, all the software components provided with WebLogic Platform, 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—in a custom installation, you can select the software components you want to install and optionally create customer application domains. Use this option to install the Integration Client or the E-Business Control Center on a standalone machine. For additional information on the installation types, see Choosing the Type of Installation.
Choose Components Note: This window is displayed only if you selected Custom installation on the Choose Install Type window. | Select 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 checked with the exception of the WebLogic Integration Client subcomponent. When you select or clear a component at the folder level, all subcomponents are selected or cleared accordingly. The check boxes for any components already installed on your system appear as a grey check box. 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 clear the WebLogic Server component check box, the WebLogic Integration and WebLogic Portal servers and samples, and the WebLogic Integration client check boxes are also cleared, since they require the WebLogic Server to run. You can, however, install the EBCC subcomponent since this is a client component that does not require that the server be installed on the same machine. 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. It does not need to be collocated with the installation setup file, or with the installed software. Remove downloaded files after installation—Select this check box if you want the installation program to delete the downloaded files after the installation is complete. If you do not select this check box, the downloaded files are saved to the storage directory you specified. Use HTTP Proxy—Select this check box 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
Download Status 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 want to proceed with the download.
Archive Integrity Check Note: This window is displayed only if you are using the net installer. | Click Next when the download verification is complete. This window is displayed while the installation program verifies that the component archive files downloaded successfully.
Choose Product Directory Note: This window is not displayed if you are performing a Custom installation and you have selected the same 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 (weblogic700) or create a new product directory. For additional information and a description of the resulting directory structure, 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, the installation program begins copying the components you specified to your system.
Status | Read the information displayed about BEA products and services and click Next when the installation program has finished copying the specified files to your system. If you are performing a Typical installation, the install is complete.
Run Configuration Wizard Note: This window is displayed only if you selected Custom installation on the Choose Install Type window. | Indicate if you want to run the Configuration Wizard to create an application domain by selecting the appropriate option. If you choose Yes, proceed to Using the Configuration Wizard for a summary description of the Configuration Wizard. For complete details, refer to the document Using the Configuration Wizard at the following URL: http://e-docs.bea.com/platform/docs70/confgwiz/index.html If you choose No, you can run the Configuration Wizard at a later time from the Start menu (Windows systems only), or the command line (UNIX and Windows system).
Install Complete | Click Done to exit the installation program. If you performed a typical installation, or a full custom installation (that is, you installed all of the components using the Custom installation option), the WebLogic Platform QuickStart application is displayed by default. 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, useful tools for accomplishing specific development tasks, and the online documentation. Note: If you do not want to launch QuickStart automatically, clear the Run QuickStart check box.

Using the Configuration Wizard

If you are performing a custom installation, at the end of the installation process you can run the Configuration Wizard to create and configure WebLogic domains. Or, in both custom and typical installations, you can start the Configuration Wizard from the Start menu or the command line. For complete details, see Using the Configuration Wizard at the following URL:

>     http://e-docs.bea.com/platform/docs70/confgwiz/index.html

You use the Configuration Wizard to create and configure custom WebLogic domains. A WebLogic domain is an interrelated set of WebLogic Server resources that are managed as a unit. A domain includes one or more WebLogic Servers, and may also include WebLogic Server clusters.

The Configuration Wizard uses preconfigured domain templates to facilitate domain creation for the target environment. The templates that are available for you to use with the Configuration Wizard are based on the components that you selected to install. For example, if you installed WebLogic Server and WebLogic Integration, the preconfigured templates for both components are available, however the templates for WebLogic Portal are not.

Configuration Options

Based on the preconfigured domain template that you choose, you are prompted to supply certain types of information for each domain. The following list offers a sampling of the type of information you need to provide.

Note: Detailed descriptions of the templates provided with the WebLogic Platform installation program are provided in Configuration Wizard Template Reference at the following URL:

http://e-docs.bea.com/platform/docs70/template/index.html

- Server Type, such as a Single standalone server, or an Administrative server with managed servers or clustered managed servers.

- A domain directory in which to create the domain. By default, this directory is created in BEA_HOME/user_projects, where BEA_HOME is the BEA Home directory containing the support information for this installation. If the directory does not exist, the Configuration Wizard creates the directory for you.

- Configuration information for the server, such as Server Name, Listen Address, Listen Port, and SSL Listen Port. Default values are provided for most values.

- A system user name and password. WebLogic Server user names and passwords can contain any character from the JDK supported character sets, including international characters.

- If you want the server configured as a Windows service. If you choose to do so, the server starts automatically each time you boot your Windows system. You must have Administrator privileges to install the server as a Windows service. For additional information, see "Setting Up a WebLogic Server as a Windows Service" in "Starting and Stopping WebLogic Servers" in the BEA WebLogic Server Administration Guide at the following URL:

http://e-docs.bea.com/wls/docs70/adminguide/startstop.html#SettingUpServerAsWindowsService

Note: You are only prompted to configure the server as a Windows service when configuring WebLogic Server domains. You are not prompted when configuring WebLogic Integration and WebLogic Portal domains.

- E-mail address and e-mail host name to enable WebLogic Integration to send e-mail from workflow instances. (This prompt is presented only when configuring domains containing business process management functionality.)

What's Next?

When you install WebLogic Platform, the installation program installs an evaluation license file in the BEA Home directory so that you can start using the product immediately. We recommend that you use the QuickStart application to familiarize yourself with the software, take the WebLogic Platform Tour, and execute the samples provided. For additional information, see Performing Post-Installation Tasks.