diff --git a/docs/source/intro/install_conda.rst b/docs/source/intro/install_conda.rst index fb0bc101f2..08c99cb938 100644 --- a/docs/source/intro/install_conda.rst +++ b/docs/source/intro/install_conda.rst @@ -84,6 +84,11 @@ This is the recommended method for users on shared systems and systems where the Last name: name Institution: where-i-work + .. admonition:: Is AiiDA unable to auto-detect the PostgreSQL setup? + :class: attention title-icon-troubleshoot + + If you get an error saying that AiiDA has trouble autodetecting the PostgreSQL setup, you will need to do the manual setup explained in the :ref:`troubleshooting section`. + --- **Check setup** diff --git a/docs/source/intro/install_system.rst b/docs/source/intro/install_system.rst index 5df3023a12..2d3bb26dce 100644 --- a/docs/source/intro/install_system.rst +++ b/docs/source/intro/install_system.rst @@ -231,6 +231,11 @@ This is the *recommended* installation method to setup AiiDA on a personal lapto Last name: name Institution: where-i-work + .. admonition:: Is AiiDA unable to auto-detect the PostgreSQL setup? + :class: attention title-icon-troubleshoot + + If you get an error saying that AiiDA has trouble autodetecting the PostgreSQL setup, you will need to do the manual setup explained in the :ref:`troubleshooting section`. + --- **Start verdi daemons** diff --git a/docs/source/intro/installation.rst b/docs/source/intro/installation.rst index 2bc09e1add..4f56897a51 100644 --- a/docs/source/intro/installation.rst +++ b/docs/source/intro/installation.rst @@ -176,6 +176,7 @@ The following parameters can be configured: +--------------+---------------------------+---------------+-------------------------------------------------------------------------------------------------------------------------+ +.. _intro:install:verdi_setup: verdi setup ----------- diff --git a/docs/source/intro/troubleshooting.rst b/docs/source/intro/troubleshooting.rst index f01519e161..d4006c241f 100644 --- a/docs/source/intro/troubleshooting.rst +++ b/docs/source/intro/troubleshooting.rst @@ -19,6 +19,8 @@ If you experience any problems, first check that all services are up and running In the example output, all service have a green check mark and so should be running as expected. If all services are up and running and you are still experiencing problems or if you have trouble with the installation of aiida-core and related services, consider the commonly encountered problems below. +.. _intro:troubleshooting:installation: + Installation issues ------------------- @@ -77,6 +79,19 @@ A way to do it is to add a line similar to the following to the ``~/.bashrc`` an .. _Stackoverflow link: http://stackoverflow.com/questions/21079820/how-to-find-pg-config-pathlink + +.. _intro:troubleshooting:installation:postgresql-autodetect-issues: + +Autodetection of the PostgreSQL setup +..................................... + +Sometimes AiiDA fails to autodetect the local configuration of PostgreSQL when running ``verdi quicksetup``. +In that case try to: + + 1. Create the database manually in PostgreSQL (see :ref:`here`). + 2. Then run the full ``verdi setup`` command (see :ref:`here`). + + RabbitMQ Installation (Unix) .............................