# Installation Guide

# Preparing for Your Installation

## What's in This Release

This distribution contains the 2.6 release of BEA AquaLogic SOA Management (ALSM).

## Before you Begin

### Macromedia Flash Player

ALSM uses the Macromedia Flash Player (version 7.0r10 or higher) on some pages to generate various graphical displays. If your web browser does not already have the Flash Player installed, you can get the latest version at this URL:

http://www.macromedia.com/go/getflashplayer

### IE Security Settings and Flash

If you use Microsoft's Internet Explorer you must make sure that your security settings are adjusted so that Internet Explorer allows the Flash player Active X control to run. To configure the settings, do the following:

1. Run Internet Explorer and select Tools > Internet Options....
2. The "Internet Options" dialog should now appear. Select the "Security" tab.
3. Select the "Medium" security level (or lower) for the "security zone" that applies to ALSM. (This will probably be either the "Internet" or "Local intranet" zones, depending on your system configuration.)
4. If you use a "Custom" security level you should click the "Custom Level..." button instead of setting a preset security level like "Medium".
5. In the Security Settings", scroll down and find the following two options;

- Run ActiveX controls and plug-ins
- Script activeX controls marked safe for scripting

6. Set them both to "Enabled" and click OK.

### Configuring Windows Firewall to Accommodate a Multi-container Installation

If you are using a Window Firewall and you plan to implement the ALSM across containers (see Appendix A: Installation Best Practices), you need to configure the firewall to make it aware of the additional ports into which you installed ALSM. Please do the following:

1. Bring up the Windows Control Panel and double-click Windows Firewall.
2. In the General tab of the Windows Firewall dialog, turn on the firewall if it is not already on.
3. Click the Exceptions tab and click the Add Port... button.
4. Enter a Port Name and Port Number for each port you used in your distributed ALSM installation. For example:

- 7001 - the standard HTTP port for WebLogic Server

Other containers use other standard ports, and you can use different port numbers for all of them; you must know what port(s) you are using.

1. For each port, you can also click the "Change Scope" button and specify that you want to allow access from all computers, only your subnet, or a custom list of IP addresses.
2. Click OK when you are finished adding ports, and then again to dismiss the Windows Firewall dialog.

### General WebLogic Server Information

- Obtain a valid ALSM 2.6 license from BEA and add it to the WebLogic Server installation on which you will install ALSM. For inforrmation about installing and updating licemse files, see http://download.oracle.com/docs/cd/E13179_01/common/docs92/install/license.html.
- Ensure that WebLogic Server is installed and running before you start installing SOA Management System.
- Recommended maximum heap size for WebLogic Server's VM is 1024MB.
- If using Sun's JVM, recommended maximum perm size is 256MB or larger.
- Recommended thread pool size is 25.
- If you plan to use ALSM sample Java key stores, you must use JDK 1.4.2_05 or higher.
- If you are running ALSM on Unix-like systems, you must restart your server with the following property set before you run reports using the service-level management component:

    -Djava.awt.headless=true

### WebLogic Server 9.2 MP1

If you are using WebLogic Server 9.2 MP1 (Maintenance Pack 1), and are installing into a managed server environment, you must manually install SOA Management System. Please see Appendix C: Creating War Files for Manual Installation on page C-7 for details.