Spécifcation technique ITSM Cockpit Page: 1 / 18
Table des matières Introduction... 3 Architecture... 4 Confguration du système... 6 I.Logiciels installés...6 II.Localisation des fchiers...6 A.Base de données... 6 B.Fichiers ITSM Cockpit... 6 III.Tâches planifées...6 IV.Lancement des applications...7 V.Batchs ITSM Cockpit...7 Arrêt / Démarrage de l application ITSM Cockpit...8 I.Séquencement...8 II.Base de données MariaDB...8 III.ITSM Cockpit Portal...8 IV.ITSM Cockpit Engine...9 V.ITSM Cockpit Manager...9 Sauvegardes et restaurations... 10 I.Sauvegardes...10 A.Fichiers de confguration et librairies... 10 B.Application... 10 C.Documents... 10 D.Base de données... 10 II.Restaurations...11 A.Fichiers... 11 B.Base de données... 11 Eléments à surveiller... 12 A.Système des serveurs... 12 B.Sauvegardes... 12 C.Application ITSM Cockpit... 12 Mises à jour... 14 I.Mise à jour de l'instance ITSM Cockpit...14 A.Sauvegarde... 14 B.Mise à jour de la base de données... 14 C.Mise à jour d'itsm Cockpit Portal... 15 D.Mise à jour d'itsm Cockpit Engine (mode local)... 15 E.Mise à jour d'itsm Cockpit Engine (mode déporté)... 15 II.Mise à jour d'itsm Cockpit Manager...17 III.Mise à jour de la licence...17 Page: 2 / 18
Introduction Ce document s'adresse aux techniciens en charge de l'administration courante des différents composants liés à l'application ITSM Cockpit. Il décrit les modes opératoires des principales tâches d'administration ainsi que les éléments à superviser afn de s'assurer du bon fonctionnement de l'application ITSM Cockpit. Il indique quels sont les fchiers de confguration et de logs et comment y accéder. Il défnit les procédures à suivre afn de mettre à jour les différents composants. Page: 3 / 18
Architecture Une instance ITSM Cockpit est composée de plusieurs éléments : Une base de données Un ou plusieurs portails Un ou plusieurs moteurs Le schéma ci-après décrit l'architecture d'une instance ITSM Cockpit simple. Page: 4 / 18
Le schéma ci-après décrit l'architecture ITSM Cockpit avec plusieurs moteurs déportés sur des réseaux différents. Page: 5 / 18
Confguration du système I. Logiciels installés Système d'exploitation Base de données Utilisation ITSM Cockpit Portal Version 2 ITSM Cockpit Engine ITSM Cockpit Manager 2008 server (64 bits) 2012 server (64 bits) MariaDB 5.X (64 bits) Logiciel II. Localisation des fchiers A. Base de données Fichier Utilisation Localisation koaly.cnf Confguration de la base de données MariaDB /etc/mysql/conf.d/ syslog Logs de la base de données MariaDB /var/log/ B. Fichiers ITSM Cockpit Répertoire C:\koaly\backups C:\koaly\exp\database C:\koaly\exp\documents C:\koaly\exp\engine C:\koaly\exp\portal C:\koaly\management-interface C:\koaly\update C:\koaly\tools Utilisation Sauvegardes Données Base de données MariaDB Données Fichiers (documents, pièces jointes, etc.) ITSM Cockpit Engine ITSM Cockpit Portal ITSM Cockpit Manager Fichiers de mise à jour Outils (sauvegarde, etc.) III. Tâches planifées Liste des tâches planifiées au niveau du planificateur de tâches du système Page: 6 / 18
Tâche Description Fréquence ITSM Cockpit DB Dump Exécute un Dump de la base de données 1 fois par jour IV. Lancement des applications Mode de lancement des applications Service Description Démarrage Koaly EXP Engine ITSM Cockpit Engine Automatique Koaly EXP Portal ITSM Cockpit Portal Automatique Koaly Management Interface ITSM Cockpit Manager Automatique MySQL Base de données MariaDB Automatique V. Batchs ITSM Cockpit Un planifcateur interne permet d'exécuter des batchs régulièrement. Il s'agit de bacths techniques nécessaires au bon fonctionnement de l'application. Les bacths sont exécutés par le portail. Batch Liste des batchs Planifcateur de tâches Module «Tâches» Planifcation des tâches Fonction Agrégation des données Module «Infrastructure» Consolidation des données du capacity planning Purge Archivage Statistiques JMS Module «Supervision» Consolidation des données des contrôles avec graphique Suppression des données obsolètes (logs, tâches acquittées, etc.) Archivage des données anciennes dans une seconde base de données Récupération et mise à jours des statistiques du Bus Afn de confgurer les batchs (portail d'exécution, statut, horaire, etc.), il faut : Se connecter au portail ITSM Cockpit. Ouvrir le menu «Administration / Paramétrage / Outils / Planning des batchs». Page: 7 / 18
Arrêt / Démarrage de l application ITSM Cockpit I. Séquencement Arrêt : 1. ITSM Cockpit Engine 2. ITSM Cockpit Portal 3. ITSM Cockpit Manager 4. Base de données MariaDB Démarrage : 1. Base de données MariaDB 2. ITSM Cockpit Manager 3. ITSM Cockpit Portal 4. ITSM Cockpit Engine Note : L'interface de gestion ITSM Cockpit Manager est indépendante de l'application ITSM Cockpit. Elle peut être arrêtée et démarrée sans impacter l'application ITSM Cockpit. II. Base de données MariaDB Ouvrir la console de gestion des services. Vérifer le statut de l'application : Contrôler le statut du service «MySQL». Démarrer l'application : Démarrer le service «MySQL». Stopper l'application : Stopper le service «MySQL». III. ITSM Cockpit Portal Se connecter à l'itsm Cockpit Manager du serveur cible (par défaut: https://serveur:8081). Ouvrir le menu de gestion des portails. Ouvrir le panneau de contrôle du portail. Ouvrir l'onglet «Contrôle». Vérifer le statut de l'application : Page: 8 / 18
Contrôler le statut actuel. Cliquer sur «Recharger» afn de mettre le statut à jour. Démarrer l'application : Cliquer sur «Stopper». Cliquer sur «Recharger» afn de mettre le statut à jour. Stopper l'application : Cliquer sur «Arrêter». Cliquer sur «Recharger» afn de mettre le statut à jour. ITSM Cockpit Administration Windows IV. ITSM Cockpit Engine Se connecter à l'itsm Cockpit Manager du serveur cible (par défaut: https://serveur:8081). Ouvrir le menu de gestion des moteurs. Ouvrir le panneau de contrôle du moteur. Ouvrir l'onglet «Contrôle». Note : Le menu de contrôle des moteurs est accessible depuis le portail ITSM Cockpit (menu Administration / Paramètres techniques / Moteurs) Vérifer le statut de l'application : Contrôler le statut actuel. Cliquer sur «Recharger» afn de mettre le statut à jour. Démarrer l'application : Cliquer sur «Stopper». Cliquer sur «Recharger» afn de mettre le statut à jour. Stopper l'application : Cliquer sur «Arrêter». Cliquer sur «Recharger» afn de mettre le statut à jour. V. ITSM Cockpit Manager Ouvrir la console de gestion des services. Vérifer le statut de l'application : Contrôler le statut du service «Koaly Management Interface». Démarrer l'application : Démarrer le service «Koaly Management Interface». Stopper l'application : Stopper le service «Koaly Management Interface». Page: 9 / 18
Sauvegardes et restaurations I. Sauvegardes A. Fichiers de confguration et librairies Sauvegarder les fchiers de confguration (my.ini, etc.) après chaque modifcation. B. Application Sauvegarder les fchiers de l'application ITSM Cockpit (C:\koaly\exp) après chaque modifcation. C. Documents Réaliser une sauvegarde quotidienne du répertoire: C:\koaly\exp\documents\ D. Base de données Un dump de la base de données est réalisé régulièrement via le script C:\koaly\tools\koalyexp_db_dump.bat lancé depuis le planifcateur de tâches Windows. Le dump génère un fchier SQL compressé et stocke ce fchier dans le répertoire C:\koaly\backups\database. Le format du fchier est KOALYEXP_AAAAMMJJ_HHMM.gz. Les dix derniers fchiers sont conservés. Réaliser une sauvegarde quotidienne du répertoire des dumps. Conserver la sauvegarde quotidienne durant une semaine au moins. Afn de réaliser un dump manuel (si besoin) en ligne de commande, il faut se rendre dans le répertoire MariaDB C:\Program Files\MariaDB 5.5\bin\ et exécuter la commande suivante. Commande : mysqldump koalyexp -u utilisateur -pmotdepasse -BFcq --single-transaction > nom_fchier.sql Description de la commande : Commande : mysqldump Options : u : utilisateur SQL p : mot de passe de l'utilisateur SQL B : indique «USE dbname» au niveau du fchier SQL de dump. F : effectuer un fush des logs avant de lancer la sauvegarde Page: 10 / 18
c : générer des INSERTs complets des données q : permet d'accélérer la sauvegarde des tables volumineuses single-transaction : génère le dump dans une seule transaction afn que le dump soit consistant nom_fchier.sql : nom du fchier SQL généré par le dump II. Restaurations A. Fichiers La restauration des fchiers (confguration, librairies, application, documents) s'effectue par recopie des fchiers. B. Base de données Il est possible de restaurer les fchiers de dump SQL. Commande (utiliser cmd.exe). cd "C:\Program Files\MariaDB 5.5\bin" mysql -u root -p Indiquer le mot de passe. Si nécessaire, supprimer l'ancienne base de données ITSM Cockpit. DROP DATABASE koalyexp; Créer la base de données. CREATE DATABASE koalyexp; Sélectionner la base de données ITSM Cockpit. USE koalyexp; Restaurer le dump. source xxxx.sql; Description des options : u : utilisateur SQL p : mot de passe de l'utilisateur SQL xxxx.sql : nom du fchier à restaurer Page: 11 / 18
Eléments à surveiller A. Système des serveurs Contrôler les points suivants régulièrement. Disque Supervision des disques C:\ 30.00% Seuil d'espace libre Service Koaly EXP Engine Koaly EXP Portal Koaly Management Interface MySQL Supervision des services Actif Actif Actif Actif Statut B. Sauvegardes Dumps SQL. Effectuer régulièrement un test de restauration sur une base de données MariaDB indépendante. Sauvegarde des documents. Effectuer régulièrement un test de restauration des fchiers dans un répertoire indépendant. C. Application ITSM Cockpit Contrôler le statut des moteurs. Au niveau du portail, ouvrir le menu «Accueil / Tableau de bord». Le statut de tous les moteurs doit être vert. Contrôler régulièrement les logs des moteurs. Se connecter à l'itsm Cockpit Manager du serveur cible (par défaut: https://serveur:8081). Ouvrir le menu de gestion des moteurs. Ouvrir le panneau de contrôle du moteur. Ouvrir l'onglet «Logs». Page: 12 / 18
Contrôler les fchiers de log suivants. Fichiers de logs des moteurs Nom Description engine.log Ensemble des messages warn.log Messages de niveau «error» et «warning» error.log Messages de niveau «error» mail.log Messages liés à la fonctionnalité d'envoi de mails (passerelle SMTP) sms.log Messages liés à la fonctionnalité d'envoi de sms (passerelle SMS) Contrôler régulièrement les logs des portails : Se connecter à l'itsm Cockpit Manager du serveur cible (par défaut: https://serveur:8081). Ouvrir le menu de gestion des portails. Ouvrir le panneau de contrôle du portail. Ouvrir l'onglet «Logs». Contrôler les fchiers de log suivants. Fichiers de logs des portails Nom Description koaly_exp.log Ensemble des messages koaly_exp_warring.log Messages de niveau «error» et «warning» koaly_exp_error.log Messages de niveau «error» Contrôler régulièrement les logs des batchs internes. Se connecter au portail ITSM Cockpit. Ouvrir le menu «Administration / Paramétrage / Outils /Logs des batchs». Vérifer qu'il n'y a pas d'événement «Erreur» dans l'historique. Page: 13 / 18
Mises à jour I. Mise à jour de l'instance ITSM Cockpit A. Sauvegarde Avant la mise à jour de l'instance, il est recommandé de sauvegarder les différents éléments qui composent l'instance. 1. Sauvegarde de la base de données. 2. Sauvegarde des documents (répertoire par défaut C:\koaly\exp\documents). En cas de système sécurisé (cluster, réplication), débrayer le système de synchronisation (si possible) afn de conserver un des environnements dans l'ancienne version. La synchronisation pourra être activée après validation de la mise à jour. B. Mise à jour de la base de données 1. Se connecter à l'itsm Cockpit Manager du serveur cible (par défaut: https://serveur:8081). 2. Sélectionner le menu «Base de données». 3. Choisir le fchier koaly-exp-db-update-x.y.z (fourni par le support) dans la partie «Téléchargement paquet de mise à jour». 4. Cliquer sur «Télécharger». 5. Vérifer que la version indiquée dans le champs «Dernière version» correspond à la version à installer. Pour lancer la mise à jour, il y a deux options. 1. Mise à jour depuis le Manager Cliquer sur «Lancer migration». Les logs de migration s'affchent dans une zone de notifcation. Elles peuvent être téléchargées et envoyées à l'éditeur en cas d'erreur de mise à jour. 2. Génération d'un script de mise à jour Cliquer sur «Générer script». Le script généré peut être appliqué manuellement à la base de données. Page: 14 / 18
C. Mise à jour d'itsm Cockpit Portal 1. Se connecter à l'itsm Cockpit Manager associé au portail (par défaut: https://serveur:8081). 2. Ouvrir le menu de gestion des portails. 3. Ouvrir le panneau de contrôle du portail. 4. Ouvrir l'onglet «Mise à jour». Les noms de la version actuelle et la nouvelle version apparaissent. 5. Charger le fchier de mise à jour koaly-exp-portal-service-update.zip (fourni par le support) et appuyer sur «Télécharger». 6. Vérifer que la version indiquée dans le champs «Dernière version» correspond à la version à installer. 7. Cliquer sur le bouton «Mettre à jour». 8. Le portail est mis à jour. L'arrêt puis le redémarrage du portail sont automatiques. 9. Contrôler les logs du portail. 10. Se connecter au portail afn de s'assurer qu'il fonctionne correctement. D. Mise à jour d'itsm Cockpit Engine (mode local) 1. S'assurer que les librairies externes sont bien présentes dans le répertoire des librairies (par défaut : C:\koaly\update\koaly-exp-engine\ext\lib) 2. Se connecter à l'itsm Cockpit Manager associé au moteur (par défaut: https://serveur:8081). 3. Ouvrir le menu de gestion des moteurs. 4. Ouvrir le panneau de contrôle du moteur. 5. Ouvrir l'onglet «Mise à jour». Les noms de la version actuelle et la nouvelle version apparaissent. 6. Charger le fchier de mise à jour koaly-exp-engine-service-update.zip (fourni par le support) et appuyer sur «Télécharger». 7. Vérifer que la version indiquée dans le champs «Dernière version» correspond à la version à installer. 8. Cliquer sur le bouton «Mettre à jour». 9. Le moteur est mis à jour. L'arrêt puis le redémarrage du moteur sont automatiques. 10. Contrôler les logs du moteur. E. Mise à jour d'itsm Cockpit Engine (mode déporté) 1. Mise à jour automatique Dans la plupart des cas, la mise à jour des moteurs déportés se fait automatiquement. Le moteur détecte qu'une nouvelle version est disponible en se connectant au portail et se met à jour automatiquement. Pour mettre à disposition une nouvelle version au niveau du portail : Page: 15 / 18
1. Télécharger le fchier koaly-exp-engine-standalone-service-update.zip. 2. Au niveau du portail, ouvrir le menu «Administration / Paramétrage / Moteur / Mise à jour» et cliquer sur «Mettre en ligne». 3. Sélectionner le fchier koaly-exp-engine-standalone-service-update.zip pour le mettre en ligne. 4. Une fois la mise en ligne effectuée, les moteurs déportés téléchargeront la nouvelle version et se mettront à jour automatiquement. 2. Mise à jour manuelle Certaines mises à jour majeures ne pourront pas être effectuées automatiquement. Ce point sera spécifé dans les mails d'information qui accompagnent les mises à jour. La procédure de mise à jour manuelle peut également être nécessaire en cas de dysfonctionnement de la mise à jour automatique. A fn de mettre à jour manuellement un moteur déporté : 1. Télécharger le fchier koaly-exp-engine-standalone-v.x.x.x-setup.exe. 2. Stopper le service «Koaly EXP Engine». 3. Sauvegarder les répertoires suivants : confguration (par défaut : C:\koaly\exp\engine\conf) librairies externes (par défaut : C:\koaly\exp\engine\ext\lib) 4. Sauvegarder le fchier koaly-exp-engine-service.exe.confg (dans C:\koaly\exp\engine). 5. Désinstaller le moteur en exécutant Uninstall.exe (dans C:\koaly\exp\engine). Page: 16 / 18
6. Exécuter le programme koaly-exp-engine-standalone-v.x.x.x-setup.exe. 7. Restaurer les répertoires et le fchier sauvegardés. 8. Démarrer le service «Koaly EXP Engine». II. Mise à jour d'itsm Cockpit Manager Afn de mettre à jour ITSM Cockpit Manager, il faut le désinstaller puis le réinstaller. 1. Ouvrir la console de gestion des services Windows. Arrêter le service «Koaly Management Interface». 2. Ouvrir le répertoire d'installation d'itsm Cockpit Manager (par défaut C:\koaly\management-interface). Sauvegarder les fchiers suivants : conf\service.xml conf\koaly.confg 3. Désinstaller ITSM Cockpit Manager via le gestionnaire de programmes Windows 4. Installer la nouvelle version d'itsm Cockpit Manager : Exécuter le programme : koaly-management-interface-vxxx-setup.exe Sélectionner «Suivant». Sélectionner «Tous les utilisateurs». Modifer le répertoire d'installation par défaut (C:\koaly\management-interface) si nécessaire. Modifer le répertoire de raccourci par défaut (Koaly\Koaly Management Interface) si nécessaire. Sélectionner «Suivant». Sélectionner «Fin». 5. Ouvrir le répertoire d'installation d'itsm Cockpit Manager (par défaut C:\koaly\management-interface). Copier les anciens fchiers dans le nouveau répertoire (remplacer les fchiers existants si nécessaire). conf\service.xml conf\koaly.confg 6. Ouvrir la console de gestion des services. Démarrer le service «Koaly Management Interface». 7. Se connecter à l'interface d'itsm Cockpit Manager (par défaut: https://serveur:8081) III. Mise à jour de la licence 1. Se connecter au portail. 2. Ouvrir le menu «Administration / Paramètres techniques / Portail / Licences». 3. Cliquer sur le bouton «Télécharger» et télécharger le fcher de licence fourni par le support. 4. Un message indique si la licence est valide ou pas. 5. Si la licence est valide, cliquer sur le bouton «Sauvegarder». Page: 17 / 18
6. Si la licence n'est pas valide, contacter le support. ITSM Cockpit Administration Windows Fin du document Page: 18 / 18