Troubleshooting your BigCouch Installation

Ubuntu man Page Issues

The Erlang package on Ubuntu 10.04 LTS is somewhat broken for 2 of the files required in the make install phase. You may encounter the following errors:

ERROR: Unable to generate spec: read file info /usr/lib/erlang/man/man5/modprobe.d.5 failed


ERROR: Untable to generate spec: read file info /usr/lib/erlang/man/man1/gst-xmlinspect-0.10.1 failed

If this happens, panic not, simply replace the two files with their gzip'ed counterparts already on the system like such:

cd /usr/lib/erlang/man/man5
rm modprobe.d.5
ln -s modprobe.conf.5.gz modprobe.d.5

Once you've replaced the modprobe.d.5 file, you can now replace the gst-xmlinspect-0.10.1 file following the same procedure:

cd /usr/lib/erlang/man/man1
rm gst-xmlinspect-0.10.1
ln -s gst-xmlinspect-0.10.1.gz gst-xmlinspect-0.10.1

In some cases there may be other man pages that require symlinking, the above procedure should work in those cases as well adjusting for the filenames.

Additionally in other cases the man page files may be missing, you will need to either install them or simply create empty files in there place.
For instance:

cd /usr/lib/erlang/man/man1
touch gst-xmlinspect-0.10.1.gz

You should now be able to execute make install correctly.

BigCouch fails on startup with a "Can't set long node name!" error

BigCouch requires that your system be set up with a fully qualified domain name. Make sure that the command hostname -f outputs a full hostname. If not, add the full hostname of your server to the /etc/hosts file.