diff --git a/doc/troubleshooting.md b/doc/troubleshooting.md index e0e4ca42736444c81e01877403869c0257d1fa5c_ZG9jL3Ryb3VibGVzaG9vdGluZy5tZA==..e3b9385cbfa7dddc1644534306047b4d9be85c6a_ZG9jL3Ryb3VibGVzaG9vdGluZy5tZA== 100644 --- a/doc/troubleshooting.md +++ b/doc/troubleshooting.md @@ -82,9 +82,9 @@ reconfigure which produced error similar to: ```plaintext -================================================================================ -Recipe Compile Error in /opt/gitlab/embedded/cookbooks/cache/cookbooks/gitlab/recipes/default.rb -================================================================================ + ================================================================================ + Recipe Compile Error in /opt/gitlab/embedded/cookbooks/cache/cookbooks/gitlab/recipes/default.rb + ================================================================================ NoMethodError ------------- @@ -88,7 +88,7 @@ NoMethodError ------------- -undefined method `[]=' for nil:NilClass +undefined method '[]=' for nil:NilClass Cookbook Trace: --------------- @@ -92,8 +92,8 @@ Cookbook Trace: --------------- - /opt/gitlab/embedded/cookbooks/cache/cookbooks/gitlab/recipes/config.rb:21:in `from_file' - /opt/gitlab/embedded/cookbooks/cache/cookbooks/gitlab/recipes/default.rb:26:in `from_file' + /opt/gitlab/embedded/cookbooks/cache/cookbooks/gitlab/recipes/config.rb:21:in 'from_file' + /opt/gitlab/embedded/cookbooks/cache/cookbooks/gitlab/recipes/default.rb:26:in 'from_file' Relevant File Content: ``` @@ -781,3 +781,18 @@ ``` As a workaround, avoid using underscores in `external_url`. There is an open issue about it: [Setting `external_url` with underscore results in a broken GitLab CI/CD functionality](https://gitlab.com/gitlab-org/omnibus-gitlab/-/issues/6077). + +## Upgrade fails with `timeout: run: /opt/gitlab/service/gitaly` error + +If the package upgrade fails when running reconfigure with the following error, +check that all Gitaly processes are stopped and then rerun `sudo gitlab-ctl reconfigure`. + +```plaintext +---- Begin output of /opt/gitlab/embedded/bin/sv restart /opt/gitlab/service/gitaly ---- +STDOUT: timeout: run: /opt/gitlab/service/gitaly: (pid 4886) 15030s, got TERM +STDERR: +---- End output of /opt/gitlab/embedded/bin/sv restart /opt/gitlab/service/gitaly ---- +Ran /opt/gitlab/embedded/bin/sv restart /opt/gitlab/service/gitaly returned 1 +``` + +Refer to [issue 341573](https://gitlab.com/gitlab-org/gitlab/-/issues/341573) for more details.