Troubleshooting

GETTING HELP

1. Refer to the documentation on this page
2. Check the issues page to see if a fix is in development
3. Ask the support community

POSTGRES ERRORS

FATAL: Peer authentication failed for user "postgres"

Solution

1. Change settings in pg_hba.conf from "peer" to "trust"
2. Restart postgres

Background

When postgres is first installed on most systems, it defaults to highly restrictive security settings that prevent the postgres user from having full access. To setup Zephyr, the postgres user needs access to create the hstore extension and add new db users.

FATAL: hstore extension not installed

Solution

1. Install postgres contribs package
2. Restart postgres

Background

Hstore is a contrib package extension and is not installed by default with postgresql-server.

ERLANG / REBAR ERRORS

General Errors

If you see a rebar error during make, it's likely one of three things

1. Erlang version is too old
2. Necessary build tools are not installed
3. Old version of Erlang is conflicting with symlinks of new version

Check which version of Erlang/OTP you have installed by starting the Erlang shell with erl ...

$ erl
Erlang R15B03 (erts-5.9.3) [source] [64-bit] [smp:8:8] [async-threads:0] [hipe] [kernel-poll:false] [dtrace]

Eshell V5.9.3  (abort with ^G)
1> 

If you don't see R15B03 or later, then you need to upgrade Erlang.

Follow the steps in the Install Guide to install the correct version.

If you have the correct version of Elrang, make sure you have installed development tools needed to compile C extensions used by Erlang.

# yum
su yum groupinstall "Development Tools"

# apt
sudo apt-get install build-essential

Error: unable to generate spec file

./rebar generate
==> rel (generate)
ERROR: Unable to generate spec: read file info /usr/lib/erlang/man/man1/gserialver.1.gz failed
ERROR: Unexpected error: rebar_abort
ERROR: generate failed while processing /home/user/zephyr/cloudstore/rel: rebar_abort
make[1]: *** [generate] Error 1
make[1]: Leaving directory `/home/user/zephyr/cloudstore'
make: *** [all] Error 2

This is most likely caused by an old version of Erlang conflicting with your newly installed version.

Solution

Divert the offending files.

Yeah. Annoying, but it works. You may have to divert multiple files. Just keep diverting and retrying.

CRASHES ON ZEPHYR START

Zephyr's Erlang components use rebar to manage dependencies. If a component crashes on startup, try deleting the component's deps directory, rerunning make, and then starting up the component.

rm -rf cloudstore/deps
make
script/zephyr start