Procédures utilisateur

Lors de l’exécution des scripts Lua, l’administrateur obtient l’accès à tout le système de fichiers à l’intérieur du répertoire du Serveur et aux certaines commandes sur l’ordinateur avec le Serveur installé.

Pour interdire l’accès aux procédures utilisateur, désactivez le droit Éditer la configuration du Serveur et du référentiel pour l’administrateur correspondant (voir le p. Administrateurs et groupes administrateur).

Pour faciliter et automatiser l’exécution de certaines tâches du Serveur Dr.Web, il est possible d’utiliser les procédures utilisateur effectuées en tant que scripts Lua.

Les procédures utilisateur sont placées dans le sous-répertoire suivant du répertoire d’installation du Serveur :

sous Windows : var\extensions

sous FreeBSD : /var/drwcs/extensions

sous Linux : /var/opt/drwcs/extensions

Après l’installation du Serveur, dans ce sous-répertoire sont placées les procédures utilisateur préinstallées.

Il est recommandé d’éditer les procédures utilisateur via le Centre de gestion.

Pour configurer l’exécution des procédures utilisateur :

1.Sélectionnez l’élément Administration dans le menu principal du Centre de gestion.

2.Dans la fenêtre qui s’ouvre, choisissez Procédures utilisateur dans le menu de gestion. Une autre fenêtre va s’ouvrir.

Arborescence des procédures

La liste hiérarchique des procédures affiche une arborescence, dont les noeuds sont des groupes de procédures et des procédures utilisateur appartenant à ces groupes.

Initialement, l’arborescence des procédures contient des groupes pré-installés suivants :

Examples of the hooks contient des modèles de toutes les procédures utilisateur disponibles. Sur la base de ces modèles, vous pouvez créer vos propres procédures utilisateur. La modification et l’exécution des procédures de modèles ne sont pas disponibles.

IBM Syslog contiennent de modèles des procédures utilisateur utilisées lors de l’intégration avec le système IBM Tivoli. Les événements correspondant aux procédures activées sont enregistrés au format Syslog.

Tous les événements sont enregistrés dans le même fichier par le chemin suivant :

sous Windows :
var\export\tivoli\syslog\drwcs_syslog.log

sous FreeBSD :
/var/drwcs/export/tivoli/syslog/drwcs_syslog.log

sous Linux :
/var/opt/drwcs/export/tivoli/syslog/drwcs_syslog.log

IBM W7Log contiennent de modèles des procédures utilisateur utilisées lors de l’intégration avec le système IBM Tivoli. Les événements correspondant aux procédures activées sont enregistrés au format IBM W7Log XML.

Pour chaque événement in fichier à part est créé par le chemin suivant :

sous Windows :
var\export\tivoli\w7log\<nom_de_l’événement>_<unix_timestamp>

sous FreeBSD :
/var/drwcs/export/tivoli/w7log/<nom_de_l’événement>_<unix_timestamp>

sous Linux :
/var/opt/drwcs/export/tivoli/w7log/<nom_de_l’événement>_<unix_timestamp>

L’apparence de l’icône dépend du type et du statut de cet élément (voir le tableau ci-dessous).

Icônes des éléments de l’arborescence de procédures

Icône

Description

Groupes de procédures

Groupe de procédures pour lequel l’exécution des procédures est autorisée.

Groupe de procédures pour lequel l’exécution des procédures est interdite.

Procédures

Procédure pour laquelle l’exécution est autorisée.

Procédure pour laquelle l’exécution est interdite.

Gestion de l’arborescence des procédures

Pour gérer les objets de l’arborescence, utilisez les éléments suivants de la barre d’outils :

 : liste déroulante pour l’ajout d’un élément à l’arborescence des procédures :

Ajouter une procédure : ajouter une nouvelle procédure utilisateur.

Ajouter un groupe de procédures : ajouter un nouveau groupe utilisateur pour y placer des procédures.

Supprimer les objets sélectionnés : supprimer une procédure utilisateur ou un groupe de procédures sélectionné dans l’arborescence.

Autoriser l’exécution de la procédure : la même action est effectuée via l’éditeur de procédures si vous cochez la case Autoriser l’exécution de la procédure. Voir aussi Activation des procédures.

Désactiver l’exécution de la procédure : la même action est effectuée via l’éditeur de procédures si vous décochez la case Activer l’exécution de la procédure. Voir aussi Activation des procédures.

Gestion des groupes de procédures

Pour créer un nouveau groupe :

1.Dans la barre d’outils, sélectionnez Ajouter un groupe de procédures.

2.Dans la fenêtre qui s’affiche, configurez les paramètres suivants :

Cochez la case Autoriser l’exécution de la procédure pour activer les procédures qui seront inclues dans ce groupe. Voir aussi Activation des procédures.

Dans le champ Nom de groupe, spécifiez un nom pour le groupe créé.

3.Cliquez sur Enregistrer.

Pour modifier l’ordre de l’utilisation des groupes :

1.Dans l’arborescence, glissez-déposez (drag and drop) un groupe de procédures et mettez-le dans le bon ordre par rapport aux autres groupes.

2.Si vous modifiez l’ordre des groupes, l’ordre de l’utilisation des procédures va changer automatiquement : les procédures des groupes qui sont placés plus haut dans l’arborescence seront exécutées les premières.

Pour déplacer une procédure dans un autre groupe :

1.Sélectionnez dans l’arborescence la procédure que vous voulez déplacer.

2.Dans le panneau de propriétés qui s’affiche, sélectionnez dans la liste déroulante Groupe supérieur le groupe dans lequel il faut placer la procédure.

3.Cliquez sur Enregistrer.

Gestion des procédures

Pour ajouter une nouvelle procédure :

1.Dans la barre d’outils, sélectionnez Ajouter une procédure.

2.Dans la fenêtre qui s’affiche, configurez les paramètres suivants :

Cochez la case Autoriser l’exécution de la procédure pour activer la procédure créée. Voir aussi Activation des procédures.

Dans la liste déroulante Groupe parent, sélectionnez le groupe dans lequel la procédure sera placée. Plus tard, vous pourrez déplacer la procédure dans un autre groupe – voir ci-dessus.

Dans la liste déroulante Procédure, sélectionnez le type de la procédure. Le type de la procédure désigne l’action pour laquelle cette procédure sera appelée.

Dans le champ Texte de procédure, entrez le script lus qui sera exécuté lors de l’appel de cette procédure.
Dans la sous-rubrique Information sur la procédure vous pouvez consulter l’événement pour lequel cette procédure sera appelée, ainsi que les informations sur la disponibilité de la base de données du Serveur pour cette procédure et les listes des paramètres d’entrée et des valeurs de retour pour ce type de la procédure.

3.Cliquez sur Enregistrer.

Pour éditer une procédure :

1.Sélectionnez dans l’arborescence la procédure que vous voulez éditer.

2.Dans la partie droite de la fenêtre, un panneau des propriétés de cette procédure va s’afficher automatiquement. Vous pouvez modifier tous les paramètres spécifiées lors de la création de la procédure, sauf le paramètre Procédure. Ce paramètre désigne l’événement pour lequel cette procédure est appelée et il n’est pas modifiable après la création de la procédure.

3.Cliquez sur Enregistrer.

Activer une procédure

L’activation des procédures et des groupes détermine si les procédures seront exécutées quand l’événement correspondant a eu lieu ou non.

Pour activer une procédure ou un groupe de procédures :

1.Sélectionnez dans l’arborescence la procédure ou le groupe que vous voulez activer.

2.Effectuez une des actions suivantes :

Dans la barre d’outils, cliquez sur le bouton Autoriser l’exécution de la procédure.

A droite de la fenêtre, dans le panneau de propriétés de l’objet sélectionné, cochez la case Autoriser l’exécution de la procédure, si la case est décochée. Cliquez sur le bouton Enregistrer.

Particularités de l’activation des procédures :

Pour que la procédure soit exécutée si l’événement correspondant a eu lieu, il faut que :

a)la procédure soit activée ;

b)le groupe qui contient cette procédure soit activé.

Si le groupe de procédures est désactivé, les procédures qui y sont inclues ne seront pas exécutées même si elles sont activées.

Si vous activez un groupe, notez que seules les procédures activées seront exécutées.