bea.com | products | dev2dev | support | askBEA

Download Docs | Site Map | Glossary
Search

Installation Guide

Installing WebLogic Server Using Graphical-Mode Installation

The following sections describe how to install WebLogic Server using the graphical user interface (GUI) 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 a UNIX Platform

- Running the Installation Program

- Configuring Domains, Servers, and Clusters with the Configuration Wizard

- What's Next?

Before You Start

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

- Make sure you are installing the product on a supported platform. A complete list of supported platforms can be found at http://e-docs.bea.com/platform/suppconfigs/index.html.

- You should read all of Preparing to Install WebLogic Server, specifically the following sections:

  - Installation Prerequisites

  - Choosing the Type of Installation

  - Selecting Directories for the WebLogic Server Installation

- You cannot re-install WebLogic Server in the same location (BEA Home or physical location) as previously installed. You must first uninstall the WebLogic Server installation, as described in Uninstalling WebLogic Server, or install in another location. You can, however, install additional Weblogic Platform components, such as the WebLogic Server examples, in the same location without uninstalling existing components.

- All WebLogic Platform components installed in a BEA product directory (for example, c:\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 7.0 Service Pack 1, and later attempt to install WebLogic Portal 7.0 Service Pack 2, you are required to upgrade WebLogic Server to Service Pack 2 before you can install WebLogic Portal. For details on upgrading your installation, see Installing WebLogic Server Service Packs and Rolling Patches.

Starting the Installation Program in Graphical Mode on Windows Platforms

To start the GUI-mode installation process on a Windows system, follow these steps:

1. Log in to the Windows system.

2. If you are installing WebLogic Server from a CD-ROM, go to step 3. If you are installing WebLogic Server by downloading from the BEA Web site:

   1. Go to http://commerce.beasys.com/downloads/weblogic_server.jsp and download the WebLogic Server installation file for your platform. See Web Distribution of WebLogic Server for information about download options.

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

      server XXX_win32.exe (package installer file—WebLogic Server, WebLogic Workshop, and related samples)

      net_platform XXX_win32.exe (net installer file—WebLogic Platform)

      where XXX is the version number of the software you are installing.

      Note: The net installer installs all or part of the WebLogic Platform, which includes WebLogic Server with WebLogic Workshop. See Web Distribution of WebLogic Server for more details.

      The installation program begins to install WebLogic Server.

   3. Proceed to Running the Installation Program.

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

   1. Insert the WebLogic Server 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 server XXX_win32.exe, where XXX is the version number of the software you are installing. The installation program begins to install WebLogic Server.

   4. Proceed to Running the Installation Program.

Starting the Installation Program in Graphical Mode on a UNIX Platform

The WebLogic Server 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 Server installation program does not include the Java 2 SDK in the installation program. 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 Java 2 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, the installation program automatically starts console-mode installation. For details, see Installing WebLogic Server Using Console-Mode Installation.

Starting Graphical-Mode Installation for .bin Installation Files

If you have an installation program file that ends in .bin, follow these steps to start the installation program in graphical mode on a UNIX system:

1. Log in to the target UNIX system.

2. Open a command-line shell.

3. If you are installing WebLogic Server from a CD-ROM, go to step 4. If installing WebLogic Server by downloading from the BEA Web site:

   1. Go to http://commerce.beasys.com/downloads/weblogic_server.jsp and download the WebLogic Server installation file for your platform. See Web Distribution of WebLogic Server for information about download options.

   2. In the command shell, go to the directory where you downloaded the installation program and start the installation by entering the following commands:

      >     chmod a+x filename

      >     ./filename.bin

      where filename.bin is the name of the WebLogic Server installation program specific to your platform.

   3. Proceed to Running the Installation Program.

4. If installing WebLogic Server from the CD-ROM:

   1. Insert the WebLogic Server 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 hardware platform.

   3. Start the installation by entering the following command:

      >     ./filename.bin

      where filename.bin is the name of the WebLogic Server installation program specific to your platform.

   4. Proceed to Running the Installation Program.

Starting Graphical-Mode Installation for .jar Installation Files

To start the graphical-mode installation process for installation files ending in .jar, follow these steps.

Note: If you are installing WebLogic Server on a hardware platform other than Windows, Solaris, HP-UX, or IBM AIX, there may be special installation instructions that apply to your hardware platform. Check your hardware platform listing on the Supported Configurations page before you run the installation program.

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

   - If you are installing from CD-ROM, insert the WebLogic Server 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 Table 2-1.

   Table 2-1 Commands to Start the WebLogic Server Installation Program

   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

   For each command, filename.jar is the name of the WebLogic Server installation file, for example pj_server XXX_generic.jar. Filenames for the net installer are preceded by net_, for example, net_pj_platform XXX_generic.jar.

   Note: You can also include the -log=/full_path_to_log_file option on the command line to create a log file during installation. For example:

   java -jar filename.jar -log=/nfs/home1/logs/wls_install.log

   The installation program creates a verbose installation log. For more information, see Generating a Verbose Installation Log.

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.

Table 2-2 Running the Installation Program

In this window . . . | Perform the following action . . .
--- | ---
Welcome | Click the Next button to proceed or 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 Server installer program automatically creates the directory for you. For details about the BEA Home directory, see 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 software components in the distribution 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. Software components vary depending on the distribution method of the software: CD-ROM or package installer: Installs WebLogic Server with WebLogic Workshop and all related examples. Net installer: Installs all components of WebLogic Platform, which includes WebLogic Server with WebLogic Workshop as well as WebLogic Portal, WebLogic Integration, and all related examples. Note: When you choose the Typical installation option, the Configuration Wizard is not invoked automatically as part of the installation. However, you can launch it manually after the installation is complete from the Start menu or with a command line script. See Configuring Domains, Servers, and Clusters with the Configuration Wizard. Custom—In a custom installation, you can select the software components you want to install and optionally run the Configuration Wizard to create custom WebLogic domains. Note: If you downloaded software using the net installer option and you want to install WebLogic Server without the additional WebLogic Platform components, select the Custom installation option and select only the components you want to install. If you want to install components other than server and server examples, see the WebLogic Platform Installation Guide. For additional information about installation types, see Choosing the Type of Installation. If you are using the typical installation option, go to the Choose Product Directory window.
Choose Components Note: This window is displayed only if you select Custom installation in the Choose Install Type window. | Select the components to install 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. The check boxes for components already installed on your system appear as a greyed-check box. If you want to install components other than server and server examples, see the WebLogic Platform Installation Guide. 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.
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. | Automatically continue installation after completion—Select this check box if you want to proceed automatically with the installation after the download is complete. This check box is selected by default. If you clear it, you must click Next when the download is complete to proceed with the installation. Pause—Click this button if you need to interrupt the download for any reason. If you do so, the download is discontinued and the Pause button changes to 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. | This window is displayed while the installation program verifies that the component archive files downloaded successfully. Click Next when the download verification is complete.
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 Server 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 Server 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 Product Installation Directory. If you choose to create a new directory, the installation program automatically creates the directory for you, if necessary. 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 installation is complete.
Run Configuration Wizard Note: This window is displayed only if you select Custom installation in the Choose Install Type window. | Indicate whether you want to run the Configuration Wizard to create an application domain by selecting the appropriate option. If you choose Yes, proceed to Configuring Domains, Servers, and Clusters with the Configuration Wizard for a summary description of the Configuration Wizard. For complete details, refer to Creating New Domains Using the Configuration Wizard in Creating and Configuring WebLogic Server Domains. If you choose No, you can run the Configuration Wizard from the Start menu (Windows only) or from the command line at a later time.
Install Complete | Click Done to exit the installation program.

Configuring Domains, Servers, and Clusters with 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, refer to Creating New Domains Using the Configuration Wizard in Creating and Configuring WebLogic Server Domains.

You use the Configuration Wizard to create and configure custom WebLogic domains. A 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 pre-configured domain templates that you use to create a domain for the target environment. WebLogic Server 7.0 includes the following templates:

- WLS Domain—The basic, full-featured template for creating WebLogic domains for WebLogic Server.

- WebLogic Workshop—A template used to create WebLogic Workshop-enabled domains. For detailed instructions, see the WebLogic Workshop documentation

- WLS Examples—A template used for updating the WebLogic Server examples domain when you install a service pack.

- WLS Petstore—A template used for recreating the WebLogic Server Pet Store domain when you install a service pack.

If you install additional WebLogic Platform components, you may see additional templates when you start the Configuration Wizard. For detailed procedures for using the Configuration Wizard with WebLogic Platform, see Using the Configuration Wizard. For details about available Configuration Wizard templates, see the Configuration Wizard Template Reference.

Configuration Options

Based on the pre-configured domain template that you choose when running the Configuration Wizard, 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. Complete details are provided in Creating New Domains Using the Configuration Wizard in Creating and Configuring WebLogic Server Domains.

- Server Type, such as a Single standalone server, or an Administration 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.

  Note: On UNIX systems, do not use spaces in the domain name.

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

  Note: On UNIX systems, do not use spaces in the server name.

- 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. Characters should also be valid XML data characters, which excludes the following characters: <, >, [, and ].

- An option to configure the server 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 the install the server as a Windows service. For complete details about installing and running WebLogic Server as a Windows service, see Setting Up a WebLogic Server as a Windows Service in the Administration Guide.

Note: You must follow XML guidelines for characters when specifying values in the Configuration Wizard. That is, you cannot use characters reserved for use in XML, such as <, >, [, and ].

What's Next?

To learn more about WebLogic Server 7.0, view the following files:

- about_wls.html

  Summarizes new features in this version of WebLogic Server and provides pointers to useful related information.

  On a Windows system, access this file by using the About WebLogic Server shortcut on the Start Menu. On both Windows and UNIX systems, access the about_wls.html file at WL_HOME\server\about_wls.html, where WL_HOME represents the top-level installation directory for the WebLogic Server software.

- readme.txt

  A text-only file that contains similar information as ABOUT_WLS.HTML. Access the readme.txt file at WL_HOME\server\readme.txt, where WL_HOME represents the top-level installation directory for the WebLogic Server software.