Skip to content
Fetching contributors…
Cannot retrieve contributors at this time
141 lines (101 sloc) 4.66 KB

The NorthScale Server

This application represents the top of the hierarchy of all memcached smart services. It is an application in the Erlang OTP sense.

[ns server]


Build dependencies include...

  • erlang (5.7.4, also needed at runtime)
  • ruby (1.8.6)
  • ruby gems
    • sprockets (install with gem install sprockets)


git clone
cd ns_server


Before you start the server, you may need to do the following

  • Below, is where you checked out and built ns_server above.
  • Make sure the needed ports are not being used (these include 8080, 11211, 11212, etc).
  • UNIX ** Build the "for_release" branch of northscale memcached that has isasl enabled (git clone && cd memcached && git checkout --track origin/for_release && ./config/ && ./configure --enable-isasl && make && make test).

    ** Build the bucket_engine library from the repository. (git clone && cd bucket_engine && ./configure --with-memcached=/path/to/your/above/dir/for/memcached/ && make && make test)

    ** Create a sym link from the for_release northscale memcached that you just built to /priv/memcached ** Create a sym link from the for_release northscale memcached memcached/.libs/ to /priv/ ** If your sym links are correct, you should be able to cd /priv and run (just to test):

/.memcached -p 11211 -d -P /tmp/ -E -e "admin=_admin;;default_bucket_name=default

NOTE: the emoxi tests will run this from ../../priv - you do not have to 
manually run memcached.

then kill your test memcached:

kill cat /tmp/

The build process, when running 'make test', will start memcached
in this manner to ensure the test succesfully runs.

* Windows:
** To make life easy, use the appropriate binary from the Northscale website. Install 
   it in /c/memcached
** If you insist on building memcached on windows, read the README file in the 
   buildbot-internal repository for instructions
** Copy  memcached.exe and into the ./priv directory
** If your copying was correct, you should be able to cd <REPO_ROOT>/priv
and run (just to test):

/.memcached -p 11211 -E &

** Kill memcached:

taskkill //F //PID tasklist.exe |grep memcached|awk '/^(\w+)\W+(\w+)/ {print $2}'

  • If you're not employing the use of sym links, instead make sure that the memcached/.libs/ and bucket_engine/.libs/ created when building the for_release northscale memcached and bucket_engine are in the same directory as the memcached executable either by copying or by soft links. For the buildbot machines, these shared libraries are not installed system-wide because they could intefere with the state of the build machine.
  • Just a general note, if you are making changes to the priv/config file and these changes don't appear to be reflected in the start up procedures, try deleting the /config dir.

The ns_server can be started through the script found in the main directory.


It starts under sasl, which will give you more detailed logging on both progress and failures of the application and the heirarcy.

Interactive Execution

If you'd like to just start a shell, then interact with the running application, use:


To start with a different node name, and pass parameters (such as a different config file), use:

./ -name $NODE_NAME -ns_server ns_server_config "$CONFIG_FILE"

For example:

./ -name ns_2 -ns_server ns_server_config "priv/config2"

Tip: if you see error message like...

=ERROR REPORT==== 18-Jan-2010::10:45:00 ===
application_controller: bad term: priv/config2

Then you will have to add backslashes around the path double-quotes -- like \"priv/config\"


Note: there were previously directions here instructing one to update submodules. Both emoxi and menelaus are now part of ns_server and there is no need to treat them as submodules.

Updating the dependencies (deps subdirectory)

make clean make git commit -m "updated emoxi & menelaus" git push

Copyright (c) 2010, NorthScale, Inc.

Something went wrong with that request. Please try again.