From 9eb8c7f3d074c779409c982ce4dd80c74c8ae52c Mon Sep 17 00:00:00 2001 From: Juan Pardo Date: Thu, 5 Nov 2026 11:28:16 +0100 Subject: [PATCH 1/5] Main cratedb-ee docs files --- cratedb-ee-docs/make.bat | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 cratedb-ee-docs/make.bat diff --git a/cratedb-ee-docs/make.bat b/cratedb-ee-docs/make.bat new file mode 100644 index 0000000..32bb245 --- /dev/null +++ b/cratedb-ee-docs/make.bat @@ -0,0 +1,35 @@ +@ECHO OFF + +pushd %~dp0 + +REM Command file for Sphinx documentation + +if "%SPHINXBUILD%" == "" ( + set SPHINXBUILD=sphinx-build +) +set SOURCEDIR=. +set BUILDDIR=_build + +%SPHINXBUILD% >NUL 2>NUL +if errorlevel 9009 ( + echo. + echo.The 'sphinx-build' command was not found. Make sure you have Sphinx + echo.installed, then set the SPHINXBUILD environment variable to point + echo.to the full path of the 'sphinx-build' executable. Alternatively you + echo.may add the Sphinx directory to PATH. + echo. + echo.If you don't have Sphinx installed, grab it from + echo.https://www.sphinx-doc.org/ + exit /b 1 +) + +if "%1" == "" goto help + +%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% +goto end + +:help +%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% + +:end +popd From 033dc203590507f40c23b02cd6f31edbd6d8e32b Mon Sep 17 00:00:00 2001 From: Juan Pardo Date: Thu, 5 Nov 2026 11:28:30 +0100 Subject: [PATCH 2/5] cratedb-ee-docs readthedocs.yaml --- cratedb-ee-docs/.readthedocs.yml | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 cratedb-ee-docs/.readthedocs.yml diff --git a/cratedb-ee-docs/.readthedocs.yml b/cratedb-ee-docs/.readthedocs.yml new file mode 100644 index 0000000..f39c639 --- /dev/null +++ b/cratedb-ee-docs/.readthedocs.yml @@ -0,0 +1,15 @@ +build: + os: "ubuntu-22.04" + tools: + python: "3.11" + +sphinx: + builder: html + configuration: ./conf.py + fail_on_warning: true + +python: + install: + - requirements: ./requirements.txt + +version: 2 From bd8010296ba259501fc529f312dfdcf186dea674 Mon Sep 17 00:00:00 2001 From: Juan Pardo Date: Thu, 5 Nov 2026 14:52:25 +0100 Subject: [PATCH 3/5] Readthedocs rename --- cratedb-ee-docs/.readthedocs.yml | 15 --------------- 1 file changed, 15 deletions(-) delete mode 100644 cratedb-ee-docs/.readthedocs.yml diff --git a/cratedb-ee-docs/.readthedocs.yml b/cratedb-ee-docs/.readthedocs.yml deleted file mode 100644 index f39c639..0000000 --- a/cratedb-ee-docs/.readthedocs.yml +++ /dev/null @@ -1,15 +0,0 @@ -build: - os: "ubuntu-22.04" - tools: - python: "3.11" - -sphinx: - builder: html - configuration: ./conf.py - fail_on_warning: true - -python: - install: - - requirements: ./requirements.txt - -version: 2 From 90eec8ee79816edd4493c26428ac760b9c277daf Mon Sep 17 00:00:00 2001 From: Juan Pardo Date: Mon, 9 Nov 2026 17:57:07 +0100 Subject: [PATCH 4/5] Added a single command to show how to display CrateDB EE Console logs --- cratedb-ee-docs/install/setup.rst | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/cratedb-ee-docs/install/setup.rst b/cratedb-ee-docs/install/setup.rst index 164c01c..b7b2823 100644 --- a/cratedb-ee-docs/install/setup.rst +++ b/cratedb-ee-docs/install/setup.rst @@ -205,6 +205,15 @@ To apply any change to the configuration, the following commands must be execute Troubleshooting ----------------- +Access the CrateDB EE Console logs +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The logs can be explored using the following command: + +.. code-block:: bash + + sudo journalctl --output=with-unit -t cratedb-ee-console + Login failures ~~~~~~~~~~~~~~~~ @@ -215,10 +224,6 @@ The most common issues related to login failures are: - A CrateDB authentication configuration rule is not correct. Look for login issues in the CrateDB logs. -Alternatively, look for login issues in the CrateDB Enterprise Console minter: - -.. code-block:: bash - - journalctl -u systemctl status minter +Alternatively, look for login issues in the CrateDB Enterprise Console logs. Make sure the IP specified in the CrateDB configuration and the IP of the CrateDB Enterprise Console seen by the CrateDB cluster are the same. From 6e2708ed99e103167eafb2c5d2c9eb015c62c835 Mon Sep 17 00:00:00 2001 From: Juan Pardo Date: Fri, 13 Nov 2026 15:36:47 +0100 Subject: [PATCH 5/5] fixup! Added a single command to show how to display CrateDB EE Console logs --- cratedb-ee-docs/make.bat | 35 ----------------------------------- 1 file changed, 35 deletions(-) delete mode 100644 cratedb-ee-docs/make.bat diff --git a/cratedb-ee-docs/make.bat b/cratedb-ee-docs/make.bat deleted file mode 100644 index 32bb245..0000000 --- a/cratedb-ee-docs/make.bat +++ /dev/null @@ -1,35 +0,0 @@ -@ECHO OFF - -pushd %~dp0 - -REM Command file for Sphinx documentation - -if "%SPHINXBUILD%" == "" ( - set SPHINXBUILD=sphinx-build -) -set SOURCEDIR=. -set BUILDDIR=_build - -%SPHINXBUILD% >NUL 2>NUL -if errorlevel 9009 ( - echo. - echo.The 'sphinx-build' command was not found. Make sure you have Sphinx - echo.installed, then set the SPHINXBUILD environment variable to point - echo.to the full path of the 'sphinx-build' executable. Alternatively you - echo.may add the Sphinx directory to PATH. - echo. - echo.If you don't have Sphinx installed, grab it from - echo.https://www.sphinx-doc.org/ - exit /b 1 -) - -if "%1" == "" goto help - -%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% -goto end - -:help -%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% - -:end -popd