Build and Install

How to install PARTAKE in your server

recommended: install to virtual machine (VM)

We distribute cookbooks and Vagrantfile to make development environment, so you can use VirtualBox and Vagrant 1.1 to set up your development environment.
Note that we do not support Windows as host machine. see #442.

1. Clone master branch from GitHub.
   • Just execute git clone git@github.com:partakein/partake.git.
   • Execute git submodule init and git submodule update to update third party libraries.
2. Set up your VM. It would cost several minutes to download and install middle ware.
   • Execute vagrant up command.
   • VM uses memory about 2 GiB. If you want to reduce it, see Vagrantfile for detail.
   • Chef-solo will install JDK, Play! framework, Postgres and initialize databases.
3. Register your application to twitter, and set token to conf/application.conf.
   • Application Type should be "Browser"
   • Callback URL is any valid URL. But do not use localhost. This will rejected by twitter.
   • Default Access Type should be "Read & Write". We do not need DirectMessage Read.
   • Check "Yes, use Twitter for login"
4. Build and run PARTAKE in your VM.
   • Sign in to your VM by vagrant ssh command.
   • You need to execute cd /vagrant && ~/play-2.0.4/play run in your VM.
   • After that, please access to http://localhost:9000/. You can use host machine to access because your localhost:9000 is forwarded to VM's 9000 port.

install to your machine directly

1. Install PostgreSQL version 9, and make 2 databases in it.
   • Default database name is partake-dev. You can change it by modifying conf/application.conf.
   • Unit test uses partake-test database, so you need to make this database too.
2. Download Play! framework.
   • To know which version we are using, please read project/plugins.sbt.
   • We recommend you to use Java7 to develop.
3. Register your application to twitter, and set token to conf/application.conf.
   • Application Type should be "Browser"
   • Callback URL is any valid URL. But do not use localhost. This will rejected by twitter.
   • Default Access Type should be "Read & Write". We do not need DirectMessage Read.
   • Check "Yes, use Twitter for login"
4. Clone master branch from GitHub.
   • Just execute git clone git@github.com:partakein/partake.git
   • Execute git submodule init and git submodule update to update third party libraries.
5. Execute play run to build and run service on your PC. After that, access to http://localhost:9000/ to use your service.

How to use Eclipse to develop

• Execute play eclipsify to generate project files.
• Launch your Eclipse and go to File -> Import... -> Existing Projects into Workspace.
• Choose folder which you cloned PARTAKE into. Eclipse will load generated project files.

How to test

• Execute play test.