|
|
|
|
|
|
| | | |
Installing WebLogic Server Using GUI-Mode Installation
The following sections describe how to install WebLogic Server using graphical user interface (GUI) mode installation on both Windows and UNIX systems:
What Is GUI-Mode Installation?
GUI-mode installation is the graphics-based method of executing the BEA Installation program. It can be run on both Windows and UNIX systems.
To run GUI-mode installation, the console attached to the machine on which you are installing the software must support a Java-based GUI. All consoles for Windows systems support Java-based GUIs, but not all consoles for UNIX systems do.
Note: To install WebLogic Server on a UNIX system with a non-graphics console, see Installing WebLogic Server on UNIX Systems Using Console-Mode Installation.
The following sections focus on using GUI-mode installation to install the WebLogic Server base product. Base product, as used here, implies a full installation of WebLogic Server, which includes the installation of the Java Development Kit (JDK). A WebLogic Server base product may or may not include integrated Service Packs.
As of WebLogic Server version 6.1, you cannot install WebLogic Server on top of a previously installed WebLogic Server 6.0 or 6.1 installation. You must first uninstall the WebLogic Server installation, as described in Uninstalling WebLogic Server.
If you are installing on Windows XP, you must install in Compatibility mode:
Starting GUI-Mode Installation on a Windows System
To start the GUI-mode installation process on a Windows system, follow these steps:
If you want to install WebLogic Server as a Windows service, you must have Administrator privileges. For information about installing WebLogic Server as a Windows service, see Understanding the WebLogic Server Windows Service.
Starting GUI-Mode Installation on a UNIX System
A WebLogic Server 6.1 installer for a UNIX platform takes one of two forms:
This section presents installation procedures for both types of installers.
Starting GUI-Mode Installation for filename.bin Installers
To start the GUI-mode installation process for filename.bin installers, follow these steps:
sh filename.bin
where filename is the name of the WebLogic Server installer.
Note: You must have write permission in the directory where you launch the installer.
sh filename.bin
where filename is the name of the WebLogic Server installer specific to your platform.
Starting GUI-Mode Installation for filename.zip Installers
To start the GUI-mode installation process for filename.zip installers, follow these steps:
PATH=full_path_to_jdk131/bin:$PATH export PATH
Replace full_path_to_jdk131 with the full pathname to the JDK 1.3.1 directory.
java -cp filename.zip install
where filename is the name of the WebLogic Server installer.
java -cp filename.zip install
where filename is the name of the WebLogic Server installer specific to your platform.
Note: You must have write permission in the directory where you launch the installer.
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 . . . |
|---|---|
|
BEA Logo |
Select the language in which to display text during the installation. |
|
Welcome |
Click the Next button to proceed with the installation. You may cancel the installation at any time by clicking Exit. |
|
License Agreement |
Read the BEA Software License Agreement and indicate your acceptance of the terms of the agreement by selecting Yes. The default is No. To continue with the installation, you must accept the terms of the license agreement and then click Next. |
|
Choose Install Set |
Select the software to be installed on your system. The default selection is Server with Examples, which installs the program files and the examples files. To accept the default, click Next. To install just the program files, select Server Only and then click Next. For a basic description of program files and examples files, see WebLogic Server Software Components. |
|
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 Product Directory |
Specify the directory in which you want to install the WebLogic Server software. Select the default product directory (wlserver6.1) or create a new product directory. If you choose to create a new directory, the installer program automatically creates the directory for you. |
|
Default Server Configuration |
Enter your configuration choices for the WebLogic Server default server:
A domain is a unit of administration for a WebLogic Server installation. A WebLogic domain may consist of one or more WebLogic Servers. For additional information about WebLogic domains, see "Overview of WebLogic Server Management" in the Administration Guide. |
|
Install WebLogic Server Service |
Click Yes if you want to install WebLogic Server as a service on your Windows system. If you select Yes, the default server starts as a service each time you boot your Windows system. The default is No. If you accept the default, WebLogic Server is not installed as a service. For more information about installing WebLogic Server as a service, see Understanding the WebLogic Server Windows Service. |
|
Create System Password |
Enter a password that contains at least 8 characters but no more than 20 characters. You are prompted to enter this password to start the WebLogic Server default server, examples server, and Pet Store server. You are prompted for the username system and this password to access the WebLogic Server Administration Console from a Web browser. The installer program creates the system account (username system having the password you specify here) during the installation. |
|
Installing . . . |
No user input is required here. The installer program is installing WebLogic Server in the user-specified product directory. Note: It is normal for the installation progress bar to stop for a fairly long time, especially at the end. The installer is still working when this occurs. |
|
Install Complete |
Click Done to exit the installer program. |
Congratulations! Your installation of the BEA WebLogic Server software is complete!
Understanding the WebLogic Server Windows Service
You must have Administrator privileges to install WebLogic Server as a Windows service.
When you install WebLogic Server as a Windows service, the installer program populates a command script file named installNtService.cmd with the default server configurations that you specified during the installation and then runs the script to create the WebLogic Server service. The following listing shows the command line structure of the installNtService.cmd script.
Listing 2-1 installNtService.cmd Script—Example
@echo off
SETLOCAL
cd C:\bea\wlserver6.1\config\mydomain
rem *** Set Classpath to load Weblogic Classes
set CLASSPATH=.;C:\bea\wlserver6.1\lib\weblogic_sp.jar;
C:\bea\wlserver6.1\lib\weblogic.jar
rem *** Set Command Line for service to execute
rem *** %JAVA_HOME%\java will automatically be prepended.
set CMDLINE="-ms64m -mx64m -classpath \"%CLASSPATH%\"
-Dweblogic.Domain=mydomain -Dweblogic.Name=myserver
-Djava.security.policy==\"C:\bea\wlserver6.1/lib/
weblogic.policy\" -Dbea.home=\"C:\bea\" weblogic.Server"
rem *** Install the service
"C:\bea\wlserver6.1\bin\beasvc" -install -svcname:myserver
-javahome:"C:\bea\jdk131"
-execdir:"C:\bea\wlserver6.1"
-extrapath:"C:\bea\wlserver6.1\bin" -cmdline:%CMDLINE%
ENDLOCAL
Running the installNtService.cmd script creates an entry for the service (myserver by default) in the Windows Registry so that the Windows system knows to start the service each time the Windows system boots. The Windows system starts the WebLogic Server default server as a process running in the background, similar to a UNIX system starting and running a daemon process.
Account and Environment Information
The WebLogic Server service runs under the LocalSystem account and the Windows System environment profile. You can view the System environment profile by choosing Start
Manual Configuration of Windows Service
To create or reconfigure the WebLogic Server service manually, you edit the installNtService.cmd script as needed and then run the script. The script, together with the uninstallNtService.cmd script, is located in the wls_6.1_prod_dir\config\domain_name directory, where wls_6.1_prod_dir represents the product directory in which you installed the WebLogic Server software, and domain_name represents the name of the default server domain you specified during installation (mydomain by default). You must have Administrator privileges to run the installNtService.cmd and uninstallNtService.cmd scripts.
Because the Windows System environment typically includes no Java compiler (javac.exe) in its PATH, you can add this path by editing the extrapath option of the beasvc command in the installNtService.cmd script and then running the script. For example, in the following extrapath option definition, the added path highlighted in bold will include the Java compiler in the Windows System environment:
-extrapath:"C:\bea\wlserver6.1\bin;C:\bea\jdk131\bin"
-cmdline:%CMDLINE%
WebLogic Server needs access to the Java compiler to be able to compile its JavaServer Pages (JSPs) during startup. Without access to the Java compiler, the WebLogic Server JSPs will not be compiled.
Note: For details about the beasvc command and its options, go to the directory where the beasvc command resides and enter beasvc -help.
Additional Windows Service Information
The WebLogic Server service uses the system password that you specified during installation when booting WebLogic Server. If you change this password at a later time, you must uninstall the service using uninstallNtService.cmd, modify the installNtService.cmd file to include the -password argument, and execute the modified installNtService.cmd file. For details about modifying the installNtService.cmd file, see "Starting and Stopping WebLogic Servers" in the Administration Guide.
Understanding the WebLogic Server Windows Shortcuts
When installing WebLogic Server on a Windows system, the installer program automatically uses BEA WebLogic E-Business Platform as the parent folder for WebLogic Server. As additional BEA Home directories are added to the system, the installer program continues to create new BEA WebLogic E-Business Platform folders using the convention shown in the following figure.
Figure 2-1 Tracking Multiple BEA Home Directories on the Same System
Each BEA Home directory has an associated BEA WebLogic E-Business Platform folder. Each BEA WebLogic E-Business Platform folder has one or more BEA product folders (see note) and two files: BEAHOMEx Location and View History. The numbers associated with BEAHOME are sequential starting at 2; no number appears if only one BEA Home directory is created on a Windows system.
Note: Because a BEA Home directory may be the home directory for several BEA products including WebLogic Server, WebLogic Collaborate, and BEA Tuxedo, a BEA WebLogic E-Business Platform folder may contain several BEA product folders.
For a given BEA Home directory and BEA WebLogic E-Business Platform folder, the BEAHOME file contains the pathname of the BEA Home directory, and the View History file contains a history of installation and uninstallation for the BEA Home directory. Double-clicking the text icon associated with either file displays its content. The BEAHOME and history files contain information extracted from the logs/log.txt file located in the BEA Home directory.
The WebLogic Server 6.1 folder (Start
Figure 2-2 WebLogic Server Shortcut Files
To learn more about WebLogic Server 6.1, view the following files:
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 6.1 shortcut (or the About WebLogic Server 6.1(spx) shortcut for a WebLogic Server 6.1 installation with integrated Service Packs). On both Windows and UNIX systems, access the ABOUT_WLS.HTML file at wls_6.1_prod_dir/ABOUT_WLS.HTML, where wls_6.1_prod_dir represents the product directory in which you installed the WebLogic Server software.
A text-only version of the ABOUT_WLS.HTML file. Access the README.TXT file at wls_6.1_prod_dir/README.TXT, where wls_6.1_prod_dir represents the product directory in which you installed the WebLogic Server software.
To verify that your software is installed correctly, and to start the default server and console, see Performing Post-Installation Tasks.
|
|
|
|
|
|
Copyright © 2001 BEA Systems, Inc. All rights reserved.
|
