Cette page est en cours d'édition, celle-ci peut contenir des erreurs ou ne pas être complète.
Modifier Aperçu
Le programme ESI.Octopus.GetDbApp.exe est utilisé pour :
- Télécharger une copie de votre base de données (BD) Octopus à partir du serveur Octopus.
- Mettre en ligne (restore) la BD sur un serveur SQL existant.
Cet article explique comment utiliser GetDbApp.
Modifier Préalables
Avant d'utiliser GetDbApp vous devez avoir :
- Un serveur SQL Server 2005 (vous avez besoin au minimum d'installer la version gratuite de SQL Server 2005 appelée SQL Server 2005 Express Edition. Si vous avez déjà un serveur SQL 2005, vous pouvez utiliser votre serveur).
- Un nom de BD sur ce serveur sous lequel la BD sera restaurée. Attention, le programme GetDbApp écrase la BD existante si elle existe déjà.
- Un répertoire partagé (share) sur le serveur SQL dans lequel GetDbApp téléchargera le fichier backup à partir du serveur Octopus. Ex: (\\MySqlServer\OctopusBackups\).
- Un ordinateur qui exécutera GetDbApp (inclut avec l'installation d'Octopus).
Modifier Paramètres du programme ESI.Octopus.GetDbApp.exe
Le programme de type command-line nécessite 3 paramètres:
/Login : Nom d'utilisateur d'un compte Octopus qui sera utilisé pour accéder au serveur Octopus pour télécharger la base de données.
/Password : Mot de passe pour le compte mentionné ci-dessus.
/ConfigFilePath : Un chemin vers le fichier de configuration. La prochaine section explique comment préparer le fichier de configuration.
/KeepDownloadedBackup : Permet de ne pas effacer le fichier de backup après l'avoir restauré.
/NoRestore : Ne restaure pas la base de données. Cette option permet seulement de copier le fichier.
Modifier Fichier de configuration
Le fichier de configuration est un fichier texte qui contient l'information sur le serveur SQL, l'emplacement du répertoire partagé et d'autres paramètres nécessaires au programme. Ce fichier utilise le format XML.
Avertissement
Avant de commencer la création du fichier de configuration, prenez soin de ne pas briser le format de fichier en modifiant les étiquettes ou la structure de fichier. Un seul "/" ou "<" ou ">" manquant ou additionnel pourra rendre le fichier inutile. Assurez-vous que les valeurs spécifiées sont valides. Ne laissez pas d'espaces vides avant ou après les valeurs. En cas d'erreur avec le fichier de configuration, le logiciel va s'arrêter sans problème. Cependant, le logiciel n'est pas très clair dans la façon qu'il avise des erreurs, alors des erreurs pourront être difficiles à trouver.
Une vérification diligente des valeurs est recommandée avant de démarrer le programme.
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<serverBackupLocationUNC>\\MySqlServer\OctopusBackups</serverBackupLocationUNC>
<serverName>MySqlServer</serverName>
<databaseName>OctopusDatabase</databaseName>
<autenticationMode>sql</autenticationMode>
<userName>sa</userName>
<password>password</password>
</configuration>
- Avec notepad, créez un fichier avec l'extension .xml contenant la configuration ci-haut.
- Remplacez les valeurs de chaque paramètre.
- Sauvegarder le fichier dans c:\program files\Octopus\GetDbAppConfiguration.xml.
Note: L'élément de configuration nommé
autenticationMode peut être mis à la valeur
integrated. Dans ce cas, les lignes de configuration
userName et
password ne seront pas utilisées. Ce mode
integrated peut seulement être utilisé s'il est supporté dans la configuration de SQL Server.
Modifier Que fait le programme exactement ?
- Connecte au serveur Octopus.
- Télécharge le backup de la BD Octopus dans le répertoire partagé sur le serveur SQL.
- Déconnecte du serveur Octopus.
- Décompresse le fichier téléchargé dans le répertoire partagé.
- Connecte au serveur SQL.
- Écrase la BD actuelle avec la BD nouvellement téléchargée.
- Déconnecte du serveur SQL.
- Supprime les fichiers téléchargés (il existe une option à la ligne de commande /KeepDownloadedBackup pour ne pas effacer le fichier).
ModifierExécution de ESI.Octopus.GetDbApp.exe
- Ouvrir une fenêtre command-line
- Entrez la commande suivante et appuyez sur ENTER: c:\
- Entrez la commande suivante et appuyez sur ENTER: cd c:\program files\octopus\
- Entrez la commande suivante en fournissant les valeurs correctes pour les 3 paramètres et appuyez sur ENTER: ESI.Octopus.GetDbApp.exe /Login: loginname /Password:password /ConfigFilePath: path
Modifier Comment automatiser GetDbApp pour télécharger à chaque jour
Pour automatiser GetDbApp, créez une tâche planifiée dans Windows qui exécute ESI.Octopus.GetDbApp.exe une fois par jour ou par semaine selon le besoin.