Armedia CodeGen

Installation Guide

Armedia CodeGen – Composer Plug-In Install Guide

Installation Guide and User Manual

Armedia, LLC ©2009 – http://armedia.com/products/generator.htm 5/1/2009

 Table of Contents

Installing CodeGen for Composer / Eclipse.......................................................3

Fulfilling the Prerequisites...................................................................................3
JRE 1.5..........................................................................................................3
DFC 5.3, 6.....................................................................................................3
Composer or Eclipse........................................................................................3
Installing and Configuring...................................................................................3
Configuring the License...................................................................................4
Upgrading CodeGen...........................................................................................4

CodeGen – Composer Plug-In Install Guide

Armedia, LLC ©2009 – http://armedia.com/products/generator.htm 5/1/2009

 Installing CodeGen for Composer / Eclipse

Fulfilling the Prerequisites

You will need the following in order to use the Armedia CodeGen on your system:

JRE 1.5
The Java Development Kit or Java Runtime Environment 1.5 can be obtained from
http://java.sun.com/javase/downloads/index_jdk5.jsp . Make sure that this particular JRE is installed
on your system before proceeding.

DFC 5.3, 6

CodeGen – Composer Plug-In Install Guide

The Documentum Foundation Classes 5.3 and 6 can be obtained from EMC Documentum's download
site at https://documentum.subscribenet.com if a customer login and password are available.
Otherwise, please consult your System Administrator in order to obtain copies of the appropriate DFC
5.3 or 6 installer. Ensure, either during or after installation, that the dmcl.ini file for your local
machine points to the Documentum Connection Broker onto which your desired Documentum
Repository is projected.

Composer or Eclipse
The Composer IDE can be downloaded from the EMC Documentum’s download site at
https://documentum.subscribenet.com. See in DFC download instructions for details.

The Eclipse IDE 3.2 can be downloaded from http://www.eclipse.org/downloads/. The Software
Development Kit is available as a compressed (.zip) file that must be extracted to a location of your
choice on your local machine. This location will be referred to hereon as {ECLIPSE_HOME}.

Installing and Configuring

Installing

1) Begin the installation from the Composer or Eclipse Help Menu item.

2) Choose "Help > Software Updates".

3) Switch tab to “Available Software”.

4) Choose “Add Site” and enter http://www.armedia.com/software/codegen/updates as the URL.

5) Select the "Armedia Code Generator" feature to install and proceed with the installation.

6) Choose the “Install” button.

7) Choose the “Next” button after the dialogue completes the install.

8) Accept the license agreement and choose “Finish”.

***When prompted to restart Eclipse, choose no, and simply close Eclipse***

Armedia, LLC ©2009 – http://armedia.com/products/generator.htm 5/1/2009

 The following steps are required complete the installation:

9) Add EMC Documentum jars and dfc.properties to plug-in lib directory:

<eclipse>/plugins/com.armedia.codegen_xx.xx.xx/lib

• dfc.jar

• certjFIPS.jar

• jsafeFIPS.jar

• Update or overwrite dfc.properties

Configuring the License

CodeGen – Composer Plug-In Install Guide

1) Starting Composer / Eclipse,

2) Switch to Java Perspective if not already there

3) Right-click on a Java Project and select "Armedia Code Generators".

4) When prompted, paste your license file similar to the below:

signature=MCwCFHOZmU7/LRB+rHFJcpDJlbwoo7GyAhRQhxylwjFk+AdmpRwPS6e8FFNUlg\=\=
expiration=1246334400000

Upgrading CodeGen
Upgrading from previous versions CodeGen is a very simple process and requires the following steps:

1) Choose "Help > Software Updates".

2) Choose CodeGen Feature and press Update

3) To upgrade the EMC Documentum jar files, copy the following files to the plug-in lib directory:
<eclipse>/plugins/com.armedia.codegen_xx.xx.xx/lib

• dfc.jar

• certjFIPS.jar

• jsafeFIPS.jar

• Update or overwrite dfc.properties

Armedia, LLC ©2009 – http://armedia.com/products/generator.htm 5/1/2009