Les commandes externes Manon, pèse su’l piton 29 mai 2017

Contenu de la présentation Survol des commandes externes À quoi ça sert ? Avantages et inconvénients ? Comment l’utiliser ? Configuration Comment le configurer ? Meilleures pratiques ? Fonctions avancées Gestion de l’identité Traitement des erreurs ExternalCommandRunner

survol Ça me donne quoi, à moi ?

À quoi ça sert ? Déclencher un programme à partir d’Octopus Ajoute une action ou un outil Utilisable par tous les intervenants Quel genre de programmes ? Programme Windows (.exe) pour en lancer l’interface graphique Application console (à partir de la ligne de commande) Interpréteur de commande (script, batch) Fichier ayant une extension connue (document Excel) Protocole ayant une application enregistrée (site web)

Cas d’utilisations Des exemples Ouvrir un accès sur le partage administratif d’un ordinateur [C$]. Lancer un ping sur un CI de type ordinateur, routeur, pare-feu, etc. Accéder à l’interface de gestion d’une imprimante, photocopieur, etc. Ouvrir simplement un document Excel. Exécuter automatiquement une importation avec DataImporter.

Avantages, inconvénients Réduit le risque d’erreur Augmente l’efficience Améliore l’expérience

Avantages, inconvénients Réduit le risque d’erreur Augmente l’efficience Améliore l’expérience Inconvénients Configuration plus complexe Fonctionnalité dépends de vous

Parce que ça ne fonctionne pas tout seul… configuration Parce que ça ne fonctionne pas tout seul…

Configuration Nécessite la permission Administrer Octopus. Configuré dans Outil | Gestion des données de référence. Situé sous Général | Commandes externes. Clique droit pour créer

Configuration S’applique à… (Vide): partout CI Contrat de location Événement Incident/SR Problème Tâche Utilisateur Changements Types de CI spécifique Contrat de service Fournisseur Pièce Rappel Tâche planifiée

Configuration de la commande Exemple à la ligne de commande C:\Utilisateurs\dloranger\> ping –t ordinateur_cible

Configuration de la commande Exemple à la ligne de commande Exemple de configuration d’une commande externe Programme: c:\windows\system32\ping.exe Démarrer dans: <vide> Paramètres: -t <<F3>> C:\Utilisateurs\dloranger\> ping –t ordinateur_cible

Configuration de la commande Exemple à la ligne de commande Exemple de configuration d’une commande externe Programme: c:\windows\system32\ping.exe Démarrer dans: <vide> Paramètres: -t [[@ConfigurationItem.CIExtendedAttributeType268]] C:\Utilisateurs\dloranger\> ping –t ordinateur_cible

les meilleures pratiques Toujours utiliser un fichier de script Mettre en place de la journalisation pour faciliter le soutien Déposer tous les scripts dans un dossier commun

Fonctions avancées Mais ce n’est pas tout…

Fonctions avancées Gestion des identités Octopus utilise le contexte de l’utilisateur courant. Utiliser la commande runas.exe dans le script pour changer de contexte. Logique de traitement des erreurs Doit être effectuée dans le script. Au besoin, passer plus de paramètres décisionnels. Par exemple, discriminer les OS Linux lors de l’ouverture du share C$.

External command runner

External command runner

External Command runner Composantes Une commande externe s’appliquant à un Incident/SR Une demande de service Une tâche dans la SR au type Commande externe Et… Un moyen de déclencher automatiquement la commande externe

External command runner Plus exactement ESI.Octopus.ExternalCommandRunnerApp.exe. Application ‘ligne de commande’ à planifier de manière récurrente. Vérifie la présence de tâche Commande externe active. Exécute la commande puis marque la tâche résolue. Vérifie à nouveau la présence de tâche candidate.

External command runner Considérations additionnelles ECR utilise les code de retour de la ligne de commande pour évaluer le succès. Si la commande externe échoue, la tâche est marquée en erreur. Les erreurs de ECR sont inscrites dans le module Événements. Le journal d’exécution de ECR va contenir le résultat des commandes. Attention aux accès pour ECR: Localisation de la commande Contexte de la tâche planifiée

Mot de la fin

Récapitulatif Aujourd’hui, on a discuter… Les avantages et inconvénients. La configuration d’une nouvelle CommandeExterne. Les meilleures pratiques pour faciliter l’utilisation de la fonctionnalité. Les fonctionnalités avancées: identités, erreurs, et ExternalCommandRunner.

Références Article sur les commandes externes Article sur l’application ExternalCommandRunner

Questions ? Commentaires ? Témoignages ?

Merci ! David Loranger Spécialiste Technique dloranger@octopus-itsm.com