Skip to content

INSTALL.md

Latest commit

 

History

History
155 lines (111 loc) · 4.21 KB

INSTALL.md

File metadata and controls

155 lines (111 loc) · 4.21 KB
Raw

homs manual installation instruction

Activiti installation

To install Activiti refer to getting started guide:

  1. Be sure to use the same database for activiti-explorer and activiti-rest applications - internal H2 in-memory database does not satisfy this requirement.
  2. Put Latera Activiti extension jar and its dependencies to WEB-INF/lib directory of each applications.
  3. Create user with id user, email user@example.com, password changeme and include him in users security-role group.
  4. Deploy demo processes.

One of the possible ways of Activiti installation with PostgreSQL database on Debian Linux is described below.

Install required packages

sudo apt-get install tomcat8 tomcat8-admin postgresql

Enable Tomcat manager interface

  1. Add user with role manager-gui to tomcat-users.xml (/etc/tomcat8/tomcat-users.xml):
<role rolename="manager-gui"/>
<user username="tomcat" password="tomcat" roles="manager-gui"/>
  1. Restart Tomcat:
sudo service tomcat8 restart

Create Activiti database

  1. Connect to PostgreSQL as super user:
sudo -u postgres psql
  1. Create database, user and grant privileges:
CREATE DATABASE activiti;
CREATE USER activiti WITH password 'activiti';
GRANT ALL privileges ON DATABASE activiti TO activiti;

Install Activiti

  1. Download Activiti 5.19.x and unzip it.
  2. Unzip wars/activiti-explorer.war and wars/activiti-rest.war.
  3. For each application:

  • Replace content of WEB-INF/classes/db.properties with:

    db=postgres
jdbc.driver=org.postgresql.Driver
jdbc.url=jdbc:postgresql://localhost:5432/activiti
jdbc.username=activiti
jdbc.password=activiti

  • Download PostgreSQL JDBC jar and put it to WEB-INF/lib directory.

  • Download Latera Activiti extension full pack and put it to WEB-INF/lib directory.

  1. Zip back activiti-explorer.war and activiti-rest.war.
  2. Deploy activiti-explorer.war and activiti-rest.war via Tomcat manager interface: http://loclahost:8080/manager/html

Deploy demo processes

  1. Login at http://localhost:8080/activiti-explorer with user kermit and password kermit.
  2. Create user with id user, email user@example.com, password changeme and include him in users security-role group.
  3. Deploy demo processes.

homs installation

homs is a familiar Ruby On Rails 4 application with PostgreSQL backend. To install it you need bundler and probably rvm.

One of the possible ways of homs installation on Debian Linux is described below.

Install required packages

sudo apt-get install git postgresql libpq-dev nodejs libqtwebkit-dev

Create homs database

  1. Connect to PostgreSQL as super user:
sudo -u postgres psql
  1. Create database, user, and grant privileges to him:
CREATE DATABASE homs;
CREATE USER homs WITH password 'homs';
GRANT ALL privileges ON DATABASE homs TO homs;

Install RVM

Follow RVM installation guide.

Install homs

  1. Clone homs git repository:
git clone https://github.com/latera/homs.git
  1. Install ruby:
rvm install ruby-2.2.4
  1. Create homs RVM gemset:
rvm use ruby-2.2.4@homs --create
  1. Install bundler:
gem install bundler
  1. Install gems:
bundle --without oracle
  1. Make configs from samples:
find config -name '*.sample' | xargs -I{} sh -c 'cp $1 ${1%.*}' -- {}
  1. Run migrations:
bundle exec rake db:migrate
  1. Fill db with test data:
bundle exec rake db:seed

Run homs

thin start --threaded

Login at http://localhost:3000 with user@example.com/changeme.