Quick Installation - Jumpstart

From bemoko developer wiki

New Documentation

Introduction

This article gives you a quick guide on how to get bemokoLive up. We at bemoko believe technology should be easy - that's why we often set ourselves challenges to make things as simple as possible and that's why we set ourselves a target for helping you to get bemokoLive installed in 5 minutes. We want you to be up and running with zero pain. In a short while you'll have bemokoLive installed and be ready to start creating some fantastic looking mobile web sites.

Assumptions

This guide assumes that you installing bemokoLive 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 bemokoLive installation, other than the localhost examples below.

The guide also assumes that you have Java installed. If it is not installed then read this.

Installing bemokoLive

Download bemokoLive - whilst it's downloading please read the evaluation agreement and ensure you're happy with the Ts & Cs.

When bemokoLive is downloaded, unpack the zip file to a directory of your choice. Open up a command line (e.g. DOS window) or terminal on your machine, change to the directory where you unpacked the zip file and run:

Note that the $ above is the command line prompt, please do not enter the $ symbol.

Running this command will run bemokoLive and automatically open the welcome page http://localhost:8080/live/welcome/i. 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 bemokoLive 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.

Appendix : Configuration Options

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.

Appendix : Troubleshooting

Java Installation

bemokoLive requires Java to be pre-installed. To verify whether you have Java installed OK, use the command prompt and check that you have a java 6 installed. See here if you are unfamiliar with using the command prompt on your machine.

Output should look something like

java version "1.6.0_07"
Java(TM) SE Runtime Environment (build 1.6.0_07-b06-153)
Java HotSpot(TM) 64-Bit Server VM (build 1.6.0_07-b06-57, mixed mode)

If you don't have Java installed you can download the JRE (Java SE Runtime Environment) from here.

Further Reading

See installing bemokoLive for details on installing bemokoLive in other environments. In particular if you want to install bemoko on Tomcat see Quick Installation - Tomcat.