bin/osp_ctl ebin/osp.app include/conf.hrl include/httpd.conf log/.gitignore src/Makefile src/osp.erl src/osp_admin.erl src/osp_app.erl src/osp_broker.erl src/osp_file.erl src/osp_mnesia.erl src/osp_proto.erl src/osp_socket.erl src/osp_sup.erl src/osp_web.erl www/index.html www/jquery.js www/style.css @@ -1,7 +1,7 @@ Open Server Platform Admin Guide -Version 0.3 -5/2/09 -Coyright 2008 Jacob Torrey +Version 0.4 +5/4/09 +Coyright 2009 Jacob Torrey Introduction Welcome to OSP! Hopefully you'll find it as exciting as we do! Let's @@ -11,15 +11,11 @@ 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 osp.conf and run: - ./setup-osp.sh - - This will setup the Mnesia redundant data store on the node (run this once) - - Now you can run the following command to start the node: - ./start-osp.sh + ./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 @@ -27,6 +23,11 @@ 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 OSP-ADMIN @@ -18,7 +18,7 @@ my $cookie = <STDIN>; chomp($cookie); open(FP, ">$output"); print FP "#!/bin/bash\n\nNODENAME=\"$name\"\nBOOTSERVER=\"$server\"\nFQDN=$fqdn # Use FQDN for node name: 0 for false, 1 for true\nMASTERNODE=\"$master\"\n"; print FP "COOKIE=\"$cookie\"\nNAME=\"-sname\"\nif [ \$FQDN -eq 1 ]\nthen\n\tNAME=\"-name\"\nfi\n"; -print FP "LOADER=\"-loader inet -hosts\"\nif [ -a \"osp.beam\" ]\nthen\n\tLOADER=\"\"\n\tBOOTSERVER=\"\"\nfi\nepmd -daemon\nerl -noshell -detached \$NAME \$NODENAME -id \$NODENAME \$LOADER \$BOOTSERVER -setcookie \$COOKIE -s osp join \$MASTERNODE\n"; +print FP "LOADER=\"-loader inet -hosts\"\nif [ -a \"osp.beam\" ]\nthen\n\tLOADER=\"\"\n\tBOOTSERVER=\"\"\nfi\nepmd -daemon\nerl -noshell -detached \$NAME \$NODENAME -id \$NODENAME \$LOADER \$BOOTSERVER -pa ./ebin -setcookie \$COOKIE -s osp join \$MASTERNODE\n"; close(FP); `chmod +x $output`; print "\nRun ./join.sh to join an existing OSP cluster\n"; gen-join.pl @@ -20,6 +20,10 @@ proto() -> PROTO. +%% @doc Opens a file for reading or writing +fopen(Filename, Flags) -> + osp_file:fopen(MOD, Filename, Flags). + %% @doc Stores a value in the mnesia database store(Key, Val) -> osp_mnesia:store(MOD_table, Key, Val). header.erl @@ -22,4 +22,4 @@ then fi epmd -daemon -erl -noshell -detached $NAME $NODENAME -id $NODENAME $LOADER $BOOTSERVER -setcookie $COOKIE -s osp join $MASTERNODE +erl -noshell -detached $NAME $NODENAME -id $NODENAME $LOADER $BOOTSERVER -pa ./ebin -setcookie $COOKIE -s osp join $MASTERNODE join.sh.sample @@ -1,4 +1,5 @@ #!/bin/bash echo "Setting up OSP" -erl -smp auto -detached -run osp setup +epmd -daemon +erl -smp auto -detached -pa ./ebin -run osp setup setup-osp.sh @@ -1,6 +1,10 @@ #!/bin/bash -echo "Starting OSP" +echo "Starting Open Server Platform" +echo "v0.4 (C) 2009 Jacob Torrey" +echo "http://www.openserverplatform.com" epmd -daemon -erl -smp auto -run osp -detached -echo "OSP started, telnet to the localhost management port (default 9876) to continue" +erl -smp auto -detached -boot osp_rel-0.4 -pa ./ebin +sleep 10 +echo "Open Server Platform started" +echo "Telnet to localhost port 9876 or go to http://localhost:9877 to continue" start-osp.sh osp.conf osp.erl osp_admin.erl osp_app.erl osp_broker.erl osp_mnesia.erl osp_proto.erl osp_socket.erl osp_sup.erl c32487993026bdb7c73268e8a4ed02382f924c51 d38893953165c969087e9d43d6adf64f930da10f Jacob Torrey torreyji@clarkson.edu http://github.com/ranok/open-server-platform/commit/3372897010380dfbbc903a19dd698a0bfc7275fa 3372897010380dfbbc903a19dd698a0bfc7275fa 2009-05-05T13:52:43-07:00 2009-05-05T13:52:43-07:00 Merge branch 'otp' Conflicts: Makefile OSP-ADMIN src/osp_admin.erl start-osp.sh 0f4eecc4fa98fda55c9d589092502238d6dbd0bb Jacob Torrey torreyji@clarkson.edu