Copy Page

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account. You can also Sign Up for a new account.

<h3>Building the Activiti Modeler for the first time</h3>

<p>Check out the excellent documentation by Signavio: <a href="http://code.google.com/p/signavio-core-components/wiki/InstallationInstructions">http://code.google.com/p/signavio-core-components/wiki/InstallationInstructions</a></p>

<p>Set the following properties and follow the instructions of the next section ('Preparing for a release') to get a working Activiti Modeler:</p>
<table class="wysiwyg-macro" data-macro-name="code" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGV9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>war = activiti-modeler
configuration = Activiti</pre></td></tr></table>
<p>All other properties are optional.</p>

<h3>Preparing for a release</h3>

<ul>
	<li>Update your local version (svn up).</li>
	<li>Update the version property in the build.properties file.</li>
	<li>Here is my build.properties for reference (Joram):</li>
</ul>

<table class="wysiwyg-macro" data-macro-name="noformat" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e25vZm9ybWF0fQ&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
# 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)://&lt;domain>(:&lt;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
</pre></td></tr></table>

<ul>
	<li>Build the war using (on the root of signavio-core-components):
<table class="wysiwyg-macro" data-macro-name="code" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGV9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>ant build-all-in-one-war</pre></td></tr></table>
The war file will be stored in the <em>target</em> folder.</li>
	<li>Set or verify in <em>user.home/.activiti/build.properties</em> the <code>modeler.target.folder</code> property to point to the <em>target</em> folder, into which the Activiti Modeler has been built.<br />
eg.
<table class="wysiwyg-macro" data-macro-name="code" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGV9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
modeler.target.folder=/Users/jbarrez/Development/workspace/signavio-core-components/target
</pre></td></tr></table></li>
	<li>Call the Ant target <code>patch.activiti.modeler</code> in <em>distro/build.xml</em> in the Activiti codebase. The easiest is to create a small script that does that for you on the root of the Modeler source:<br />
This will patch the modeler war to include the Cycle plugin and the Activiti stencil set.
<table class="wysiwyg-macro" data-macro-name="code" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGV9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
ant -f /Users/jbarrez/Development/workspace/activiti/distro/build.xml patch.activiti.modeler
</pre></td></tr></table>
The patched war will be created in <strong>/target/patched</strong></li>
</ul>

<h3>Testing the war</h3>

<ol>
	<li>Checkout the to-be-released (tag) version</li>
	<li>Edit <em>distro/src/setup/build.xml :</em> change the property 'activiti.modeler.download.url' to the war on your local system. Example: 
<table class="wysiwyg-macro" data-macro-name="code" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGV9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>&lt;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" /></pre></td></tr></table></li>
	<li>Comment the <em>'skip.deploy.activiti.modeler=true</em>' property in the $user.home/.activiti/build.properties</li>
	<li>Build a new activiti distro (in qa dir: <em>ant build.clean.distro</em> or in distro dir: <em>ant clean distro</em>) and run the demo setup (in qa dir: <em>ant test.demo.setup</em> or in distro/target/activiti-${activiti.version}/setup/ dir: <em>ant demo.setup</em>).</li>
	<li>Verify if the <a href="http://localhost:8080/activiti-modeler/p/explorer">modeler</a> is correctly working.</li>
</ol>

<h3>Changing the location of the process model repository</h3>

<p>After running the demo setup, process XML files are stored in the <em>workspace/activiti-modeler-examples/</em> folder. The location of the file-based repository can be switched by changing the <strong>fileSystemRootDirectory</strong> property in the <strong>(exploded)activiti-modeler.war/WEB-INF/classes/configuration.properties</strong> file.</p>

<h3>Changing the host of the Modeler</h3>

<p>After running the demo setup, the Activiti Modeler will accessible only on the <em>localhost</em> address. When you want to change the host of the Modeler, e.g. to run it centrally on a server, change the <strong>host</strong> property in the <strong>(exploded)activiti-modeler.war/WEB-INF/classes/configuration.properties</strong> file.&gt; cat configuration.properties<br />
host = <a href="http://192.168.1.101:8080">http://192.168.1.101:8080</a><br />
fileSystemRootDirectory = /Users/jbarrez/Development/model-repo </p>

<h3>Configuring Apache Tomcat for Activiti Modeler</h3>

<p>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,</p>

<ul>
	<li>ensure that <strong>-Dfile.encoding=UTF-8</strong> is added to the java-call in ${catalina.home}/bin/catalina.bat or${catalina.home}/bin/catalina.sh, respectively.</li>
	<li>ensure that <strong>URIEncoding=&quot;UTF-8&quot;</strong> is set on the HTTP-connector in ${catalina.home}/conf/server.xml, i.e. like this:&lt;Connector port=&quot;8080&quot; protocol=&quot;HTTP/1.1&quot; connectionTimeout=&quot;20000&quot; redirectPort=&quot;8443&quot; URIEncoding=&quot;UTF-8&quot; /&gt;</li>
</ul>