Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

DOCS: add help for quicksetup fails in intro #4838

Merged
5 changes: 5 additions & 0 deletions docs/source/intro/install_conda.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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<intro:troubleshooting:installation:postgresql-autodetect-issues>`.

---

**Check setup**
Expand Down
5 changes: 5 additions & 0 deletions docs/source/intro/install_system.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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<intro:troubleshooting:installation:postgresql-autodetect-issues>`.

---

**Start verdi daemons**
Expand Down
1 change: 1 addition & 0 deletions docs/source/intro/installation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -176,6 +176,7 @@ The following parameters can be configured:
+--------------+---------------------------+---------------+-------------------------------------------------------------------------------------------------------------------------+


.. _intro:install:verdi_setup:

verdi setup
-----------
Expand Down
15 changes: 15 additions & 0 deletions docs/source/intro/troubleshooting.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
-------------------

Expand Down Expand Up @@ -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<intro:install:database>`).
2. Then run the full ``verdi setup`` command (see :ref:`here<intro:install:verdi_setup>`).

ramirezfranciscof marked this conversation as resolved.
Show resolved Hide resolved

RabbitMQ Installation (Unix)
.............................

Expand Down