Les attributs spécifiés avec la commande servent de paramètres par défaut pour tous les jobs qui doivent être générés. Si la procédure à exécuter pour un groupe de procédures est clairement définie, elle reste ouverte pour les groupes de logiciels. Par défaut, pour les produits de groupe de logiciels, la commande sélectionne la routine d'installation par défaut des produits pour les jobs. Toutes ces valeurs par défaut peuvent être écrasées par des spécifications supplémentaires dans le fichier de procédures.
Supposons qu'un fichier de procédures soit spécifié. Pour chaque entrée d'un groupe de procédures, on détermine si la procédure et le produit apparaissent également ou non dans le fichier de procédures spécifié. S'ils n'y figurent pas, les valeurs par défaut des commandes seront utilisées pour générer le job. Sinon, les spécifications de la première entrée correspondante du fichier de procédures écrasent les valeurs par défaut et ces attributs modifiés sont utilisés pour générer le job. Les jobs seront générés par ordre de tri des procédures dans le groupe.
Par exemple, supposons un gestionnaire de domaines, le groupe de procédures suivant et une commande comme suit :
pg: ........Procédure :........configure_001 ................Produit........test_001 ................Version........1.0 ........Procédure :........activate_002 ................Produit........test_002 ................Version........1.1 cadsmcmd swlibrary action=assignGroupToTarget name=pg computer=tar01 after=exacttime prompUser allowCancel Parameters="-xon xf -rs" procedures=c:\temp\procFile.txt
Supposons, en outre, le contenu de fichier c:\temp\procFile.txt suivant :
Item=test_002 version=1.1 procedure=activate_002 task=activate after=boottime allowCancel=n GlobalTime=y Parameters=""
Deux jobs sont générés. Le premier concerne la procédure configure_001 et les attributs de la commande sont utilisés comme valeurs par défaut. En d'autres termes, after=exacttime, promptUser, cancelAllow et Parameters=-xon xf -rs. Le deuxième job généré concerne la procédure activate_002, et dans ce cas, les valeurs par défaut de la commande sont également utilisées, mais certaines d'entre elles sont écrasées par l'entrée correspondante du fichier de procédures. Ceci entraîne la création d'un job doté des attributs after=boottime, promptUser et GlobalTime alors que allowCancel n'est pas défini et Parameters est vide.
Dans le cas d'un groupe de logiciels, on vérifie uniquement si le produit correspond à une entrée dans le fichier de procédures. La première entrée trouvée est utilisée. La procédure spécifiée de l'entrée correspondante et les paramètres indiqués écrasent les valeurs par défaut et ces attributs modifiés sont utilisés pour générer le job.
Par exemple, supposons un gestionnaire de domaines, le groupe de logiciels suivant et une commande comme suit :
swg: ........Produit :........test_011 ................Version........2.1 ................Procédure d'installation par défaut........inst_011 ........Produit :........test_012 ................Version........2.2 ................Procédure d'installation par défaut........inst_012 cadsmcmd swlibrary action=assignGroupToTarget name=swg computer=tar01 after=exacttime prompUser allowCancel Parameters="-xon xf -rs" preaction=logoff procedures=c:\temp\procFile.txt
Supposons, en outre, le contenu de fichier c:\temp\procFile.txt suivant :
Item=test_012 version=2.2 procedure=activate_012 task=activate after=boottime allowCancel=n GlobalTime=y Parameters="-cleanUp"
Item=test_011 version=2.0 procedure=activate_011 task=activate allowCancel=n GlobalTime=y Parameters="-format"
Deux jobs sont générés. Le premier concerne le produit test_011 de la version 2.1. Il s'agit d'un job d'installation fonctionnant avec la procédure par défaut inst_011. Ce job est généré à l'aide de la commande par défaut uniquement parce qu'il n'existe pas d'entrée correspondante dans le fichier procedures, bien que le produit test_011 soit cité dans le fichier mais dans une version différente. Par conséquent, le job est généré avec les attributs after=exacttime, promptUser, allowCancel et Parameters="-xon xf -rs".
Le deuxième job est généré pour le produit test_012 version 2.2. Cette fois-ci, il existe une entrée correspondante dans le fichier de procédures. Par conséquent, les valeurs par défaut fournies par la commande ont été mises à jour par celles de l'entrée, et le job créé concerne la procédure d'activation activate_012 avec les attributs after=boottime, promptUser, GlobalTime, preaction=logoff et Parameters=-cleanUp, alors que allowCancel n'est pas défini.
Un groupe de logiciels peut comporter une structure hiérarchique. En d'autres termes, il contient d'autres groupes de logiciels ou de procédures. La commande fonctionne de manière récursive, c'est-à-dire qu'elle évalue également les sous-groupes et génère des jobs pour leurs entrées. Lors de l'utilisation de structures de groupe hiérarchique, l'utilisateur doit tenir compte du fait que les produits et les procédures sont uniques dans cette hiérarchie. Considérons, par exemple, la structure suivante :
swg: (groupe de logiciels) ........Produit :........test_001 ................Version........2.1 ................Procédure d'installation par défaut........inst_001 ........Produit :........test_022 ................Version........1.1/00 ................Procédure d'installation par défaut........inst_022 swg_1: (groupe de logiciels) ........Produit........test_010 ................Version........1.0 ................Procédure d'installation par défaut........inst_010 ........Produit :........test_001 ................Version........2.1 ................Procédure d'installation par défaut........inst_001 pg_11: (groupe de procédures) ........Procédure :........configure_001 ................Produit........test_001 ................Version........2.1 ........Procédure :........activate_022 ................Produit........test_022 ................Version........1.1/00 pg_1: (groupe de procédures) ........Procédure:........configure_022 ................Produit........test_022 ................Version........1.1/00 ........Procédure :........activate_022 ................Produit........test_022 ................Version........1.1/00
L'appel de la commande pour ce groupe provoque l'apparition d'avertissements, et certains produits et procédures sont ignorés. Il s'applique au produit test_001 de la version 2.1 dans swg_1 parce qu'il apparaît déjà au niveau swg ainsi que pour la procédure activate_022 du produit test_022 de la version 1.1/00 dans pg_11 parce qu'il apparaît déjà dans pg_1. Si un fichier procedures est codé en même temps que la commande, la présence des entrées correspondantes dans les groupes de procédures est d'abord vérifiée. Une fois terminés, les groupes de logiciels de la hiérarchie sont comparés aux entrées restantes des fichiers de procédures, autrement dit, aux entrées qui ne sont pas déjà utilisées dans les groupes de procédures.
Supposons, par exemple, la structure swg précédemment indiquée et la commande suivante sur un gestionnaire de domaines :
cadsmcmd swlibrary action=assignGroupToTarget name=swg computer=tar01 after=exacttime promptUser allowCancel Parameters="-xon xf -rs" procedures=c:\temp\procFile.txt
Supposons, en outre, le contenu de fichier c:\temp\procFile.txt suivant :
Item=test_001 version=2.1 procedure=configure_001 task=configure allowCancel=n Parameters="-init" preaction=reboot
Item=test_001 version=2.1 procedure=install_min task=install allowCancel=n Parameters="-x -y -z" preaction=logoff postaction=reboot
Item=test_022 version=1.1/00 procedure=configure_022 task=configure preaction=logoff Repeat noCalendar
Item=test_022 version=1.1/00 procedure=activate_022 task=activate preaction=logoff Repeat noCalendar
Ceci génère les jobs suivants avec les attributs indiqués :
test_001 2.1: install_min task=install after=exacttime promptUser Parameters="-x -y -z" preaction=log0ff postaction=reboot test_022 1.0/00:inst_002 task=install after=exacttime promptUser allowCancel Parameters="-xon xf -rs" test_022 1.0/00:configure_022 task=configure after=exacttime preaction=logoff promptUser allowCancel Repeat noCalendar] Parameters="-xon xf -rs" test_022 1.0/00:activate_022 task=activate after=exacttime preaction=logoff promptUser allowCancel Repeat noCalendar] Parameters="-xon xf -rs" test_010 1.0:inst_010 task=install after=exacttime promptUser allowCancel Parameters="-xon xf -rs" test_001 1.0/00:configure_001 task=configure after=exacttime promptUser Parameters="-init" preaction=reboot
Le produit test_001 version 2.1 dans swg_1, ainsi que la procédure activate_022 de test_022 version 1.1/00 dans pg_11 seront ignorés.
Les entrées du fichier de procédure ont le format suivant :
item=item
version=version
procedure=procedure task={install|configure|activate|uninstall}
[deliverytime=AAAA-MM-JJ hh:mm ]
[attime=AAAA-MM-JJ hh:mm ]
[after={exacttime|boottime}] [calendarname=deliverycalendar]
[preaction={none|reboot|logoff}]
[postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd}]
[promptUser={o|n}]
[allowCancel={o|n}]
[execTimedOut={o|n}]
[prompt=jours.heures]
[offline={o|n}]
[RunAtShutdown={o|n}]
[PreventLogon={o|n}]
[GlobalTime={o|n}]
[nocalendar={o|n}]
[ResolveQuery={o|n}]
[Parameters=paramètre_utilisateur]
[repeat={y|n}]
[stagingserver={o|n}]
[JobTimeout=j.h]
Nom de l'élément de groupe auquel cette entrée est associée.
Version de l'élément de groupe auquel cette entrée est associée.
Spécifie la procédure d'élément à appliquer.
Indique le type de procédure. Voici les différents types autorisés :
La procédure installe l'élément.
La procédure configure l'élément.
La procédure active l'élément.
La procédure désinstalle l'élément.
Si le paramètre n'est pas défini, le type install est utilisé par défaut.
Les paramètres item, version, procedure et task doivent être codés au début de chaque ligne et dans le même ordre que dans la définition de syntaxe indiquée auparavant. Les paramètres restants peuvent être codés dans n'importe quel ordre.
La signification des autres paramètres correspond aux paramètres de commande précédemment indiqués. Si un y est utilisé dans le script, le paramètre est activé. Dans le cas contraire, il n'est pas activé. Pour les paramètres non définis, la valeur par défaut utilisée provient de chaque paramètre des commandes.
Supposons qu'un groupe de logiciels swg_1 doive être distribué vers les cibles fournies par le groupe q_grp. Le groupe de logiciels swg_1 affiche le contenu et la structure suivants :
cadsmcmd swlibrary action=listswg name=swg_1
CA IT Client Manager r12
Version de ligne de commande ITCM 12.8.0.xxxx
Copyright (c) 2013 CA. Tous droits réservés.
Mode Trace : Désactivé Connexion au gestionnaire par défaut en tant qu'utilisateur <utilisateur par défaut> ...OK. Gestionnaire : mongestionnaire Domaine : mondomaine Type de domaine : Domaine Prise en charge : CO CCNF USD OSIM AM ------------------------------------------------------------------------------- Liste des membres du groupe de procédures swg_1 ------------------------------------------------------------------------------- InstallActivateConfigureUninstall 1 <Générique>, <Standard>, 3(0), schbe05, Transmission du code de sortie qui doit être renvoyé en tant que paramètre utilisateur. TransferComplexDirectoryStructure 1 <Générique>, <Standard>, 329(0), QA Mch schir03, Package SD comprenant une structure de répertoires complexes SDCMD<A000000> : OK
Supposons que les exigences du conteneur de jobs à utiliser soient les suivantes :
Les valeurs par défaut pour tous les jobs à générer sont :
Les exigences individuelles pour les jobs et les éléments sont les suivantes :
Pour la distribution et l'exécution des jobs associés, la commande assignGroupToTarget est utilisée. En raison des exigences individuelles pour certains jobs, un fichier de procédure est nécessaire pour décrire ces exigences. Le contenu de ce fichier de procédure est le suivant :
item=tstbase version=1.0 procedure=remdir task=configure postaction=reboot
item=tstbase version=1.0 procedure=setdir task=configure postaction=reboot
item=tstbase version=1.0 procedure=inst task=install preaction=logoff preventLogon
La commande suivante crée un conteneur de jobs nommé par défaut, le renseigne avec les jobs nécessaires et planifie son exécution :
cadsmcmd swlibrary action=assignGroupToTarget name=swg_1 compgrp=q_grp transaction rollback deliveryTime="2005-06-30 13:00" atTime="2005-07-05 01:00" after=exacttime resolveQuery procedures=c:\temp\proc.usd
CA IT Client Manager r12
Version de ligne de commande ITCM 12.8.0.xxxx
Copyright (c) 2013 CA. Tous droits réservés. Connexion au gestionnaire wwwww01b sous le nom de <utilisateur par défaut> ...OK. Un conteneur nommé q_grp [04/11/02 10:44:10.093] a été créé. Evaluer le groupe swg_1 Evaluer le groupe swg_1/pg_1 Evaluer le fichier de procédures c:\temp\proc.usd Générer le job tstbase 1.0:inst : OK. Générer le job Editeur DMS 6.01.0000:Installation locale : OK. Générer le job tstbase 1.0:remdir : OK. Générer le job tstbase 1.0:setdir : OK. Générer le job tstkpk01 1.0:inst : OK. SDCMD<A000000> : OK
La commande suivante affiche le conteneur de jobs généré :
cadsmcmd jobContainer action=showAttr name="q_grp [04/11/02 10:44:10.093]"
CA IT Client Manager r12
Version de ligne de commande ITCM 12.8.0.xxxx
Copyright (c) 2013 CA. Tous droits réservés. Connexion au gestionnaire wwwww01b sous le nom de <utilisateur par défaut> ...OK. ------------------------------------------------------------------------------- Afficher les attributs du conteneur de jobs q_grp [04/11/02 10:44:10.093] ------------------------------------------------------------------------------- Nom du conteneur de jobs.....................: q_grp [04/11/02 10:44:10.093] Propriétés du conteneur de jobs...............: 28 .........................................Transaction .........................................Annuler les jobs précédents lors d'un échec .........................................installation en Cascade Scellé..................................: Oui Créé le.............................: 2005-04-11 10:45 Modifié le.............................: 2005-04-11 10:45 Nombre d'objets contenus : 5 Etat du conteneur de jobs....................: en attente .........................................3 - jobs en attente .........................................0 - jobs actifs .........................................2 - jobs ok .........................................0 - jobs ayant échoué Nom du job.............................: tstbase 1.0:inst ..Etat global........................: WAITING .........................................2 - cibles de job en attente .........................................0 - cibles de job actives .........................................0 - cibles de job ok .........................................0 - cibles de job ayant échoué ..Numéro de commande du job.....................: 0 ..Créé le...........................: 2005-06-30 13:00 ..Activé le..........................: 2005-07-05 01:00 ..Message d'état.......................: OK ..Cible.................................: KKKKK01B ....Tâche...............................: install ....Etat du job..........................: WAITING ....Tâche...............................: install ....Commencé le.........................: 2005-07-05 01:00 ....Terminé le.......................: 2005-04-11 10:45 ....Créé le.........................: 2005-04-11 10:45 ....Données envoyées en %..............: ....Message d'état.....................: OK ....Commandé par.........................: KKKKK01 ....Type...............................: obligatoire ....Commentaire.......................: ..Cible.................................: KKKKK01C ....Tâche...............................: install ....Etat du job..........................: WAITING ....Tâche...............................: install ....Commencé le.........................: 2005-07-05 01:00 ....Terminé le.......................: 2005-04-11 10:45 ....Créé le.........................: 2005-04-11 10:45 ....Données envoyées en %..............: ....Message d'état.....................: OK ....Commandé par.........................: KKKKK01 ....Type...............................: obligatoire ....Commentaire.......................: Nom du job.............................: Editeur DMS 6.01.0000:Installation locale ..Etat global........................: WAITING .........................................2 - cibles de job en attente .........................................0 - cibles de job actives .........................................0 - cibles de job ok .........................................0 - cibles de job ayant échoué ..Numéro de commande du job.....................: 1 ..Créé le...........................: 2005-06-30 13:00 ..Activé le..........................: 2005-07-05 01:00 ..Message d'état.......................: OK ..Cible.................................: KKKKK01B ....Tâche...............................: install ....Etat du job..........................: WAITING ....Tâche...............................: install ....Commencé le.........................: 2005-07-05 01:00 ....Terminé le.......................: 2005-04-11 10:45 ....Créé le.........................: 2005-04-11 10:45 ....Données envoyées en %..............: ....Message d'état.....................: OK ....Commandé par.........................: KKKKK01 ....Type...............................: obligatoire ....Commentaire.......................: ..Cible.................................: KKKKK01C ....Tâche...............................: install ....Etat du job..........................: WAITING ....Tâche...............................: install ....Commencé le.........................: 2005-07-05 01:00 ....Terminé le.......................: 2005-04-11 10:45 ....Créé le.........................: 2005-04-11 10:45 ....Données envoyées en %..............: ....Message d'état.....................: OK ....Commandé par.........................: KKKKK01 ....Type...............................: obligatoire ....Commentaire.......................: Nom du job.............................: tstbase 1.0:remdir ..Etat global........................: inconnu (9) .........................................0 - cibles de job en attente .........................................0 - cibles de job actives .........................................0 - cibles de job ok .........................................0 - cibles de job ayant échoué ..Numéro de commande du job.....................: 2 ..Créé le...........................: 2005-06-30 13:00 ..Activé le..........................: 2005-07-05 01:00 ..Message d'état.......................: Avertissement lors de la configuration du job. Aucune installation cible .........................................trouvée au cours de l'étape d'évaluation. Nom du job.............................: tstbase 1.0:setdir ..Etat global........................: inconnu (9) .........................................0 - cibles de job en attente .........................................0 - cibles de job actives .........................................0 - cibles de job ok .........................................0 - cibles de job ayant échoué ..Numéro de commande du job.....................: 3 ..Créé le...........................: 2005-06-30 13:00 ..Activé le..........................: 2005-07-05 01:00 ..Message d'état.......................: Avertissement lors de la configuration du job. Aucune installation cible .........................................trouvée au cours de l'étape d'évaluation. Nom du job.............................: tstkpk01 1.0:inst ..Etat global........................: WAITING .........................................2 - cibles de job en attente .........................................0 - cibles de job actives .........................................0 - cibles de job ok .........................................0 - cibles de job ayant échoué ..Numéro de commande du job.....................: 4 ..Créé le...........................: 2005-06-30 13:00 ..Activé le..........................: 2005-07-05 01:00 ..Message d'état.......................: OK ..Cible.................................: KKKKK01B ....Tâche...............................: install ....Etat du job..........................: WAITING ....Tâche...............................: install ....Commencé le.........................: 2005-07-05 01:00 ....Terminé le.......................: 2005-04-11 10:45 ....Créé le.........................: 2005-04-11 10:45 ....Données envoyées en %..............: ....Message d'état.....................: OK ....Commandé par.........................: KKKKK01 ....Type...............................: obligatoire ....Commentaire.......................: ..Cible.................................: KKKKK01C ....Tâche...............................: install ....Etat du job..........................: WAITING ....Tâche...............................: install ....Commencé le.........................: 2005-07-05 01:00 ....Terminé le.......................: 2005-04-11 10:45 ....Créé le.........................: 2005-04-11 10:45 ....Données envoyées en %..............: ....Message d'état.....................: OK ....Commandé par.........................: KKKKK01 ....Type...............................: obligatoire ....Commentaire.......................: SDCMD<A000000> : OK
La commande suivante vous permet d'afficher les attributs d'un job particulier de ce conteneur :
cadsmcmd jobContainer action=showAttrJobs name=" q_grp [04/11/02 10:44:10.093]"jobName=" tstbase 1.0:inst"
CA IT Client Manager r12
Version de ligne de commande ITCM 12.8.0.xxxx
Copyright (c) 2013 CA. Tous droits réservés. Connexion au gestionnaire wwwww01b sous le nom de <utilisateur par défaut> ...OK. ------------------------------------------------------------------------------- Liste d'attributs du job q_grp [04/11/02 10:44:10.093] du conteneur tstbase 1.0:inst ------------------------------------------------------------------------------- Nom du job.............................: tstbase 1.0:inst Logiciel............................... : tstbase 1.0 Procédure.............................. : inst Livré le.............................: 2005-06-30 13:00 Activé le............................: 2005-07-05 01:00 Message d'état......................... : OK Etat global.......................... : WAITING .........................................2 - cibles de job en attente .........................................0 - cibles de job actives .........................................0 - cibles de job ok .........................................0 - cibles de job ayant échoué Tâche du job............................... : install Action préliminaire.............................. : déconnecter l'utilisateur Action consécutive............................. : aucune action Inviter l'utilisateur............................ : Non Indicateurs de caractéristiques................... : .........................................empêcher l'ouverture de session de l'utilisateur durant l'exécution du job .........................................heure locale/exacte contrôlé par calendrier .........................................résoudre les groupes de requêtes Calendrier de livraison...................... : Paramètres utilisateur : Inviter pendant.......................... : 1 jours, 0 heure Expiration de délai du job............................ : 7 jours, 0 heure SDCMD<A000000> : OK
|
Copyright © 2013 CA.
Tous droits réservés.
|
|