bea.com | products | dev2dev | support | askBEA

Download Docs | Site Map | Glossary
Search

Installation Guide

Installing WebLogic Server Using Console-Mode Installation

The following sections describe how to install WebLogic Server 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 the WebLogic Server installation, please review the following information:

- Make sure you are installing the product on a certified platform. A complete list of certified 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 it was 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, /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 Console-Mode Installation on Windows Systems

To start the installation in console mode on a Windows system, follow these steps:

1. Log in to the Windows system.

2. Open an MS-DOS command prompt window.

3. If you are installing WebLogic Server from 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. Go to the directory where you downloaded the installation program and invoke the installation procedure by entering one of the following commands:

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

      net_platform XXX_win32.exe -mode=console (net installer file—WebLogic Platform)

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

      Note: By default, 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.

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

      server XXX_win32 -mode=console -log=d:\logs\weblogic_install.log

      The path must be to a file. All folders in the path must exist before you execute the command or the installation program will not create the log file. For more information, see Generating a Verbose Installation Log.

      The installation program begins to install WebLogic Server.

   3. Proceed to Running Console-Mode Installation.

4. If installing WebLogic Server from CD-ROM:

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

   2. Open an MS-DOS command prompt window.

   3. Go to the CD-ROM directory.

   4. Invoke the installation procedure by entering the following command:

      >     serverXXX_win32 -mode=console

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

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

      server XXX_win32 -mode=console -log=d:\logs\weblogic_install.log

      The path must be to a file. All folders in the path must exist before you execute the command or the installation program will not create the log file.

   5. Proceed to Running Console-Mode Installation.

Starting Console-Mode Installation on UNIX Systems

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.

Starting Console-Mode Installation for .bin Installation Files

To start the console-mode installation process for installation files ending in .bin, follow these steps:

1. Log in to the target UNIX system.

2. Open a command-line shell.

3. If you are installing WebLogic Server from 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. Go to the directory where you downloaded the installation program and invoke the installation procedure by entering the following commands:

      >     chmod a+x filename.bin

      >     ./filename.bin -mode=console

      where filename.bin is the name of the WebLogic Server installation file.

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

      ./server XXX_solaris.bin -mode=console
      -log=/nfs/home1/logs/wls_install.log

      The path must be to a file. All folders in the path must exist before you execute the command or the installation program will not create the log file.

   3. Proceed to Running Console-Mode Installation.

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. Invoke the installation procedure by entering the following command:

      >     ./filename.bin -mode=console

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

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

      ./server XXX_solaris.bin -mode=console
      -log=/nfs/home1/logs/wls_install.log

      The path must be to a file. All folders in the path must exist before you execute the command or the installation program will not create the log file.

   4. Proceed to Running Console-Mode Installation.

Starting Console-Mode Installation for .jar Installation Files

To start the console-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 an appropriate Java 2 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 Java 2 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 3-1.

   Table 3-1 Commands for Starting the WebLogic Server Installation Program

   If you are . . . | Enter the following command . . .
   --- | ---
   Installing on a UNIX platform other than IBM AIX, S/390, or Z-Series | java -jar filename.jar -mode=console
   Installing on an AIX, S/390, or Z-Series platform | java -classpath filename.jar com.bea.installer.BEAInstallController -mode=console

   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 700_generic.jar.

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

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

   The path must be to a file. All folders in the path must exist before you execute the command or the installation program will not create the log file.

6. 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 in response to any prompt. To review or change your selection, enter previous at the prompt.

Note: The sample console text and directory pathnames in this section use UNIX conventions (forward slashes) in pathnames, for example, /home1/bea/weblogic700. When entering pathnames on a Windows system, use the Windows convention (backslashes) for pathnames, for example C:\bea\weblogic700.

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 press Enter to continue with the installation process.

   The License Agreement prompt is displayed.

2. Read the BEA Software License Agreement and indicate your acceptance or rejection of the terms of the agreement by typing yes or no, respectively, at the prompt. To review the entire agreement, press Enter or type more several times. If you type no, the installation process terminates. To proceed with the installation, type yes to indicate your agreement with the terms of the license.

   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 BEA Home Directory.

   The installation program displays the following prompt:

   >     Choose BEA Home Directory:

   >     Select Option:
   >         1 - Create a new BEA Home
   >         2 - Use an existing BEA Home [/home/bea]

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

   Do one of the following:

   - To use an existing BEA Home directory, type 2 or next, 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 to the BEA Home directory, for example /home/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:

   >     <-------- BEA Installer - WebLogic Platform 7.0.0.1 ----->

   >     Choose BEA Home Directory:

   >        ->1¦ Yes, Use this BEA home directory [/home/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| Typical Installation (Install all software
   >      components, including program files and examples.)

   >          2| Custom Installation (Choose software components to
   >      install and optionally create custom application domains.
   >      Recommended for advanced users.)

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

   Do one of the following:

   - Type 1 or press Enter to choose a Typical installation.

     In a typical installation, all software components provided with 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.

     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.

     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: 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 are installing from CD-ROM or using the package installer, the Choose Product Directory prompt is displayed. Go to step 7.

   If you are using the net installer, the Specify Download Options prompt is displayed. Go to step 6.

   - Type 2 to choose a Custom installation. 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.

     The Choose Components prompt is displayed.

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

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

   >     Choose Components:

   >        Release 7.0
   >         |-----WebLogic Server  [0] x
   >         |    |-----Server  [0.0] x
   >         |    |-----Workshop  [0.1] x
   >         |    |-----Server Examples  [0.2] x

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

   By default, all components are selected as indicated by the x (UNIX systems), or check mark (Windows systems), at the end of each 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 0.2 on the command line.

   The word Installed is shown in brackets for any components you have already installed on your system.

   Note: If you downloaded the software using the net installer option, you will see options for additional WebLogic Platform components. To install WebLogic Server with WebLogic Workshop only, deselect the additional WebLogic components. If you want to install other components of the WebLogic Platform, refer to the WebLogic Platform Installation Guide.

   When you are finished selecting components, press Enter or type next. 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.

   If you are installing from CD-ROM or 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 presents the following options:

   >     SPECIFY DOWNLOAD OPTIONS

   >     1- Modify Storage directory  (none)
   >     2- Modify Remove download files after installation (No)
   >     3- Modify Proxy Host (none)
   >     4- Modify Proxy Port (none)

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

   If you have previously installed WebLogic Server and specified a storage directory during the installation process, the full pathname for that directory is displayed as the default. To accept the defaults presented, type next or press Enter. If you have not specified a download storage directory in a previous installation and you want to save the download files, you need to specify a directory before you can proceed with the installation. To specify a storage directory or modify any of the other 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. This option is required if you are using the net installer.

   - 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 Remove download files after installation option is set to Yes. If you accept the default for this option (No), the downloaded files are saved to the storage directory you specified.

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

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

   After you have indicated your preferences, the files begin downloading to the storage directory you specified. 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 Server software. Select the default product directory (bea_home/weblogic700) or create a new product directory. If you specify a new directory, the installation program automatically creates the directory for you.

   The choices displayed in this section are as follows:

   >     Choose Product Directory:

   >         Product Directory= [/home/bea/weblogic700]

   >     Select Option:
   >         1 - Input new Product Directory
   >         2 - Reset to default

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

   Do one of the following:

   - Press Enter, type 2 or next, to accept the current selection. If you type 2 at the initial prompt, you accept the default product directory (/home/bea/weblogic700 in this example).

   - Type 1 to enter a new product installation directory. The following text is displayed:

     >     Choose Product Directory:
     >       Product Directory = [/home1/bea/weblogic700]

     >     Input new Product Directory OR [Exit][Previous][Next]>

     Enter the full path to the directory in which you want to install WebLogic Platform software. For example:

     >     /home3/weblogic700

     When you press Enter, the pathname you entered is displayed as the product directory. Press Enter or type next. The following text is displayed:

     >     Choose Product Directory:
     >        ->1| Yes, use this product directory [/home3/weblogic700]
     >          2| No, select another product directory

     >     Enter index numbers 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.

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

     Note: It is normal for the installation program to stop for a fairly long time, especially at the end. The installation program is still working when this occurs.

   If you are performing a typical installation, the installation is complete. Press Enter to exit the installation program. If you are performing a custom installation, the Run Configuration Wizard prompt is displayed.

8. Indicate whether you want to run the Configuration Wizard to create a WebLogic domain by selecting the appropriate option. The console displays the following options:

   >     Run Configuration Wizard

   >       ->1 - Yes, run Configuration Wizard to create my application domain
   >         2 - No, skip Configuration Wizard

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

   Press Enter or type 1 to launch the Configuration Wizard. Type 2 or next to skip the Configuration Wizard. You can launch it again after completing the installation.

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

   For more information about the Configuration Wizard, see Configuring Domains, Servers, and Clusters with the Configuration Wizard.

   After you have created your domains or typed 2 to skip the Configuration Wizard, the installation is complete.

9. Press Enter to exit the installation program.

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.

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