Open Server Platform
Version 0.4
11/1/09
Coyright (C) 2009 Jacob Torrey
Open Server Platform (OSP) is an open source (MIT License) project to make it easier to create secure,
multi-threaded servers that can be distributed (onto the cloud even). You can find more information
about OSP at http://www.openserverplatform.com. The main repository is on Google Code, but since SVN
is such a nightmare to use, the bleeding edge code will be kept here, and push to Google every time
something big happens.
Introduction
Welcome to OSP! Hopefully you'll find it as exciting as we do! Let's
get started then, shall we?
Requirements
Before you can get started, you'll need a few dependancies installed:
-> erlang (HiPE or regular (HiPE reccomended)
-> The XML::Simple perl module
-> Netcat
Starting OSP
Once you have the OSP environment downloaded, edit the include/osp.conf and run:
./bin/osp_ctl start
This will start an OSP instance on the local machine prepared to server
code to remote nodes and running the Mnesia shared state database. It will
also start the administrator console listening on port 9876. Once this script
is complete, telnet to 127.0.0.1 on port 9876. You are now in the admin
console for OSP, from whence you can see stats about the current system, add
other nodes to the OSP cluster, and manage running applications.
In addition to the telnet interface, there is a CLI script in ./bin that
provides a more scriptable interface to the OSP cluster.
As of version 0.4, there is also a web management console which can be
found at http://localhost:9877 that provides a more user friendly management
interface.
Adding other nodes
To add other diskless nodes (nodes without a copy of OSP, just copy
join.sh to each machine and edit it to reflect your setup. Before running the
join script, type 'add-diskless-ip <ip of joining machine>' on the OSP admin
console. Now you can run the join script and on the OSP admin console, when
you run 'stats', you should see your new node.
To add nodes that have a local copy of OSP, just edit the join script
to point to the other nodes and run it. It will automatically detect if there
is a local copy of OSP and use that one.
Starting applications
To start applications, connect to the admin console and type 'start
<app name> <port #> <node name>'. If you want to run an application on the
master server, start it on that one first. If you are starting an application
on remote machine, you must ensure that it resides on that machine, or if it is
a diskless node, that the compiled application is on the master code server.
