Amsetwiki: Getting Started

More...

What to get started with#

The software deliverables from the AMSeT project were the AMSeT Workflow Toolkit, a set of sample, atomic Alfresco workflows, a Guanxi Shibboleth security interface for Alfresco, an Alfresco SWORD interface, and an Alfresco SWORD Blackboard Building Block.

1. Getting started with the AMSeT Workflow Toolkit#

1.1 Read the AMSeT Workflow Toolkit Developer Guide.

1.2 Install GlassFishESB

Note that the Mac OSX GlassFishESB/JBI development environment needs some special setting up: see JBI/MacOSX. All AMSeT BPEL projects were developed on Windows XP.

https://open-esb.dev.java.net/Downloads.html

The full install of GlassFishESB 2.1 includes NetBeans 6.5.1, GlassFish 2.1 enterprise server and the OpenESB components.

The components only download requires an existing Glassfish 2.1 and NetBeans 6.5.1.

The full install is recommended - it's quick and painless. If you have other installations of GlassFish or NetBeans on your machine, there is no need to worry about the different installations interfering with each other. At any one time I can have about 5 different releases of NetBeans and 6 GlassFish on my machine with no issues. The only thing to watch is trying to run more than one server at a time which will result in port-already-in-use errors unless you change the configuration.

From the GlassFishESB site, the Java requirements are:

Prerequisities: a Sun JDK: version 1.5.0_14 or later for JDK 5, or version 1.6.0_10 or later for JDK 6.
Note: avoid JDK 1.6.0_13 and 1.6.0_14 due to some incompatibilities with several of the design time 
wizards.

Refer to the GlassFishESB site for installation details, but it is essentially double-click the installation file and watch it go. You will be asked to supply initial username, password and port numbers for the GlassFish server.

1.3 Install and start MySQL 5 on the machine on which Alfresco will be running.

1.4. Install Alfresco Community Edition 3.2.

The simplest option is to use the alfresco-community-tomcat download which includes its own Tomcat servlet engine, Alfresco SourceForge Files. If MySQL is running, then this will install all dependencies. Under the installation folder there are alf_start and alf_stop bat or sh files to start Tomcat/Alfresco.//

1.5 Use the NetBeans Subversion client to check out the AMSeT Workflow Toolkit from the AMSeT SourceForge site at https://amset.svn.sourceforge.net/svnroot/amset and create a NetBeans project.

1.6 Change the Alfresco endpoints in the Alfresco WSDLs in the toolkit project to point to your Alfresco installation.

1.7 Download wsmonitor and edit the configuration file to point to your Alfresco installation. Start wsmonitor (see AMSeT wsmonitor blog entry).

1.8 View the AMSeT Workflow Toolkit demonstration. This screencast shows how to create, run and test a workflow.

2. Getting started with the atomic workflows#

The software requirements are the same as for the toolkit above. (Alfresco Labs 3 Final was the latest version available when the development started and this was used in the project for the atomics. However, Alfresco Community 3.2 is the latest version and this should be used. The toolkit was developed on this.)

The sample workflows can be downloaded from the AMSeT SourceForge site. A screencast is provided on the Documentation page which describes how to use the samples.