Mettre à jour ORKA

Avant de modifier les fichiers ou la base de données, empêchez les utilisateurs de continuer à travailler dans ORKA.

La sauvegarde doit être créée avant tout remplacement de fichier ou toute migration de la base de données.

Sauvegarder la base de données

Adaptez le nom de l’utilisateur et de la base de données à votre environnement.

$ mysqldump -u orka_user -p orka \
  > orka_backup_$(date +%Y%m%d_%H%M).sql

Vérifier le fichier SQL

$ ls -lh orka_backup_*.sql

Sauvegarder les fichiers persistants

$ cd /var/www/orka
$ sudo tar -czf \
  orka_files_backup_$(date +%Y%m%d_%H%M).tar.gz \
  backend/.env.local \
  backend/var

Copiez l’archive fournie par ORKA CS dans un répertoire temporaire. Son nom dépend de la version distribuée.

$ sudo mkdir -p /tmp/orka-update
$ sudo chown "$(id -un)":"$(id -gn)" /tmp/orka-update
$ cp orka-update-v1.1.zip /tmp/orka-update/
$ cd /tmp/orka-update
$ unzip orka-update-v1.1.zip

La commande rsync permet d’aligner les fichiers applicatifs avec la nouvelle version tout en excluant la configuration locale et le répertoire persistant.

Effectuer d’abord une simulation

L’option --dry-run affiche les opérations prévues sans modifier l’installation.

$ sudo rsync -av --delete --dry-run \
  --exclude 'backend/.env.local' \
  --exclude 'backend/var/' \
  /tmp/orka-update/ \
  /var/www/orka/

Appliquer la mise à jour

$ sudo rsync -av --delete \
  --exclude 'backend/.env.local' \
  --exclude 'backend/var/' \
  /tmp/orka-update/ \
  /var/www/orka/

Composer installe les versions de dépendances définies dans le fichier de verrouillage livré avec la nouvelle version.

$ cd /var/www/orka/backend
$ php8.4 /usr/bin/composer install \
  --no-dev \
  --optimize-autoloader

Installing dependencies from lock file
Verifying lock file contents can be installed
Generating optimized autoload files
No security vulnerability advisories found

Installez les dépendances JavaScript définies par la nouvelle version, puis reconstruisez l’interface destinée à la production.

$ cd /var/www/orka/frontend
$ npm install
$ npm run build

vite building for production...
✓ modules transformed
dist/index.html
dist/assets/
✓ built successfully

Le répertoire frontend/dist contient désormais l’interface de la nouvelle version.

Les migrations Doctrine adaptent la structure de la base de données aux besoins de la nouvelle version.

$ cd /var/www/orka/backend
$ php8.4 bin/console doctrine:migrations:migrate \
  --no-interaction

Contrôler l’état des migrations

$ php8.4 bin/console doctrine:migrations:status

Le cache de l’ancienne version ne doit pas être réutilisé par la nouvelle application.

$ cd /var/www/orka/backend
$ php8.4 bin/console cache:clear --env=prod
$ php8.4 bin/console cache:warmup --env=prod

Après le remplacement des fichiers et la reconstruction du cache, vérifiez que PHP-FPM peut écrire dans les emplacements nécessaires.

$ sudo chmod -R 775 /var/www/orka/backend/var
$ sudo chmod -R 775 /var/www/orka/backend/public

Lorsque le serveur Web utilise le compte www-data, vérifiez également que le propriétaire ou le groupe lui permet d’accéder aux fichiers.

$ sudo chown -R www-data:www-data \
  /var/www/orka/backend/var

Redémarrez PHP-FPM ainsi que le serveur Web afin que les processus utilisent la nouvelle version des fichiers.

Avec NGINX

$ sudo systemctl restart php8.4-fpm
$ sudo systemctl restart nginx

Avec Apache

$ sudo systemctl restart php8.4-fpm
$ sudo systemctl restart apache2

Contrôler leur état

$ sudo systemctl status php8.4-fpm
$ sudo systemctl status nginx