Mettre à niveau votre version de Cyberdocs

Attention : avant toutes mises à jour, faites une sauvegarde de vos données !

Mise à jour depuis la version 2.1 vers la version 2.2

Nous supposerons ici que votre répertoire d'installation se nomme "pcd-install" et le répertoire source "pcd-src".

Ci-dessous, les principales étapes pour mettre à niveau Cyberdocs 2.1 vers 2.2. Adaptez les indications en fonction de votre installation.

  • Faites une sauvegarde du répertoire pcd-install dans son intégralité
  • Téléchargez la nouvelle version en archive ou depuis le SVN (page de téléchargement)
  • Passez votre site en maintenance
  • Renommez votre répertoire "pcd-install" en "pcd-install.old" et "pcd-src" en "pcd-src.old"
  • Placez les nouvelles sources de Cyberdocs dans "pcd-src".
  • Suivez la procédure d'installation du module de conversion et de gestion de Cyberdocs, comme indiqué dans la documentation, mais n'installez-pas la module de diffusion (ne pas lancer installation-web.sh/bat) car celui-ci n'a pas été modifié entre la version 2.1 et 2.2. NE PAS recopier l'ancien fichier pcd.properties, mais modifier le nouveau.
  • Vérifiez, avec un document ODT de tests, que le module de gestion et/ou de conversion fonctionnent correctement. En cas de problèmes, repportez-vous à la documentation et à la FAQ , avant de poser vos questions sur les listes .
  • Une fois votre nouvelle installation fonctionnelle
    • Supprimez le répertoire"pcd-install/production" et déplacez votre ancien répertoire "pcd-install.old/production" dans "pcd-install"
    • Supprimer le répertoire "pcd-install/gestion/data" et déplacer votre ancien répertoire "pcd-install.old/php/data" dans "pcd-install/gestion"
    • Remplacer le fichier "pcd-install/outils/xslt/utiles/styles.xml"par votre ancien fichier "pcd-install.old/outils/xslt/utiles/styles.xml"
  • Si vous utilisez le module de gestion, vérifiez que :
    • Les répertoires et fichiers de "pcd-install/gestion/data" et "pcd-install/production" soient accessibles en écritures par le serveur web.
    • Le répertoire et fichiers de "pcd-install/outils" doivent avoir les droits en execution par le serveur web.
  • Testez votre installation en effectuant une conversion d'un fichier ODT ou SXW.
  • IMPORTANT : les fichiers .doc ne sont plus traités par le module de conversion. Vous devez les ouvrir avec OpenOffice et les enregistrer en ODT.

Mise à jour depuis la version 2.0 vers la version 2.2

IMPORTANT : la mise à jour complète d'une version 2.0 vers 2.2, et notamment du module de pubication (SDX), peut s'avérer fastidieuse. En effet, mettre à jour SDX nécessite de réindexer tous vos documents. Nous vous conseillons donc de ne mettre à niveau que le module de conversion et le module de gestion, en attendant la version 3.0 de Cyberdocs (début 2010), qui remplacera totalement le module de diffusion.

Nous supposerons ici que votre répertoire d'installation se nomme "pcd-install" et le répertoire source "pcd-src".

Ci-dessous, les principales étapes pour mettre à niveau Cyberdocs 2.0 vers 2.2. Adaptez les indications en fonction de votre installation.

  • Faites une sauvegarde du répertoire pcd-install dans son intégralité
  • Téléchargez la nouvelle version en archive ou depuis le SVN (page de téléchargement)
  • Passez votre site en maintenance
  • Renommez votre répertoire "pcd-install" en "pcd-install.old" et "pcd-src" en "pcd-src.old"
  • Placez les nouvelles sources de Cyberdocs dans "pcd-src".
  • Suivez la procédure d'installation du module de conversion et de gestion Cyberdocs, comme indiqué dans la documentation. NE PAS recopier l'ancien fichier pcd.properties, mais modifier le nouveau. Si vous désirez installez le module de diffusion avec SDX 2.3b1, vous devrez réindexer tous les documents actuellement en ligne sur votre site. Assurez-vous de posséder la liste des fichiers nécessaires et consultez la documentation pour effectuer une indexation globale. Si vous n'installez pas le module de diffusion, ne lancez pas installation-web.sh/bat.
  • Vérifiez, avec un document ODT de tests, que le module de gestion et/ou de conversion fonctionnent correctement. En cas de problèmes, repportez-vous à la documentation et à la FAQ , avant de poser vos questions sur les listes .
  • Une fois votre nouvelle installation fonctionnelle
    • Supprimez le répertoire"pcd-install/production" et déplacez votre ancien répertoire "pcd-install.old/production" dans "pcd-install"
    • Remplacer le fichier "pcd-install/outils/xslt/utiles/styles.xml"par votre ancien fichier "pcd-install.old/outils/xslt/utiles/styles.xml"
  • Si vous utilisez le module de gestion, vérifiez que :
    • Les répertoires et fichiers de "pcd-install/gestion/data" et "pcd-install/production" soient accessibles en écritures par le serveur web.
    • Le répertoire et fichiers de "pcd-install/outils" doivent avoir les droits en execution par le serveur web.
  • Recréez les institutions via les interfaces du module de gestion : en saisissant les mêmes indentifiants d'institution, vous retrouverez tous vos documents.
  • Recréez les comptes utilisateurs (il n'est pas possible de les récupérer de l'ancienne version).
  • Testez votre installation en effectuant une conversion d'un fichier ODT ou SXW.
  • IMPORTANT : les fichiers .doc ne sont plus traités par le module de conversion. Vous devez les ouvrir avec OpenOffice et les enregistrer en ODT.