Developers HOWTO (ocs)

How to do specific things with the ocs project.

1 Build a Release
2 Access the Erlang CLI shell

Build a Release

The complete procedure to get, build and test SigScale’s ocs project is as follows:

~$ git clone https://github.com/sigscale/ocs.git
~$ cd ocs
~/ocs$ aclocal; autoheader; autoconf; libtoolize --automake; automake --add-missing
~/ocs$ mkdir ../ocs.build
~/ocs$ cd ../ocs.build
~/ocs.build$ mkdir -p shell/lib
~/ocs.build$ ERL_LIBS=`pwd`/shell/lib ERLANG_INSTALL_LIB_DIR=`pwd`/shell/lib ../ocs/configure
~/ocs.build$ ERL_LIBS=`pwd`/shell/lib make install
~/ocs.build$ ERL_LIBS=`pwd`/shell/lib make check

Access the Erlang CLI shell

The command line interface (CLI) may be reached in a few ways. The recommended method is to start a local Erlang node, connect to the running node and run a remote shell. This can be accomplished with the following command at a Linux shell:

erl -sname $LOGNAME -hidden -remsh ocs@`hostname`

You may need to first install a copy of the running node’s cookie which you can do with:

touch ~/.erlang.cookie
sudo cp /home/otp/.erlang.cookie ~/
chmod 400 ~/.erlang.cookie

Once at the Erlang CLI shell lines are terminated by the . (period) character. For more information see chapter 2.2 of the Getting Started with Erlang User’s Guide.

To quit type ^G (control-G) and then at the next > prompt type q and enter.