Abstract: An overview of the the process involved in installing Erlang, and Riak on OSX and others - using Kerl, Homebrew, and package managers - this document is intended for a developer audience, for casual OSX users - just run brew install erlangand let the package manager do all the work for you. Riak bundles it's own Erlang VM, so if that's all you want just download the Riak package from the Basho website, no further work required.
#Stage 1 (Setup chores)
- unixodbc
brew install unixodbc - gcc
brew install gcc - openssl -
brew install openssl
And, now from Erlang 18 and El Capitain onward, there is yet another step to getting a build, ommit this, and Erlang silently compiles without the crypto module. I guess it's better than compiling with a broken crypto module, all things considered. See this issue for more info.
brew link --force openssl
It's also worth noting that kerl throws away the environment when building Erlang releases, the only way to pass those crucial build flags to automake and friends is to add them to the ~/.kerlrc file. At a minimum the ~/.kerlrc should contain the following:
export KERL_CONFIGURE_OPTIONS="--disable-hipe --enable-smp-support --enable-threads --enable-kernel-poll --enable-darwin-64bit --with-ssl=/usr/local"
export CFLAGS="-DOPENSSL_NO_EC=1"
- PAM devel headers/libs
apt-get install libpam0g-dev
- PAM devel headers/libs
yum install pam-devel
There may be other requirements, let me know if you needed to install anything else.
I put all my non-company github repositories under /common, follow these steps to set it up.
And I need the right directories and perms configured
sudo mkdir -p /common
sudo chown $(whoami) /common
cd /common/
git clone [email protected]:kerl/kerl.git
updated - kerl can now be installed on OSX using brew install kerl
You can add kerl to your path by twidling your ~/.profile file, something like the following should do the job:
export PATH=$PATH:$HOME/bin
Then create the ~/bin directory and symlink ~/bin/kerl directly to /common/kerl/kerl
#Stage 2 (Building an Erlang)
Ok, this is going well. Lets list the releases:
[~%]kerl list releases
17.0-rc1 17.0-rc2 R10B-0 R10B-10 R10B-1a R10B-2 R10B-3 R10B-4 R10B-5 R10B-6 R10B-7 R10B-8 R10B-9 R11B-0 R11B-1 R11B-2 R11B-3 R11B-4 R11B-5 R12B-0 R12B-1 R12B-2 R12B-3 R12B-4 R12B-5 R13A R13B R13B01 R13B02-1 R13B02 R13B03 R13B04 R14A R14B R14B01 R14B02 R14B03 R14B04 R14B_erts-5.8.1.1 R15B R15B01 R15B02 R15B02_with_MSVCR100_installer_fix R15B03-1 R15B03 R16A_RELEASE_CANDIDATE R16B R16B01 R16B02 R16B03-1 R16B03
You can run kerl update releases to update this list from erlang.org
Build and install a bunch of different versions.
[~%]kerl build 17.0-rc2 17.0-rc2
kerl build R15B01 R15B01
kerl build R15B02 R15B02
kerl build R15B03 R15B03
kerl build R16B03 R16B03
kerl install 17.0-rc2 /erls/17.0-rc2
kerl install R15B01 /erls/r15b01
kerl install R15B02 /erls/r15b02
kerl install R15B03 /erls/r15b03
kerl install R16B03 /erls/r16b03
Ok, now we've got a bunch of different versions installed.
It is tiresome to create activation aliases for each version of Erlang installed by Kerl. It would be much nicer if the aliases were somehow automatically generated.
Create a ZSH function which will deactivate the prior Erlang version if it is enabled, and enable the current version.
cat <<"EOF" > ~/.zshrc.kerl
setopt extendedglob
function __kerlang() {
if [[ $( type -w kerl_deactivate ) =~ "none" ]]; then
source $1
else
kerl_deactivate
source $1
fi
}
kerl list installations | while read i j ; do alias activate_$i="__kerlang ${j}/activate" ; done
EOF
Ensure it is sourced from your ~/.zshrc file
grep "source ~/.zshrc.kerl" ~/.zshrc || echo 'source ~/.zshrc.kerl' >> ~/.zshrc
Create a new terminal or shell to get your fresh ~/.zshrc* loaded, and lets try it out.
basho-catah% activate_r15b01
basho-catah% erl
Erlang R15B01 (erts-5.9.1) [source] [smp:4:4] [async-threads:0] [hipe] [kernel-poll:false]
Eshell V5.9.1 (abort with ^G)
1>
BREAK: (a)bort (c)ontinue (p)roc info (i)nfo (l)oaded
(v)ersion (k)ill (D)b-tables (d)istribution
^C%
basho-catah% activate_r16b03-1
basho-catah% erl
Erlang R16B03-1 (erts-5.10.4) [source] [64-bit] [smp:4:4] [async-threads:10] [hipe] [kernel-poll:false]
Eshell V5.10.4 (abort with ^G)
#Step 4 (building Riak)
git clone [email protected]:basho/riak.git
cd riak
activate_r15b03 #or without zsh helper . /erls/r15b03/activate
git checkout riak-1.4wip -b riak-1.4wip
make devrel NODES=5
git clone [email protected]:basho/riak.git
cd riak
activate_R16B03 #or without zsh helper . /erls/R16B03/activate
git checkout develop
make devrel NODES=5
Increase the ulimit
ulimit -n 65000
(ZSH) Start each of the Riak instances
for i in ./dev/dev[1-5]/bin/riak(:h) ; do $i/riak start ; done
Or... (bash) start each of the Riak instances
./dev/dev1/bin/riak start
./dev/dev2/bin/riak start
./dev/dev3/bin/riak start
./dev/dev4/bin/riak start
./dev/dev5/bin/riak start
- Split into different guides
- Check for typo's and mixspelt words