Skip navigation.
Downloads | Product Documentation | Support

Administration Application Installation

# Preparing to Install

This section provides the information needed to install the BEA WebLogic Enterprise Security Administration Application, including system requirements, and prerequisite software and hardware. It does not include information for installing a Security Service Module.

This section covers the following topics:

- Installation and Distribution
- Installation Prerequisites
- Selecting Directories for the Installation

# Installation and Distribution

BEA WebLogic Enterprise Security products are distributed and installed using the BEA Installation and Distribution System, which provides a complete framework for the following:

- Distribution of BEA products by download from the BEA web site
- Installation and uninstallation of the BEA WebLogic Enterprise Security Administration Application including documentation

BEA WebLogic Enterprise Security is distributed on both the BEA web site and on CD-ROM.

## Web Distribution

If you want to install the product by downloading it from the BEA web site, contact BEA Sales at http://www.bea.com/framework.jsp?CNT=sales1.htm&FP=/content/about/contact/ and request a download.

The package installer downloads a stand-alone version of the installation program that contains the complete Administration Application. The package installer is approximately 70 MB.

Documentation is available from the product documentation home page. Be sure to download the most up-to-date information from the BEA web site at: http://e-docs.bea.com/wles/docs42/download.html.

## CD-ROM Distribution

If you purchased BEA WebLogic Enterprise Security from your local sales representative, you will find the following items in the product box:

Four CD-ROMs:

- Disk 1 of 4 contains the following BEA WebLogic Enterprise Security products:

- Administration Application software for Microsoft Windows platforms
- Security Service Modules software for Microsoft Windows platforms
- Documentation in both PDF and HTML format

- Disk 2 of 4 contains the following BEA WebLogic Enterprise Security products:

- Administration Application software for Linux and Sun Solaris
- Security Service Modules software for Linux and Sun Solaris

- Disks 3 of 4 contains the BEA WebLogic Enterprise Security metadirectory software for Microsoft Windows platforms. This product is used with the Administration Application to integrate user repositories.
- Disks 4 of 4 contains the BEA WebLogic Enterprise Security metadirectory software for Linux and Sun Solaris platforms.

The following printed documents:

- Introduction to BEA WebLogic Enterprise Security
- BEA Software License and Limited Warranty pamphlet
- Customer Support Quick Reference and Other Important Information card

# Installation Prerequisites

The Administration Application requires certain software components to operate properly. Review these requirements carefully before installing the product.

- System Requirements
- Licensing
- Requirements for Reinstalling the Administration Application

## System Requirements

Table 2-1 lists the system requirements for the Administration Application.

Note: The machine on which you install the Administration Application must have a static IP address. The IP address is used by the Security Service Modules and Service Control Manager for connectivity. Also, on a Windows platform, the file system must be configured for NTFS and not FAT.

Table 2-1 System Requirements

Use | Component and Version
--- | ---
WebLogic Server 8.1 with Service Service Pack 3 or 4 | WebLogic Enterprise Security Administration Server requires that you install the BEA WebLogic Server in the `BEA HOME` directory. You can download WebLogic Server from: http://commerce.bea.com/showallversions.jsp?family=WLS
Java Development Kit (JDK) | The installation program requires JRE 1.4.2_04 or JRE 1.4.2_05, which are installed as part WebLogic Server 8.1, SP3 and SP4 respectively. Note: The installation process sets `JAVA_HOME` and related variables to point to this directory. All scripts installed use `JAVA_HOME` by default.
Database Storage | Oracle 8i (8.1.7) or Oracle 9i Release 2 (9.2.0.1) or Sybase Adaptive Server Enterprise, Version 12.5 Note: BEA recommends using the Oracle 9.2.0.4 client on Linux platforms. Use of an earlier version may seriously increase the amount of system memory used by the WebLogic Enterprise Security servers or processes. This behavior can eventually cause the server to use up the system memory. The use of Oracle 9.2.0.4 does not exhibit this behavior. For instructions on how to set up your database, see Setting Up and Administering the Database.
Database Connectivity | Oracle or Sybase Client Runtime Software BEA recommends that the version of your client software be the same as the database to which you are connecting. Do not use an older version of the client software to connect to a newer version of the database server. For instructions on how to set up the database client, see Installing and Configuring an Oracle Client and Installing and Configuring a Sybase Database Client.
Platforms supported | The BEA WebLogic Enterprise Security Administration Application runs on any of the following platforms: Intel Pentium compatible with Microsoft Windows NT 4.0 Intel Pentium compatible with Microsoft Windows 2000 Professional Intel Pentium compatible with Microsoft Windows 2000 Server/Advanced Server Sun Microsystems Sparc with Solaris, versions 8 and 9 Linux Red Hat Advanced Server, version 3.0
Web Browser | Microsoft Internet Explorer, Version 5.5 or later; 6.0 is recommended. In addition, the Java Plug-in for Internet Explorer from the Java Runtime Environment (JRE) 1.4 or greater is required.
Display Resolution | A display resolution of 1024 x 768 or higher is recommended when running the Administration Console.
Memory | 256 MB of RAM minimum, 512 MB or more is recommended. Each user session requires approximately 5 MB of memory.
Hard Disk Space | About 100 MB free storage space for the installed product (this does not include WebLogic Server storage space). Refer to the database installation instructions for recommendations on database storage allocation.
Certificates and Keystores | BEA WebLogic Enterprise Security uses an implementation of the Transport Layer Security (TLS) 1.0 specification (see TLS Protocol). The server hosting the WebLogic Enterprise Security Administration Application supports TLS on a dedicated listen port that defaults to 7010. To establish a secure connection, a Web browser connects to the Administration Server by supplying the listen port and the secure address (HTTPS) in the connection URL, for example, https://myserver:7010.
User Repository | Optionally, an external directory server or database, containing your user store, configured through the BEA WebLogic Enterprise Security Metadirectory. This product is included with your software. You must install it according to the instructions, and then configure it to provision the Administration Application metadirectory. For further information on how to use metadirectory with the Administration Application, see Configuring Metadirectories.
Reporting | Optionally, you can use Log4j to configure a reporting application to support auditing features. For further information on how to use Log4j with the Administration Application, see: http://jakarta.apache.org/log4j/docs/.

## Licensing

The product software cannot be used without a valid license. When you install the Administration Application, the installation program creates an evaluation license that expires in 90 days.

To use the Administration Application in a production environment, you must purchase a license. For information about purchasing a license, contact your BEA Sales Representative.

## Requirements for Reinstalling the Administration Application

If you are installing the Administration Application on a computer on which the Administration Application was previously installed, refer to Uninstallingand make sure all of the uninstall steps were completed; otherwise the installation may fail.

# Selecting Directories for the Installation

During installation, you need to specify locations for the following directories:

- BEA Home Directory
- Product Installation Directory

## BEA Home Directory

During installation, you are prompted to choose an existing BEA Home (`BEA_HOME`) directory. You should specify the same BEA Home directory that you specified when you installed WebLogic Server 8.1. The BEA Home directory is a repository for common files that are used by multiple BEA products installed on the same machine. For this reason, the BEA Home directory can be considered a "central support directory" for the BEA products installed on your system. The files in the BEA Home directory are essential to ensuring that BEA software operates correctly on your system. They perform the following types of functions:

- Ensure that licensing works correctly for the installed BEA products
- Facilitate checking of cross-product dependencies during installation

The files and directories in the BEA Home (`BEA_HOME`) directory are described in your WebLogic documentation. Although it is possible to create more than one BEA Home directory, BEA recommends that you avoid doing so. In almost all situations, a single BEA Home directory is sufficient. There may be circumstances, however, in which you prefer to maintain separate development and production environments on a single machine, each containing a separate product stack. With two directories, you can update your development environment (in a BEA Home directory) without modifying the production environment until you are ready to do so.

## Product Installation Directory

The product installation directory contains all the software components used to administer BEA WebLogic Enterprise Security. During installation, you are prompted to choose a product installation directory. If you accept the default, the software is installed in the following directory:

`c:\bea\wles42-admin` (Windows)

`/opt/bea/wles42-admin` (Sun Solaris and Linux)

where`c:\bea` is the `BEA_HOME` directory and wles42-admin is the product installation directory. You can specify any name and location on your system for your product installation directory and there is no requirement that you name the directory wles42-admin or create it under the BEA Home directory.