This article presents two basic ways of installing and starting Aperte Modeler.

Download runtime bundle

Aperte Modeler is bundled with other Aperte Workflow products inside the runtime bundle or demo archive. Please refer to main quick start guide on how to obtain and install this bundles.

Setup using own application server

This approach assumes one have previously installed and configured Aperte Workflow runtime environment on Liferay Portal instance. The instruction provided below was prepared for Apache Tomcat 6 application server, with both Aperte Workflow runtime and Aperte Modeler web application deployed together. Chances are, that no additional steps will be required on your application server of choice.

Step by step instruction

1. Download the latest Aperte Modeler WAR archive (apertemodeler.war) from http://sourceforge.net/projects/aperteworkflow/files/AW1.0/.
2. Deploy the WAR archive by copying it into $CATALINA_HOME/webapps.
3. Make sure the WAR archive was unpacked and deployed.
4. It might be required to edit the configuration in WEB-INF/classes/configuration.properties file to reflect your environment. Application or server restart after your changes are applied may be necessary as well.
   • Make sure that host parameter value is equivalent to your server address because provided default may not be valid in all environments.
   • If you want to use existing model repository insert its path into the fileSystemRootDirectory parameter value.
   • Make sure that fileSystemRootDirectory parameter value points to a valid system directory. If this parameter is left empty, the path is going to be resolved as: ${aperte.workflow.home}/modeler-repo, ${liferay.home}/modeler-repo or just ./modeler-repo. At least one of those must exist.
   • Make sure that jbpmGuiUrl parameter value points to the context root of the Aperte Workflow runtime aperteworkflow web application.
5. Make sure that Aperte Workflow runtime is running and is accessible.
6. Navigate to Aperte Modeler page inside your browser, e.g. http://localhost:8080/apertemodeler.
7. When asked to authenticate, log in using your credentials in the Liferay Portal instance on which Aperte Workflow runtime was installed. The default username usually is joebgloggs and password is test.