Installation Guide

Installation

This chapter describes how to install and deploy the BEA AquaLogic Interaction Development Kit (IDK).

To install the IDK, complete the following steps:

Make sure that you have met the prerequisites for installation. For details, see the list of supported configurations in Installation Prerequisites.
Install the AquaLogic Interaction Development Kit (IDK) components using the instructions that follow. For notes on upgrading, see Upgrading From a Previous Version of the IDK.

Note:

To support APIs that use binary upload or download (for example, remote.prc.collaboration.document.idocumentmanager.insertnewdocument), you must install WSE 2.0sp3 (http://msdn.microsoft.com/webservices/webservices/building/wse/).

AquaLogic Interaction Development Kit (IDK) version 5.2 and above includes a remote logging API for use with AquaLogic Interaction Logging Utilities. To support this feature, you must download and install the Logging Utilities package from BEA dev2dev (dev2dev.bea.com). For details on enabling IDK logging, see Configuring Logging Receivers in the AquaLogic Interaction Development Documentation.

Installing the AquaLogic Interaction Development Kit (IDK)

To install the BEA AquaLogic Interaction Development Kit (IDK), extract the edk_java.zip / edk_java.tar.gz (Java) | edk_dotnet.zip (.NET) file into the root AquaLogic Interaction folder, typically C:\bea\alui or C:\Program Files\alui.

The following subfolders will be created in the \ptedk folder:

\devkit includes the files required to build Web Applications. For .NET, this includes asmx files, Web.config, and dlls. For Java, this folder includes the WEB-INF subfolder.
\documentation includes the API documentation (NDocs). For the latest IDK API documentation, see BEA dev2dev (dev2dev.bea.com).

Upgrading From a Previous Version of the IDK

IDK (EDK) versions 5.2 and above include different dependencies than previous releases. Copying the new edk.dll will not result in a full installation. Make sure to copy the files located in the /bin folder and overwrite your existing IDK/EDK assemblies to add new dependencies and updated versions of old dependencies.

Creating Custom IDK Projects

For details on configuring your IDE for IDK development, see the following pages in the AquaLogic Interaction Development Documentation:

Setting Up a Custom IDK Project (Java | .NET)
IDK Quickstart: Hello World Portlet (Java | .NET)