# Coppermine Photo Gallery v1.5.x: Documentation et manuel

# Sauvegarde

Cette page est destinée à expliquer la façon de sauvegarder une galerie Coppermine.

Les sauvegardes peuvent être utilisées pour restaurer votre galerie en cas de problème (si le disque dur du serveur devient hors service, un piratage, ou erreur de manipulation) ou si vous souhaitez déplacer votre galerie (déplacer votre serveurs, changer d’hébergeur, utiliser une autre application).

Coppermine stocke le contenu à la fois au niveau du système de fichiers (A l’intérieure de votre espace web - c'est le disque dur de votre serveur web) ainsi que dans la de base de données. Voyez la base de données comme un tableau géant de tables qui sont liées les une avec les autres. Bien que la base de données soit (techniquement) stockée dans des fichiers, vous ne pouvez pas sauvegarder le fichier qui représente la base de données. Cela vient de la façon dont une base de données fonctionne. En outre, vous n'avez généralement pas accès au dossier qui représente la base de données (Ne commencez pas à le chercher pour essayer de le trouver - vous ne seriez quand même pas en mesure de l'utiliser). C'est pourquoi le processus de sauvegarde doit être double: vous devez sauvegarder vos fichiers et vous avez besoin de sauvegarder également votre base de données. Une sauvegarde de l'une d'elles sans l'autre se traduira par une sauvegarde incomplète qui sera difficilement utilisable.

### Sauvegarde des fichiers

La sauvegarde des fichiers est assez simple et vous devriez déjà être familier avec la technologie, en supposant que vous avez installé Coppermine de la manière recommandée par l'équipe de développement de Coppermine : utilisez votre application FTP favorite. Méfiez-vous des outils basiques intégrés dans un éditeur WYSIWYG. Méfiez-vous des logiciels simulant les applications "web-FTP" vous avez besoin d’un véritable logiciel FTP. Si vous n'en avez pas déjà, procurez vous-en un avant de continuer.

#### Sauvegarde complète des fichiers

Le terme "sauvegarde complète de fichiers" signifie dans ce cas "une sauvegarde de tous les fichiers de la galerie Coppermine". Il est conseillé de l’effectuer au moins une fois, ainsi, vous aurez une sauvegarde complète qui vous servira après un sinistre.

Pour accomplir une telle sauvegarde, créez en premier, un dossier sur votre disque dur local. Bien sûr, vous devez vous assurer au préalable qu'il y ait assez de place sur le périphérique de stockage que vous utilisez (votre disque dur interne ou externe dans la plupart des cas) pour contenir toute la galerie, une fois que la sauvegarde sera effectuée. Si vous êtes à court d'espace disque sur votre ordinateur, vous pouvez graver le contenu de votre sauvegarde sur un CD ou un DVD une fois que votre sauvegarde est terminée, puis libérer le précieux espace du disque dur après que vous ayez tout copié sur CD/DVD.

#### Sauvegarde partielle des fichiers

Si vous effectuez des sauvegardes fréquemment, vous n'avez pas à faire une sauvegarde complète des fichiers à chaque fois, comme le code du noyau de Coppermine (c'est à dire tous les fichiers qui font que Coppermine fonctionne sur le serveur) ne change pas d'une sauvegarde à l'autre. C'est pourquoi vous pouvez effectuer ensuite une sauvegarde partielle, c'est à dire uniquement le contenu du dossier albums de Coppermine qui correspond à `http://exemple.fr/votre_dossier_coppermine/albums`. /. Si vous avez besoin d’effectuer une restauration plus tard, vous devrez restaurer votre première sauvegarde complète et puis restaurer votre sauvegarde partielle qui a été créé plus tard et qui sera plus précise et récents.

#### Incrémenter un fichier de sauvegarde

Il existe d’astucieux outils disponibles auprès de tiers qui effectueront une sauvegarde incrémentielles par FTP, c'est à dire qu'ils ne sauvegardent que les fichiers qui sont nouveaux ou qui ont changé depuis la dernière fois que la sauvegarde a été effectuée. Cela permet de réduire de façon spectaculaire le temps nécessaire pour effectuer une sauvegarde, mais compliquera un peu plus une restauration après une catastrophe - vous ne devriez utiliser cette option si vous savez ce que vous faites.

### Sauveagarde de la base de données

Coppermine crée lors de l'installation initiale plusieurs tables dans la base de données qui sont utilisées pour stocker de contenu:

- La table pictures stocke le chemin d'accès au niveau du système de fichiers pour le contenu de votre galerie (autrement dit les images)
- La table config stocke votre configuration
- La table users stocke des données sur vos utilisateurs enregistrés (y compris le compte administrateur)
- ...

Il existe de nombreuses autres tables qui stockent des aspects spécifiques du contenu de votre galerie - pour une liste complète de toutes les tables et la structure en leur sein, jetez un œil au schéma de la base de données. Toutes les tables d'une galerie Coppermine ont le même préfixe - celui que vous avez choisi lors de l'installation initiale. Pour effectuer une sauvegarde de la base de données, assurez-vous de sauvegarder toutes les tables Coppermine, c'est à dire toutes celles qui ont le préfixe que vous avez choisi lors de l'installation. Si vous n'êtes pas sûr du préfixe, téléchargez le fichie include/config.inc.php avec votre logiciel FTP sur votre ordinateur, puis ouvrer le pour afficher ce qu’il contient à l'aide d'un éditeur de texte (le Bloc-notes est très bien): le préfixe doit être nommé dedans. Par défaut, le nom du préfixe est `cpg15x_`.

#### Sauvegarde de la base de données: qu’est-ce qui doit être sauvegardé ?

La formulation peut varier, en fonction de l'outil que vous utilisez et de sa version pour effectuer la sauvegarde, vous vous avez besoin de savoir exactement quoi sauvegarder.

Une sauvegarde complète contient à la fois la définition de la structure des tables de la base de données (à savoir les "instructions" nécessaires pour créer les tables vides si elles ont été perdues ou ont besoin d'être créé sur un autre serveur), ainsi que les données (à savoir, le contenu actuel des tables).

Les tables qui composent Coppermine n’ont pas toutes la même importance:

- La table cpg15x_hit_stats peut devenir très grande si vous avez activé la fonction "Enregistrer le détail des statistiques des Hits". Par la suite, la sauvegarde peut devenir très grande si le contenu de cette table est pris en compte lors des sauvegardes fréquentes. Lorsque vous déplacez un Coppermine installer à partir d'un serveur sur un autre, cela pourrait être une bonne idée de sauter l’enregistrement du détail des statistiques des hits et donc de ne pas sauvegarde le contenu de cette table particulière.
- La table cpg15x_sessions trace les connectés et des utilisateurs anonymes par sessions. Elle se rempli automatiquement si elle est vide, vous n'avez donc pas nécessairement à la sauvegarder.
- La table cpg15x_temp_messages est utilisé pour stocker les messages d'une page à l'autre - le contenu est de très courte durée et sera purgé fréquemment, de sorte que la table n'a pas besoin d'être préservé lors de l'exécution des sauvegardes fréquente.

Gardez à l'esprit que Coppermine vous fera savoir (à savoir, qu’il y aura un message d'erreur) si une table est manquante, vous devez donc créer les tables ci-dessus en premier lieu, mais elles peuvent être vides.

#### Outils de sauvegarde de base de données

Coppermine ne contient pas d'outil de sauvegarde de base de données - donc vous aurez besoin d'en trouver un vous-même et l'utiliser. Cependant, il y a une liste d'outils que l'équipe de développement recommande::

- ##### phpMyAdmin

  Application web Open-source de gestion de base de données qui peut être téléchargé (gratuitement) et installée sur votre serveur internet (facile d’installation). Il est livré avec plusieurs langues (dont le frnçais). Votre hébergeur peut même fournir cet outil.
  [Plus]

  Merci noter que l'équipe de développement de Coppermine ne peut pas vous aider lors de l'utilisation de phpMyAdmin - alors voici juste un bref résumé qui n'est pas censé être un remplacement de la documentation de phpMyAdmin:

  - Allez avec votre navigateur vers l'URL de votre copie de phpMyAdmin (en supposant que vous avez réussi à installer phpMyAdmin sur votre espace web ou que votre hébergeur vous fournit phpMyAdmin)
  - Le cas échéant (c'est à dire si les paramètres de sécurité de phpMyAdmin sont configurés en conséquence), fournissez vos données de connexion phpMyAdmin si vous êtes invité à les saisir
  - Le cas échéant (par exemple, si vous avez accès à plusieurs bases de données), sélectionnez la base de donnée ou se trouvent les tables de Coppermine (la base de données que vous avez sélectionné lors de l'installation de Coppermine) dans le cadre en haut à gauche de l'interface de phpMyAdmin
  - Dans le cadre de droite tout en haut de phpMyAdmin, choisissez dans les boutons de navigation "Exporter"
  - Sur l'écran "Schéma et données de la base", sélectionnez les tables que vous voulez sauvegarder (par défaut, toutes les tables de la base de données sont sélectionnés) dans le cadre "Exporter". Si vous n'êtes pas sûr, sauvegardez toutes les tables de Coppermine, c'est à dire toutes les tables qui ont le même préfixe que celui que vous avez spécifié lors de l'installation de Coppermine en premier lieu
  - Dans le cadre "Exporter" laissez le bouton "SQL" sélectionné, qui est déjà celui-ci par défaut
  - Assurez-vous que la case à cocher "structure" est cochée
  - Ne cochez pas la case "Drop table" - cela "supprime la table une fois la sauvegarde terminée", ce qui est sans doute quelque chose que vous ne voudriez certainement pas voir ce produire, puisque Coppermine cesserait immédiatement de fonctionner et vous n’auriez plus qu’à effectuer une restauration.
  - Assurez-vous que la case "données" est cochée
  - Il est conseillé (mais pas obligatoire) de cocher la case "Insertions complètes"
  - Il est conseillé (mais pas obligatoire) de cocher la case "Insertions étendues"
  - Il est conseillé de cocher la case "Transmettre" cela vous permettra de télécharger un fichier au lieu de juste avoir une sortie écran de la sauvegarde que vous devriezcopier & coller dans un fichier texte.
  - Si vous avez des dépassements de temps (time-outs) lors de la création de la sauvegarde de la base de donnée, essayez d'activer la compression de fichier (vous ne pouvez bien enetendu utilier que la methode de compression disponible sur votre serveur)

  Si vous n'êtes pas sûr, lisez la documentation qui est livrée avec phpMyAdmin et les tutoriaux de sauvegarde sur internet avec l’aide de Google, le forum de support de Coppermine n'est pas le bon endroit pour demander de l'aide sur l'utilisation de phpMyAdmin.

- ##### mySqlDumper

  MySQLDumper est une application web qui peut être téléchargée et installée sur votre serveur internet. Elle est destinée à être utilisé pour créer des sauvegardes de votre base de donnée MySQL (et éventuellement restaurer ces sauvegardes). Particulièrement utile si vous n'avez pas d'accès shell à votre serveur et que la sauvegarde naturelle de mySQL ne focntionne pas à cause des dépassement de temps.
  [Plus]

- ##### mysqldump

  L'outil mysqdump ne doit pas être confondu avec mySqlDumper ou vice versa: mysqldump est un script qui s'applique au ressources internes de mysql et qui ne peut être utilisé que si vous avez un accès shell (ce qui est rarement le cas pour la plupart des utilisateurs ayant un hébergeur). [Plus]

- ##### mysqlhotcopy

  Le script Perl mysqlhotcopy est intégré aux ressources de mysql. C'est le moyen le plus rapide de faire une sauvegarde d'une base de donnée ou d'une table en particulier, mais il ne peut être lancé que sur la même mechine que celle ou se trouve physiquement la base de donnée. mysqlhotcopy ne focntionne que pour la sauvegarde de tables MyISAM et ARCHIVE. Il ne tourne que sous UNOX et NetWare. [Plus]

#### Après la sauvegarde de base de données

Après avoir effectué manuellement la sauvegarde de la base de données, il est important de s'assurer que celle-ci fonctionne comme prévu. Par conséquence, vous devriez vraiment d’abord essayer d'ouvrir le fichier et voir s’il n’est pas corrompu. Idéalement, vous devriez effectuer une restauration sur une galerie test pour vous assurez que tout fonctionne comme prévu.

Il y a de nombreux utilisateurs qui comptent sur leur sauvegarde, sans jamais l'avoir testée une fois: si vous n'avez jamais testé votre stratégie de sauvegarde, vous ne saurez jamais si elle vous permettra d'effectuer une restauration en cas de catastrophe. Sachant qu’il y a beaucoup de choses qui peuvent mal tourner, il est vraiment recommandé de tester votre sauvegarde.

### Déplacement de votre galerie

Votre galerie Coppermine peut être déplacée sur votre serveur ainsi que d'un espace web à l'autre. Voici comment accomplir ces tâches:

#### Déplacement au sein de votre serveur

Le déplacement de votre galerie sur votre serveur web (par exemple à partir d'un dossier particulier à la racine de votre site ou vice versa) est relativement facile. Coppermine se compose de deux volets:

- Fichiers
- Documents de base de données

La bonne chose concernant le déplacement de vos fichiers / dossiers réside dans les faits Coppermine ne stocke pas le chemin absolu vers un fichier dans la base de données, mais seulement un chemin relatif: le chemin relatif du dossier albums. Par la suite, vous pouvez déplacer le dossier dans lequel votre galerie Coppermine réside sur votre serveur facilement et vous n'aurez en conséquence pas à modifier vos documents de la base de données.

Il suffit de garder à l'esprit que vous devez déplacer le dossier de Coppermine en entier, en gros vous devez déplacer tous les fichiers et dossiers et pas seulement certains d'entre eux. Le dossier et la structure des fichiers dans votre répertoire de Coppermine doivent rester intacts lors de leurs déplacements.

Fondamentalement, il existe deux options pour cela:

- ##### Il vous suffit de renommer le dossier dans lequel votre galerie réside

  C'est la méthode la plus facile. Si votre galerie Coppermine réside actuellement dans `http://exemple.fr/votre_dossier_coppermine/` et que vous trouvez que l’URL est difficile à mémoriser pour vos visiteurs, vous pouvez simplement renommer le dossier `votre_dossier_coppermine` par autre chose qui est plus facile à mémoriser, par exemple `galerie` ou `photos`. Pour accomplir cela, il suffit d'utiliser votre application FTP favorite et renommez le dossier qui correspond à `http://exemple.fr/votre_dossier_coppermine/` en conséquence. Tout ce qui reste alors à faire est de modifier la valeur dans la configuration de Coppermine à la section URL du répertoire de votre Galerie Coppermine.

- ##### Vous déplacez le contenu du dossier de Coppermine vers

  Sauf si vous avez un accès à l’interpréteur de commande de votre serveur internet, il s'agit d'un processus en trois étapes: d'abord vous copiez le contenu du répertoire de Coppermine dans un dossier temporaire sur votre ordinateur en utilisant votre application FTP. Ensuite, vous restaurez le contenu de ce dossier dans le répertoire cible sur votre serveur. Enfin, vous devez définir des permissions pour la structure des nouveaux dossiers.
  Admettons que votre site internet se trouve à l'adresse `http://exemple.com/` et que votre galerie Coppermine est placée dans `http://exemple.com/coppermine/`. Considérons que le répertoire racine `http://exemple.com/` correspond au chemin absolu `/home/htdocs/` sur le serveur et que par conséquent la galerie correspond à l'adresse serveur `/home/htdocs/coppermine/`. Admettons que vous vouliez la déplacer dans un répertoire nommé "`photos`" qui se trouve dans un dossier nommé "`multimedia`". Pour cette cible, le chemin absolu sera `/home/htdocs/multimedia/photos/` et l'URL cible sera `http://exemple.com/multimedia/photos/`.

  Etape | Serveur Web | Sens | Ordinateur local | Explication
  --- | --- | --- | --- | ---
  1 | URL: `http://exemple.com/coppermine/` Absolute path: `/home/htdocs/coppermine/` | → | `c:\temp\coppermine\` | Utilisez votre client FTP pour copier le dossier de la galerie et tout ce qu'il contient dans un dossier temporaire sur le disque dur de votre ordinateur.
  2 | URL: `http://exemple.com/multimedia/photos/` Absolute path: `/home/htdocs/multimedia/photos/` | ← | `c:\temp\coppermine\` | Utilisez votre client FTP pour copier tout le contenu du dossier local temporaire dans le nouveau dossier cible sur le serveur.
  3 | URL: `http://exemple.com/multimedia/photos/albums/` Absolute path: `/home/htdocs/multimedia/photos/albums/` | n/a | - | Définissez des permissions (en utilisant votre logiciel FTP) sur le dossier albums qui doit être accessible en écriture.

  Enfin vous pouvez supprimer le dossier local temporaire où vous avez stocké vos fichiers de Coppermine, mais il est conseillé de garder ce dossier comme sauvegarde.
  Peu importe le dossier source et le dossier cible, ce n'est pas du tout important, pas plus qu'importe la profondeur dans lequel le répertoire de Coppermine est imbriqué dans la structure des dossiers sur votre serveur. Les étapes nécessaires pour effectuer le transfert de Coppermine à partir d'un dossier vers la racine du site ou vice versa ne diffèrent pas du tout: la racine du site est en fait simplement représentée par un dossier au niveau du système de fichiers du serveur, et vous déplacez le contenu vers un dossier.

#### Déplacement d'un serveur à un autre

Ce scénario s'applique généralement lorsque vous passez d'un hébergeur à l'autre. En fait, vous créer une copie de vos fichiers (sauvegarde complète des fichiers) et une copie de votre base de données (sauvegarde complète de la base de données) de l'ancien serveur et une restauration des copies sur le nouveau serveur.

Vous êtes encouragés à créer et maintenir des sauvegardes fréquentes dans le cas où quelque chose se passe mal, donc vous devriez vraiment déjà avoir une sauvegarde. Toutefois, si vous n'en n’avez pas, vous devez en créer une maintenant. Vous devez garder à l'esprit qu'il pourrait y avoir une interruption de votre site lors du déplacement d'un hébergeur à l'autre. Idéalement, l’interruption sera négligeable, mais vous ne serez généralement pas en mesure d'accéder à la galerie sur l'ancien serveur n’y sur le nouveau sous la même URL en le même temps. Par conséquence, vous devez sauvegarder l'ancien serveur pendant que vous le pouvez encore, c'est à dire avant que votre contrat d’hébergement n’arrive à expiration et que vous ne puissiez plus accéder à l'ancien serveur pour créer la sauvegarde. Si vous n'avez pas de sauvegarde et que votre serveur n'est plus accessible, vous n’aurez pas de chance: personne ne sera en mesure de vous aider à récupérer votre galerie - il est absolument obligatoire d'avoir une sauvegarde de travail à la fois de vos fichiers ainsi que votre base de données.

Reportez-vous aux sections correspondantes de cette page pour comprendre en détail comment créer des sauvegardes.

Voici un résumé des étapes nécessaires et quelques notes sur les choses difficiles:

- ##### Le mode de maintenance

  Dites à vos visiteurs qu'il y aura des travaux de maintenance sur votre site et qu'il pourrait y avoir des interruptions. Si vous permettez aux visiteurs d’interagir, comme par le téléchargement de fichiers ou l'envoi de commentaires, il vaut mieux mettre la galerie en mode hors connexion ou assurez-vous autrement que le contenu de votre base de données ne changera pas après avoir créé la sauvegarde.

- ##### Sauvegarde de vos fichiers

  Téléchargez par FTP votre dossier Coppermine au complet (y compris tous les dossiers et fichiers qu'il contient) de l'ancien serveur vers le disque dur de votre ordinateur, en préservant la structure des sous-dossiers.

- ##### Créez une sauvegarde de votre base de données

  Utiliser un outil comme phpMyAdmin ou similaire pour une sauvegarde de votre base de données, c'est à dire une copie (sauvegarde) de vos entrées MySQL de la base de données. Assurez-vous que vous ne créer pas seulement une sauvegarde de la structure des tables - vous avez besoin de sauvegarder le contenu réel (à savoir les documents de la base de données).

- ##### Vérifiez que votre sauvegarde fonctionne

  Vérifiez si la sauvegarde MySQL contient toutes les données (ouvrir le fichier zippé de la sauvegarde et utiliser un éditeur de texte pour l'afficher). Idéalement, restaurez la galerie entière sur une galerie test au cas où vous ne pouvez pas accéder au nouveau serveur, il reste encore à vous assurez que votre sauvegarde faite est valide pour travailler.

- ##### Téléchargez via FTP vos dossiers Coppermine sur le nouveau serveur

  Restaurer les fichiers sur le nouveau serveur si vous le pouvez, de plus en préservant la structure exacte des sous-dossiers qui existe dans la sauvegarde sur votre ordinateur.

- ##### Définissez les permissions

  Coppermine à besoin des permissions d'écriture sur certains dossiers, vous devez donc définir les permissions sur le nouveau serveur de la même manière que vous avez à fait lors de l'installation de la première installation de Coppermine sur l'ancien serveur. N'oubliez pas cette étape, elle est importante !

- ##### Restaurez la base de données

  Restaurer les tables MySQL en exécutant les requêtes de la sauvegarde de fichiers que vous avez créé sur l'ancien serveur. Pour y parvenir, vous aurez besoin du même outil sur le nouveau serveur (le serveur cible) que vous avez utilisé sur l'ancien serveur pour créer la sauvegarde, si vous avez utilisé phpMyAdmin sur l'ancien serveur pour créer la sauvegarde, vous devez utiliser phpMyAdmin sur le nouveau serveur pour la restauration de la sauvegarde.

- ##### Modifier les paramètres de la base de données

  Votre nouvel hébergeur doit vous avoir fourni les accès aux données MySQL (vous déjà eu à utiliser ces données pour restaurer la sauvegarde sur le nouveau serveur). Ces données MySQL diffèrent généralement des données MySQL de l’ancien serveur web, si vous devez modifier le fichier qui contient les données, de sorte que vous devrez modifier le fichier qui contient les données. Utilisez un éditeur de texte (le Bloc-notes est très bien) et modifier `include/config.inc.php`: à l'intérieur de ce fichier, vous trouverez les anciennes données MySQL que vous devrez remplacer par les données MySQL du nouveau serveur.

- ##### Désactivez le mode maintenance

  Si vous avez initialement mis à votre galerie en mode hors connexion sur l'ancien serveur vous devez vous rappeler pour activer le mode hors connexion sur le nouveau serveur. Aller dans le panneau de configuration de Coppermine et modifier le paramètre correspondant.

- ##### Tout tester en profondeur

  Testez toutes les facettes de votre galerie: essayez de vous connecter en tant que qu’utilisateur régulier (non-administrateur), essayez d'utiliser le téléchargement http, postez un commentaire, etc.

#### Inconvénients du renommage

Il ya plusieurs inconvénients lors du changement d'URL de votre galerie:

- Les signets / favoris de vos visiteurs ne seront plus applicables
- L'index des moteurs de recherche pointe vers la vieille URL. Par la suite, vous perdrez le classement dans les index de recherche

Tim Berners-Lee ("l'inventeur" du www) a inventé le slogan "Cool URIs don't change (les bonnes adresses URI ne changent pas)" qui s'applique toujours, ainsi vous feriez mieux de réfléchir à deux fois avant de renommer le répertoire de Coppermine une fois qu'il a été établi. Il est préférable de choisir un nom de dossier intelligent dès le départ (lors de la première installation de Coppermine). Quoi qu'il en soit, si vous devez change changer l'URI de votre galerie (ou en fait tout autre URL), vous devriez au moins mettre en place une redirection qui se charge du changement: sur les serveurs sous Apache (et à condition que votre serveur supporte cette fonctionnalité), vous pouvez mettre en place une redirection en utilisant un fichier `.htaccess file` avec directive de redirection.

#### Changer l'URL de Coppermine dans la configuration

Chaque fois que l'URL de votre galerie change (c'est à dire après avoir déplacé votre galerie dans votre serveur Web ou après avoir renommé le dossier dans lequel elle résidait), vous devez tenir compte du changement de l'URL dans la configuration de Coppermine:

- Allez à la nouvelle URL avec la barre d'adresse de votre navigateur
- Connectez-vous en tant qu'administrateur si vous n'êtes pas déjà connecté
- Allez dans le panneau de configuration de Coppermine
- Développer "Paramètres généraux"
- Entrez la nouvelle URL dans le champ "URL du répertoire de votre Galerie Coppermine"
- Faites défiler vers le bas le panneau de configuration
- Enregistrez vos modifications en soumettant le formulaire en utilisant le bouton correspondant au bas de la page