Utilice este tema para emplear un archivo de propiedades extraído para crear o
eliminar objetos de configuración que no sean tipos de objetos servidor, clúster, aplicación o
grupo de autorizaciones.
Acerca de esta tarea
Con el grupo de mandatos PropertiesBasedConfiguration para el objeto AdminTask,
puede utilizar archivos de propiedades para crear y eliminar objetos de configuración de sus entornos.
Avoid trouble: No puede aplicar directamente un
archivo de propiedades del sistema operativo
z/OS a un
sistema operativo distribuido.
De manera similar, no puede aplicar directamente un
archivo de propiedades de sistema operativo distribuido a un sistema operativo z/OS.
gotcha
Procedimiento
- Inicie la herramienta de scripts wsadmin.
- Extraiga un archivo de propiedades para el subtipo relevante para su configuración.
Utilice
el mandato extractConfigProperties para extraer el archivo de propiedades para el recurso que le interese. El ejemplo siguiente extrae las propiedades para el recurso ThreadPool:
AdminTask.extractConfigProperties('[-propertiesFileName
threadPool.props -configData
Server=server1 -filterMechanism SELECTED_SUBTYPES -selectedSubTypes [ThreadPool]]')
El mandato genera un archivo de plantilla parecido a la plantilla de ejemplo
siguiente:
# # SubSection 1.0.1.4 # Thread pools # ResourceType=ThreadPool
ImplementingResourceType=Server ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:Thr
eadPoolManager=ID#ThreadPoolManager_1:ThreadPool=ID#builtin_ThreadPool_4 # # #Properties #
maximumSize=20 #integer name=Default inactivityTimeout=5000 #integer minimumSize=5
#integer isGrowable=false #boolean
- Cree o suprima objetos de configuración.
Para crear una agrupación
de hebras nuevo o suprimir una existente, modifique el atributo ResourceId.
- Para crear una agrupación de hebras nueva, establezca el atributo ResourceId en un valor
que no exista en su configuración. En el ejemplo siguiente, fíjese que
ThreadPool=ID#builtin_ThreadPool_4 ResourceId se sustituye por
ThreadPool=ID#ThreadPool_99999 ResourceId, que no existe en la configuración:
# # SubSection 1.0.1.4 # Thread pools # ResourceType=ThreadPool
ImplementingResourceType=Server ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:Thr
eadPoolManager=ID#ThreadPoolManager_1:ThreadPool=ID#ThreadPool_99999 # # #Properties # maximumSize=20
#integer name=myThreadPool inactivityTimeout=5000 #integer minimumSize=5 #integer isGrowable=false #Boolean
Ejecute el mandato applyConfigProperties para aplicar el archivo de propiedades a su
configuración, según se muestra en el mandato siguiente:
AdminTask.applyConfigProperties('[-propertiesFileName threadPool.props]')
El mandato valida automáticamente el archivo de propiedades y, a continuación, utiliza
los valores modificados en el archivo para crear una agrupación de hebras nueva en su
configuración.
- Para suprimir la agrupación de hebras, especifique la propiedad DELETE=true
en la cabecera del archivo de propiedades, según se muestra en el ejemplo siguiente:
# # SubSection 1.0.1.4 # Thread pools # ResourceType=ThreadPool
ImplementingResourceType=Server ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:Thr
eadPoolManager=ID#ThreadPoolManager_1:ThreadPool=myThreadPool DELETE=true # # #Properties # maximumSize=20
#integer name=myThreadPool inactivityTimeout=5000 #integer minimumSize=5 #integer isGrowable=false #boolean
Ejecute el mandato deleteConfigProperties para utilizar el archivo de propiedades
para eliminar la agrupación de hebras de su configuración como muestra el mandato siguiente:
AdminTask.deleteConfigProperties('[-propertiesFileName threadPool.props]')
El mandato valida automáticamente el archivo de propiedades y, a continuación, utiliza el atributo y valor nuevos del archivo para suprimir la agrupación de hebras de su configuración.
Avoid trouble: Si ejecuta el mandato deleteConfigProperties antes de añadir el atributo
DELETE=true y el valor al archivo de propiedades, el mandato restablece las propiedades
a sus valores predeterminados. El sistema elimina completamente las propiedades que
no tengan valores predeterminados.
gotcha
- Guarde los cambios de configuración.
Utilice el siguiente ejemplo de mandatos para guardar
los cambios de configuración:
AdminConfig.save()