Documentation

Installing bemokoLive - Jump Start

We believe technology should be easy - this jump start install will have you up and running with bemoko in 5 minutes.

Download, Unpack and Run

This guide assumes that you installing bemoko on your local machine. If you want to install on a remote machine then you should access the system with the appropriate URLs to the deployed bemoko installation, other than the localhost examples below.
We also assume that you have Java v6 installed. If you haven't got it installed then please read more on java installation.
  1. Download bemoko
  2. Unpack the zip file into a directory of your choice.
  3. Open up a command line (e.g. DOS window) or terminal on your machine
  4. Change to the directory where you unpacked the zip file

and run:

java -jar bemokoLive-1.9.2.war

Running this command will run bemoko and automatically open the welcome page

http://localhost:8080/live/welcome

You should see a friendly welcome page with configuration information such as the screen shot below. That's all there is to it to get access to many of the features of the bemoko platform and start building some mobile sites. Yes - there's more you can do, but we'll come to those later once you've had some hands on.

Configuration Options

If you want to pick up sites from a different file location

java -Dbemoko.sites.location=/var/bemoko/source/sites/ -jar bemokoLive-1.9.2.war

If you want to use a persistent database - i.e. data persists through restarts - then a lightweight way of doing this is using the HSQLDB file based database, e.g.

java -Dbemoko.datasource.url=jdbc:hsqldb:file:/var/bemoko/jumpstart/bemoko-db -jar bemokoLive1.9.2.war

You should increase the memory used by the java instance, e.g.

java -Xms512m -Xmx512m -XX:MaxPermSize=256m -jar bemokoLive-1.9.2.war

Increasing the MaxPermSize is particularly important since the default JVM perm size settings may not be sufficient to support compliation of multiple sites.

If you need to use a different port other than the default one of 8080, you can set it on the command line with the system property bemoko.server.port, e.g.

java -Dbemoko.server.port=9000 -jar bemokoLive-1.9.2.war

More