update admin_upgrade doc with irods note (#1991)

bihealth · Feb 24, 2025 · 75a4d16 · 75a4d16
1 parent b1e00b9
commit 75a4d16
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/docs_manual/source/admin_upgrade.rst b/docs_manual/source/admin_upgrade.rst
@@ -91,6 +91,11 @@ environment components:
    scripts) to be compatible with the ``env.example`` file of the current
    ``sodar-docker-compose`` release.
 
+- **NOTE:** Make sure ``IRODS_PASS`` and ``IRODS_PASSWORD_SALT`` are set with
+  the same values as in your previous installation. Otherwise iRODS will fail to
+  run after re-importing old databases, as the service user is unable to connect
+  to the ICAT server.
+
 6. Run ``./init.sh`` (or the corresponding command in your deployment scripts)
    to recreate directories.