Wiki de l'ARHN

Axe de recherche en histoire numérique
LARHRA UMR5190

Nous utilisons ce logiciel pour tout ce qui concerne la gestion de la base de données

• Démarrer le logiciel pgAdmin3 (à ne pas confondre avec l'application web phpPgAdmin)
  • Pour les utilisateurs de Windows, il se trouve dans le dossier C:\Bitnami\wappstack-5.5.29-1\postgresql\bin et normalement on peut le lancer depuis le menu des applications
  • Pour les utilisateurs de MacOS, il faut le télécharger depuis cette page en prenant la version qui correspond à votre système d'exploitation, si possible la plus récente.
• Pour tous, une fois pgAdmin3 installé, il faut paramétrer la connexion :
  • Dans le menu Fichier > Ajouter un serveur
  • Nom du serveur 'postgresql_9_4'
  • Hôte: localhost
  • port TCP : 5432
  • base maintenance: postgres
  • nom utilisateur: postgres
  • Mot de passe: le votre et l'enregistrer
• Une fois connectés, il faut tester si l'extension XML de votre base de données marche (normalement pas de soucis pour Windows, quelques soucis pour MacOS)
  • Sélectionner sans l'ouvrir la base par défaut 'postgres' (qu'il ne faut jamais toucher)
  • Ouvrir une boîte de dialogue SQL avec le bouton 'SQL' en forme de loupe qui se trouve parmi les boutons en haut de la fenêtre (cf. l'illustration ci-dessous)

• copie dans la boîte de dialogue SQL cette requête:

  SELECT (xpath('/my:a/text()', '<my:a xmlns:my="http://example.com">Test réussi !</my:a>',
               ARRAY[ARRAY['my', 'http://example.com']]))[1];

• l'exécuter avec le bouton en forme de flêche verte
• si l'extension XML est correctement installée, vous aurez ce résultat : “Test réussi !”
• Sinon, vous aurez le message d'erreur qui se trouve dans l'illustration. Si c'était le cas, il faut tenter d'abord de désinstaller et réinstaller la distribution Bitnami. Si ça ne marche toujours pas, il faudra installer une autre distribution de PostgreSQL (prière de m'écrire un mail pour me prévenir).

• Télécharger le fichier qui contient la sauvegarde de la base de données
• Créer un dossier appelé BD_TD2015 et un sous-dossier appelé 'sauvegardes'
• Déplacer le fichier téléchargé vers le dossier 'BD_TD2015' et le décompresser (dézipper)

• Une fois la connexion au serveur ouverte et le mot de passé 'avalé', créer une nouvelle base de données appelée 'TD2015'. Dans l'onglet Définition mettre 'codage' à UTF8, laisser le reste des paramètres par défaut.
• Si vous aviez déjà créé une base TD2015, il faut la supprimer et en recréer une vide
• Pour supprimer la base TD2015, visualisez-là dans PgAdmin3, faites un click-droit sur la base, puis supprimer

• ATTENTION : la base de données 'TD2015' est réservée à l'exercice, n'y mettez jamais de données qui vous appartiennent !
• Si vous l'aviez déjà fait, créez provisoirement une nouvelle base de données appelée TD2015bis pour l'exercice [un lien vers d'autres instructions suivra]

• Ouvrir la nouvelle base de données (double-click)
• Restaurer les sauvegardes depuis le dossier dézippé:
  • click droit sur la base de données TD2015 et choisir dans le menu contextuel 'Restaurer'
  • chercher le dossier téléchargé et dézippé, ouvrir le fichier base.backup
  • clicker le bouton 'Restauration'
  • Si vous lisez à la fin du log: “Le process a retourné le code de sortie 0.” c'est réussi (0 = OK ; 1 = erreur)

Si tout s'est bien passé la base est installée. Sélectionnez la base TD2015 et rafraichissez (bouton avec les flèches rouges et vertes)