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.

Le groupe de commandes ConfigArchiveOperations de l'objet AdminTask inclut les commandes suivantes :

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

  • [Windows]A l'aide de la chaîne Jython :
    AdminTask.exportProxyProfile('[-archive "c:/myCell.car"]')
  • [AIX][Solaris][HP-UX][Linux][IBM i][z/OS]A l'aide de la chaîne Jython :
    AdminTask.exportProxyProfile('-archive c:/myCell.car')
  • [Windows]Avec une liste Jython :
    AdminTask.exportProxyProfile(['-archive', 'c:/myCell.car'])
  • [AIX][Solaris][HP-UX][Linux][IBM i][z/OS]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'])
  • [AIX][Solaris][HP-UX][Linux][IBM i][z/OS]
    A l'aide de la chaîne Jython :
    AdminTask.exportProxyServer('[-archive /myProxyServer.car -nodeName node1 
     -serverName server1]')
  • [AIX][Solaris][HP-UX][Linux][IBM i][z/OS]
    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

La commande exportWasprofile permet d'exporter l'ensemble de la configuration de cellule vers une archive de configuration. La commande exportWasprofile ne fonctionne pas entre les plateformes distribuées et les plates-formes z/OS.
Restriction : Seules les configurations de serveur de base avec un seul noeud sont prises en charge par la commande exportWasprofile.
Elle permet d'exporter 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 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'])
Exemple d'utilisation en mode interactif :
  • 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

  • [Windows]A l'aide de la chaîne Jython :
    AdminTask.importProxyProfile('-archive c:/myCell.car -deleteExistingServers true')
  • [AIX][Solaris][HP-UX][Linux][IBM i][z/OS]A l'aide de la chaîne Jython :
    AdminTask.importProxyProfile('-archive /myCell.car -deleteExistingServers true')
  • [Windows]Avec une liste Jython :
    AdminTask.importProxyProfile('-archive', 'c:/myCell.car', '-deleteExistingServers', 'true')
  • [AIX][Solaris][HP-UX][Linux][IBM i][z/OS]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'])
  • [AIX][Solaris][HP-UX][Linux][IBM i][z/OS]
    A l'aide de la chaîne Jython :
    AdminTask.importProxyServer('[-archive /myProxyServer.car -nodeName node1 -serverInArchive server1
     -deleteExistingServer true]')
  • [AIX][Solaris][HP-UX][Linux][IBM i][z/OS]
    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

Syntaxe d'un exemple de mode différé :
  • 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])
Exemple d'utilisation en mode interactif :
  • 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'])

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_atconfigarchive
Nom du fichier : rxml_atconfigarchive.html