Skip to content

Latest commit

 

History

History
106 lines (66 loc) · 2.49 KB

install.md

File metadata and controls

106 lines (66 loc) · 2.49 KB
Raw

Install

Dependencies

U.C.Engine has a few dependencies:

  • make
  • erlang (R14A)
  • yaws
  • mnesia or mongodb
  • eunit (for testing only)

Debian

On Debian systems the following packages should provide the necessary stuff (but do verify you have the minimal erlang version!):

  • erlang
  • erlang-yaws
  • make

To install them, just run this command:

$> aptitude install erlang erlang-yaws make
$> export ERL_LIBS=/usr/lib/yaws/

Ubuntu

Ubuntu is currently shipped with erlang R13B03. You must upgrade to R14B01 unless erl show something like Erlang R14A.

$ sudo apt-get install build-essential libncurses5-dev openssl libssl-dev
$ wget http://www.erlang.org/download/otp_src_R14B01.tar.gz
$ tar xvzf otp_src_R14B01.tar.gz
$ cd otp_src_R14B01
$ ./configure && make && sudo make install

And then install U.C.Engine dependencies:

$> aptitude install erlang yaws make
$> export ERL_LIBS=/usr/lib/yaws/

Fedora Core 14

Fedore Core 14 comes with Erlang R14B02 and Yaws 1.89. Install them wih:

$> yum install erlang yaws yaws-devel

Make sure the full path of yaws is set:

$> export ERL_LIBS=/usr/lib/erlang/lib/yaws

Mac OS X

MacPorts

$> sudo port selfupdate
$> sudo port install erlang +ssl yaws
$> sudo port load yaws
$> export ERL_LIBS=/opt/local/lib/yaws/

Homebrew

$> brew install erlang yaws
$> export ERL_LIBS=/usr/local/Cellar/yaws/1.88/lib/yaws

Get the source code

Once you are sure to have all the dependencies installed on your system, retrieve the source code from our github repository:

$> git clone git://github.com/AF83/ucengine.git
$> cd ucengine

Run the server

Then build the server:

$> make rel
$> cd rel/ucengine
$> ./bin/ucengine start

Now your U.C.Engine instance is running, go to localhost:5280.

You can copy rel/ucengine to other folder or server without problems and discard the git repository.

Inject some data

If you want to play with U.C.Engine, you can start the demo with some data (meetings, users, ...).

$> cd rel/ucengine
$> ./bin/demo.sh localhost

It will create three meetings:

  • demo
  • demo2
  • agoroom

And few users:

  • an admin user (username: root, pwd: root)
  • a default user (username: participant, pwd: pwd)

Further reading

  • Control U.C.Engine with [[ucengine-admin]]
  • Start the tutorial, [[playing with API and command line tool|tutorial_1_api_cli]]