Téléchargement et installation de la dernière version

• Téléchargement et installation

  Nous nous plaçons dans le cas standard où :

  • votre serveur est un serveur Linux
  • votre logiciel SynerGaia est placé dans un répertoire /var/lib/synergaia/synergaia-99.00/ où 99.00 est un numéro de version ;
  • vos applications SynerGaia sont dans un répertoire /var/www/html/appli/ où appli est le code de votre application.

  La méthode la plus simple pour installer la nouvelle version est de procéder comme suit (en l'adaptant à votre environnement)

  étape 1 : préparez la nouvelle version SynerGaïa sans l'appliquer

  Cette étape ne nécessite pas d'interrompre le service Synergaia et ne touche pas les applications.
  On travaille ici toujours dans le répertoire /var/lib/synergaia/
  Dans toute la suite, 99.00 est le code de la nouvelle version (il faut donc le remplacer par la valeur exacte !)

  • Téléchargez le fichier archive contenant la nouvelle version à partir du lien sur la page de la dernière version publiée
  • Créez un nouveau répertoire /var/lib/synergaia/synergaia-99.00/
  • donnez-lui les mêmes autorisations que les autres répertoires SynerGaia
  • Décompressez le fichier de la nouvelle version dans le répertoire ../synergaia-99.00/
  • Vérifiez dans la documentation de version si la nouvelle version nécessitera ou non de remplacer le fichier index.php dans les répertoires des applications (/var/www/html/appli/index.php)

  étape 2 : pour chaque application concernée, appliquez la nouvelle version

  à partir de la version 24.03

  1. ouvrez l'application SynerGaia concernée dans un navigateur avec un identifiant administrateur
  2. allez dans le menu Outils > Logiciel > Gérer la disponiblité et mettez l'application en maintenance pour les utilisateurs
  3. allez dans le menu Outils > Logiciel > Mettre une nouvelle version
  4. déconnectez-vous de SynerGaia (en haut à droite : déconnexion)
  5. rouvrez SynerGaia en admin
  6. aller dans le menu Outils > Logiciel > Mettre à jour la version
  7. allez dans le menu Outils > Logiciel > Gérer la disponiblité et remettez l'application disponible pour les utilisateurs

  pour les version antérieures à la version 24.03

  • Fermez le service SynerGaïa sur l'application concernée (ici ../synergaia par exemple) (voir "mise en maintenance")
  • Ouvrez le fichier /appli/config/config.php dans un éditeur de texte (sans doute avec les droits administrateur)
  • mettez à jour la ligne contenant le code de la version SynerGaia avec le nouveau code de version
  • modifiez le le répertoir appli/nav en le remplaçant par un lien symbolique vers le nouveau synergaia/synergaia-99.00/nav
  • si la version le demande (voir ci-dessus), remplacez le fichier appli/index.php par une copie de la nouvelle version (sous synergaia-99.00)
  • mettez les autorisations www-data à ce lien symbolique (et à index.php s'il est nouveau)
  • Ouvrez SynerGaïa sur l'application avec un identifiant Administrateur, et cliquez sur l'entrée du menu "Outils > Logiciel > Mettre à jour la version"
  • Le traitement de montée de version s'exécute (en général 1 à 2 minutes) ; quand il est terminé, contrôlez que tous les messages sont corrects.
  • Validez le fonctionnement de votre application
  • Rouvrez le service SynerGaia de l'application pour les utilisateurs (enlevez le mode "maintenance")

  Informations complémentaires pour l'installation

  Sauvegardes préalables

  Attention de bien sauvegarder votre fichier appli/config/config.php qui contient les informations d'accès à la base CouchDB.

  Sans cette précaution, vous seriez obligés de repasser par l'installation (sans perdre d'informations, mais c'est inutile...)

  Si vous prévoyez de sauter plusieurs versions d'un seul coup, il peut être prudent de sauvegarder les bases CouchDB (voir le répertoire dans /var/lib/couchdb probablement)

  Autorisations sur les répertoires

  Sous Linux, vous devrez aussi probablement forcer des autorisations d'accès sur votre répertoire synergaia/. En général, vous pouvez exécuter dans une fenêtre terminal la commande suivante :

  sudo chown -R www-data:www-data /var/www/synergaia/
  

  où /var/www/synergaia/ est le chemin de votre répertoire SynerGaïa (à adapter selon votre configuration)

  Enfin pensez également à protéger en lecture le répertoire synergaia/config/ qui contient les fichiers de configuration.

  Cela peut se faire :

  • par un fichier .htaccess
  • ou des directives dans le fichier php.ini