Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente Prochaine révision Les deux révisions suivantes | ||
td_histoire_numerique:installation_de_la_base_de_donnees [2015/10/10 09:49] Francesco Beretta [Installation de l'interface] |
td_histoire_numerique:installation_de_la_base_de_donnees [2015/12/01 09:12] Francesco Beretta [Mise à jour de la base de données] |
||
---|---|---|---|
Ligne 19: | Ligne 19: | ||
* Nom du serveur 'postgresql_9_4' | * Nom du serveur 'postgresql_9_4' | ||
* Hôte: localhost | * Hôte: localhost | ||
- | * port TCP : 5432 | + | * port TCP : 5432 (port 5433 pour les utilisateurs de MacOS qui ont le serveur PostgreSQL de la distribution Enterprise DB) |
* base maintenance: postgres | * base maintenance: postgres | ||
* nom utilisateur: postgres | * nom utilisateur: postgres | ||
Ligne 90: | Ligne 90: | ||
* sous Windows : C:\Bitnami\wappstack-5.5.29-1\apache2\htdocs\TD2015 | * sous Windows : C:\Bitnami\wappstack-5.5.29-1\apache2\htdocs\TD2015 | ||
* sous MacOS : /Applications/mappstack-5.5.29-1/apache2/htdocs/TD2015 | * sous MacOS : /Applications/mappstack-5.5.29-1/apache2/htdocs/TD2015 | ||
- | * Dans le dossier TD2015, cherchez le document 'phpgen_settings.php' (avec ou sans suffixe), ouvrez-le avec un éditeur de texte (bloc-notes sous Windows, TextEdit de LibreOffice sous MacOS) | + | * Dans le dossier TD2015, cherchez le document 'phpgen_settings.php' (avec ou sans suffixe), ouvrez-le avec un éditeur de texte (bloc-notes sous Windows, TextEdit sous MacOS) |
* Modifiez le mot de passe en y mettant **votre mot de passe** d'accès au serveur PostgreSQL créé lors de l'installation. Les paramètres se présentent ainsi: <code>function GetGlobalConnectionOptions() | * Modifiez le mot de passe en y mettant **votre mot de passe** d'accès au serveur PostgreSQL créé lors de l'installation. Les paramètres se présentent ainsi: <code>function GetGlobalConnectionOptions() | ||
{ | { | ||
Ligne 107: | Ligne 107: | ||
* Si vous deviez tomber sur un message d'erreur, écrivez-moi un mail avec copie d'écran du message. | * Si vous deviez tomber sur un message d'erreur, écrivez-moi un mail avec copie d'écran du message. | ||
- | ===== Installation d'une base de données à usage personnel ===== | ||
- | ==== Création de la base de données à usage personnel ==== | + | ==== Mise à jour de la base de données ==== |
+ | Version la plus récente de la base de données (permier décembre 2015): {{:td_histoire_numerique:td2015_20151201.zip|télécharger ici}}. | ||
+ | Pour mettre à jour la base de données: | ||
+ | * Attention: cette démarche ne concerne que la base de données–exemple. **Ne pas toucher à sa base personnelle !** | ||
+ | * Lancer le logiciel PgAdmin3 | ||
+ | * Ouvrir la base de données existante et déplier le dossier des schémas | ||
+ | * Supprimer, dans cet ordre, les schémas: vues, paramètres, objets (click droit sur un schéma, puis supprimer ou supprimer en cascade) | ||
+ | * Décompresser le dossier contenant la nouvelle base de données | ||
+ | * Recréer les schémas, selon les indications fournies ci-dessus à propos de la cération d'une nouvelle base de données, dans cet ordre: objets, parametres, vues | ||
+ | * Découvrir le contenu de la nouvelle base de données depuis l'interface | ||
- | === Création d'une nouvelle base de données === | + | \\ |
+ | |||
+ | |||
+ | |||
+ | ===== Installation d'une base de données à usage personnel ===== | ||
+ | |||
+ | |||
+ | ==== Création de la base de données à usage personnel ==== | ||
* On procède de la même manière que pour installer la base TD2015, selon les instructions ci-dessus, en utilisant pgAdmin3. | * On procède de la même manière que pour installer la base TD2015, selon les instructions ci-dessus, en utilisant pgAdmin3. | ||
Ligne 122: | Ligne 137: | ||
* On copie cette instruction <code>truncate table objets.objet restart identity cascade;</code>, on la colle dans la boîte de dialogue SQL et on l'exécute | * On copie cette instruction <code>truncate table objets.objet restart identity cascade;</code>, on la colle dans la boîte de dialogue SQL et on l'exécute | ||
* Si on voit ce résultat <code>NOTICE: truncate cascades to table "date_objet". NOTICE: truncate cascades to table "nom_objet". La requête a été exécutée avec succès en 21 ms, mais ne renvoie aucun résultat.</code> c'est que tout a été exécuté correctement | * Si on voit ce résultat <code>NOTICE: truncate cascades to table "date_objet". NOTICE: truncate cascades to table "nom_objet". La requête a été exécutée avec succès en 21 ms, mais ne renvoie aucun résultat.</code> c'est que tout a été exécuté correctement | ||
+ | * Exécuter la même opération sur la table des associations avec cette instruction <code>truncate table objets.association_objets restart identity cascade;</code> | ||
* On peut désormais alimenter sa propre base de données, c'est-à-dire créer de nouveaux objets. | * On peut désormais alimenter sa propre base de données, c'est-à-dire créer de nouveaux objets. | ||
* ATTENTION: les tables et vues des schémas 'parametres' et 'vues' ne doivent pas être modifiées d'aucune manière | * ATTENTION: les tables et vues des schémas 'parametres' et 'vues' ne doivent pas être modifiées d'aucune manière | ||
Ligne 127: | Ligne 143: | ||
- | === Création de l'interface de la base de données à usage personnel === | + | ==== Création de l'interface de la base de données à usage personnel ==== |
* On procède comme pour l'installation de l'interface de la base de données du TD2015, selon les indications données ci-dessus. | * On procède comme pour l'installation de l'interface de la base de données du TD2015, selon les indications données ci-dessus. | ||
Ligne 133: | Ligne 149: | ||
* On appelle le dossier-copie 'bd_perso': le contenu sera identique à 'TD2015', seul le nom du dossier change | * On appelle le dossier-copie 'bd_perso': le contenu sera identique à 'TD2015', seul le nom du dossier change | ||
* Il faut mettre le dossier 'bd_perso' dans 'htdocs' | * Il faut mettre le dossier 'bd_perso' dans 'htdocs' | ||
- | * Il faut ensuite paramétrer la connexion dans le fichier 'phpgen_settings.php' (avec ou sans suffixe), en l'ouvrant avec un éditeur de texte (bloc-notes sous Windows, TextEdit de LibreOffice sous MacOS) | + | * Il faut ensuite paramétrer la connexion dans le fichier 'phpgen_settings.php' (avec ou sans suffixe), en l'ouvrant avec un éditeur de texte (bloc-notes sous Windows, TextEdit sous MacOS) |
- | * | + | * Il faut mettre votre mot de passe et le nom de la nouvelle base de données: <code>function GetGlobalConnectionOptions() |
+ | { | ||
+ | return array( | ||
+ | 'server' => 'localhost', | ||
+ | 'port' => '5432', | ||
+ | 'username' => 'postgres', | ||
+ | 'password' => '[votre mot de passe]', | ||
+ | 'database' => 'bd_perso' # 'Eventuellement en choisir une autre mais il doit être le même que celui de la base postgresql | ||
+ | );</code> | ||
+ | * Taper cette adresse dans un navigateur web afin d'accéder à la page d'accueil de la nouvelle base de données: | ||
+ | * http://127.0.0.1:8080/bd_perso/accueil.html (version Mac) | ||
+ | * http://127.0.0.1/bd_perso/accueil.html (version Windows) | ||
+ | * Après avoir pris connaissance des conditions de la licence, naviguez dans votre base de donnés. | ||
+ | * Si vous deviez tomber sur un message d'erreur, écrivez-moi un mail avec copie d'écran du message. | ||
+ | |||
+ | ASTUCE : avec cette méthode, vous pouvez créer autant de bases de données que vous voulez – mais une suffira en règle générale | ||
+ | |||
+ | |||
+ | |||
+ | ====== Sauvegarde de votre base de données personnelle !!! ====== | ||
+ | |||
+ | |||
+ | IMPORTANT: il faut **effectuer des sauvegardes régulières de votre base de données personnelle** en exportant en format SQL le contenu du schéma 'objets'. Vous pourrez ainsi recréer une copie identique de votre base dans n'importe quel serveur PostgreSQL, par ex. sur un autre ordinateur. | ||
+ | |||
+ | * Ouvrir le client PGAdmin3 et vous connecter à la base de données 'bd_perso' | ||
+ | * Déplier les schémas dans l'arboréscence à gauche | ||
+ | * sélectionner le schéma Objets, faire un click droit et sélectionner la commande sauvegarder{{ :td_histoire_numerique:pgsql_sauvegarde_du_schema.png?100 |}} | ||
+ | * créer –si vous ne l'avez pas déjàfait– un dossier de sauvegarde de vos données dans le dossier du TD ou de votre Master | ||
+ | * atteindre ce dossier par le bouton '...' de la sauvegarde de PGAdminIII qui se trouve à côté du chemin des fichiers dans la boîte de dialogue. | ||
+ | * comme nom du ficher de sauvegarde taper '**schema_objets_20151010.sql**' en indiquant la date du jour en format ISO. Vous saurez ainsi directement à quelle date vous avez effectué la dernière sauvegarde. Vérifiez que le suffixe est bien **.sql**. | ||
+ | * Ensuite paramétrer dans le même onglet: | ||
+ | * Format : **fichier plat** ( ! ) | ||
+ | * Codage : UTF8 | ||
+ | * Le reste : rien à changer ! | ||
+ | * Onglet 'Options 1': cocher 'Ne pas sauvegarder: Propriétaire, Droits'; le reste décoché | ||
+ | * Onglet 'Options 2' : cocher 'Requêtes : Utiliser les colonnes pour les Insert, Utiliser les commandes pour les insert' Le reste décoché, sauf laisser 'Messages en mode verbeux' | ||
+ | * Puis appuyer sur Sauvegarder. | ||
+ | * Si tout se passe bien, la liste des messages termine par 'Le process a retourné le code de sortie 0.' (si c'est '1' il y a un problème, '0' c'est OK) | ||
+ | * Vérifier que vous trouvez le nouveau document dans le dossier 'sauvegardes' sur votre disque dur. | ||
+ | * Ce n'est pas nécessaire de sauvegarder les autres schémas car normalement vous ne les touchez pas. Ils sont donc identiques aux fichiers que je vous ai envoyés. | ||
+ | * Le fichier de sauvegare vous permettra de recréer une copie exacte de votre schéma 'objets', contenant vos propres données, sur un autre serveur (exactement comme on a fait lors de l'installation de la base de données pour le fichier exercice que je vous ai fourni). Donc si votre ordinateur a une défaillance, ou qu'on vous le vole, et si vous avez une copie de ces fichiers sur un disque dur à la maison, vous pourrez recréer votre base sur un nouvel ordinateur. Exactement comme on fait avec un document de traitement de texte. | ||
+ | |||
+ | |||
+ | Le fichier de sortie .sql est un fichier texte, facilement stockable sur une clé USB et très facile à mettre sur n'importe quelle autre plateforme, garantissant ainsi la pérennité de vos données. | ||
+ | |||
+ | Plus tard, vous pourrez aussi m'envoyer ces fichiers et je pourrai voir vos données, vous donner des indications et précisions et vous paramétrer des requêtes d'exploitation, pour vous aider à exploiter vos données. | ||
+ |