Utilisation du groupe de commandes ConfigArchiveOperations de l'objet AdminTask avec les scripts de wsadmin
Les langages de script Jython ou Jacl permettent de configurer des serveurs dans votre environnement. Les commandes et paramètres du groupe ConfigArchiveOperations peuvent être utilisés pour exporter ou importer des configurations serveur et des configurations de cellule intégrales.
exportProxyProfile
La commande exportProxyProfile permet d'exporter l'ensemble de la configuration de cellule d'un serveur proxy sécurisé vers une archive de configuration. Elle ne fonctionne pas entre les systèmes d'exploitation distribués et z/OS.
Objet cible
Aucun
Paramètres obligatoires
- -archive
- Indique le chemin d'accès complet de l'archive de configuration exportée. (Chaîne, obligatoire)
Valeur renvoyée
La commande ne renvoie pas de sortie.
Exemple d'utilisation en mode de traitement par lots
A l'aide de la chaîne Jython :
AdminTask.exportProxyProfile('[-archive "c:/myCell.car"]')
A l'aide de la chaîne Jython :
AdminTask.exportProxyProfile('-archive c:/myCell.car')
Avec une liste Jython :
AdminTask.exportProxyProfile(['-archive', 'c:/myCell.car'])
Avec une liste Jython :
AdminTask.exportProxyProfile(['-archive', 'c:/myCell.car'])
Syntaxe d'un exemple de mode interactif
- Avec Jython :
AdminTask.exportProxyProfile('-interactive')
exportProxyServer
La commande exportProxyServer permet d'exporter la configuration de serveur proxy sécurisé vers un noeud défini dans l'archive de configuration. Cette commande exporte le fichier de métadonnées du noeud sur lequel réside le serveur. Vous pouvez utiliser ces informations ultérieurement lors de l'importation de l'archive de configuration afin de vérifier que le noeud cible est compatible avec le noeud à partir duquel vous exportez le serveur.
Cette commande virtualise la configuration de serveur et exporte un serveur vers une archive de configuration. Ce processus annule les associations existantes entre les configurations de serveur définies dans l'archive de configuration et celles définies dans le système.
Objet cible
NONE (Aucun)Paramètres requis
- -archive
- Indique le chemin d'accès complet de l'archive de configuration exportée. (Chaîne, obligatoire)
- -serverName
- Indique le nom du serveur proxy sécurisé. (Chaîne, obligatoire)
Paramètres facultatifs
- -nodeName
- Indique le nom de noeud du serveur proxy sécurisé. Ce paramètre n'est obligatoire que si le nom du serveur proxy sécurisé n'est pas unique dans la cellule. (Chaîne, facultatif)
Valeur renvoyée
La commande ne renvoie pas de sortie.
Exemples
Syntaxe d'un exemple de mode différé :
- A l'aide de la chaîne Jython :
AdminTask.exportProxyServer('[-archive c:/myProxyServer.car -nodeName node1 -serverName server1]')
- A l'aide de la liste Jython :
AdminTask.exportProxyServer(['-archive', 'c:/myProxyServer.car', '-nodeName', 'node1', '-serverName', 'server1'])
- A l'aide de la chaîne Jython :
AdminTask.exportProxyServer('[-archive /myProxyServer.car -nodeName node1 -serverName server1]')
- A l'aide de la liste Jython :
AdminTask.exportProxyServer(['-archive', '/myProxyServer.car', '-nodeName', 'node1', '-serverName', 'server1'])
Exemple d'utilisation en mode interactif :
- Avec Jython :
AdminTask.exportServer ('-interactive')
exportServer
La commande exportServer permet d'exporter la configuration de serveur vers un noeud défini dans l'archive de configuration. Elle permet d'exporter une configuration de serveur proxy.
Cette commande virtualise la configuration de serveur et exporte un serveur vers une archive de configuration. Ce processus annule les associations existantes entre les configurations de serveur définies dans l'archive de configuration et celles définies dans le système. Ce processus supprime également des applications du serveur indiqué, annule la relation entre le serveur indiqué et le groupe central du serveur, du cluster ou du membre du bus d'intégration de services.
La commande exportServer exporte le fichier de métadonnées du noeud sur lequel réside le serveur. Vous pouvez utiliser ces informations ultérieurement lors de l'importation de l'archive de configuration afin de vérifier que le noeud cible est compatible avec le noeud à partir duquel vous exportez le serveur.
Objet cible
NONE (Aucun)Paramètres et valeurs renvoyées
- -archive
- Indique le chemin d'accès complet de l'archive de configuration exportée. (Chaîne, obligatoire)
- -nodeName
- Indique le nom de noeud du serveur. Ce paramètre n'est obligatoire que lorsque le nom de serveur n'est pas unique dans la cellule. (Chaîne, facultatif)
- -serverName
- Indique le nom du serveur. (Chaîne, obligatoire)
Exemples
Syntaxe d'un exemple de mode différé :
- A l'aide de Jacl :
$AdminTask exportServer {-archive c:/myServer.car -nodeName node1 -serverName server1}
- A l'aide de la chaîne Jython :
AdminTask.exportServer('[-archive c:/myServer.car -nodeName node1 -serverName server1]')
- A l'aide de la liste Jython :
AdminTask.exportServer(['-archive', 'c:/myServer.car', '-nodeName', 'node1', '-serverName', 'server1'])
Exemple d'utilisation en mode interactif :
- A l'aide de Jacl :
$AdminTask exportServer {-interactive}
- A l'aide de la chaîne Jython :
AdminTask.exportServer ('[-interactive]')
- A l'aide de la liste Jython :
AdminTask.exportServer (['-interactive'])
exportWasprofile
Objet cible
NONE (Aucun)Paramètres et valeurs renvoyées
- -archive
- Indique le chemin d'accès complet de l'archive de configuration exportée. (Chaîne, obligatoire)
Exemples
Syntaxe d'un exemple de mode différé :- A l'aide de Jacl :
$AdminTask exportWasprofile {-archive c:/myCell.car}
- A l'aide de la chaîne Jython :
AdminTask.exportWasprofile('[-archive c:/myCell.car]')
- A l'aide de la liste Jython :
AdminTask.exportWasprofile(['-archive', 'c:/myCell.car'])
- A l'aide de Jacl :
$AdminTask exportWasprofile {-interactive}
- A l'aide de la chaîne Jython :
AdminTask.exportWasprofile ('[-interactive]')
- A l'aide de la liste Jython :
AdminTask.exportWasprofile (['-interactive'])
importApplicationsFromWasprofile
Ce script importe des applications Java EE pour le serveur d'applications spécifié d'un fichier d'archive de configuration (fichier .car) généré à l'aide d'une commande AdminTask exportWasprofile vers une configuration de cellule cible.
Si vous souhaitez importer une application Java EE qui dépend d'une bibliothèque partagée, cette dernière doit être configurée et exister sur le noeud cible pour que l'application importée puisse démarrer. Il n'est pas possible d'importer une application Java EE déjà déployée dans la cellule cible spécifiée.
Objet cible
Aucun.
Paramètres et valeurs renvoyées
- -archive
- Indique le chemin d'accès complet de l'archive de configuration exportée. (Chaîne, obligatoire)
- -targetNodeName
- Indique le nom de noeud du serveur d'applications cible à partir duquel les applications seront importées. Le nom spécifié doit exister sur le système cible. N'indiquez pas ce paramètre si vous spécifiez une valeur pour le paramètre targetClusterName. (Chaîne, obligatoire si le paramètre targetClusterName n'est pas spécifié.)
- -targetServerName
- Indique le nom du serveur d'applications cible sur lequel les applications seront importées. Le serveur spécifié doit exister sur le système cible. N'indiquez pas ce paramètre si vous spécifiez une valeur pour le paramètre targetClusterName. (Chaîne, obligatoire si le paramètre targetClusterName n'est pas spécifié.)
- -targetClusterName
- Indique le nom du cluster cible sur lequel les applications seront importées. Le cluster spécifié doit exister sur le système cible. N'indiquez pas ce paramètre si vous spécifiez une valeur pour les paramètres targetNodeName et targetServerName. (Chaîne, obligatoire si les paramètres targetNodeName et targetServerName sont spécifiés.)
- -sourceServerName
- Indique le nom du serveur source à partir duquel les applications
seront importées. Le serveur spécifié doit exister dans le fichier d'archive de configuration. Ce paramètre est obligatoire dans les circonstances suivantes.
Soit
- il existe plusieurs serveurs dans le fichier d'archive de configuration ET les noms de serveur source et cible sont différents, soit
- le paramètre targetClusterName est spécifié.
(Chaîne, facultatif)
Exemple de sortie
La commande ne renvoie pas de sortie.
Exemples
Syntaxe d'un exemple de mode différé :
- Langage Jacl :
$AdminTask importApplicationsFromWasprofile {-archive c:/myCell.car -targetNodeName myNodeName -targetServerName myServerName -sourceServerName mySourceServerName}
$AdminTask importApplicationsFromWasprofile {-archive c:/myCell.car -targetClusterName myClusterName -sourceServerName mySourceServerName}
- A l'aide de la chaîne Jython :
AdminTask.importApplicationsFromWasprofile('[-archive c:/myCell.car -targetNodeName myNodeName -targetServerName myServerName -sourceServerName mySourceServerName]')
AdminTask.importApplicationsFromWasprofile('[-archive c:/myCell.car -targetClusterName myClusterName -sourceServerName mySourceServerName]')
- Avec une liste Jython :
AdminTask.importApplicationsFromWasprofile(['-archive', 'c:/myCell.car', '-targetNodeName', 'myNodeName', '-targetServerName', 'myServerName', '-sourceServerName', 'mySourceServerName'])
AdminTask.importApplicationsFromWasprofile(['-archive', 'c:/myCell.car', '-targetClusterName', 'myClusterName', '-sourceServerName', 'mySourceServerName'])
Exemple d'utilisation en mode interactif :
- Langage Jacl :
$AdminTask importApplicationsFromWasprofile {-interactive}
- A l'aide de la chaîne Jython :
AdminTask.importApplicationsFromWasprofile ('[-interactive]')
- Avec une liste Jython :
AdminTask.importApplicationsFromWasprofile (['-interactive'])
importProxyProfile
La commande importProxyProfile permet d'importer une configuration de cellule de l'archive de configuration vers le système. Seules les configurations de base de serveur unique sont prises en charge par cette commande. La commande importProxyProfile ne fonctionne pas entre les plateformes distribuées et les plates-formes z/OS.
Objet cible
Aucun.
Paramètres requis
- -archive
- Indique le chemin d'accès complet de l'archive de configuration exportée. (Chaîne, obligatoire)
Paramètres facultatifs
- -deleteExistingServers
- Indique s'il faut remplacer les serveurs proxy existants dans le profil par les serveurs du profil proxy importé. Spécifiez true pour écraser les serveurs existants. (Booléen, facultatif)
Valeur renvoyée
La commande ne renvoie pas de sortie.
Syntaxe d'un exemple de mode de traitement par lots
A l'aide de la chaîne Jython :
AdminTask.importProxyProfile('-archive c:/myCell.car -deleteExistingServers true')
A l'aide de la chaîne Jython :
AdminTask.importProxyProfile('-archive /myCell.car -deleteExistingServers true')
Avec une liste Jython :
AdminTask.importProxyProfile('-archive', 'c:/myCell.car', '-deleteExistingServers', 'true')
Avec une liste Jython :
AdminTask.importProxyProfile('-archive', '/myCell.car', '-deleteExistingServers', 'true')
Syntaxe d'un exemple de mode interactif
- Avec Jython :
AdminTask.importProxyProfile('-interactive')
importProxyServer
La commande importProxyServer permet d'importer un serveur proxy sécurisé résidant dans une archive de configuration vers le système. Cette commande importe toutes les configurations de la portée du serveur définies dans l'archive de configuration vers la configuration système.
Objet cible
NONE (Aucun)Paramètres requis
- -archive
- Indique le chemin complet de l'archive de configuration à importer. (Chaîne, obligatoire)
Paramètres facultatifs
- -nodeInArchive
- Indique le nom de noeud du serveur défini dans l'archive de configuration. Indique une valeur pour ce paramètre s'il y a plusieurs noeuds dans l'archive de configuration. (Chaîne, facultatif)
- -serverInArchive
- Indique le nom du serveur proxy sécurisé défini dans l'archive de configuration. Indique une valeur pour ce paramètre s'il y a plusieurs serveurs proxy sécurisés dans l'archive. (Chaîne, facultatif)
- -deleteExistingServer
- Indique s'il faut supprimer et remplacer un serveur existant ayant le même nom que le serveur à importer. Définissez la valeur de la commande à true pour écraser les serveurs existants portant le même nom. (Chaîne, facultatif)
- -nodeName
- Indique le nom du noeud sur lequel le serveur proxy sécurisé est importé. Ce paramètre n'est obligatoire que si le nom du serveur proxy sécurisé n'est pas unique dans la cellule. (Chaîne, facultatif)
- -serverName
- Indique le nom du serveur proxy sécurisé. Si le nom de serveur indiqué correspond à celui d'un serveur existant sous le noeud, une exception est générée. (Chaîne, facultatif)
- -coreGroup
- Indique le nom du groupe central auquel le serveur proxy sécurisé appartient. (Chaîne, facultatif)
Valeur renvoyée
La commande ne renvoie pas de sortie.
Exemples
Syntaxe d'un exemple de mode différé :
- A l'aide de la chaîne Jython :
AdminTask.importProxyServer('[-archive c:/myProxyServer.car -nodeName node1 -serverInArchive server1 -deleteExistingServer true]')
- A l'aide de la liste Jython :
AdminTask.importProxyServer(['-archive', 'c:/myProxyServer.car', '-nodeName', 'node1', '-serverInArchive', 'server1', '-deleteExistingServer', 'true'])
- A l'aide de la chaîne Jython :
AdminTask.importProxyServer('[-archive /myProxyServer.car -nodeName node1 -serverInArchive server1 -deleteExistingServer true]')
- A l'aide de la liste Jython :
AdminTask.importProxyServer(['-archive', '/myProxyServer.car', '-nodeName', 'node1', '-serverInArchive', 'server1', 'server1', '-deleteExistingServer', 'true'])
Exemple d'utilisation en mode interactif :
- Avec Jython :
AdminTask.importProxyServer('-interactive')
importServer
La commande importServer permet d'importer un serveur résidant dans une archive de configuration vers le système. Cette commande importe toutes les configurations de la portée du serveur définies dans l'archive de configuration vers la configuration système. Elle permet d'importer une configuration de serveur proxy sécurisé.
Objet cible
NONE (Aucun)Paramètres et valeurs renvoyées
- -archive
- Indique le chemin d'accès complet de l'archive de configuration. (Chaîne, obligatoire)
- -nodeInArchive
- Indique le nom de noeud du serveur défini dans l'archive de configuration. (Chaîne, facultatif lorsqu'un seul noeud est défini dans l'archive de configuration, obligatoire lorsque plusieurs noeuds y sont définis)
- -serverInArchive
- Indique le nom du serveur défini dans l'archive de configuration. (Chaîne, facultatif lorsqu'un seul serveur est défini dans l'archive nodeInConfiguration indiquée, obligatoire lorsque plusieurs serveurs y sont définis)
- -nodeName
- Indique le nom du noeud vers lequel le serveur est importé. (Chaîne, facultatif lorsqu'un seul noeud est défini)
- -serverName
- Indique le nom du serveur vers lequel le serveur est importé. Si le nom de serveur indiqué correspond à celui d'un serveur existant sous le noeud, une exception est générée. (Chaîne, facultatif, valeur par défaut :serverInArchive)
- -coreGroup
- Indique le nom du groupe central auquel le serveur doit appartenir. (Chaîne, facultatif)
Exemples
Syntaxe d'un exemple de mode différé :
- A l'aide de Jacl :
$AdminTask importServer {-archive c:/myServer.car -nodeInArchive node1 -serverInArchive server1}
- A l'aide de la chaîne Jython :
AdminTask.importServer('[-archive c:/myServer.car -nodeInArchive node1 -serverInArchive server1]')
- A l'aide de la liste Jython :
AdminTask.importServer(['-archive', 'c:/myServer.car', '-nodeInArchive', 'node1', '-serverInArchive', 'server1'])
Exemple d'utilisation en mode interactif :
- A l'aide de Jacl :
$AdminTask importServer {-interactive}
- A l'aide de la chaîne Jython :
AdminTask.importServer ('[-interactive]')
- A l'aide de la liste Jython :
AdminTask.importServer (['-interactive'])
importWasprofile
La commande importWasprofile permet d'importer une configuration de cellule de l'archive de configuration vers le système. Seules les configurations de base du serveur avec un seul noeud sont prises en charge par cette commande. Elle permet d'importer un profil de serveur proxy sécurisé.
Elle ne fonctionne pas entre les systèmes d'exploitation distribués et z/OS.
Objet cible
NONE (Aucun)Paramètres et valeurs renvoyées
- -archive
- Indique le chemin d'accès complet de l'archive de configuration exportée. (Chaîne, obligatoire)
- -deleteExistingServers
- Lorsque sa valeur est true, ce paramètre supprime les serveurs existants du profil cible et importe l'archive de configuration sur le profil cible. (Booléen, facultatif)
La valeur par défaut est false qui spécifie de ne pas remplacer les serveurs.
Exemples
- A l'aide de Jacl :
$AdminTask importWasprofile {-archive c:/myCell.car}
$AdminTask importWasprofile { -archive profile.car -deleteExistingServers true}
- A l'aide de la chaîne Jython :
AdminTask.importWasprofile('[-archive c:/myCell.car]')
AdminTask.importWasprofile('[-archive profile.car -deleteExistingServers true]')
- A l'aide de la liste Jython :
AdminTask.importWasprofile(['-archive', 'c:/myCell.car'])
AdminTask.importWasprofile(['-archive', 'profile.car', '-deleteExistingServers', true])
- A l'aide de Jacl :
$AdminTask importWasprofile {-interactive}
- A l'aide de la chaîne Jython :
AdminTask.importWasprofile ('[-interactive]')
- A l'aide de la liste Jython :
AdminTask.importWasprofile (['-interactive'])