# Installation Guide

# Installation

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

To install the IDK, complete the following steps:

1. Make sure that you have met the prerequisites for installation. For details, see the list of supported configurations in Installation Prerequisites.
2. Install the 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/).

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 IDK

To install the AquaLogic Interaction Development Kit (IDK), extract the ALIDK_java_v6-0_win.zip | ALIDK_dotnet_v6-0_win.zip (.NET) | ALIDK_v6-0_sol.tgz (Java) | ALIDK_v6-0_aix.tgz (Java) file into the root AquaLogic Interaction folder, typically C:\bea\alui or C:\Program Files\alui in Windows.

The following subfolders will be created in the \idk 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 AquaLogic Interaction Development Kit 6.0 Documentation on http://www.oracle.com/technology/documentation/index.html.

### Upgrading From a Previous Version of the IDK

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

Note: Version 6.0 includes the following naming changes. Make sure to update all references before recompiling your code.

Version 6.0 | Version 5.4 and earler
--- | ---
idk.jar / idk.dll | edk.jar / edk.dll
/idk (root directory) | /ptedk

## 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)