Installation changes / hints / Troubleshooting; Update documentation

[pkoevesdi]

I had quite some trouble getting this installed in redmine 5.0.6, so I collect some stuff that I had to change in the installation process. Could this be tested and put into the reference docs resp. troubleshooting?

step 1, Debian:

root# apt install build-essential libssh2-1 libssh2-1-dev cmake libgpg-error-dev git ruby-dev pkg-config libssl-dev
(added git ruby-dev pkg-config libssl-dev)

before step 4:

useradd -m git
usermod -p '*' git # otherwise "locked user" error via ssh
nano /etc/passwd #-> change /bin/sh to /bin/bash for git user
cp /home/redmine/ssh_keys/redmine_gitolite_admin_id_rsa.pub /home/git

in step 4:

git$ git clone https://github.com/sitaramc/gitolite
(changed to (https)

Troublehooting:

• https://redmine.nrkt.enerkite.com/settings/plugin/redmine_git_hosting?tab=gitolite_config_test -> "Rugged compiled features" "SSH" red: Probably rugged was installed before redmine-git-hosting, without the flag --with-ssh. To fix:

  su - redmine
  bundle clean --force
  sudo gem uninstall rugged
  bundle config set --local without 'development:test'
  bundle config set --local build.rugged --with-ssh
  bundle install
  systemctl restart apache2
  

• tail -f /usr/share/redmine/log/git_hosting.log throws errors about wrong SSH key while changing gitolite config from inside redmine, see: Invalid or unknown remote ssh hostkey (Rugged?) #822 (comment)

  echo "PubkeyAcceptedAlgorithms +ssh-rsa" > /etc/ssh/sshd_config
  systemctl restart sshd
  

• Internal server error 500 in GUI configuration in redmine_git_hosting:

  ln -s /var/log/redmine/ /usr/share/redmine/log