Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Building

...

the

...

Activiti

...

Modeler

...

for

...

the

...

first

...

time

...

Check

...

out

...

the

...

excellent

...

documentation

...

by

...

Signavio:

...

http://code.google.com/p/signavio-core-components/wiki/InstallationInstructions

...

Set the following properties and follow the instructions of the next section ('Preparing for a release') to get a working Activiti Modeler:

Code Block
war = activiti-modeler
configuration = Activiti{code}

All

...

other

...

properties

...

are

...

optional.

...

Preparing

...

for

...

a

...

release

...

  • Update

...

  • your

...

  • local

...

  • version

...

  • (svn

...

  • up).

...

  • Update

...

  • the

...

  • version

...

  • property

...

  • in

...

  • the

...

  • build.properties

...

  • file.

...

  • Here

...

  • is

...

  • my

...

  • build.properties

...

  • for

...

  • reference

...

  • (Joram):

...

No Format
# This is the Signavio Core Components configuration file. Most users only have to configure this file.

# The path to your Apache Tomcat webapps folder
dir-tomcat-webapps = /apache-tomcat-6.0.16/webapps

# The path to your jBoss deployment folder
dir-jboss-webapps = /jboss-5.1.0/server/default/deploy

# The folder the war file(s) is/are stored
target = target

# The version of the application. If you want to integrate the Signavio Core Components into
#  your own software product, you can align the version number.
version=5.0-SNAPSHOT

# The name of the war file, if you use the all-in-one-war build target
war = activiti-modeler

# The configuration you want to use. This is the name of the folder in the 'configuration' project
#  that contains the configuration and skin files. The following configurations are available:
#  default, Activiti, jBPM
#  You can also add your own configuration in the 'configuration' project.
configuration = Activiti

# The URL of your server. Format: http(s)://<domain>(:<port>)
#  Do not add a trailing slash here!
host = http://localhost:8080

# The path on your system the directories and diagram files are created.
# Do not use \ ! Always use / !
fileSystemRootDirectory = ../../../workspace/activiti-modeler-examples
{noformat}


* Build the war using (on the root of 
  • Build the war using (on the root of signavio-core-components):

...

  • Code Block

...

  • ant build-all-in-one-war

...

  • The

...

  • war

...

  • file

...

  • will

...

  • be

...

  • stored

...

  • in

...

  • the

...

  • target

...

  • folder.

...

  • Set

...

  • or

...

  • verify

...

  • in

...

  • user.home/.activiti/build.properties

...

  • the

...

  • modeler.target.folder

...

  • property

...

  • to

...

  • point

...

  • to

...

  • the

...

  • target

...

  • folder,

...

  • into

...

  • which

...

  • the

...

  • Activiti

...

  • Modeler

...

  • has

...

  • been

...

  • built.

...


  • eg.

...

  • Code Block

...

  • 
    modeler.target.folder=/Users/jbarrez/Development/workspace/signavio-core-components/target
    

...

  • Call the Ant target patch.activiti.modeler

...

  • in

...

  • distro/build.xml

...

  • in

...

  • the

...

  • Activiti

...

  • codebase.

...

  • The

...

  • easiest

...

  • is

...

  • to

...

  • create

...

  • a

...

  • small

...

  • script

...

  • that

...

  • does

...

  • that

...

  • for

...

  • you

...

  • on

...

  • the

...

  • root

...

  • of

...

  • the

...

  • Modeler

...

  • source:

...


  • This

...

  • will

...

  • patch

...

  • the

...

  • modeler

...

  • war

...

  • to

...

  • include

...

  • the

...

  • Cycle

...

  • plugin

...

  • and

...

  • the

...

  • Activiti

...

  • stencil

...

  • set.

...

  • Code Block

...

  • 
    ant -f /Users/jbarrez/Development/workspace/activiti/distro/build.xml patch.activiti.modeler
    

...

  • The

...

  • patched

...

  • war

...

  • will

...

  • be

...

  • created

...

  • in

...

  • /target/patched

...

Testing the war

  1. Checkout the to-be-released

...

  1. (tag)

...

  1. version

...

  1. Edit

...

  1. distro/src/setup/build.xml

...

  1. :

...

  1. change

...

  1. the

...

  1. property

...

  1. 'activiti.modeler.download.url'

...

  1. to

...

  1. the

...

  1. war

...

  1. on

...

  1. your

...

  1. local

...

  1. system.

...

  1. Example:

...

  1. Code Block

...

  1. <property name="activiti.modeler.download.url" value="file:///Users/jbarrez/Development/signavio/signavio-core-components/signavio-core-components-read-only/target/patched/activiti-modeler-${activiti.version}.war" />

...

  1. Comment the 'skip.deploy.activiti.modeler=true

...

  1. '

...

  1. property

...

  1. in

...

  1. the

...

  1. $user.home/.activiti/build.properties

...

  1. Build

...

  1. a

...

  1. new

...

  1. activiti

...

  1. distro

...

  1. (in

...

  1. qa

...

  1. dir:

...

  1. ant

...

  1. build.clean.distro

...

  1. or

...

  1. in

...

  1. distro

...

  1. dir:

...

  1. ant

...

  1. clean

...

  1. distro

...

  1. )

...

  1. and

...

  1. run

...

  1. the

...

  1. demo

...

  1. setup

...

  1. (in

...

  1. qa

...

  1. dir:

...

  1. ant

...

  1. test.demo.setup

...

  1. or

...

  1. in

...

  1. distro/target/activiti-$

...

  1. {activiti.version

...

  1. }/setup/

...

  1. dir:

...

  1. ant

...

  1. demo.setup

...

  1. ).

...

  1. Verify

...

  1. if

...

  1. the

...

  1. modeler

...

  1. is

...

  1. correctly

...

  1. working.

...

Changing the location of the process model repository

After running the demo setup, process XML files are stored in the workspace/activiti-modeler-examples/

...

 folder.

...

The

...

location

...

of

...

the

...

file-based

...

repository

...

can

...

be

...

switched

...

by

...

changing the fileSystemRootDirectory property in the (exploded)activiti-modeler.war/WEB-INF/classes/configuration.properties

...

 file.

Changing the host of the Modeler

After running the demo setup, the Activiti Modeler will accessible only on the localhost address. When you want to change the host of the Modeler, e.g. to run it centrally on a server, change the host property in the (exploded)activiti-modeler.war/WEB-INF/classes/configuration.properties

...

 file.>

...

cat

...

configuration.properties

...


host

...

=

...

http://192.168.1.101:8080

...


fileSystemRootDirectory

...

=

...

/Users/jbarrez/Development/model-repo 

...

Configuring Apache Tomcat for Activiti Modeler

In the context of the activiti demo setup Apache Tomcat is configured correctly. If Apache Tomcat is configured manually we need to make sure that UTF-8 encoding is enabled for accessing the filesystem and for URI-encoding. To this end,

  • ensure that -Dfile.encoding=UTF-8

...

  •  is added to the java-call

...

  • in ${catalina.home}/bin/catalina.

...

  • bat or${catalina.home}/bin/catalina.sh,

...

  • respectively.

...

  • ensure that URIEncoding="UTF-8"

...

  •  is set on the HTTP-connector

...

  • in ${catalina.home}/conf/server.xml,

...

  • i.e.

...

  • like

...

  • this:<Connector

...

  • port="8080"

...

  • protocol="HTTP/1.1"

...

  • connectionTimeout="20000"

...

  • redirectPort="8443"

...

  • URIEncoding="UTF-8"

...

  • />