diff --git a/doc/installation/index.md b/doc/installation/index.md index 754e15c9cfb0d05403fdd9dbea29d883f6d4047b_ZG9jL2luc3RhbGxhdGlvbi9pbmRleC5tZA==..d1adc5d613c982ea88f948a547a88f8311013e7b_ZG9jL2luc3RhbGxhdGlvbi9pbmRleC5tZA== 100644 --- a/doc/installation/index.md +++ b/doc/installation/index.md @@ -115,6 +115,7 @@ sudo systemctl disable gitlab-runsvdir sudo rm /usr/lib/systemd/system/gitlab-runsvdir.service sudo systemctl daemon-reload + sudo systemctl reset-failed sudo gitlab-ctl uninstall ``` diff --git a/doc/troubleshooting.md b/doc/troubleshooting.md index 754e15c9cfb0d05403fdd9dbea29d883f6d4047b_ZG9jL3Ryb3VibGVzaG9vdGluZy5tZA==..d1adc5d613c982ea88f948a547a88f8311013e7b_ZG9jL3Ryb3VibGVzaG9vdGluZy5tZA== 100644 --- a/doc/troubleshooting.md +++ b/doc/troubleshooting.md @@ -820,6 +820,17 @@ Refer to [issue 341573](https://gitlab.com/gitlab-org/gitlab/-/issues/341573) for more details. +## Reconfigure is stuck when re-installing GitLab + +Because of a [known issue](https://gitlab.com/gitlab-org/omnibus-gitlab/-/issues/7776), you can see the reconfigure process stuck at +`ruby_block[wait for logrotate service socket] action run` after uninstalling GitLab and trying to install it again. This problem occurs when one of the `systemctl` commands are +not executed when [uninstalling GitLab](installation/index.md#uninstall-the-linux-package-omnibus). + +To resolve this issue: + +- Make sure you followed all the steps when uninstalling GitLab and perform them if necessary. +- Follow the workaround in [issue 7776](https://gitlab.com/gitlab-org/omnibus-gitlab/-/issues/7776). + ## Mirroring the GitLab `yum` repository with Pulp or Red Hat Satellite fails Direct mirroring of the Omnibus GitLab `yum` repositories located at <https://packages.gitlab.com/gitlab/> with [Pulp](https://pulpproject.org/) or