| Verantwortung | TVLuke |
| Container | redmine |
| W. Ports | keine |
| OS | Debian 10.11 |
| Server | magrathea |
| Zustand | Produktiv |
Hier findet sich die technische Dokumentation des Chaotikum Redmines. Die Nutzungshinweise finden sich hier.
Das redmine ist auf Magrathea installiert. Der Container heißt redmine.
Der Reverse-Proxy ist im Container web. Die Requests nimmt das Redmine im redmine container entgegen.
Das Redmine liegt in /srv/redmine/ (das ist aber nur ein Symlink, eigentlich liegt dort ein Ordner mit der aktuellen Version, der daneben in /srv liegt).
☝Obacht: Damit ist unsere Installation etwas anders als jene, die in vielen Tutorials beschrieben wird, die von cd /var/www/redmine ausgeht. Darauf also immer aufpassen, wenn man Tutorials oder Anleitungen nutzt und Befehle nicht unbedacht kopieren. |
|---|
Wir nutzen Redmines native LDAP Anbindung, welche von Administratoren eingerichtet werden kann.
In der Redmine Admin oberfläche ist die LDAP-Verbidung eingetragen. Redmine nutzt den LDAP admin account. Es scheint möglich dort einen filter einzutragen, es ist keiner Eingetragen. Laut Einstellung werden *uid*, *givenName*, *sn* und *mail* aktuel genutzt. Hier könnten aber ggf auch andere genutzt werden.
Filter:
(&(objectClass=Person)(memberOf=cn=freigeschaltet,ou=groups,dc=chaotikum,dc=org))
Redmine unterstützt Plugins. Nicht alle Plugins unterstützen Redmine 4 darauf ist also zu achten.
Ein Plugin wird installiert, indem man es (meist als zip oder so) in den /srv/redmine/plugins/ ordner legt, dort entpackt. Dann muss man aus dem /srv/redmine/ Verzeichnis den
bundle install --without development test rmagick --no-deployment
| ☝Obacht: in den meisten Tutorials wird nicht auf rmagick verzichtet. Wir haben aber kein ImageMagick. |
|---|
bundle exec rake redmine:plugins NAME=[PLUGIN NAME] RAILS_ENV=production
Manche Plugins sind da auch weniger spezifisch und sagen stattdessen
bundle exec rake redmine:plugins RAILS_ENV=production
Was nötig ist, hängt ggf. auch einfach vom Plugin ab oder so…
nun den Service neu starten
systemctl restart redmine systemctl status redmine
Grundsätzliche Anleitung zur Plugin (un)instalation hier
Redmine kann mit Themes hübscher gemacht werden.
Backup kann man wie unter diesem Link beschrieben durchführen, das heißt, die Attachments und die db müssen separat voneinander gesichert werden.
Dafür wird der Ordner /srv/redmine/files kopiert und gesichert und mit dem Befehl
/usr/bin/pg_dump -U redmine -h postgres.chaotikum.net -Fc --file=redmine.sqlc redmine
(Passwort nötig) der Datenbank Server gesichert. Das Redmine nutzt unsere Postgres-DB im Postgres Container.
Wie man Updatet beschreibt Redmine hier. Natürlich sollte man das nur nach einem Backup machen.
Update auf 4.0.3 wurde folgendermaßen gemacht:
cd /srv wget https://www.redmine.org/releases/[AKTUELLE VERSION].tar.gz tar -xvzf [AKTUELLE VERSION].tar.gz
Sidenote: An dieser Stelle muss man ggf ein Distro-Versionsupdate machen und vielleicht ist auch das Ruby zu alt und danach fliegt einem evtl. auch uWSGI um die Ohren. Man denke an apt install uwsgi-plugin-rack-ruby2.3 (Die version muss ggf (Wir haben keine Ahnung was hier los ist) zur Version im vendor Ordner des Redmine passen oder so… Echt, kein Plan.).
Wir haben tatsächlich kein ImageMagick, also
bundle install --without development test rmagick
Auch beim nächsten Schritt kann es zu Problemen bzgl der ruby version kommen. Das liegt an der generierten „Gemifile.lock“ und der Tatsache, dass ggf mehr als ein Ruby auf dem System ist.
bundle exec rake generate_secret_token
DB Update
bundle exec rake db:migrate RAILS_ENV=production
Clear Cache
bundle exec rake tmp:cache:clear RAILS_ENV=production
nun den Symlink neu setzen auf den aktuellen Ordner aus /srv
rm redmine ln -s redmine-[Version] redmine
nun den service neu starten
systemctl restart redmine systemctl status redmine
das log findet sich unter
/var/log/uwsgi/app/redmine.log
Dort kann man nun ggf nachsehen, warum das nicht läuft.
Um auf der Konsole mit dem Redmine zu interagieren muss man (im redmine Ordner) eine Rails-Konsole öffnen, dafür
RAILS_ENV=production bin/rails c
Dann kann man so spannende Dinge tun
User.all
User.find_by_login ('tvluke')
Auf den Container können alle Leute, die auf Magrathea können, dies ist andernorts dokumentiert. Alle diese Menschen können sich (oder anderen) über die Rails-Konsole Admin Rechte verschaffen.
In das Textfeld einfach das Datum der Wartung eintragen, am besten in der Form yyyy-mm-dd.
Du besitzt nicht die Benutzerrechte um Seiten hinzuzufügen.Wird nicht mehr ergänzt. Wartungslogs werden stattdessen genutzt.
# TODO: Remove the following line when #32223 is fixed gem "sprockets", "~> 3.7.2"
[Unit] Description=redmine After=syslog.target network.target [Service] Type=simple WorkingDirectory=/srv/redmine Environment=RAILS_ENV=production ExecStart=/usr/local/bin/bundle exec rails s -p 80 Restart=always [Install] WantedBy=multi-user.target
Magu würde sich wünschen das nach Möglichkeit das redmine aus Debian bezogen wird. Vorteile es gibt Updates und s würde das Upgrade erleichtern.
— Martin Gummi 19.05.2019 13:21
Processing by ProjectsController#settings as HTML
Parameters: {"id"=>"vorstandsarbeit"}
Current user: tvluke (id=28)
Rendering projects/settings.html.erb within layouts/base
Rendered projects/_form.html.erb (15.4ms)
Rendered projects/_edit.html.erb (17.1ms)
Rendered common/_tabs.html.erb (22.6ms)
Rendered projects/settings.html.erb within layouts/base (48.5ms)
Missing template, responding with 404: Missing partial projects/_project_color_form with {:locale=>[:de, :en], :formats=>[:html], :variants=>[], :handlers=>[:raw, :erb, :html, :builder, :ruby, :rsb]}. Searched in:
* "/srv/redmine-4.0.3/plugins/redmine_theme_changer/app/views"
* "/srv/redmine-4.0.3/plugins/redmine_agile/app/views"
* "/srv/redmine-4.0.3/app/views"
Rendering common/error.html.erb within layouts/base
Rendered common/error.html.erb within layouts/base (0.5ms)
Das Problem ist wohl https://www.redmineup.com/questions/216-agile-plugin-not-working das agile plugin muss also geupdated werden (oder weg)
/srv/redmine-4.0.3/tmp und /srv/redmine-4.0.3/files haben Probleme mit ihren rechten, das muss alles per hand und ist recht doof. Aber scheint zu tun.redmine/vendor installiert sondern global, sonst kann uswgi sie nicht sehen. Redmine läuft wieder./home/backupZustand (18.05.2019): Redmine version ist von 2015 (3.0.4), debian ist noch Version 8.