[[TracNav(TOC)]]

= How-To and FAQ =

 * '''Q: Using ''automake'' I get an error message "directory should not contain /" - what can I do?'''

   A: Probably you have an outdated automake version installed, we have seen such problems with 1.7.9. Upgrade to at least 1.10.1.

 * '''Q: While installing rasdaman I find out, during ''./configure'', that some further packages are required. Can you give a summary of these?'''

   A: Besides the standard ones which should be available on any vanilla Linux, it is this list:  ''g++ 4.x, make, git-core,  autoconf, libtool, gawk, flex, bison, [http://packages.debian.org/en/lenny/libreadline5-dev libreadline-dev], [http://www.postgresql.org postgresql 8.3.x], [http://packages.debian.org/en/lenny/libecpg-dev libecpg-dev], [https://cds.sun.com/is-bin/INTERSHOP.enfinity/WFS/CDS-CDS_Developer-Site/en_US/-/USD/ViewFilteredProducts-SingleVariationTypeFilter sun-java6-jdk], libtiff-dev, libjpeg-dev, [http://packages.debian.org/en/lenny/libhdf4g-dev libhdf4g-dev], [http://packages.debian.org/en/lenny/libpng12-dev libpng12-dev], [http://packages.debian.org/en/lenny/libnetpbm10-dev libnetpbm10-dev], libopenssl-devel''.

 * '''Q: Having done all the above, ''./configure'' complains about missing ''curses'' although ''ncurses'' is there.'''

   A: You have run into a [http://bugs.gentoo.org/67481 bug in the ncurses package]; in /usr/lib, manually create symlinks ''libcurses.a -> libncurses.a'' and ''libcurses.so -> libncurses.so''.

 * '''Q: configure complains that some required files, like install-sh, cannot be found.''' 

    A: retry configure after running
{{{
automake --add-missing
}}}

 * '''Q: I get a link error, function ECPGget_connection cannot be found.'''

   A: What appears to have happened is that in PostgreSQL 8.3.0 they removed ECPGget_connection and they have reintroduced it by 8.3.7. So PostgreSQL versions 8.3.0 up to (but excluding) 8.3.7 cannot be used.

 * '''Q: When running the script "create_db.sh", I get the following cryptic error message:'''
      {{{ Creating base RASBASE...Warning/error in AdminIf Connect: }}}

      {{{ SQLSTATE: 08001 SQLCODE: -402}}}

   A: Please login as the user owning the postgresql processes, and run the same command. Use '''only''' that user for further work with rasdaman. If you use Ubuntu and installed postgres with apt-get, then you should probably login as user '''postgres'''. ( The problem is that the postgres db does not allow full access to rasdaman tools, because they do not run under the administrative user that launched the db server process. )

   A: Another cause of the problem might be that postgres does not allow incoming connections. If you have Postgres v8 or more recent, please modify file "postgresl.conf", and set (uncomment) the option 
     {{{ listen_addresses = 'localhost' }}}
If you have Postgres v7, please set (uncomment) the following option:
     {{{ tcpip_socket = true }}}