====== Résumé du projet de migration de Chaudron ======

===== Quoi ? =====

L'instance actuelle de chaudron est sur une machine prêtée par un adhérent. De plus, la version installée est ancienne. Elle n'offre notamment pas d'accès à l'API v3.

L'objectif de ce projet est double :

  - Migrer chaudron sur une VM de l'association
  - Monter en version d'OpenProject (le logiciel derrière Chaudron)

===== Combien ça coûte et rapporte ? =====

  * une VM avec XM de ram
  * la maintenance à assurer pour les adminsys

===== Systèmes affectés (modifiés, supprimés, nouveaux) =====

  * créer une nouvelle VM pour héberger Chaudron
  * mettre à jour l'enregistrement DNS
  * migrer les données depuis l'instance chaudron actuelle
  * décomissioner la machine de l'adhérent 

===== Personnes nécessairement touchées par les changements =====

Tous les membres utilisant Chaudron, ce qui pour l'instant représente très peu de monde, voir personne.

===== Processus modifiés =====

Cela permettra de développer des outils faisant le lien entre COIN et Chaudron.

L'interface de la dernière version de Chaudron est également plus claire, ceci favorisera peut être l'usage de Chaudron.

====== Migration de Chaudron ======

  - Création d'une VM de test
  - Installation manuelle d'OpenProject
  - Tentative de migration des données

Une fois les points précédents validés :

  - Validation de la configuration avec adminsys@
  - Validation de la procédure de migration des données avec adminsys@
  - Création d'une recette ansible pour l'installation
  - Rédaction de la doc adminsys + doc utilisateurs

Ressources :

  * https://www.openproject.org/download-and-installation/
  * https://www.openproject.org/system-requirements/

===== Préparation de la VM de test =====

https://www.openproject.org/system-requirements/

  * 1G de RAM en prérequis
  * VM : tagarin-ale.faimaison.net [[http://www.bieresbretonnes.fr/portfolio-item/tagarin-ale/|Bière Tagarin Ale]]

<code>
gnt-instance add -s 10G -B maxmem=1G \
    --net 0:ip=89.234.176.153,mode=routed,mac=generate \
    -o debootstrap+default --node mutine.faimaison.net:dramm-hud.faimaison.net \
    tagarin-ale.faimaison.net
</code>

Debian 8 (jessie) avec FDE car on pourrait y stocker des informations personnelles.

===== Installation d'OpenProject (via le dépôt officiel) =====

https://www.openproject.org/download-and-installation/

==== Installation ====

Le projet propose un dépôt tiers pour installer OpenProject.

  - Import the packager.io repository signing key <code>wget -qO - https://deb.packager.io/key | sudo apt-key add -</code>
  - Install apt-https suppport <code>apt-get install apt-transport-https</code>
  - Add the OpenProject package source in ''/etc/apt/sources.list.d/openproject.list'' with the following contents<code>deb https://deb.packager.io/gh/opf/openproject-ce jessie stable/6</code>
  - Install the OpenProject Community Edition package <code>apt-get update && apt-get install openproject</code>

==== Configuration ====

https://www.openproject.org/download-and-installation/#configuration

  * Package configuration <code>openproject configure</code>

Les valeurs par défauts suffisent pour avoir une instance de test en HTTP simple.

**Attention** si à la configuration, aucune adresse email n'a été renseignée, on ne peut pas changer de mot de passe admin au premier démarrage (avec l'erreur : ''Email can't be blank.'').

La solution :

<code>
# grep root_password /etc/openproject/installer.dat
# mysql openproject -p<password>
mysql> UPDATE users SET mail='admin@email' WHERE id = '1';
mysql> commit; # optionnel car l'autocommit est activé par défaut
</code>

Après une première utilisation, la VM swap avec 1G de RAM, j'ai donc augmenté à 1.5G.
En fait, ça swap car j'avais activé [[https://dev.mysql.com/doc/refman/5.6/en/ha-memcached.html|memcached]], sans cette option, la VM tourne correctement avec 1G de RAM.

==== Backup et restauration ====

https://www.openproject.org/operations/backup/backup-guide-packaged-installation/

<code>openproject run backup</code> Cette commande crée des backups de la base de données, des fichiers et dépôts attachés, et de la configuration. Les archives sont placées dans ''/var/db/openproject/backup'' et il suffit de les placer au bon endroit pour restaurer la configuration, les fichiers et les dépôts. 

Pour la base de données, on peut utiliser la commande suivante : <code>zcat mysql-dump-<date>.sql.gz | mysql -u <dbuser> -h <dbhost> -p <dbname></code>
On trouve les identifiants grâce à la commande suivante : 
<code>
# openproject config:get DATABASE_URL
=> e.g.: mysql2://dbusername:dbpassword@dbhost:dbport/dbname
</code>

  * Restauration des fichiers attachés OK
  * Restauration de la base de données OK
  * Restauration de la configuration KO (je ne comprends pas comment faire)
  * Restauration des dépôts ??? (je n'ai pas testé l'utilisation des dépôts)

===== Installation d'OpenProject (manuellement) =====

https://github.com/opf/openproject/blob/release/6.1/docs/installation/manual/README.md