Les langages de script Jacl ou Jython permettent de gérer les domaines de service de catalogue présents dans votre configuration WebSphere Application Server.
wsadmin>$AdminTask help XSDomainManagement
Argument | Description |
---|---|
-name (requis) | Spécifie le nom du domaine de service de catalogue à créer. |
-default | Spécifie si le domaine de service de catalogue est le domaine par défaut de la cellule. La valeur par défaut est true. (booléen : a soit la valeur true, soit la valeur false). |
-properties | Spécifie les propriétés personnalisées du domaine de service de catalogue. |
Argument | Description |
---|---|
name_of_endpoint | Spécifie le nom du point de contact du service de catalogue.
|
custom_properties | Spécifie les propriétés personnalisées du point de contact du domaine de service de catalogue. Si vous ne disposez pas de propriétés personnalisées, utilisez des guillemets doubles ("") pour cet argument. |
endpoint_ports | Spécifie les numéros de port du point de contact du domaine de service de catalogue. Les ports doivent être définis dans l'ordre suivant : <client_port>,<listener_port>
|
Argument | Description |
---|---|
-securityEnabled | Spécifie que la sécurité du client est activée pour le serveur de catalogue. Le fichier des propriétés du serveur qui est associé au serveur de catalogue sélectionné doit avoir un paramètre securityEnabled correspondant dans le fichier des propriétés du serveur. Si ces paramètres ne correspondent pas, une exception est générée. (booléen : a soit la valeur true, soit la valeur false). |
-credentialAuthentication (facultatif) | Indique si l'authentification des données d'identification est imposée ou prise en charge.
|
-authenticationRetryCount (facultatif) | Spécifie le nombre de tentatives d'authentification si les données
d'identification sont arrivées à expiration. Si vous ne voulez pas réessayer l'authentification, définissez la valeur à 0. La valeur par défaut est 0. |
-credentialGeneratorClass | Indique la classe d'implémentation de com.ibm.websphere.objectgrid.security.plugins.builtins. WSTokenCredentialGenerator pour que le client récupère les jetons de sécurité de l'unité d'exécution. |
-credentialGeneratorProps | Spécifie les propriétés de la classe d'implémentation CredentialGenerator. Les propriétés sont envoyées à l'objet avec la méthode setProperties(String). La valeur des propriétés du générateur de données d'identification est utilisée seulement si une valeur est spécifiée pour la zone Classe du générateur de données d'identification. |
Valeur retournée :
Exemples de mode de traitement par lots
Le mode de traitement par lots impose de formater correctement l'entrée de commande. Utilisez le mode interactif pour que les valeurs que vous entrez soient correctement traitées. Lorsque vous utilisez le mode de traitement par lots, vous devez définir les arguments d'étape -defineDomainServers en utilisant un tableau de propriétés spécifiques. Ce tableau a le format name_of_endpoint custom_properties endpoint_ports. La valeur endpoint_ports est la liste des ports qui doivent être définis dans l'ordre suivant : <client_port>,<listener_port>.
$AdminTask createXSDomain {-name TestDomain -default true -defineDomainServers
{{xhost1.ibm.com "" ,2809}} -configureClientSecurity {-securityEnabled false
-credentialAuthentication Required -authenticationRetryCount 0 -credentialGeneratorClass
com.ibm.websphere.objectgrid.security.plugins.builtins.UserPasswordCredentialGenerator
-credentialGeneratorProps "manager manager1"}}}
AdminTask.createXSDomain('[-name TestDomain -default true
-defineDomainServers [[xhost1.ibm.com "" ,2809]
[xhost2.ibm.com "" ,2809]] -configureClientSecurity [-securityEnabled false
-credentialAuthentication Required -authenticationRetryCount 0 -credentialGeneratorClass
com.ibm.websphere.objectgrid.security.plugins.builtins.UserPasswordCredentialGenerator
-credentialGeneratorProps "manager manager1"] ]')
$AdminTask createXSDomain {-name TestDomain -default true -defineDomainServers
{{cellName/nodeName/serverName "" 1109}}}
$AdminTask createXSDomain {-interactive}
AdminTask.createXSDomain ('[-interactive]')
La commande deleteXSDomain supprime un domaine de service de catalogue.
Valeur retournée :
$AdminTask deleteXSDomain {-name TestDomain }
AdminTask.deleteXSDomain('[-name TestDomain ]')
$AdminTask deleteXSDomain {-interactive}
AdminTask.deleteXSDomain ('[-interactive]')
La commande getDefaultXSDomain renvoie le domaine de service de catalogue par défaut de la cellule.
Paramètres requis : aucun.
Valeur de retour : nom du domaine de service de catalogue.
$AdminTask getDefaultXSDomain
AdminTask.getDefaultXSDomain
$AdminTask getDefaultXSDomain {-interactive}
AdminTask.getDefaultXSDomain ('[-interactive]')
La commande listXSDomains retourne la liste des domaines de services de catalogue existants.
Paramètres requis : aucun.
Valeur de retour : liste de tous les domaines de services de catalogue dans la cellule.
$AdminTask listXSDomains
AdminTask.listXSDomains
$AdminTask listXSDomains {-interactive}
AdminTask.listXSDomains ('[-interactive]')
La commande modifyXSDomain modifie un domaine de service de catalogue existant.
Le mode de traitement par lots impose de formater correctement l'entrée de commande. Utilisez le mode interactif pour que les valeurs que vous entrez soient correctement traitées. Lorsque vous utilisez le mode de traitement par lots, vous devez définir les arguments d'étape -modifyEndpoints, -addEndpoints et -removeEndpoints en utilisant un tableau de propriétés spécifiques. Ce tableau a le format name_of_endpoint host_name custom_properties endpoint_ports. La valeur endpoint_ports est la liste des ports qui doivent être définis dans l'ordre suivant : <client_port>,<listener_port>.
Argument | Description |
---|---|
-name (requis) | Spécifie le nom du domaine de service de catalogue que vous souhaitez éditer. |
-default | Avec la valeur true, spécifie que le domaine de service de catalogue est le domaine par défaut de la cellule (booléen). |
-properties | Spécifie les propriétés personnalisées du domaine de service de catalogue. |
Argument | Description |
---|---|
name_of_endpoint | Spécifie le nom du point de contact du service de catalogue.
|
endpoint_ports | Spécifie les numéros de port du point de contact du domaine de service de catalogue. Les noeuds finals doivent être définis dans l'ordre suivant : <client_port>,<listener_port>
|
Argument | Description |
---|---|
name_of_endpoint | Spécifie le nom du point de contact du service de catalogue.
|
custom_properties | Spécifie les propriétés personnalisées du point de contact du domaine de service de catalogue. Si vous ne disposez pas de propriétés personnalisées, utilisez des guillemets doubles ("") pour cet argument. |
endpoint_ports | Spécifie les numéros de port du point de contact du domaine de service de catalogue. Les noeuds finals doivent être définis dans l'ordre suivant : <client_port>,<listener_port>
|
Argument | Description |
---|---|
name_of_endpoint | Spécifie le nom du point de contact de domaine de service de catalogue à supprimer. |
Argument | Description |
---|---|
-securityEnabled | Spécifie que la sécurité du client est activée pour le serveur de catalogue. Le fichier des propriétés du serveur qui est associé au serveur de catalogue sélectionné doit avoir un paramètre securityEnabled correspondant dans le fichier des propriétés du serveur. Si ces paramètres ne correspondent pas, une exception est générée. (booléen : a soit la valeur true, soit la valeur false). |
-credentialAuthentication (facultatif) | Indique si l'authentification des données d'identification est imposée ou prise en charge.
|
-authenticationRetryCount (facultatif) | Spécifie le nombre de tentatives d'authentification si les données
d'identification sont arrivées à expiration. Si vous ne voulez pas réessayer l'authentification, définissez la valeur à 0. La valeur par défaut est 0. |
-credentialGeneratorClass | Indique la classe d'implémentation de com.ibm.websphere.objectgrid.security.plugins.builtins. WSTokenCredentialGenerator pour que le client récupère les jetons de sécurité de l'unité d'exécution. |
-credentialGeneratorProps | Spécifie les propriétés de la classe d'implémentation CredentialGenerator. Les propriétés sont envoyées à l'objet avec la méthode setProperties(String). La valeur des propriétés du générateur de données d'identification est utilisée seulement si une valeur est spécifiée pour la zone Classe du générateur de données d'identification. |
Valeur retournée :
$AdminTask modifyXSDomain {-name TestDomain -default true -modifyEndpoints
{{xhost1.ibm.com "" ,2809}} -addEndpoints {{xhost2.ibm.com "" ,2809}}}
-removeEndpoints {{xhost3.ibm.com}}}
AdminTask.modifyXSDomain('[-name TestDomain
-default false -modifyEndpoints [[xhost1.ibm.com "" ,2809]]
-addEndpoints [[xhost3.ibm.com "" ,2809]]
-removeEndpoints [[xhost2.ibm.com]]]')
$AdminTask modifyXSDomain {-name monDomaine -default false
-configureClientSecurity {-securityEnabled true -
Supported -authenticationRetryCount 1 -credentialGeneratorClass
com.ibm.websphere.objectgrid.security.plugins.builtins.UserPasswordCredentialGenerator
-credentialGeneratorProps "manager manager1"}}
$AdminTask modifyXSDomain {-interactive}
AdminTask.modifyXSDomain ('[-interactive]')
La commande testXSDomainConnection teste la connexion à un domaine de service de catalogue.
Valeur de retour : si la connexion peut être établie, retourne true. Dans le cas contraire, des informations d'erreur de connexion sont retournées.
$Admintask testXSDomainConnection
AdminTask.testXSDomainConnection
$AdminTask testXSDomainConnection {-interactive}
AdminTask.testXSDomainConnection ('[-interactive]')
La commande testXSServerConnection teste la connexion à un serveur de catalogue. Cette commande fonctionne pour les serveurs autonomes et les serveurs qui font partie d'un domaine de service de catalogue.
Valeur retournée :
$Admintask testXSServerConnection {-host xhost1.ibm.com -listenerPort 2809}
AdminTask.testXSServerConnection('[-host xshost3.ibm.com -listenerPort 2809]')
$AdminTask testXSServerConnection {-interactive}
AdminTask.testXSServerConnection ('[-interactive]')