====== Installer le site vitrine Salamander à partir d'une sauvegarde ======

Cette note explique comment installer le site vitrine Salamander Drupal à partir d'une sauvegarde issue du module Drupal "[[https://www.drupal.org/project/backup_migrate|Backup and Migrate]]".

===== Les étapes =====

  * **[[#save|Récupération de la sauvegarde]]**.
  * **[[#docroot|Copier le contenu 'docroot']]**.
  * **[[#create_db|Création d'une base de données MySQL]]**.
  * **[[#import_db|Importer les données dans la nouvelle BDD]]**.
  * **[[#new_user_db|Créer l'utilisateur MySQL de la nouvelle BDD ]]**.
  * **[[#settings|Modification du fichier settings.php Drupal]]**.

----
<BOOKMARK:save>
===== Récupération de la sauvegarde =====

Récupérer une copie du site (sous /u01/backups/Drupal_Salamander_Site/ du serveur DEV ou
en créer une manuellement, si c'est possible, via le menu d'administration Drupal (connecté en admin) "Configuration" -> "Système" -> "Backup & Migrate").

----
<BOOKMARK:docroot>
===== Copier le contenu 'docroot' =====

Après avoir dézippé la sauvegarde (parfois deux fois !), copier le contenu du dossier 'docroot' dans le répertoire web de destination de votre serveur (répertoire 'www' ou un sous-répertoire du site de destination).

----
<BOOKMARK:create_db>
===== Création d'une base de données MySQL =====

Via PhpMyAdmin (//via l'entrée de menu 'MySQL Databases' du cPanel pour Planet Hoster//), créer une nouvelle base de données MySQL avec le nom "sam_vitrine" (//chez Planet Hoster, il préfixe obligatoirement la BDD avec le nom de compte soit 'salaugoo_'//).

----
<BOOKMARK:import_db>
===== Importer les données dans la nouvelle BDD =====

Via PhpMyadmin, après sélection de la nouvelle base de données créée :

  * via l'onglet "Opérations" : s'assurer que l'interclassement est bien positionné sur '**utf8_general_ci**'. 

  * via l'onglet "Importer" : importer le fichier database.sql (présent à côté du dossier 'docroot' de la sauvegarde).

----
<BOOKMARK:new_user_db>
===== Créer l'utilisateur MySQL de la nouvelle BDD =====

Via PhpMyAdmin (//via l'entrée de menu 'MySQL Databases' du cPanel pour Planet Hoster//), créer un utilisateur "sam_vitrine" avec le champ "client" -> "localhost" (//champ inexistant pour l'entrée de menu 'MySQL Databases' du cPanel//) puis le mot de passe fournit dans le KeePass : MySQL -> user site vitrine.


Modifier les privilèges de l'utilisateur précédemment créé pour lui donner tous les droits sur la base de données "sam_vitrine" (//Pour Planet Hoster, il faut, via l'entrée de menu 'MySQL Databases', ajouter l'utilisateur à la BDD grâce au formulaire "Add User To Database"//).

----
<BOOKMARK:settings>
===== Modification du fichier settings.php Drupal =====

<note important>Si on essaie dès maintenant d'accéder au nouveau site Drupal récemment installé, il va ouvrir un formulaire de première connexion afin de paramétrer l'environnement comme s'il s'agissait d'une nouvelle application.</note>

Ceci est dû au fait que la base de données n'est pas encore reliée avec l'applicatif Drupal.

Pour créer ce lien, il faut ajouter le fichier 'settings.php' suivant dans le répertoire 'sites/default' de l'installation Drupal (fichier compris dans le zip) :

{{:dev_doc:site_vitrine:settings.zip|}}

Ce fichier aurait été créé si on avait déroulé le formulaire de configuration de première connexion Drupal. Ce fichier 'settings.php' comprend le même contenu que le fichier qui aurait été généré, à l’exception du code suivant qui a été rajouté aux alentours de la ligne 200 :

<code>
$databases = array (
  'default' => 
  array (
    'default' => 
    array (
      'database' => 'sam_vitrine',
      'username' => 'sam_vitrine',
      'password' => 'MDP',
      'host' => 'localhost',
      'port' => '',
      'driver' => 'mysql',
      'prefix' => '',
    ),
  ),
);
</code>

**Il faut donc modifier ce bout de code afin de préciser les bons identifiants de connexion lié à l'utilisateur MySQL créé précédemment !**