Gettings Started

#Welcome to the multikanban wiki!#

##Getting Started##

This is my attempt at a gettings started page on the wiki, the following is how I got MultiKanBan working:

Note: I'm using Ubuntu 14 for this installation, although this should work with other similar distributions.

Multikanban Front End Install/Setup

1. Install the required packages (also install mysql-server if you plan on using the web server as the database server as well).

sudo apt-get install npm apache2 php5 git unzip curl mysql-client php5-mysql -y

1. Install node.js.

Download and run setup script for node.js 0.12.

curl -sL https://deb.nodesource.com/setup_0.12 | sudo bash -

Download and install node.js itself.

sudo apt-get install -y nodejs

1. Install Composer

curl -sS https://getcomposer.org/installer | php

1. Enable the mod_rewrite module in Apache.

a2enmod rewrite

service apache2 restart

1. Goto your root web server directory.

cd /var/www/html

1. Remove the any default, pre installed files.

rm index.html

1. Download multikanban from the github repo.

git clone https://github.com/mezod/multikanban.git

1. Install the requirements based on package.json

cd multikanban

npm install

1. Install bower

npm install -g bower

1. Install requirements from bower.json

bower install

1. Move the app folder to the root web server directory (/var/www/html/)

cd /var/www/html/app

mv * ../

rm app -R

1. Create a folder in scripts/, called vendor.

mkdir /var/www/html/scripts/vendor/

1. Move the bower_components folder contents to the newly created vendor folder.

cd /bower_components/

mv * /var/www/html/scripts/vendor/

1. Change the following lines in index.html.

from

<link rel="stylesheet" media="screen" href="/multikanban/app/styles/styles.css" type="text/css" />

to

<link rel="stylesheet" media="screen" href="styles/styles.css" type="text/css" />

and from

<script data-main="/multikanban/app/scripts/main.js" src="/multikanban/app/scripts/vendor/requirejs/require.js"> </script>

to

<script data-main="scripts/main.js" src="scripts/vendor/requirejs/require.js"></script>

Multikanban Back End Install/Setup

2. Create folder 'multikanban-api' in the root web server folder.

mkdir /var/www/html/multikanban-api/

2. Download the multikanban api repo into that folder.

cd /var/www/html/multikanban-api/

wget https://github.com/mezod/multikanban-api/archive/master.zip

2. Unzip the repo.

unzip master.zip

2. Move all the files into /multikanban-api/

cd multikanban-api-master

mv * ../

cd ../

rm -r multikanban-api-master

1. Install PHP requirements with Composer

php composer.phar install

1. Change the database details in Application.php (Around line 103).

cd /var/www/html/multikanban-api/src/multikanban/multikanban/

nano Application.php

from

 $this->register(new DoctrineServiceProvider(), array(
          'db.options' => array(
          'dbname' => 'multikanban',
          'user' => 'root',
          'password' => 'root',
          'host' => 'localhost',
          'driver' => 'pdo_mysql',
          ),
      ));

to

 $this->register(new DoctrineServiceProvider(), array(
          'db.options' => array(
          'dbname' => 'YOUR DATABASE NAME HERE',
          'user' => 'YOUR USERNAME HERE',
          'password' => 'YOUR PASSWORD HERE',
          'host' => 'YOUR MYSQL HOST HERE (PUT localhost IF YOURE USING THE WEB SERVER AS THE DATABASE SERVER',
          'driver' => 'pdo_mysql',
          ),
      ));

This worked for me, apart from the fact that the api seems incomplete, I will check with the project author about this. For additional help refer to the author's blog.