Commandes de l'objet AdminConfig en utilisant les outils de script wsadmin
L'objet AdminConfig permet d'appeler des commandes de configuration et de créer ou de modifier des éléments de la configuration WebSphere Application Server. Par exemple, il permet de créer une source de données.
Vous pouvez démarrer le client de scriptage même lorsqu'aucun serveur n'est actif, si seules les opérations locales vous intéressent. Pour une exécution en mode local, démarrez le client de scriptage avec l'option -conntype NONE. Un message vous informe que vous êtes en mode local. Lorsqu'un serveur est en cours d'exécution, n'exécutez pas l'outil AdminConfig en mode local. Les modifications de configuration effectuées en mode local ne sont pas répercutées dans la configuration du serveur en cours d'exécution. Si vous sauvegardez une configuration non compatible, la configuration risque d'être endommagée.
Dans l'environnement d'un gestionnaire de déploiement, les mises à jour de la configuration sont uniquement disponibles lorsqu'un client de scriptage est connecté à un gestionnaire de déploiement.
Lorsque le client de scriptage est connecté à un agent de noeud ou à un serveur d'applications géré, vous n'êtes pas en mesure de mettre à jour la configuration car les configurations de ces processus serveur sont des copies de la configurations maîtresse qui réside sur le gestionnaire de déploiement. Cette copie est créée sur une machine noeud lorsqu'une synchronisation de la configuration du gestionnaire de déploiement et de l'agent de noeud a lieu. Pour modifier la configuration des processus de serveur, vous devez connecter un client de scriptage à un gestionnaire de déploiement. Pour cette raison, pour modifier une configuration, n'exécutez pas un client de scriptage en mode local sur une machine noeud. Cette configuration n'est pas prise en charge.

params='[[name name1] [nameInNameSpace nameSpace_Name] [string_to_bind "value, withComma"]]'
AdminConfig.create(type, parent, params)
Vous pouvez également utiliser la commande modify :
AdminConfig.modify(type, params)
- attributes
- checkin
- convertToCluster
- Créer
- createClusterMember
- createDocument
- createUsingTemplate
- defaults
- deleteDocument
- existsDocument
- extract
- getCrossDocumentValidationEnabled
- getid
- getObjectName
- getObjectType
- getSaveMode
- getValidationLevel
- getValidationSeverityResult
- hasChanges
- help
- installResourceAdapter
- list
- listTemplates
- modify
- parents
- queryChanges
- remove
- required
- reset
- resetAttributes
- save
- setCrossDocumentValidationEnabled
- setSaveMode
- setValidationLevel
- show
- showall
- showAttribute
- types
- uninstallResourceAdapter
- unsetAttributes
- validate
attributes
La commande attributes renvoie la liste des attributs de niveau supérieur d'un type donné.
Objet cible
Aucun.Paramètres requis
- type_objet
- Indique le nom du type d'objet basé sur les fichiers de configuration XML. Le type d'objet ne doit pas obligatoirement être identique à celui qui s'affiche dans la console d'administration.
Paramètres facultatifs
Aucun.Exemple de sortie
"properties Property*" "serverSecurity ServerSecurity"
"server Server@" "id Long" "stateManagement StateManageable"
"name String" "moduleVisibility EEnumLiteral(MODULE,
COMPATIBILITY, SERVER, APPLICATION)" "services Service*"
"statisticsProvider StatisticsProvider"
Exemples
- Avec Jacl :
$AdminConfig attributes ApplicationServer
- Avec Jython :
print AdminConfig.attributes('ApplicationServer')
checkin
La commande checkin permet de restituer un fichier dans le référentiel de configuration qui est décrit par l'URI (Uniform Resource Identifier) de document. Cette méthode ne s'applique qu'aux configurations de gestionnaire de déploiement.
Objet cible
Aucun.Paramètres requis
- URI
- L'URI du document est fonction de la racine du référentiel de configuration, par exemple:
racine_serveur_app\config
/WebSphere/AppServer/config
\WebSphere\AppServer\config
- nom_fichier
- Indique le nom du fichier source à restituer.
- objet_opaque
- Indique un objet que la commande extract de l'objet AdminConfig renvoie par un appel préalable.
Paramètres facultatifs
Aucun.Exemple de sortie
"properties Property*" "serverSecurity ServerSecurity"
"server Server@" "id Long" "stateManagement StateManageable"
"name String" "moduleVisibility EEnumLiteral(MODULE,
COMPATIBILITY, SERVER, APPLICATION)" "services Service*"
"statisticsProvider StatisticsProvider"
Exemples
- Avec Jacl :
$AdminConfig checkin cells/MyCell/Node/MyNode/serverindex.xml /mydir/myfile $obj
$AdminConfig checkin cells/MyCell/Node/MyNode/serverindex.xml c:\\mydir\myfile $obj
$AdminConfig checkin cells/MyCell/Node/MyNode/serverindex.xml \mydir\myfile $obj
- Avec Jython :
print AdminConfig.checkin('cells/MyCell/Node/MyNode/serverindex.xml', '/mydir/myfile', obj)
print AdminConfig.checkin('cells/MyCell/Node/MyNode/serverindex.xml', 'c:\mydir\myfile', obj)
print AdminConfig.checkin('cells/MyCell/Node/MyNode/serverindex.xml', '\mydir\myfile', obj)
convertToCluster
La commande convertToCluster permet de convertir un serveur de sorte qu'il devienne le premier membre d'un groupe de serveurs (cluster).
Objet cible
Aucun.Paramètres requis
- ID_serveur
- ID configuration du serveur concerné.
- nom_cluster
- Indique le nom du cluster concerné.
Paramètres facultatifs
Aucun.Exemple de sortie
myCluster(cells/mycell/clusters/myCluster|cluster.xml#ClusterMember_2)
Exemples
- Avec Jacl :
set serverid [$AdminConfig getid /Server:myServer/] $AdminConfig convertToCluster $serverid myCluster
- Avec Jython :
serverid = AdminConfig.getid('/Server:myServer/') print AdminConfig.convertToCluster(serverid, 'myCluster')
Créer
La commande create permet de créer des objets de configuration.
Objet cible
Aucun.Paramètres requis
- type
- Indique le nom du type d'objet basé sur les fichiers de configuration XML. Il ne doit pas obligatoirement être identique à celui qui s'affiche dans la console d'administration.
- ID_parent
- Indique l'ID configuration de l'objet parent.
- attributes
- Indique tous les attributs à ajouter à l'ID configuration.
Paramètres facultatifs
Aucun.Exemple de sortie
ds1(cells/mycell/nodes/DefaultNode/servers/server1|resources.xml#DataSource_6)
Exemples
- Avec Jacl :
set jdbc1 [$AdminConfig getid /JDBCProvider:jdbc1/] $AdminConfig create DataSource $jdbc1 {{name ds1}}
- A l'aide des attributs de chaîne Jython :
jdbc1 = AdminConfig.getid('/JDBCProvider:jdbc1/') print AdminConfig.create('DataSource', jdbc1, '[[name ds1]]')
- A l'aide de Jython avec des attributs d'objet :
jdbc1 = AdminConfig.getid('/JDBCProvider:jdbc1/') print AdminConfig.create('DataSource', jdbc1, [['name', 'ds1']])
- Utilisez l'exemple suivant pour créer un port :
#replace server1 with your server name serverName = 'server1' #replace smtitant24Node03 with your node name node = AdminConfig.getid('/Node:smtitan24Node03') #print node serverEntries = AdminConfig.list('ServerEntry', node).split(java.lang.System.getProperty('line.separator')) for serverEntry in serverEntries: sName = AdminConfig.showAttribute(serverEntry, "serverName") if sName == serverName: #print serverEntry #replace OVERLAY_TEST with the value you want for your endPointName id = AdminConfig.create('NamedEndPoint', serverEntry, '[[endPointName "OVERLAY_TEST"]]') #print id start = id.find('#') #print start end = id.find(')',start) #print end str = id[start:end] server = id[0:start] #print server #print str #replace 8888 with the value you want for your port AdminConfig.create('EndPoint', server+str+')', '[[port "8888"] [host "*"]]') AdminConfig.save() #AdminConfig.reset()
createClusterMember
La commande createClusterMember permet de créer un objet serveur sur le noeud indiqué par le paramètre d'ID noeud. Ce serveur est créé en tant que membre du cluster existant indiqué par le paramètre d'ID cluster et contient les attributs indiqués dans le paramètre d'attributs de membre. Le serveur est créé à l'aide du modèle de serveur indiqué par l'attribut d'ID modèle, et qui contient le nom spécifié par l'attribut memberName. L'attribut memberName est obligatoire. Les options du modèle sont uniquement disponibles pour le premier membre de cluster créé. Tous les membres de cluster créés après le premier membre sont identiques.
Objet cible
Aucun.Paramètres requis
- ID_cluster
- Indique l'ID configuration du cluster en question.
- ID noeud
- Indique l'ID configuration de l'objet en question.
- ID modèle
- Indique l'ID modèle à utiliser pour créer le serveur.
- attributs_membre
- Indique tous les attributs à ajouter au membre de cluster. L'attribut memberName est obligatoire et définit le nom du membre de cluster à créer.
Paramètres facultatifs
Aucun.Exemple de sortie
myCluster(cells/mycell/clusters/myCluster|cluster.xml#ClusterMember_2)
Exemples
- Avec Jacl :
set clid [$AdminConfig getid /ServerCluster:myCluster/] set nodeid [$AdminConfig getid /Node:mynode/] $AdminConfig createClusterMember $clid $nodeid {{memberName newMem1} {weight 5}}
- A l'aide des attributs de chaîne Jython :
clid = AdminConfig.getid('/ServerCluster:myCluster/') nodeid = AdminConfig.getid('/Node:mynode/') print AdminConfig.createClusterMember(clid, nodeid, '[[memberName newMem1] [weight 5]]')
- A l'aide de Jython avec des attributs d'objet :
clid = AdminConfig.getid('/ServerCluster:myCluster/') nodeid = AdminConfig.getid('/Node:mynode/') print AdminConfig.createClusterMember(clid, nodeid, [['memberName', 'newMem1'], ['weight', 5]])
createDocument
La commande createDocument permet de créer un document dans le référentiel de configuration.
Objet cible
Aucun.Paramètres requis
- URI_document
- Indique le nom du document à créer dans le référentiel.
- nom_fichier
- Indique un nom de fichier local valide du document à créer.
Paramètres facultatifs
Aucun.Exemples
- Avec Jacl :
$AdminConfig createDocument cells/mycell/myfile.xml /mydir/myfile
$AdminConfig createDocument cells/mycell/myfile.xml c:/mydir/myfile
$AdminConfig createDocument cells/mycell/myfile.xml /mydir/myfile
- A l'aide de Jython avec des attributs de chaîne :
AdminConfig.createDocument('cells/mycell/myfile.xml', 'c:/mydir/myfile')
AdminConfig.createDocument('cells/mycell/myfile.xml', '/mydir/myfile')
AdminConfig.createDocument('cells/mycell/myfile.xml', '/mydir/myfile')
createUsingTemplate
La commande createUsingTemplate permet de créer un type d'objet avec le parent donné, en utilisant un modèle. Vous ne pouvez utiliser cette commande que pour la création d'un serveur avec le type APPLICATION_SERVER. Si vous souhaitez créer un serveur avec un autre type que APPLICATION_SERVER, utilisez la commande createGenericServer ou createWebServer.
Objet cible
Aucun.Paramètres requis
- type
- Indique le type d'objet à créer.
- parent
- Indique l'ID configuration du parent.
- modèle
- Indique l'ID configuration d'un objet existant. Cet objet peut correspond à un objet modèle renvoyé à l'aide de la commande listTemplates ou à tout autre objet existant du type correct.
Paramètres facultatifs
- attributes
- Indique des valeurs d'attributs pour l'objet. Les attributs spécifiés à l'aide de ce paramètre remplacent les valeurs paramétrées dans le modèle.
Exemple de sortie
myCluster(cells/mycell/clusters/myCluster|cluster.xml#ClusterMember_2)
Exemples
- Avec Jacl :
set node [$AdminConfig getid /Node:mynode/] set templ [$AdminConfig listTemplates JDBCProvider "DB2 JDBC Provider (XA)"] $AdminConfig createUsingTemplate JDBCProvider $node {{name newdriver}} $templ
- A l'aide de Jython avec des attributs de chaîne :
node = AdminConfig.getid('/Node:mynode/') templ = AdminConfig.listTemplates('JDBCProvider', "DB2 JDBC Provider (XA)") print AdminConfig.createUsingTemplate('JDBCProvider', node, '[[name newdriver]]', templ)
- A l'aide de Jython avec des attributs d'objet :
node = AdminConfig.getid('/Node:mynode/') templ = AdminConfig.listTemplates('JDBCProvider', "DB2 JDBC Provider (XA)") print AdminConfig.createUsingTemplate('JDBCProvider', node, [['name', 'newdriver']], templ)
defaults
La commande defaults permet d'afficher les valeurs par défaut des attributs d'un type donné. Cette méthode affiche tous les attributs que peut contenir un objet d'un type spécifique. Si l'attribut a une valeur par défaut, cette méthode affiche également le type et la valeur par défaut de chaque attribut.
Objet cible
Aucun.Paramètres requis
- type
- Indique le type d'objet à renvoyer. Le nom du type d'objet indiqué est basé sur les fichiers de configuration XML. Il ne doit pas obligatoirement être identique à celui qui s'affiche dans la console d'administration.
Paramètres facultatifs
Aucun.Exemple de sortie
Attribute Type Default
usingMultiRowSchema Boolean false
maxInMemorySessionCount Integer 1000
allowOverflow Boolean true
scheduleInvalidation Boolean false
writeFrequency ENUM
writeInterval Integer 120
writeContents ENUM
invalidationTimeout Integer 30
invalidationSchedule InvalidationSchedule
Exemples
- Avec Jacl :
$AdminConfig defaults TuningParams
- Avec Jython :
print AdminConfig.defaults('TuningParams')
deleteDocument
La commande deleteDocument permet de supprimer un document du référentiel de configuration.
Objet cible
Aucun.Paramètres requis
- URI_document
- Indique le document à supprimer du référentiel.
Paramètres facultatifs
Aucun.Exemples
- Avec Jacl :
$AdminConfig deleteDocument cells/mycell/myfile.xml
- Avec Jython :
AdminConfig.deleteDocument('cells/mycell/myfile.xml')
existsDocument
La commande existsDocument permet de vérifier la présente d'un document dans le référentiel de configuration.
Objet cible
Aucun.Paramètres requis
- URI_document
- Indique le document à vérifier dans le référentiel.
Paramètres facultatifs
Aucun.Exemple de sortie
1
Exemples
- Avec Jacl :
$AdminConfig existsDocument cells/mycell/myfile.xml
- Avec Jython :
print AdminConfig.existsDocument('cells/mycell/myfile.xml')
extract
La commande extract permet d'extraire du référentiel de configuration le fichier décrit par le paramètre d'URI de document et le place dans le fichier désigné par filename. Cette méthode ne s'applique qu'aux configurations de gestionnaire de déploiement.
Objet cible
Aucun.Paramètres requis
- URI_document
- Indique le document à extraire du référentiel de configuration. L'URI du document doit exister dans le référentiel. L'URI du document est fonction de la racine du référentiel de configuration, par exemple:
/WebSphere/AppServer/config
racine_serveur_app\config
- nom_fichier
- Indique le nom du fichier dans lequel extraire le document. Ce paramètre doit indiquer un nom de fichier local correct dans lequel se trouve le document. Si le fichier désigné par le paramètre nom_fichier existe, le fichier extrait le remplace.
Paramètres facultatifs
Aucun.Exemple de sortie
La commande renvoie un objet "digest" opaque qui doit servir à restituer le fichier à l'aide de la commande checkin.
Exemples
- Avec Jacl :
set obj [$AdminConfig extract cells/MyCell/nodes/MyNode/serverindex.xml /mydir/myfile]
set obj [$AdminConfig extract cells/MyCell/nodes/MyNode/serverindex.xml c:\\mydir\myfile]
set obj [$AdminConfig extract cells/MyCell/nodes/MyNode/serverindex.xml \mydir\myfile]
- Avec Jython :
obj = AdminConfig.extract('cells/MyCell/nodes/MyNode/serverindex.xml','/mydir/myfile')
obj = AdminConfig.extract('cells/MyCell/nodes/MyNode/serverindex.xml','c:\mydir\myfile')
obj = AdminConfig.extract('cells/MyCell/nodes/MyNode/serverindex.xml','\mydir\myfile')
getCrossDocumentValidationEnabled
La commande getCrossDocumentValidationEnabled permet de renvoyer un message indiquant le paramétrage d'activation de la validation interdocuments. Cette méthode renvoie la valeur true si la validation interdocuments est activée.
Objet cible
Aucun.Paramètres requis
Aucun.
Paramètres facultatifs
Aucun.
Exemple de sortie
WASX7188I: Cross-document validation enablement set to true
Exemples
- Avec Jacl :
$AdminConfig getCrossDocumentValidationEnabled
- Avec Jython :
print AdminConfig.getCrossDocumentValidationEnabled()
getid
La commande getid permet de renvoyer l'ID configuration d'un objet.
Objet cible
Aucun.Paramètres requis
- chemin_imbrication
- Indique le chemin d'imbrication concerné.
Paramètres facultatifs
Aucun.
Exemple de sortie
Db2JdbcDriver(cells/testcell/nodes/testnode|resources.xml#JDBCProvider_1)
Exemples
- Avec Jacl :
$AdminConfig getid /Cell:testcell/Node:testNode/JDBCProvider:Db2JdbcDriver/
- Avec Jython :
print AdminConfig.getid('/Cell:testcell/Node:testNode/JDBCProvider:Db2JdbcDriver/')
getObjectName
La commande getObjectName permet de renvoyer une version chaîne du nom d'objet du MBean correspondant en cours d'exécution. Cette méthode renvoie une chaîne vide lorsqu'il n'existe pas de MBean correspondant en cours d'exécution.
Objet cible
Aucun.Paramètres requis
- ID_configuration
- Indique l'ID configuration du nom d'objet à renvoyer.
Paramètres facultatifs
Aucun.
Exemple de sortie
WebSphere:cell=mycell,name=server1,mbeanIdentifier=cells/mycell/nodes/mynode/servers/server1/
server.xml#Server_1,type=Server,node=mynode,process=server1,processType=UnManagedProcess
Exemples
- Avec Jacl :
set server [$AdminConfig getid /Node:mynode/Server:server1/] $AdminConfig getObjectName $server
- Avec Jython :
server = AdminConfig.getid('/Node:mynode/Server:server1/') print AdminConfig.getObjectName(server)
getObjectType
Utilisez la commande getObjectType pour afficher le type d'objet de l'ID configuration de l'objet impliqué.
Objet cible
Aucun.Paramètres requis
- ID_configuration
- Indique l'ID configuration du nom d'objet à renvoyer.
Paramètres facultatifs
Aucun.
Exemples
- Avec Jacl :
set server [$AdminConfig getid /Node:mynode/Server:server1/] $AdminConfig getObjectType $server
- Avec Jython :
server = AdminConfig.getid('/Node:mynode/Server:server1/') print AdminConfig.getObjectType(server)
getSaveMode
- overwriteOnConflict - Sauvegarde les modifications même si elles sont en conflit avec d'autres modifications de configuration.
- rollbackOnConflict - Provoque l'échec de l'opération de sauvegarde si les modifications sont en conflit avec d'autres modifications de configuration. Il s'agit de la valeur par défaut.
Objet cible
Aucun.Paramètres requis
Aucun.
Paramètres facultatifs
Aucun.
Exemple de sortie
rollbackOnConflict
Exemples
- Avec Jacl :
$AdminConfig getSaveMode
- Avec Jython :
print AdminConfig.getSaveMode()
getValidationLevel
La commande getValidationLevel permet de renvoyer la validation utilisée lorsque des fichiers sont extraits du référentiel.
Objet cible
Aucun.Paramètres requis
Aucun.
Paramètres facultatifs
Aucun.
Exemple de sortie
WASX7189I: Validation level set to HIGH
Exemples
- Avec Jacl :
$AdminConfig getValidationLevel
- Avec Jython :
print AdminConfig.getValidationLevel()
getValidationSeverityResult
La commande getValidationSeverityResult permet de renvoyer le nombre de messages de validation ayant la gravité donnée de la dernière validation.
Objet cible
Aucun.Paramètres requis
- severity
- Indique le niveau de gravité pour lequel renvoyer le nombre de messages de validation. Spécifiez un entier compris entre 0 et 9.
Paramètres facultatifs
Aucun.
Exemple de sortie
16
Exemples
- Avec Jacl :
$AdminConfig getValidationSeverityResult 1
- Avec Jython :
print AdminConfig.getValidationSeverityResult(1)
hasChanges
La commande hasChanges permet de déterminer s'il existe des modifications de configuration non sauvegardées.
Objet cible
Aucun.Paramètres requis
Aucun.
Paramètres facultatifs
Aucun.
Exemple de sortie
1
Exemples
- Avec Jacl :
$AdminConfig hasChanges
- Avec Jython :
print AdminConfig.hasChanges()
help
La commande help permet d'afficher des informations d'aide statiques relatives à l'objet AdminConfig.
Objet cible
Aucun.Paramètres requis
Aucun.
Paramètres facultatifs
Aucun.
Exemple de sortie
WASX7053I: The AdminConfig object communicates with the configuration service in a product to manipulate
configuration data for an Application Server installation. The AdminConfig object has commands to list,
create, remove, display, and modify configuration data, as well as commands to display information about
configuration data types.
Most of the commands supported by the AdminConfig object operate in two modes: the default mode is one in which
the AdminConfig object communicates with the Application Server to accomplish its tasks. A local mode is also
possible, in which no server communication takes place. The local mode of operation is invoked by bringing up
the scripting client without a server connected using the command line "-conntype NONE" option or setting the
"com.ibm.ws.scripting.connectionType=NONE" property in the wsadmin.properties file.
The following commands are supported by the AdminConfig object; more detailed information about each of these commands is
available by using the help command of the AdminConfig object and by supplying the name of the command as an argument.
attributes Shows the attributes for a given type
checkin Checks a file into the configuration repository.
convertToCluster Converts a server to be the first member of a new server cluster
create Creates a configuration object, given a type, a parent, and a list of attributes, and
optionally an attribute name for the new object
createClusterMember Creates a new server that is a member of an existing cluster.
createDocument Creates a new document in the configuration repository.
installResourceAdapter Installs a J2C resource adapter with the given RAR file name and an option string in the node.
createUsingTemplate Creates an object using a particular template type.
defaults Displays the default values for the attributes of a given type.
deleteDocument Deletes a document from the configuration repository.
existsDocument Tests for the existence of a document in the configuration repository.
extract Extracts a file from the configuration repository.
getCrossDocumentValidationEnabled Returns true if cross-document validation is enabled.
getid Show the configuration ID of an object, given a string version of its containment
getObjectName Given a configuration ID, returns a string version of the ObjectName
for the corresponding running MBean, if any.
getSaveMode Returns the mode used when "save" is invoked
getValidationLevel Returns the validation that is used when files are extracted from the repository.
getValidationSeverityResult Returns the number of messages of a given severity from the most recent validation.
hasChanges Returns true if unsaved configuration changes exist
help Shows help information
list Lists all the configuration objects of a given type
listTemplates Lists all the available configuration templates of a given type.
modify Changes the specified attributes of a given configuration object
parents Shows the objects which contain a given type
queryChanges Returns a list of unsaved files
remove Removes the specified configuration object
required Displays the required attributes of a given type.
reset Discards the unsaved configuration changes
save Commits the unsaved changes to the configuration repository
setCrossDocumentValidationEnabled Sets the cross-document validation enabled mode.
setSaveMode Changes the mode used when "save" is invoked
setValidationLevel Sets the validation used when files are extracted from the repository.
show Shows the attributes of a given configuration object
showall Recursively shows the attributes of a given configuration
object, and all the objects that are contained within each attribute.
showAttribute Displays only the value for the single attribute that is specified.
types Shows the possible types for configuration
validate Invokes validation
Exemples
- Avec Jacl :
$AdminConfig help
- Avec Jython :
print AdminConfig.help()
installResourceAdapter
La commande installResourceAdapter permet d'installer dans le noeud un adaptateur de ressource J2C (Java 2 Connector) avec le nom de fichier RAR (Resource Adapter Archive) donné et une chaîne d'option. Lorsque vous éditez l'application installée avec le fichier RAR intégré, seuls la fabrique de connexions J2C, les spécifications d'activation J2C et les objets d'administration J2C existants sont édités. Aucun nouvel objet J2C n'est créé.
Objet cible
Aucun.Paramètres requis
- node
- Indique le noeud en question.
- nom_fichier_RAR
- Indique le nom qualifié complet du fichier RAR qui réside dans le noeud désigné.
Paramètres facultatifs
- options
- Indique d'autres options permettant d'installer un adaptateur de ressources. Les options admises sont les suivantes :
- rar.name
- rar.desc
- rar.archivePath
- rar.classpath
- rar.nativePath
- rar.threadPoolAlias
- rar.propertiesSet
L'option rar.archivePath indique le chemin où le fichier est extrait. Si vous ne précisez pas cette option, l'archive est extraite dans le répertoire $\{CONNECTOR_INSTALL_ROOT\}. L'option rar.classpath indique un autre chemin d'accès aux classes.
L'option rar.propertiesSet est construite de la manière suivante :
Chaque attribut de la propriété est indiqué entre accolades. Une propriété est indiquée entre accolades {}. Vous pouvez spécifier plusieurs propriétés entre accolades {}.name String value String type String *desc String *required true/false * means the item is optional
Exemple de sortie
myResourceAdapter(cells/mycell/nodes/mynode|resources.xml#J2CResourceAdapter_1)
Exemples
- Avec Jacl :
$AdminConfig installResourceAdapter /rar/mine.rar mynode{-rar.name myResourceAdapter -rar.desc "My rar file"}
$AdminConfig installResourceAdapter c:/rar/mine.rar mynode {-rar.name myResourceAdapter -rar.desc "My rar file"}
- Avec Jython :
print AdminConfig.installResourceAdapter('/rar/mine.rar', 'mynode', '[-rar.name myResourceAdapter -rar.desc "My rar file"]')
print AdminConfig.installResourceAdapter('c:/rar/mine.rar', 'mynode', '[-rar.name myResourceAdapter -rar.desc "My rar file"]')
resourceProperties (name=myName,value=myVal)
dans la configuration de l'adaptateur de ressources, exécutez les commandes suivantes :pSet = [['propertySet',[['resourceProperties',[[['name','myName'], ['type', 'String'], ['value','myVal']]]]]]]
myRA =AdminConfig.installResourceAdapter('/query.rar','mynodeCellManager05', ['-rar.desc','mydesc'])
myRA =AdminConfig.installResourceAdapter('c:\query.rar','mynodeCellManager05', ['-rar.desc','mydesc'])
AdminConfig.modify(myRA,pSet)
list
La commande list permet de renvoyer une liste d'objets d'un type donné ou d'affiner la requête de recherche en affectant un type et un parent sectorisé ou en affectant un type et un modèle de caractère générique (*) ou d'expression régulière Java (.*) dans la syntaxe de la commande afin de personnaliser la requête de recherche.
Objet cible
Aucun.Paramètres requis
- type_objet
- Indique le nom du type d'objet. Le nom du type d'objet est basé sur les fichiers de configuration XML et ne doit pas obligatoirement être identique à celui qui s'affiche dans la console d'administration.
Paramètres facultatifs
- scope
- Indique des informations de requête de recherche supplémentaires à l'aide d'un parent sectorisé.
- pattern
- Indique des informations de requête de recherche supplémentaires à l'aide d'un modèle de caractère générique (*) ou d'expression Java régulière (.*).
Exemple de sortie
Db2JdbcDriver(cells/mycell/nodes/DefaultNode|resources.xml#JDBCProvider_1)
Db2JdbcDriver(cells/mycell/nodes/DefaultNode/servers/deploymentmgr|resources.xml#JDBCProvider_1)
Db2JdbcDriver(cells/mycell/nodes/DefaultNode/servers/nodeAgent|resources.xml#JDBCProvider_1)
Exemples
- Avec Jacl :
$AdminConfig list JDBCProvider
- Avec Jython :
print AdminConfig.list('JDBCProvider')
Remarque : Utilisez des guillemets simples ou doubles.
- Avec Jacl :
$AdminConfig list JDBCProvider derby*
- Avec Jython :
print AdminConfig.list('JDBCProvider', 'derby*')
Vous pouvez utiliser des modèles d'expressions Java régulières et des modèles de caractères génériques pour préciser le nom de la commande pour la liste $AdminConfig, les types et les fonctions listTemplates.
- Avec Jacl :
$AdminConfig list Server server1.*
- Avec Jython :
print AdminConfig.list("Server", "server1.*")
Les exemples suivants illustrent chaque objet de configuration de serveur en affectant un type d'objet et un ID de configuration de portée parent :
- Avec Jacl :
$AdminConfig list Server myNode(cells/myCell/nodes/myNode|node.xml#Node_1)
- Avec Jython :
print AdminConfig.list("Server", "myNode(cells/myCell/nodes/myNode|node.xml#Node_1)")
- Avec Jacl et des modèles d'expression Java régulières :
$AdminConfig types SSLConfig.*
- Ave Jacl et des modèles de caractères génériques :
$AdminConfig types SSLConfig*
- Avec Jython et des modèles d'expressions Java régulières :
print AdminConfig.types("SSLConfig.*")
- Avec Jython et des modèles de caractères génériques :
print AdminConfig.types("SSLConfig*")
listTemplates
La commande listTemplates affiche la liste des ID objet modèle. Vous pouvez utiliser les caractères génériques (*) ou les expressions Java régulières (.*) dans la syntaxe de commande pour personnaliser la requête de recherche.
Objet cible
Aucun.Paramètres requis
- type_objet
- Indique le nom du type d'objet. Le nom du type d'objet est basé sur les fichiers de configuration XML et ne doit pas obligatoirement être identique à celui qui s'affiche dans la console d'administration.
- pattern
- Indique d'autres informations de requête de recherche à l'aide de caractères génériques ou d'expressions Java régulières.
Paramètres facultatifs
Aucun.Exemple de sortie
"Derby JDBC Provider (XA)(templates/servertypes/APPLICATION_SERVER/servers/DeveloperServer|resources.xml#builtin_jdbcprovider)"
"Derby JDBC Provider (XA)(templates/servertypes/APPLICATION_SERVER/servers/defaultZOS|resources.xml#builtin_jdbcprovider)"
"Derby JDBC Provider (XA)(templates/servertypes/APPLICATION_SERVER/servers/default|resources.xml#builtin_jdbcprovider)"
"Derby JDBC Provider (XA)(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)"
"Derby JDBC Provider 40 (XA)(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_2)"
"Derby JDBC Provider 40 Only (XA)(templates/system|jdbc-resource-provider-only-templates.xml#JDBCProvider_derby_2)"
"Derby JDBC Provider 40 Only(templates/system|jdbc-resource-provider-only-templates.xml#JDBCProvider_derby_1)"
"Derby JDBC Provider 40(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_1)"
"Derby JDBC Provider Only (XA)(templates/system|jdbc-resource-provider-only-templates.xml#JDBCProvider_derby_4)"
"Derby JDBC Provider Only(templates/system|jdbc-resource-provider-only-templates.xml#JDBCProvider_derby_3)"
"Derby JDBC Provider(templates/servertypes/APPLICATION_SERVER/servers/DeveloperServer|resources.xml#JDBCProvider_1124467079638)"
"Derby JDBC Provider(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_derby_3)"
Exemples
- Avec Jacl :
$AdminConfig listTemplates JDBCProvider
- Avec Jython :
print AdminConfig.listTemplates('JDBCProvider')
- Avec Jacl :
$AdminConfig listTemplates JDBCProvider sybase*
- Avec Jython :
print AdminConfig.listTemplates('JDBCProvider', 'sybase*')
modify
La commande modify permet de prendre en charge la modification des attributs d'objet.
Objet cible
Aucun.Paramètres requis
- ID_configuration
- Indique l'ID configuration de l'objet à modifier.
- attributes
- Indique les attributs à modifier pour l'ID configuration concerné.
Paramètres facultatifs
Aucun.Exemples
- Avec Jacl :
$AdminConfig modify ConnFactory1(cells/mycell/nodes/DefaultNode/servers/deploymentmgr|resources.xml# GenericJMSConnectionFactory_1) {{userID newID} {password newPW}}
- A l'aide de Jython avec des attributs de chaîne :
AdminConfig.modify('ConnFactory1(cells/mycell/nodes/DefaultNode/servers/deploymentmgr|resources.xml# GenericJMSConnectionFactory_1)', '[[userID newID] [password newPW]]')
- A l'aide de Jython avec des attributs d'objet :
AdminConfig.modify('ConnFactory1(cells/mycell/nodes/DefaultNode/servers/deploymentmgr|resources.xml# GenericJMSConnectionFactory_1)', [['userID', 'newID'], ['password', 'newPW']])
parents
La commande parents permet d'obtenir des informations relatives aux types d'objet.
Objet cible
Aucun.Paramètres requis
- type_objet
- Indique le type d'objet qui vous intéresse. Le nom du type d'objet est basé sur les fichiers de configuration XML et ne doit pas obligatoirement être identique à celui qui s'affiche dans la console d'administration.
Paramètres facultatifs
Aucun.Exemple de sortie
Cell
Node
Server
Exemples
- Avec Jacl :
$AdminConfig parents JDBCProvider
- Avec Jython :
print AdminConfig.parents('JDBCProvider')
queryChanges
La commande queryChanges renvoie la liste des fichiers de configuration non sauvegardés.
Objet cible
Aucun.Paramètres requis
Aucun.Paramètres facultatifs
Aucun.Exemple de sortie
WASX7146I: The following configuration files contain unsaved changes:
cells/mycell/nodes/mynode/servers/server1|resources.xml
Exemples
- Avec Jacl :
$AdminConfig queryChanges
- Avec Jython :
print AdminConfig.queryChanges()
remove
La commande remove permet de supprimer un objet de configuration.
Objet cible
Aucun.Paramètres requis
- ID_configuration
- Indique l'objet de configuration qui vous intéresse.
Paramètres facultatifs
Aucun.Exemples
- Avec Jacl :
set ds [$AdminConfig list DataSource "Default Datasource*"] $AdminConfig remove $ds
- Avec Jython :
ds = AdminConfig.list('DataSource', 'Default Datasource*') AdminConfig.remove(ds)
required
La commande required affiche les attributs obligatoires que contient un objet d'un type spécifique.
Objet cible
Aucun.Paramètres requis
- type
- Indique le type d'objet pour lequel afficher les attributs obligatoires. Le nom du type d'objet est basé sur les fichiers de configuration XML. Ce n'est pas obligatoirement celui qu'affiche la console d'administration.
Paramètres facultatifs
Aucun.Exemple de sortie
Attribute Type
streamHandlerClassName String
protocol String
Exemples
- Avec Jacl :
$AdminConfig required URLProvider
- Avec Jython :
print AdminConfig.required('URLProvider')
reset
La commande reset permet de réinitialiser l'espace de travail temporaire qui contient la configuration.
Objet cible
Aucun.Paramètres requis
Aucun.Paramètres facultatifs
Aucun.Exemples
- Avec Jacl :
$AdminConfig reset
- Avec Jython :
AdminConfig.reset()
resetAttributes
Utilisez la commande resetAttributes pour réinitialiser des attributs spécifiques de l'objet de configuration impliqué.
Objet cible
Aucun.Paramètres requis
- ID_configuration
- Précise l'ID configuration de l'objet de configuration impliqué.
- attributes
- Précise l'attribut à réinitialiser et la nouvelle valeur à lui accorder.
Paramètres facultatifs
Aucun.Exemples
- Avec Jacl :
set ds [$AdminConfig list DataSource "Default Datasource*"] $AdminConfig resetAttributes $ds {{"description" "A new description for the data source"}}
- Avec Jython :
ds = AdminConfig.list('DataSource', 'Default Datasource*') AdminConfig.resetAttributes(ds, [["description", "A new description for the data source"]])
save
La commande save permet d'enregistrer les modifications apportées à la configuration.
Objet cible
Aucun.Paramètres requis
Aucun.Paramètres facultatifs
Aucun.Exemple de sortie
La commande save ne renvoie pas de sortie.
Exemples
- Avec Jacl :
$AdminConfig save
- Avec Jython :
AdminConfig.save()
setCrossDocumentValidationEnabled
La commande setCrossDocumentValidationEnabled active le mode de validation interdocuments. Les valeurs incluent true ou false.
Objet cible
Aucun.Paramètres requis
- flag
- Indique si la validation interdocuments est activée ou désactivée. Indiquez true pour activer la validation interdocuments, ou false pour la désactiver.
Paramètres facultatifs
Aucun.Exemple de sortie
WASX7188I: Cross-document validation enablement set to true
Exemples
- Avec Jacl :
$AdminConfig setCrossDocumentValidationEnabled true
- Avec Jython :
print AdminConfig.setCrossDocumentValidationEnabled('true')
setSaveMode
La commande setSaveMode permet de modifier le comportement de la commande save.
Objet cible
Aucun.Paramètres requis
- mode_sauvegarde
- Indique le mode de sauvegarde à utiliser. La valeur par défaut est rollbackOnConflict. En cas de conflit lors d'une opération de sauvegarde, les modifications non sauvegardées ne sont pas validées. L'autre valeur est overwriteOnConflict, qui sauvegarde les modifications dans le référentiel de configuration même en cas de conflit. Pour utiliser overwriteOnConflict comme valeur de cette commande, la fonction de remplacement de la configuration du gestionnaire de déploiement doit être activée.
Paramètres facultatifs
Aucun.Exemple de sortie
La commande setSaveMode ne renvoie pas de sortie.
Exemples
- Avec Jacl :
$AdminConfig setSaveMode overwriteOnConflict
- Avec Jython :
AdminConfig.setSaveMode('overwriteOnConflict')
setValidationLevel
La commande setValidationLevel permet de définir la validation utilisée lorsque des fichiers sont extraits du référentiel.
Objet cible
Aucun.Paramètres requis
- niveau
- Indique le niveau de validation à utiliser. Il existe cinq niveaux de validation : none, low, medium, high ou highest.
Paramètres facultatifs
Aucun.Exemple de sortie
WASX7189I: Validation level set to HIGH
Exemples
- Avec Jacl :
$AdminConfig setValidationLevel high
- Avec Jython :
print AdminConfig.setValidationLevel('high')
show
La commande show renvoie les attributs de niveau supérieur de l'objet désigné.
Objet cible
Aucun.Paramètres requis
- ID_configuration
- Indique l'ID configuration de l'objet en question.
Paramètres facultatifs
Aucun.Exemple de sortie
[name "Sample Datasource"] [description "Data source for the Sample entity beans"]
Exemples
- Avec Jacl :
$AdminConfig show Db2JdbcDriver(cells/mycell/nodes/DefaultNode|resources.xmlJDBCProvider_1)
- Avec Jython :
print AdminConfig.show('Db2JdbcDriver(cells/mycell/nodes/DefaultNode|resources.xmlJDBCProvider_1)')
showall
La commande showall permet l'affichage récursif des attributs d'un objet de configuration donné.
Objet cible
Aucun.Paramètres requis
- ID_configuration
- Indique l'ID configuration de l'objet en question.
Paramètres facultatifs
Aucun.Exemple de sortie
La commande renvoie une chaîne contenant la valeur d'attribut, comme dans les exemples suivants :
tcpNoDelay: null
SoTimeout: 0
bytesRead: 6669
{authMechanismPreference BASIC_PASSWORD}
{connectionPool {{agedTimeout 0}
{connectionTimeout 180}
{freePoolDistributionTableSize 0}
{maxConnections 10}
{minConnections 1}
{numberOfFreePoolPartitions 0}
{numberOfSharedPoolPartitions 0}
{numberOfUnsharedPoolPartitions 0}
{properties {}}
{purgePolicy EntirePool}
{reapTime 180}
{stuckThreshold 0}
{stuckTime 0}
{stuckTimerTime 0}
{surgeCreationInterval 0}
{surgeThreshold -1}
{testConnection false}
{testConnectionInterval 0}
{unusedTimeout 1800}}}
{datasourceHelperClassname com.ibm.websphere.rsadapter.DerbyDataStoreHelper}
{description "Datasource for the WebSphere Default Application"}
{diagnoseConnectionUsage false}
{jndiName DefaultDatasource}
{logMissingTransactionContext true}
{manageCachedHandles false}
{name "Default Datasource"}
{properties {}}
{propertySet {{resourceProperties {{{name databaseName}
{required false}
{type java.lang.String}
{value ${APP_INSTALL_ROOT}/${CELL}/DefaultApplication.ear/DefaultDB}} {{name shu
tdownDatabase}
{required false}
{type java.lang.String}
{value {}}} {{name dataSourceName}
{required false}
{type java.lang.String}
{value {}}} {{name description}
{required false}
{type java.lang.String}
{value {}}} {{name connectionAttributes}
{required false}
{type java.lang.String}
{value upgrade=true}} {{name createDatabase}
{required false}
{type java.lang.String}
{value {}}}}}}}
{provider "Derby JDBC Provider(cells/isthmusCell04/nodes/isthmusNode14/servers/s
erver1|resources.xml#JDBCProvider_1183122153343)"}
{providerType "Derby JDBC Provider"}
{relationalResourceAdapter "WebSphere Relational Resource Adapter(cells/isthmusC
ell04/nodes/isthmusNode14/servers/server1|resources.xml#builtin_rra)"}
{statementCacheSize 10}
[datasourceHelperClassname com.ibm.websphere.rsadapter.DerbyDataStoreHelper]
[description "Datasource for the WebSphere Default Application"]
[jndiName DefaultDatasource]
[name "Default Datasource"]
[propertySet [[resourceProperties [[[description "Location of Apache Derby default database."]
[name databaseName]
[type string]
[value ${WAS_INSTALL_ROOT}/bin/DefaultDB]] [[name remoteDataSourceProtocol]
[type string]
[value []]] [[name shutdownDatabase]
[type string]
[value []]] [[name dataSourceName]
[type string]
[value []]] [[name description]
[type string]
[value []]] [[name connectionAttributes]
[type string]
[value []]] [[name createDatabase]
[type string]
[value []]]]]]]
[provider "Apache Derby JDBC Driver(cells/pongo/nodes/pongo/servers/server1|resources.xml#JDBCProvider_1)"]
[relationalResourceAdapter "WebSphere Relational Resource Adapter(cells/pongo/nodes/pongo/servers/server1|
resources.xml#builtin_rra)"]
[statementCacheSize 0]
Vous devrez convertir la chaîne de la
sortie Jython en liste pour la suite du traitement.Exemples
- Avec Jacl :
$AdminConfig showall "Default Datasource(cells/mycell/nodes/DefaultNode/servers/server1:resources.xml#DataSource_1)"
- Avec Jython :
print AdminConfig.showall ("Default Datasource(cells/mycell/nodes/DefaultNode/servers/server1:resources.xml#DataSource_1)")
showAttribute
La commande showAttribute affiche uniquement la valeur de l'unique attribut indiqué.
Objet cible
Aucun.Paramètres requis
- ID_configuration
- Indique l'ID configuration de l'objet en question.
- attribute
- Indique l'attribut à interroger.
Paramètres facultatifs
Aucun.Exemple de sortie
mynode
Exemples
- Avec Jacl :
set ns [$AdminConfig getid /Node:mynode/] $AdminConfig showAttribute $ns hostName
- Avec Jython :
ns = AdminConfig.getid('/Node:mynode/') print AdminConfig.showAttribute(ns, 'hostName')
Dans les versions antérieures à la version 7.0.0.5, le langage de script Jython ne reconnaît pas les caractères spéciaux. De plus, si une virgule ou un espace apparaît entre des paramètres d'attribut, ces caractères sont traités comme des délimiteurs, et ignorés lors de la sauvegarde de la valeur de l'attribut. Vous pouvez par exemple trouver la série de commandes Jython suivante :
vous pouvez utiliser la commande suivante pour afficher la valeur :value='{"param1","param2"}' serverId=AdminConfig.getid('/Cell:cell_name/Node:node_name/Server:server_name') nameSpace=AdminConfig.create('StringNameSpaceBinding',serverId,[['name','TestName'], ['nameInSpace','TestNameSpace'],['stringToBind',value] ])
ce qui produit le résultat suivant :print AdminConfig.showAttribute(nameSpace, 'stringToBind')
Dans la version 7.0.0.5 et suivantes, le langage de script Jython reconnaît la virgule si elle est précédée d'une barre oblique inversée (\). Par exemple, dans la série de commandes Jython précédente, remplacez la première ligne par la commande suivante :{"param1" "param2"}
Quand vous affichez la valeur avec print, vous obtenez :value='{"param1"\,"param2"}'
{"param1","param2"}
types
Utilisez la commande types pour obtenir une liste de types d'objet de configuration que vous pouvez manipuler, ou personnalisez la requête de recherche en ajoutant un modèle de caractères génériques (*) ou d'expressions régulières Java (.*) supplémentaire dans la syntaxe de la commande.
Objet cible
Aucun.Paramètres requis
Aucun.Paramètres facultatifs
- pattern
- Indique des informations de requête de recherche supplémentaires à l'aide d'un modèle de caractère générique (*) ou d'expression Java régulière (.*).
Exemple de sortie
AdminService
Agent
ApplicationConfig
ApplicationDeployment
ApplicationServer
AuthMechanism
AuthenticationTarget
AuthorizationConfig
AuthorizationProvider
AuthorizationTableImpl
BackupCluster
CMPConnectionFactory
CORBAObjectNameSpaceBinding
Cell
CellManager
Classloader
ClusterMember
ClusteredTarget
CommonSecureInteropComponent
Exemples
- Avec Jacl :
$AdminConfig types
- Avec Jython :
print AdminConfig.types()
- Avec Jacl :
$AdminConfig types *security*
- Avec Jython :
print AdminConfig.types('*security*')
uninstallResourceAdapter
La commande uninstallResourceAdapter permet de désinstaller un adaptateur de ressource J2C (Java 2 Connector) comportant un ID configuration d'adaptateur de ressource J2C et une liste d'options. Lorsque vous retirez un objet J2CResourceAdapter du référentiel de configuration, le répertoire installé est retiré au moment de la synchronisation. Une demande d'arrêt est envoyée au bean géré J2CResourceAdapter qui a été retiré.
Objet cible
Aucun.Paramètres requis
- ID_configuration
- Indique l'ID configuration de l'adaptateur de ressource à supprimer.
Paramètres facultatifs
- liste_options
- Indique les options de désinstallation pour la commande. L'option admise est force. Cette option force la désinstallation de l'adaptateur de ressource sans vérifier si celui-ci est utilisé par une application. L'application qui l'utilise n'est pas désinstallée. Si vous n'indiquez pas l'option force et que l'adaptateur de ressource indiqué est toujours en cours d'utilisation, l'adaptateur de ressource n'est pas désinstallé.
Exemple de sortie
WASX7397I: The following J2CResourceAdapter objects are removed:
MyJ2CRA(cells/juniarti/nodes/juniarti|resources.xml#J2CResourceAdapter_1069433028609)
Exemples
- Avec Jacl :
set j2cra [$AdminConfig getid /J2CResourceAdapter:MyJ2CRA/] $AdminConfig uninstallResourceAdapter $j2cra {-force}
- Avec Jython :
j2cra = AdminConfig.getid('/J2CResourceAdapter:MyJ2CRA/') print AdminConfig.uninstallResourceAdapter(j2cra, '[-force]')
unsetAttributes
Utilisez la commande unsetAttributes pour réinitialiser des attributs spécifiques d'un objet de configuration à leurs valeurs par défaut.
Objet cible
Aucun.Paramètres requis
- ID_configuration
- Précise l'ID configuration de l'objet de configuration impliqué.
- attributes
- Spécifie les attributs à réinitialiser à leurs valeurs par défaut.
Paramètres facultatifs
Aucun.Exemples
- Avec Jacl :
set cluster [$AdminConfig getid /ServerCluster:myCluster] $AdminConfig unsetAttributes $cluster {"enableHA", "preferLocal"}
- Avec Jython :
cluster = AdminConfig.getid("/ServerCluster:myCluster") AdminConfig.unsetAttributes(cluster, ["enableHA", "preferLocal"])
validate
La commande validate demande les résultats de la validation de la configuration d'après les fichiers de l'espace de travail, la valeur de l'indicateur d'activation de la validation interdocuments et le niveau de validation fixé. Vous pouvez éventuellement spécifier un ID configuration pour définir la portée. Dans ce cas, la portée de cette demande est définie par l'objet désigné par le paramètre d'ID configuration.
Objet cible
Aucun.Paramètres requis
Aucun.Paramètres facultatifs
- ID_configuration
- Indique l'ID configuration de l'objet en question.
Exemple de sortie
WASX7193I: Validation results are logged in c:\WebSphere5\AppServer\logs\wsadmin.valout: Total number of messages: 16
WASX7194I: Number of messages of severity 1: 16
Exemples
- Avec Jacl :
$AdminConfig validate
- Avec Jython :
print AdminConfig.validate()