Corporate Info | News | Solutions | Products | Partners | Services | Events | Download | How To Buy
Installing and Setting up WebLogic Server 5.1: Previous topic | Next topic | Contents | Index

Installing from a zip archive (UNIX, Windows NT)

Overview

This section tells you how to install WebLogic Server using the zip archive. This zip archive is required for installing WebLogic Server on supported UNIX systems and may also be used for installation on Windows NT.

Note: When installing WebLogic Server on a UNIX system, do not unzip the distribution on a Windows NT machine and then copy that installation to a UNIX machine.

Installing on Windows NT using the zip archive

Installing WebLogic Server on Windows NT using the zip archive instead of the InstallShield means that the following steps will not be performed automatically:

- Windows Convenience Programs will not be installed.

- Start menu shortcuts will not be set up.

- The weblogic.properties file will not be modified.

- The weblogic.policy file will not be modified.

- You will be unable to install WebLogic Server as a Windows NT service.

BEA recommends that you use the InstallShield version when installing on Windows NT. For more information, see Installing using the InstallShield distribution (Windows NT).

Upgrading from a previous release

If you have a version of WebLogic Server earlier than 5.1.0, you should either remove your previous installation or re-name its directory. Do not install the new release on top of an older release.

Installing from the zip archive

Note: If you are installing on Windows NT, please ignore the steps labeled (UNIX only).

1. Download the WebLogic distribution, or locate the weblogic510.zip file on your CD (located in the root directory).

2. (UNIX only) Create a UNIX user to install WebLogic Server, such as weblogic (optional). This allows you to control access to the distribution and to set permissions for your WebLogic distribution. See the documentation for your operating system for details. You may also want to create a group that has permissions to access the distribution.

3. (UNIX only) Log in with the WebLogic user you created.

4. Select a directory for the installation. BEA recommends that you install WebLogic Server in a directory where you normally install shared applications, such as /usr/local/weblogic. If you are upgrading from a previous version of WebLogic Server, rename or delete the root directory of your old installation.

5. Unzip the distribution. You can use the unzip utility to un-pack the distribution (or WinZip on Windows NT), or, if you already have a Java Development Kit (JDK) installed, you can use the Java jar utility. (The jar utility is not included with the JRE.) A weblogic directory will be created in the directory where you execute the jar command. For example,

       $ jar -xvf path/weblogic510.zip

       (where path is the path to the weblogic510.zip file)

   unzips the distribution into a directory called weblogic, located beneath the current directory.

6. Edit the weblogic.properties file, located in the top-level directory where you unpacked the WebLogic Server distribution. The weblogic.properties file contains name-value pairs for properties that set the functionality of the WebLogic Server. To run the server with a basic configuration, you must edit several properties:

   - Administrator's password. Edit the property weblogic.password.system, adding your own system administrator's password. This user-selected password is used to access administrative functions of WebLogic Server such as the WebLogic Console. The default minimum length for the password is 8 characters and the maximum is 16 characters (this can be changed, see Setting WebLogic Properties).
     For example,

         weblogic.password.system=myPassword

   - Modify paths to your installed directory. The default weblogic.properties file uses a path of /weblogic as the default location for various files. If you have installed WebLogic Server into a different directory, replace all the /weblogic entries with the correct directory.

   - Modify external paths. The weblogic.properties file refers to several directories outside of the WebLogic Server installation. Examine all instances of c:/ in the weblogic.properties file and correct these entries as needed.

   - Install a performance pack. If you are installing WebLogic Server on Windows NT, Solaris 2.6/2.7, or AIX 4.3, you can add a native performance pack that uses a platform-optimized (native) socket muxer to improve server performance. To use a performance pack, make sure the following property is defined in your weblogic.properties file (the default weblogic.properties file shipped with your distribution already defines this property and sets it to true):

         weblogic.system.nativeIO.enable=true

7. If you are using Java 2 (JDK 1.2), modify the weblogic.policy file. This is covered in detail under Setting up the Java security manager for Java 2.

8. (UNIX only) Set the file permissions (optional). After you unpack the distribution, the permissions for all of the files will be 644 (read/write access for the user, read access for the group and for all). For security reasons, you may want to change these permissions, particularly on sensitive files such as weblogic.properties, weblogic.log, and weblogic.policy. For these sensitive files, BEA recommends that you set the permissions to 640 (no access for "all").

9. (UNIX only) If you will be running WebLogic Server as a web server listening for requests on port 80, please see Additional steps on UNIX .

10. (UNIX only) If you will be using performance packs or WebLogic ZAC, you must set your load (or shared) library path to point to the directory containing the native libraries for your platform. (On most UNIX systems, this is called the LD_LIBRARY_PATH, on HP-UX, it is called SHLIB_PATH, and on Bull/IBM AIX it is called LIBPATH. See your operating system documentation for instructions on setting this variable.) These libraries are located in the directory shown in the table below.

    ####

    Platform | Directory containing shared library
    --- | ---
    Bull/IBM AIX | weblogic/lib/aix
    HP-UX 11 | weblogic/lib/hpux11
    SGI IRIX | weblogic/lib/irix
    Red Hat Linux | weblogic/lib/linux
    Sun Solaris | weblogic/lib/solaris
    Compaq Tru64 Unix | weblogic/tru64unix

    (Where weblogic is the directory containing your WebLogic Server installation.)

11. (UNIX only) If you are using the HP-UX platform, please see the note on shared libraries.

Next steps

1. Oracle users only.

   If you will be using the supplied Oracle JDBC driver (WebLogic jDriver for Oracle, formerly called jdbcKona/Oracle) you must explicitly set your SHARED LIBRARY PATH to include the appropriate BEA-supplied libraries. See Installing WebLogic jDriver for Oracle for details. Your Oracle-supplied client libraries must also be included in the shared library path.

2. Starting WebLogic Server

   The WebLogic Server distribution is now installed on your computer. To find out how to set up and start WebLogic Server, please see Setting up and Starting WebLogic Server 5.1.

.

Copyright © 2000 BEA Systems, Inc. All rights reserved. Required browser: Netscape 4.0 or higher, or Microsoft Internet Explorer 4.0 or higher.