Vous pouvez utiliser des fichiers de propriétés pour créer ou modifier
les propriétés de la machine virtuelle Java™ (JVM).
Avant de commencer
Déterminez les changements à apporter à votre configuration JVM.
Démarrez l'outil de scriptage wsadmin. Pour démarrer wsadmin à l'aide du langage Jython, exécutez la commande wsadmin -lang jython du répertoire bin
du profil de serveur.
Pourquoi et quand exécuter cette tâche
Grâce à un fichier de propriétés, vous pouvez créer, modifier ou supprimer
les propriétés JVM.
Exécutez les
commandes administratives à l'aide de wsadmin pour créer ou changer un fichier de propriétés pour une JVM, valider les propriétés et les appliquer à
votre configuration.
Tableau 1. Actions associées aux propriétés JVM. Vous pouvez modifier ou supprimer des propriétés JVM.Action |
Procédure |
création |
Non applicable |
modify |
Modifiez les propriétés JVM et exécutez la commande applyConfigProperties. Le produit ignores les valeurs de propriété null
ou de liste vide {} et applique uniquement
les valeurs non nulles et non vides. |
suppression |
Modifiez le fichier de propriétés JVM pour qu'il contienne
uniquement les propriétés à supprimer, puis exécutez la commande deleteConfigProperties. Le fait de supprimer une propriété permet de paramétrer la valeur de propriété sur une valeur par défaut
le cas échéant.
Si aucune valeur par défaut n'existe pour la propriété, le produit
supprime la propriété.
|
create Property |
Non applicable |
delete Property |
Non applicable |
Vous pouvez éventuellement utiliser le mode interactif avec les commandes :
AdminTask.command_name('-interactive')
Procédure
- Modifier un fichier de propriétés existant.
- Obtenez un fichier de propriétés pour la JVM à changer.
Vous pouvez extraire
un fichier de propriétés pour un objet JavaVirtualMachine
à l'aide de la commande extractConfigProperties.
- Ouvrez le fichier de propriétés dans un éditeur et changez les
propriétés selon les besoins.
Vérifiez que les variables d'environnement
du fichier de propriétés correspondent à votre système.
Voici un exemple de fichier de propriétés JavaVirtualMachine :
#
# Header
#
ResourceType=JavaVirtualMachine
ImplementingResourceType=Server
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:JavaProcessDef=:JavaVirtualMachine=
AttributeInfo=jvmEntries
#
#
#Properties
#
internalClassAccessMode=ALLOW #ENUM(ALLOW|RESTRICT),default(ALLOW)
JavaHome="C:\cf50922.30\test/java" #readonly
debugArgs="-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=7777"
classpath={}
initialHeapSize=0 #integer,default(0)
runHProf=false #boolean,default(false)
genericJvmArguments=
hprofArguments=
osName=null
bootClasspath={}
verboseModeJNI=false #boolean,default(false)
maximumHeapSize=0 #integer,default(0)
disableJIT=false #boolean,default(false)
verboseModeGarbageCollection=false #boolean,default(false)
executableJarFileName=null
verboseModeClass=false #boolean,default(false)
debugMode=false #boolean,default(false)
#
# Header JVM System properties
#
ResourceType=JavaVirtualMachine
ImplementingResourceType=Server
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:JavaProcessDef=:JavaVirtualMachine=
AttributeInfo=systemProperties(name,value)
#
#
#Properties
#
com.ibm.security.krb5.Krb5Debug=off
com.ibm.security.jgss.debug=off
#
EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myCell04
nodeName=myNode
serverName=myServer
- Exécutez la commande applyConfigProperties pour créer ou changer une configuration JVM.
L'exécution de la commande applyConfigProperties
applique le fichier de propriétés à la configuration. Le produit ignores les valeurs de propriété null
ou de liste vide {} et applique uniquement
les valeurs non nulles et non vides.
Dans cet
exemple Jython, le paramètre facultatif -reportFileName
génère un rapport nommé report.txt:
AdminTask.applyConfigProperties(['-propertiesFileName MonTypeObjet.props -reportFileName report.txt '])
- Si vous n'avez plus besoin de la propriété JVM,
vous pouvez supprimer la propriété à condition qu'elle ne possède pas de valeur par défaut.
Pour supprimer une ou plusieurs propriétés, spécifiez uniquement les propriétés à supprimer
dans le fichier de propriétés et exécutez la commande deleteConfigProperties, par exemple :
AdminTask.deleteConfigProperties('[-propertiesFileName myObjectType.props -reportFileName report.txt]')
Si une propriété présente une valeur par défaut, la propriété
n'est pas supprimée, mais est paramétrée sur la valeur par défaut.
Résultats
Vous pouvez utiliser le fichier de propriétés pour configurer et gérer
les propriétés JVM.
Que faire ensuite
Sauvegardez les modifications de la configuration.