![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
Tâches d'administration de l'ensemble de règles
Vous pouvez utiliser les commandes ruleset de l'ensemble de règles pour ajouter, supprimer ou modifier des règles et des actions dans le fichier ruleset.xml sans utiliser la console d'administration.
createRuleset
La commande createRuleset crée une liste d'ensemble de règles.
Paramètres requis
- -rulesetName
- Indique le nom de l'ensemble de règles. (Chaîne, obligatoire)
- -rulesetType
- Indique le type de protocole à associer à l'ensemble de règles. Les types valides sont HTTP et SOAP. (Chaîne, obligatoire)
- -defaultContinue
- Définit la valeur de l'indicateur de continuation par défaut. Les valeurs admises sont True et False. (Booléen, requis)
Paramètres optionnels
- -odrname
- Indique le nom du routeur ODR auquel s'applique l'ensemble de règles. Le paramètre -odrname est requis uniquement si vous modifiez un routeur ODR. (Chaîne, facultatif)
- -nodename
- Indique le nom du noeud sur lequel réside le routeur ODR. Le paramètre -nodename est requis uniquement si vous modifiez un routeur ODR. (Chaîne, facultatif)
- -clustername
- Indique le nom du cluster auquel s'applique l'ensemble de règles. Le paramètre -clusterName est requis uniquement si vous modifiez un cluster ODR. (Chaîne, facultatif)
Utilisation de l'exemple de mode de traitement par lots
- Avec Jacl :
$AdminTask createRuleset {-odrname odr -nodename noeud1 -rulesetName monEnsembleDeRègles -rulesetType HTTP -defaultContinue True}
- A l'aide de la chaîne Jython :
AdminTask.createRuleset ('-odrname odr -nodename noeud1 -rulesetName monEnsembleDeRègles -rulesetType HTTP -defaultContinue True')
Exemple d'utilisation en mode interactif
- Avec Jacl :
$AdminTask createRuleset {-interactive}
- A l'aide de la chaîne Jython :
AdminTask.createRuleset ('[-interactive]')
listRuleset
La commande listRuleset affiche la liste des règles et des actions de l'ensemble de règles.
Paramètres obligatoires
- -rulesetName
- Indique le nom de l'ensemble de règles. (Chaîne, obligatoire)
Paramètres optionnels
- -odrname
- Indique le nom du routeur ODR auquel s'applique l'ensemble de règles. Le paramètre -odrname est requis uniquement si vous modifiez un routeur ODR. (Chaîne, facultatif)
- -nodename
- Indique le nom du noeud sur lequel réside le routeur ODR. Le paramètre -nodename est requis uniquement si vous modifiez un routeur ODR. (Chaîne, facultatif)
- -clustername
- Indique le nom du cluster auquel s'applique l'ensemble de règles. Le paramètre -clusterName est requis uniquement si vous modifiez un cluster ODR. (Chaîne, facultatif)
Utilisation de l'exemple de mode de traitement par lots
- Avec Jacl :
$AdminTask listRuleset {-odrname odr -nodename noeud1 -rulesetName monEnsembleDeRègles}
- A l'aide de la chaîne Jython :
AdminTask.listRuleset ('-odrname odr -nodename noeud1 -rulesetName monEnsembleDeRègles')
Exemple d'utilisation en mode interactif
- Avec Jacl :
$AdminTask listRuleset {-interactive}
- A l'aide de la chaîne Jython :
AdminTask.listRuleset ('[-interactive]')
addRuleToRuleset
La commande addRuleToRuleset ajoute une règle à l'ensemble de règles.
Paramètres obligatoires
- -rulesetName
- Indique le nom de l'ensemble de règles. (Chaîne, obligatoire)
- -ruleName
- Indique le nom de la règle. Le paramètre -ruleName doit être unique dans l'ensemble de règles. (Chaîne, obligatoire)
- -rulePriority
- Indique une valeur sous forme d'entier positif représentant la priorité de la règle. Zéro est la priorité la plus élevée. (Chaîne, obligatoire)
- -expression
- Indique l'expression de règle. La valeur doit figurer entre guillemets. (Chaîne, obligatoire)
Paramètres optionnels
- -odrname
- Indique le nom du routeur ODR auquel s'applique l'ensemble de règles. Le paramètre -odrname est requis uniquement si vous modifiez un routeur ODR. (Chaîne, facultatif)
- -nodename
- Indique le nom du noeud sur lequel réside le routeur ODR. Le paramètre -nodename est requis uniquement si vous modifiez un routeur ODR. (Chaîne, facultatif)
- -clustername
- Indique le nom du cluster auquel s'applique l'ensemble de règles. Le paramètre -clusterName est requis uniquement si vous modifiez un cluster ODR. (Chaîne, facultatif)
Utilisation de l'exemple de mode de traitement par lots
- Avec Jacl :
$AdminTask addRuleToRuleset {-odrname odr -nodename noeud1 -rulesetName monEnsembleDeRègles -ruleName maRègle -rulePriority 0 -expression "vhost = vhostA"}
- A l'aide de la chaîne Jython :
AdminTask.addRuleToRuleset('-odrname odr -nodename noeud1 -rulesetName monEnsembleDeRègles -ruleName maRègle -rulePriority 0 -expression "vhost = \'vhostA\'"')
Exemple d'utilisation en mode interactif
- Avec Jacl :
$AdminTask addRuleToRuleset {-interactive}
- A l'aide de la chaîne Jython :
AdminTask.addRuleToRuleset ('[-interactive]')
removeRuleFromRuleset
La commande removeRuleFromRuleset supprime une règle de l'ensemble de règles.
Paramètres obligatoires
- -rulesetName
- Indique le nom de l'ensemble de règles. (Chaîne, obligatoire)
- -ruleName
- Indique le nom de la règle à supprimer. (Chaîne, obligatoire)
Paramètres optionnels
- -odrname
- Indique le nom du routeur ODR auquel s'applique l'ensemble de règles. Le paramètre -odrname est requis uniquement si vous modifiez un routeur ODR. (Chaîne, facultatif)
- -nodename
- Indique le nom du noeud sur lequel réside le routeur ODR. Le paramètre -nodename est requis uniquement si vous modifiez un routeur ODR. (Chaîne, facultatif)
- -clustername
- Indique le nom du cluster auquel s'applique l'ensemble de règles. Le paramètre -clusterName est requis uniquement si vous modifiez un cluster ODR. (Chaîne, facultatif)
Utilisation de l'exemple de mode de traitement par lots
- Avec Jacl :
$AdminTask removeRuleFromRuleset {-odrname odr -nodename noeud1 -rulesetName monEnsembleDeRègles -ruleName maRègle}
- A l'aide de la chaîne Jython :
AdminTask.removeRuleFromRuleset('-odrname odr -nodename noeud1 -rulesetName monEnsembleDeRègles -ruleName maRègle')
Exemple d'utilisation en mode interactif
- Avec Jacl :
$AdminTask removeRulefromRuleset {-interactive}
- A l'aide de la chaîne Jython :
AdminTask.removeRulefromRuleset ('[-interactive]')
changeRulePriority
La commande changeRulePriority modifie la priorité d'une règle.
Paramètres obligatoires
- -rulesetName
- Indique le nom de l'ensemble de règles. (Chaîne, obligatoire)
- -ruleName
- Indique le nom de la règle à modifier. (Chaîne, obligatoire)
- -rulePriority
- Indique une valeur sous forme d'entier positif représentant la priorité de la règle. Zéro est la priorité la plus élevée. (Chaîne, obligatoire)
Paramètres optionnels
- -odrname
- Indique le nom du routeur ODR auquel s'applique l'ensemble de règles. Le paramètre -odrname est requis uniquement si vous modifiez un routeur ODR. (Chaîne, facultatif)
- -nodename
- Indique le nom du noeud sur lequel réside le routeur ODR. Le paramètre -nodename est requis uniquement si vous modifiez un routeur ODR. (Chaîne, facultatif)
- -clustername
- Indique le nom du cluster auquel s'applique l'ensemble de règles. Le paramètre -clusterName est requis uniquement si vous modifiez un cluster ODR. (Chaîne, facultatif)
Utilisation de l'exemple de mode de traitement par lots
- Avec Jacl :
$AdminTask changeRulePriority {-odrname odr -nodename noeud1 -rulesetName monEnsembleDeRègles -ruleName maRègle -rulePriority 1}
- A l'aide de la chaîne Jython :
AdminTask.changeRulePriority('-odrname odr-nodename noeud1 -rulesetName monEnsembleDeRègles -ruleName maRègle -rulePriority 1')
Exemple d'utilisation en mode interactif
- Avec Jacl :
$AdminTask changeRulePriority {-interactive}
- A l'aide de la chaîne Jython :
AdminTask.changeRulePriority ('[-interactive]')
changeRuleExpression
La commande changeRuleExpression modifie une expression de règle.
Paramètres obligatoires
- -rulesetName
- Indique le nom de l'ensemble de règles. (Chaîne, obligatoire)
- -ruleName
- Indique le nom de la règle à modifier. (Chaîne, obligatoire)
- -expression
- Indique la nouvelle expression de règle. (Chaîne, obligatoire)
Paramètres optionnels
- -odrname
- Indique le nom du routeur ODR auquel s'applique l'ensemble de règles. Le paramètre -odrname est requis uniquement si vous modifiez un routeur ODR. (Chaîne, facultatif)
- -nodename
- Indique le nom du noeud sur lequel réside le routeur ODR. Le paramètre -nodename est requis uniquement si vous modifiez un routeur ODR. (Chaîne, facultatif)
- -clustername
- Indique le nom du cluster auquel s'applique l'ensemble de règles. Le paramètre -clusterName est requis uniquement si vous modifiez un cluster ODR. (Chaîne, facultatif)
Utilisation de l'exemple de mode de traitement par lots
- Avec Jacl :
$AdminTask changeRuleExpression {-odrname odr -nodename noeud1 -rulesetName monEnsembleDeRègles -ruleName maRègle -expression "vhost = vhostB"}
- A l'aide de la chaîne Jython :
AdminTask.changeRuleExpression('-odrname odr -nodename noeud1 -rulesetName monEnsembleDeRègles -ruleName maRègle') -expression "vhost = \'vhostB\'"')
Exemple d'utilisation en mode interactif
- Avec Jacl :
$AdminTask changeRuleExpression {-interactive}
- A l'aide de la chaîne Jython :
AdminTask.changeRuleExpression ('[-interactive]')
addActionToRule
La commande addActionToRule ajoute une action à une règle.
Paramètres obligatoires
- -rulesetName
- Indique le nom de l'ensemble de règles. (Chaîne, obligatoire)
- -ruleName
- Indique le nom de la règle. Le paramètre -ruleName doit être unique dans l'ensemble de règles. (Chaîne, obligatoire)
- -actionName
- Indique le nom de l'action. Le paramètre -actionName doit être unique dans l'ensemble de règles. (Chaîne, obligatoire)
- -actionType
- Indique le type d'action à associer à la règle. (Chaîne, obligatoire)
- -actionValue
- Indique la valeur de l'action, par exemple le format du fichier journal. (Chaîne, obligatoire)
- -actionContinue
- Définit la valeur de l'indicateur de continuation de l'action. Les valeurs admises sont True et False. (Booléen, requis)
Paramètres optionnels
- -odrname
- Indique le nom du routeur ODR auquel s'applique l'ensemble de règles. Le paramètre -odrname est requis uniquement si vous modifiez un routeur ODR. (Chaîne, facultatif)
- -nodename
- Indique le nom du noeud sur lequel réside le routeur ODR. Le paramètre -nodename est requis uniquement si vous modifiez un routeur ODR. (Chaîne, facultatif)
- -clustername
- Indique le nom du cluster auquel s'applique l'ensemble de règles. Le paramètre -clusterName est requis uniquement si vous modifiez un cluster ODR. (Chaîne, facultatif)
Utilisation de l'exemple de mode de traitement par lots
- Avec Jacl :
$AdminTask addActionToRule {-odrname odr -nodename noeud1 -rulesetName monEnsembleDeRègles -ruleName maRègle -actionName monAction -actionType log -actionValue "MyCustom.log %r %T %z %Z" -actionContinue true}
- A l'aide de la chaîne Jython :
AdminTask.addActionToRule('-odrname odr -nodename noeud1 -rulesetName monEnsembleDeRègles -ruleName maRègle') -actionName monAction -actionType log -actionValue "MyCustom.log %r %T %z %Z" -actionContinue true')
Exemple d'utilisation en mode interactif
- Avec Jacl :
$AdminTask addActionToRule {-interactive}
- A l'aide de la chaîne Jython :
AdminTask.addActionToRule ('[-interactive]')
removeActionFromRule
La commande removeActionFromRule supprime une action d'une règle.
Paramètres obligatoires
- -rulesetName
- Indique le nom de l'ensemble de règles. (Chaîne, obligatoire)
- -ruleName
- Indique le nom de la règle contentant l'action. (Chaîne, obligatoire)
- -actionName
- Indique le nom de l'action à supprimer. (Chaîne, obligatoire)
Paramètres optionnels
- -odrname
- Indique le nom du routeur ODR auquel s'applique l'ensemble de règles. Le paramètre -odrname est requis uniquement si vous modifiez un routeur ODR. (Chaîne, facultatif)
- -nodename
- Indique le nom du noeud sur lequel réside le routeur ODR. Le paramètre -nodename est requis uniquement si vous modifiez un routeur ODR. (Chaîne, facultatif)
- -clustername
- Indique le nom du cluster auquel s'applique l'ensemble de règles. Le paramètre -clusterName est requis uniquement si vous modifiez un cluster ODR. (Chaîne, facultatif)
Utilisation de l'exemple de mode de traitement par lots
- Avec Jacl :
$AdminTask removeActionFromRule {-odrname odr -nodename noeud1 -rulesetName monEnsembleDeRègles -ruleName maRègle -actionName monAction}
- A l'aide de la chaîne Jython :
AdminTask.removeActionFromRule('-odrname odr -nodename noeud1 -rulesetName monEnsembleDeRègles -ruleName maRègle -actionName monAction')
Exemple d'utilisation en mode interactif
- Avec Jacl :
$AdminTask removeActionFromRule {-interactive}
- A l'aide de la chaîne Jython :
AdminTask.removeActionFromRule ('[-interactive]')
addDefaultAction
La commande addDefaultAction ajoute une action par défaut à un ensemble de règles.
Paramètres obligatoires
- -rulesetName
- Indique le nom de l'ensemble de règles. (Chaîne, obligatoire)
- -actionName
- Indique le nom de l'action. Le paramètre -actionName doit être unique dans l'ensemble de règles. (Chaîne, obligatoire)
- -actionType
- Indique le type d'action à associer à la règle. (Chaîne, obligatoire)
- -actionValue
- Indique la valeur de l'action, par exemple le format du fichier journal. (Chaîne, obligatoire)
- -actionContinue
- Définit la valeur de l'indicateur de continuation de l'action. Les valeurs admises sont True et False. (Booléen, requis)
Paramètres optionnels
- -odrname
- Indique le nom du routeur ODR auquel s'applique l'ensemble de règles. Le paramètre -odrname est requis uniquement si vous modifiez un routeur ODR. (Chaîne, facultatif)
- -nodename
- Indique le nom du noeud sur lequel réside le routeur ODR. Le paramètre -nodename est requis uniquement si vous modifiez un routeur ODR. (Chaîne, facultatif)
- -clustername
- Indique le nom du cluster auquel s'applique l'ensemble de règles. Le paramètre -clusterName est requis uniquement si vous modifiez un cluster ODR. (Chaîne, facultatif)
Utilisation de l'exemple de mode de traitement par lots
- Avec Jacl :
$AdminTask addDefaultAction {-odrname odr -nodename noeud1 -rulesetName monEnsembleDeRègles -actionName defAction -actionType log -actionValue "défaut.log %a %d %D" -actionContinue True}
- A l'aide de la chaîne Jython :
AdminTask.addDefaultAction('-odrname odr -nodename noeud1 -rulesetName monEnsembleDeRègles -actionName defAction -actionType log -actionValue "default.log %a %d %D" -actionContinue True')
Exemple d'utilisation en mode interactif
- Avec Jacl :
$AdminTask addDefaultAction {-interactive}
- A l'aide de la chaîne Jython :
AdminTask.addDefaultAction ('[-interactive]')
removeDefaultAction
La commande removeDefaultAction supprime une action par défaut d'un ensemble de règles.
Paramètres obligatoires
- -rulesetName
- Indique le nom de l'ensemble de règles. (Chaîne, obligatoire)
- -actionName
- Indique le nom de l'action à supprimer. (Chaîne, obligatoire)
Paramètres optionnels
- -odrname
- Indique le nom du routeur ODR auquel s'applique l'ensemble de règles. Le paramètre -odrname est requis uniquement si vous modifiez un routeur ODR. (Chaîne, facultatif)
- -nodename
- Indique le nom du noeud sur lequel réside le routeur ODR. Le paramètre -nodename est requis uniquement si vous modifiez un routeur ODR. (Chaîne, facultatif)
- -clustername
- Indique le nom du cluster auquel s'applique l'ensemble de règles. Le paramètre -clusterName est requis uniquement si vous modifiez un cluster ODR. (Chaîne, facultatif)
Utilisation de l'exemple de mode de traitement par lots
- Avec Jacl :
$AdminTask removeDefaultAction {-odrname odr -nodename noeud1 -rulesetName monEnsembleDeRègles -actionName defAction}
- A l'aide de la chaîne Jython :
AdminTask.removeDefaultAction('-odrname odr -nodename noeud1 -rulesetName monEnsembleDeRègles -actionName defAction')
Exemple d'utilisation en mode interactif
- Avec Jacl :
$AdminTask removeDefaultAction {-interactive}
- A l'aide de la chaîne Jython :
AdminTask.removeDefaultAction ('[-interactive]')