Upgrade vers Prowhy 1.3

Sauvegarde Prowhy 1.0.X

Pour cette mise à jour, nous allons installer ProWhy 1.3 en parallèle de l'ancien ProWhy.

  • Sauvegarde BDD
    Avant toute autre procédure liée à l'upgrade, il est impératif de réaliser une sauvegarde de la base de données.
    Cette sauvegarde peut être par exemple effectuée à l'aide des commandes suivantes :
    $ mysql -u root --password=MYSQL_PWD
    mysql> create database prowhy_production_1_0;
    (ou un autre nom à votre choix)
    mysql> exit
    $ mysqldump -u root --password=MYSQL_PWD prowhy_production | mysql -u root --password=MYSQL_PWD prowhy_production_1_0

    remplacer "prowhy_production" par le nom de la database d'origine, et "prowhy_production_1_0" par le nom de la nouvelle database.
  • Renommer l'ancienne version de Prowhy :
    $ mv ~/prowhy ~/prowhy1_0
  • Dans le fichier prowhy1_0/config/database.yml : modifier le nom de la bdd production par le nom de la sauvegarde (prowhy_production_1_0)
  • Modifier le lien /var/www :
    $ sudo rm /var/www/prowhy
    $ sudo ln -s ~/prowhy1_0/public /var/www/prowhy1_0
  • Fichiers de configuration Apache :
    $ sudo a2dissite prowhy_vhost
    $ sudo mv /etc/apache2/sites-available/prowhy_vhost.conf /etc/apache2/sites-available/prowhy1_0_vhost.conf
    (avec ou sans les extensions .conf selon votre version d'Apache)
    Dans le fichier prowhy1_0_vhost.conf remplacer "prochy" par "prowhy1_0"
    $ sudo a2ensite prowhy1_0_vhost
  • Tester :
    Relancer le serveur Apache
    $ sudo service apache2 restart

Vous pouvez accéder à l'ancienne version de l'application depuis l'adresse : http://adresse_du_serveur/prowhy1_0

Installation Ruby 1.9.3

Rvm

Si Ruby a été précédemment installé sans utiliser "rvm" alors vous devez installer rvm.
Pour cela, se réferrer au point 1 de la documentation d'installation de ProWhy 1.3 ici : Installation RVM

Ruby 1.9.3

Rappel : vous devez ajouter rvmsudo devant les commandes uniquement si vous avez réalisé une installation en root de rvm.
  • Chargement et installation de ruby :
    $ rvm install 1.9.3-p551
    $ rvm use 1.9.3
    $ rvm --default use 1.9.3
  • En cas de problème avec rvm install :
    $ rvm requirements
    Si besoin installer les composants nécessaires, et relancer la commande.

Chargement et installation de ProWhy 1.3

Chargement avec svn

Créer un répertoire prowhy et charger l'application
$ mkdir prowhy
$ svn checkout http://www.prowhy.org/svn/prowhy/stable/prowhy-1.3-b prowhy

Droits sur les répertoires de l'application

$ sudo chown passenger:passenger ~/prowhy1.3/config/environment.rb
$ sudo chmod 664 ~/prowhy1.3/config/environment.rb
$ sudo chown -R passenger:passenger ~/prowhy1.3/public
$ sudo chmod -R 775 ~/prowhy1.3/public

Installation des composants nécessaires à l'application (gems)

Dans le répertoire de l'application (prowhy)
$ cd prowhy // le gemset associé à cette version de Prowhy est automatiquement créé à cette étape
$ bundle install

Mise à jour de la base de données

Attention : si vous n'avez pas réalisé la sauvegarde de la base de données, il est indispensable de la réaliser avant l'étape suivante.

Dans le répertoire de l'application (prowhy1.3)
  • Éditer le fichier config/database.yml :
    - Si besoin modifier le nom de la base de données en mode production : utiliser le nom de la base de données NON utilisée par l'ancienne version de ProWhy.
    - Modifier le mot de passe d'accès à mysql
  • Mise à jour des tables :
    $ rake db:migrate RAILS_ENV=production
  • Insertion des données manquantes :
    $ rake db:fixtures:load FIXTURES=langues RAILS_ENV=production
  • Copie des images et documents liés aux résolutions de problèmes :
    - Copier tout le contenu de l'ancien répertoire public/docs vers prowhy1.3/public/docs

Transfert des modifications

Si vous avez effectué des modifications (fichiers fixtures, image de la page d'accueil), vous devez transférer les fichiers correspondants :

  • Pour les Fixtures :
    Copier les fichiers modifiés de "prowhy1_0/tests/fixtures" vers "prowhy/tests/fixtures"
  • Pour l'image de la page d'accueil :
    Copier le fichier public/images/custom_trex/societe_custom.jpg de "prowhy1_0" vers "prowhy"

Configuration Apache

Création du lien vers le dossier public de l'application (dans /var/www par exemple)

$ sudo ln -s ~/prowhy/public /var/www/prowhy

Configuration du Virtual Host Apache en mode production

  • Créer le fichier /etc/apache2/sites-available/prowhy_vhost[.conf] :
    <Location /prowhy> 
        # mode production :
        RailsEnv production 
    
        # Permet de définir le chemin de la version de ruby à utiliser, si elle est différente de la configuration de Passenger.
        PassengerRuby /home/prowhy/.rvm/gems/ruby-1.9.3-p551@prowhy-rails-3.2/wrappers/ruby
    
        RackBaseURI /prowhy 
        Options -MultiViews 
    </Location>
    
  • Activer le site prowhy dans Apache :
    $ sudo a2ensite prowhy_vhost
  • Relancer le serveur Apache
    $ sudo service apache2 restart

Vous pouvez désormais accéder à l'application prowhy :
http://adresse_du_serveur/prowhy

Login : admin
Passwd : admin

Also available in: PDF HTML TXT