Nettoyage doc Redmine

This commit is contained in:
Victor LABORIE 2017-07-04 18:21:20 +02:00
parent 4d127999ec
commit 02813587c8
8 changed files with 0 additions and 411 deletions

View file

@ -1,41 +0,0 @@
**Cette page a été importée automatiquement de notre ancien wiki mais n'a pas encore été révisée.**
# Mysql
### Prérequis
Installation de [wiki:HowtoMySQL MySQL].
Installation des librairies de développements MySQL
~~~
# aptitude install libmysqlclient-dev
~~~
### Configuration
Création de l'utilisateur et de la base de donnée :
~~~
MYSQLPASS=$(perl -e 'print map{("a".."z","A".."Z",0..9)[int(rand(62))]}(1..16)')
mysql <<EOF
CREATE DATABASE $REDMINE CHARACTER SET utf8;
GRANT ALL PRIVILEGES ON $REDMINE.* TO "$REDMINE"@'localhost' identified by '$MYSQLPASS';
EOF
~~~
Configuration autologin MySQL de l'utilisateur $REDMINE :
~~~
cat > /home/$REDMINE/.my.cnf <<EOF
[client]
user = $REDMINE
password = $MYSQLPASS
EOF
~~~
Correction des droits sur .my.cnf :
~~~
chown $REDMINE: /home/$REDMINE/.my.cnf
~~~

View file

@ -1,49 +0,0 @@
**Cette page a été importée automatiquement de notre ancien wiki mais n'a pas encore été révisée.**
# Suppression de Redmine
Pour supprimer votre installation de redmine, rien de plus simple.
## I. Suppression
Arrêt du service Redmine :
~~~
systemctl stop puma@$REDMINE
~~~
Suppression de l'utilisateur système $REDMINE ainsi que son groupe :
~~~
userdel $REDMINE
groupdel $REDMINE
~~~
Suppression de l'application :
~~~
rm -rf /home/$REDMINE /etc/init.d/redmine_$REDMINE
~~~
## II. Suppression de la base de donnée
* Mysql :
~~~
mysql <<SQL
DROP DATABASE $REDMINE;
DROP USER $REDMINE@localhost;
SQL
~~~
## III. Suppression configuration Web
* Nginx :
~~~
rm /etc/nginx/ssl/redmine_$REDMINE* /etc/nginx/sites-enabled/redmine_$REDMINE /etc/nginx/sites-available/redmine_$REDMINE
nginx -t
if [ $? == 0 ]; then
service nginx reload
fi
~~~

View file

@ -1,63 +0,0 @@
**Cette page a été importée automatiquement de notre ancien wiki mais n'a pas encore été révisée.**
# Migration de votre ancienne installation Redmine
Après avoir finit votre [wiki:HowToRedmine-Source installation].
Se connecter avec l'utilisateur de votre nouveau Redmine :
~~~
su - $REDMINE
~~~
Réaliser un dump SQL de votre ancienne installation :
~~~
ssh votre-serveur-actuel.tld mysqldump database_name > redmine_dump.sql
~~~
Puis stopper votre nouvelle installation :
~~~
systemctl stop puma@$REDMINE
~~~
Vider la base de donnée actuelle :
~~~
TABLES=$(mysql $USER -e 'show tables' | awk '{ print $1}' | grep -v '^Tables' )
for t in $TABLES
do
echo "Deleting $t table from $USER database..."
mysql $USER -e "drop table $t"
done
~~~
Importer votre dump SQL:
~~~
mysql -D $USER --default-character-set=utf8 < redmine_dump.sql
~~~
Migrer la base de données :
~~~
rake -qf ~/redmine/Rakefile db:migrate RAILS_ENV=production
~~~
Migrer les plugins :
~~~
rake -qf ~/redmine/Rakefile redmine:plugins:migrate RAILS_ENV=production
~~~
Relancer votre Redmine :
~~~
systemctl start puma@$REDMINE
~~~
Synchroniser les fichiers attachés :
~~~
scp -Cr votre-serveur-actuel.tld:dossier-files ~/
~~~

View file

@ -1,58 +0,0 @@
**Cette page a été importée automatiquement de notre ancien wiki mais n'a pas encore été révisée.**
# Plugins
### Listes des plugins
* [wiki:HowToRedmine-Source/Plugins/Redmine_multiprojects_issue Plugin Redmine Multiprojects Issue]
* Permet d'assigner des projets secondaires à une demande.
* [wiki:HowToRedmine-Source/Plugins/Redmine_git_hosting Plugin Redmine Git Hosting]
* Permet l'intégration de Redmine avec Gitolite.
* [wiki:HowToRedmine-Source/Plugins/Redmine_wiki_notes Plugin Redmine Wiki Notes]
* Ajoute des macros au wiki pour afficher un bloc de type note/info/warning/tip.
### Mise à jour (User = $REDMINE)
*Éteindre Puma avant les mises à jours.*
Rendez vous dans le dossier du plugins /home/$REDMINE/redmine/plugins/nom_plugin puis :
Pour une mise à jour mineure :
~~~
git pull
~~~
Pour une mise à jour majeure, récuperer la dernière branche stable, vérifier les prérequis puis :
~~~
git checkout $BRANCHE
~~~
Effectuer ensuite les tâches post-update ci-dessous.
### Taches post-installation / post-update
Mise à jour des gem :
~~~
bundle install --gemfile=~/www/Gemfile --path=~/.gem
~~~
Migration des plugins :
~~~
rake -qf ~/www/Rakefile redmine:plugins:migrate RAILS_ENV=production
~~~
Correction des droits
~~~
chmod u=rwX,g=rX,o= ~/www/plugins -R"
~~~
Désinstaller un plugin :
~~~
rake -qf ~/www/Rakefile redmine:plugins:migrate[plugin_name,0] RAILS_ENV=production
~~~

View file

@ -1,27 +0,0 @@
**Cette page a été importée automatiquement de notre ancien wiki mais n'a pas encore été révisée.**
# Sauvegarde de votre installation Redmine
Connexion en tant que l'utilisateur $REDMINE :
~~~
su - $REDMINE
~~~
Export de la base Mysql :
~~~
mysqldump $USER > redmine_dump.sql
~~~
Sauvegarde de la configuration de Redmine :
~~~
tar -zcvf ~/$USER_config.tgz ~/redmine/config
~~~
Sauvegarde des fichiers attachées :
~~~
tar -zcvf ~/$USER_files.tgz ~/files
~~~

View file

@ -1,85 +0,0 @@
**Cette page a été importée automatiquement de notre ancien wiki mais n'a pas encore été révisée.**
# Mise à jour de votre installation Redmine
Connection en tant que l'utilisateur $REDMINE :
~~~
# su - $REDMINE
$ umask 022
~~~
Rendez vous dans le dossier d'installation de Redmine :
~~~
$ cd ~/redmine
~~~
## Pour faire une mise à jour mineure (ex: 3.0.2 vers 3.0.3)
~~~
# su - $REDMINE
$ umask 022
$ cd ~/redmine
$ git pull
$ bundle update
# systemctl restart puma@$REDMINE
# systemctl status puma@$REDMINE
~~~
## Pour faire une mise à jour majeure (ex: 2.6 vers 3.0)
Déterminer votre branche courante (elle est précédé d'un étoile) :
~~~
$ git branch
~~~
Lister les branches distantes (ne prendre en compte que les versions stables) :
~~~
$ git pull
$ git branch -r
~~~
Si une version plus récente de Redmine est présente, vérifier les prérequis en vous rendant sur [redmine.org](http://www.redmine.org/projects/redmine/wiki/RedmineInstall#Requirements)
Version de Ruby et de Ruby on Rails :
~~~
$ ruby -v
$ rails -v
~~~
Si les prérequis sont satisfaits :
~~~
# systemctl stop puma@$REDMINE
# su - $REDMINE
$ umask 022
$ gem update puma --user
$ cd ~/redmine
# systemctl stop puma@$REDMINE
$ git pull
$ git checkout $BRANCHE
$ rm Gemfile.lock
$ bundle update
$ rake -q db:migrate RAILS_ENV=production
# systemctl start puma@REDMINE
$ systemctl status puma@REDMINE
~~~
Mise à jour des plugins (exemple avec le plugin foo) :
~~~
# su - $REDMINE
$ umask 022
$ cd ~/redmine
# systemctl stop puma@$REDMINE
$ cd plugins ; ls
$ cd foo
$ git pull && git branch -r
$ rake -q redmine:plugins:migrate RAILS_ENV=production
# systemctl start puma@REDMINE
$ systemctl status puma@REDMINE
~~~

View file

@ -1,88 +0,0 @@
**Cette page a été importée automatiquement de notre ancien wiki mais n'a pas encore été révisée.**
# Nginx
### Prérequis
Installation de [wiki:HowtoNginx Nginx].
### Configuration
Création du dossier de log :
~~~
mkdir /var/log/nginx/$REDMINE
chown www-data:adm /var/log/nginx/$REDMINE
chmod u=rwx,g=rxs,o= /var/log/nginx/$REDMINE
~~~
Création du vhost $REDMINE :
~~~
cat > /etc/nginx/sites-available/$REDMINE <<EOF
upstream ruby_$REDMINE {
server unix:/run/$REDMINE/ruby.sock fail_timeout=0;
}
server {
server_name $REDMINE.$(hostname -d);
listen 0.0.0.0:80;
listen [::]:80;
# listen 0.0.0.0:443 ssl;
# listen [::]:443 ssl;
# if ( $scheme = http ) {
# return 301 <https://$server_name$request_uri;>
# }
# ssl_certificate /etc/ssl/certs/redmine_$REDMINE.crt;
# ssl_certificate_key /etc/ssl/private/redmine_$REDMINE.key;
root /home/$REDMINE/www/public;
access_log /var/log/nginx/$REDMINE/access.log;
error_log /var/log/nginx/$REDMINE/error.log;
error_page 503 @maintenance;
location / {
if (!-f /run/$REDMINE/ruby.pid) {
return 503;
}
try_files \$uri @ruby;
}
location @maintenance {
#proxy_pass <http://maintenance-url.com;>
rewrite ^(.*)$ /500.html break;
}
location @ruby {
proxy_set_header X-Forwarded-Proto \$scheme;
proxy_set_header X-Forwarded-For \$remote_addr;
proxy_set_header Host \$<http_host;>
proxy_redirect off;
proxy_read_timeout 300;
proxy_pass <http://ruby_$REDMINE;>
}
}
EOF
~~~
Activation du vhost $REDMINE :
~~~
ln -s /etc/nginx/sites-available/$REDMINE /etc/nginx/sites-enabled/$REDMINE
~~~
Pour mettre en place le ssl, voir [wiki:HowtoSSL] et nommée votre certificat et votre clé comme ceci :
* /etc/ssl/certs/redmine_$REDMINE.crt
* /etc/ssl/private/redmine_$REDMINE.key.
Test de la configuration nginx et rechargement le cas échéant :
~~~
nginx -t
if [ $? == 0 ]; then
service nginx reload
fi
~~~
#### Si iptables est configuré, pensez à ouvrir les ports 80 et 443 entrants !