Grupo de mandatos PropertiesBasedConfiguration para el objeto AdminTask con scripts wsadmin

Puede utilizar el lenguaje de scripts Jython para personalizar una parte de la configuración del sistema utilizando los archivos de propiedades. Los repositorios de configuración de WebSphere almacenan muchos tipos diferentes de configuraciones. Puede utilizar archivos de propiedades para personalizar algunas de estas configuraciones. Puede personalizar algunas configuraciones creadas mediante WCCM (WebSphere Common Configuration Model) o configuraciones desplegadas como aplicaciones Java EE.

El WCCM (WebSphere Common Configuration Model) se configura mediante el mandato AdminConfig en los scripts. AdminConfig.types() listas los tipos en WCCM y AdminConfig.attributes("type") lista los atributos para un tipo específico. La personalización de estos tipos utilizando los archivos de propiedades suele ser más fácil que escribir un script para realizar algunos cambios. En un entorno de producción, las aplicaciones Java EE se suelen desplegar mediante el mandato AdminApp en scripts. Para un entorno de desarrollo, el uso de un archivo de propiedades ofrece un modo más fácil de comprender la sintaxis cuando se crean los parámetros necesarios para gestionar la aplicación. Tenga en cuenta que el despliegue de aplicaciones utiliza su propio conjunto de tipos WCCM

Los ejemplos de configuraciones que no puede configurar directamente mediante los archivos de propiedades son:
  • SIBus
  • Aplicaciones a nivel de negocio
  • Archivos de almacenes de claves y de confianza
  • Archivos de conjuntos de políticas de servicios web
  • Registro de usuarios basado en archivos
Estas configuraciones se gestionan mediante sus propios mandatos AdminTask . Tenga en cuenta que hay un escape en la configuración basada en archivos de propiedades para invocar los mandatos AdminTask. Pero esto es sólo una sintaxis alternativa para llamar a los mandatos. La configuración real no se proporciona en el archivo de propiedades.
Utilice los archivos de propiedades, de este modo:
  1. Examine los ejemplos documentados en la sección gestión de objetos de configuración específicos utilizando los archivos de propiedades.
  2. Copie y pegue los ejemplos aplicables en un archivo de texto, edite los ejemplos según sea necesario y aplique los ejemplos a su entorno con sustituciones de variables adecuadas. Hay muchos ejemplos que cubren una amplia gama de configuraciones utilizadas frecuentemente.
  3. Para un tipo WCCM soportado, puede extraer dicho tipo desde una célula existente como un punto de inicio, editar el archivo extraído y volver a aplicarlo a la célula existente.

    Par a los tipos WCCM soportados que no sean Cell, Node, Server o ServerCluster, extraiga el tipo específico de una célula existente con la opción -options [[PortablePropertiesFile true]] para crear un formato de archivo portable. A continuación, edite el archivo de propiedades y aplíquelo a una célula diferente con sustituciones de variables adecuadas. Puede utilizar este método para mover los subconjuntos de configuración utilizados habitualmente, tales como definiciones de recursos y valores de JVM (Java Virtual Machine) de un entorno a otro.

Avoid trouble Avoid trouble: Utilice los archivos de propiedades para personalizar y no duplicar o fusionar entornos. No extraiga todo un tipo Cell, Node, Server o ServerCluster para aplicarlo a un entorno diferente. Solamente se aplica un subconjunto de tipos WCCM y la información extraída no se fusiona con el entorno nuevo de un modo significativo. gotcha
Los siguientes tipos WCCM están soportados:
Tabla 1. Tipos WCCM soportados. Puede utilizar los archivos de propiedades para configurar los tipos WCCM que se listan en esta tabla.
AccessPointGroup ActivationSpec ActivationSpecTemplateProps ActivitySessionService
AdminObject AdminObjectTemplateProps AdminServerAuthentication AdminService
AllActivePolicy AllAuthenticatedUserExt AllAuthenticatedUsersInTrustedRealmsExt ApplicationProfileService
ApplicationServer Auditoría AuditEventFactory AuditNotificationMonitor
AuditPolicy AuditServiceProvider AuditSpecification AuthenticationMechanism
AuthenticationTarget AuthorizationConfig AuthorizationGroup AuthorizationGroupMember
AuthorizationProvider AuthorizationTableExt AuthorizationTableImpl BackupCluster
BridgeInterface CACertificate CAClient CMPConnectorFactory
CacheProvider Cell Certificado Chain
Classloader ClusterMember CommonSecureInterop CompensationService
ConfigSynchronizationService ConnectionDefTemplateProps ConnectionDefinition ConnectionPool
ConnectionTest Connector Cookie CoreGroup
CoreGroupAccessPoint CoreGroupBridgeService CoreGroupBridgeSettings CoreGroupServer
CryptoHardwareToken CustomAuthMechanism CustomService CustomUserRegistry
DCSInboundChannel DPClonableDeviceSettings DPClonableDeviceSettingsVersion DPDevice
DPDomain DPDomainVersion DPFirmware DPFirmwareVersion
DPManagedSet DPManager DRSConnectionPool DRSPartition
DRSSerialization DRSSettings DataPowerMgrInboundChannel DataReplication
DataReplicationDomain DataSource DebugService DiagnosticProviderService
DigestAuthentication DiskCacheCustomPerformanceSettings DiskCacheEvictionPolicy DistributionQueue
DynamicCache DJBCache EJBContainer EJBTimer
EndPoint EventGroupProfile EventGroupProfileList EventInfrastructureProvider
EventInfrastructureService EventServerProfile EveryoneExt ExtensionMBean
ExtensionMBeanProvider ExternalCacheGroup ExternalCacheGroupMember FileTransferService
Filtro GenericChannelFactory GenericInboundChannel GenericJMSConnectionFactory
GenericJMSDestination GenericOutboundChannel HAManagerService HTTPConnector
HTTPInboundChannel HTTPOutboundChannel HTTPTransport HTTPTunnelInboundChannel
HTTPTunnelOutboundChannel HostAlias I18NService IIOPSecurityProtocol
IIOPTransport IconType IdentityAssertionLayer IdentityAssertionQOP
IdentityAssertionTypeAssociation InvalidationSchedule J2CActivationSpec J2CAdminObject
J2CResourceAdapter J2EEResourcePropertySet JAASAuthData JAASConfiguration
JAASConfigurationEntry JAASLoginModule JDBCProvider JFAPFactory
JFAPInboundChannel JFAPOutboundChannel JMSProvider JMSTransport
JavaProcessDef JavaVirtualMachine KRB Clave
KeyManager KeyReference KeySet KeySetGroup
KeyStore KeyStoreFile LDAPSearchFilter LDAPUserRegistry
LTPA Biblioteca LibraryRef ListenerPort
LocalOSUserRegistry MOfNPolicy MQConnectionFactory MQFAPInboundChannel
MQFAPOutboundChannel MQQueue MQQueueConnectionFactory MQTopic
MQTopicConnectionFactory MailProvider MailSession ManagementScope
MappingModule MemoryCacheEvictionPolicy MessageLayer MessageListener
MessageListenerService MessageQOP MimeEntry MonitoringPolicy
NameServer NoOpPolicy Node NodeGroup
ORBInboundChannel ObjectCacheInstance ObjectPool ObjectPoolManagerInfo
ObjectPoolProvider ObjectPoolService ObjectRequestBroker OneOfNPolicy
OutboundResourceAdapter OutputRedirect PME51ServerExtension PMEServerExtension
PMIModule PMIService PMRClusterExtension PeerAccessPoint
PeerCoreGroup PluginConfigService PluginProperties PluginServerClusterProperties
PortletContainer PreferredServerPolicy PrimaryAdminExt ProcessExecution
ProtocolProvider ProxyInboundChannel RASLoggingService RMIConnector
RMQChannelFactory RMQOutboundChannel RSAToken Referenceable
RepositoryService ResourceAdapter ResourceEnvironmentProvider RoleAssignmentExt
SecurityRoleExt ServerEntry ServerExt ServerIndex
SIPContainer SIPContainerInboundChannel SIPInboundChannel SIPOutboundChannel
SIPProxyInboundChannel SOAPConnector SPNEGO SSLConfig
SSLConfigGroup SSLInboundChannel SSLOutboundChannel SWAMAuthentication
SchedulerConfiguration SchedulerProvider SchedulerService SecureAssociationService
SecureSocketLayer Seguridad SecurityDomain SecurityPermission
SecurityProtocolQOP Server ServerCluster ServerIdentity
ServiceLog ServletCacheInstance SessionBeanConfig SessionDatabasePersistence
SessionManager SingleSignon StartupBeansService StateManageable
StatefulSessionBeanConfig StaticPolicy StatisticsProvider StreamRedirect
StringNameSpaceBinding SystemMessageServer TAInterceptor TCPFactory
TCPInboundChannel TCPOutboundChannel TPVService TaskProvider
ThreadPool TimerManagerInfo TimerManagerProvider TraceLog
TraceService TransactionService TransportChannelFactory TransportChannelService
TransportLayer TransportQOP TrustAssociation TrustManager
TrustedAuthenticationRealm TuningParams TunnelAccessPointGroup TunnelPeerAccessPoint
TunnelTemplate UDPInboundChannel UDPOutboundChannel URL
URLProvider UserExt VariableMap VirtualHost
WAS40ConnectionPool WAS40DataSource WASQueue WASQueueConnectionFactory
WASTopic WASTopicConnectionFactory WIMUserRegistry WLMCoreGroupBridgePlugin
WSNotification WSSchedule WebContainer WebContainerInboundChannel
WebModuleConfig WebModuleDeployment WebServer WebserverPluginSettings
WeightAdvisor WorkAreaPartition WorkAreaPartitionService WorkAreaService
WorkManagerInfo WorkManagerProvider WorkManagerService  
Utilice los mandatos siguientes para gestionar la configuración del sistema:

applyConfigProperties

El mandato applyConfigProperties aplica propiedades de un archivo de propiedades específico a la configuración. El sistema añade atributos o datos de configuración a la configuración, si no existe una propiedad específica. Si las propiedades existen en la configuración, el sistema establece los valores nuevos para los atributos.

Objeto de destino

Ninguno.

Parámetros necesarios

-propertiesFileName
Especifica el nombre del archivo de propiedades que se va a aplicar. (String, obligatorio)

Parámetros opcionales

-variablesMapFileName
Especifica el nombre del archivo de correlación de variables. Este archivo contiene valores para variables que utiliza el sistema del archivo de propiedades. (String, opcional)
-variablesMap
Especifica los valores de las variables que se van a utilizar con el archivo de propiedades. (Properties, opcional)
-reportFileName
Especifica el nombre de un archivo de informe que contiene la salida para el mandato applyConfigProperties. (String, opcional)
-reportFilterMechanism
Especifica el tipo de mecanismo de filtro de informes. Especifique All para visualizar toda la información del informe. Especifique Errors para visualizar sólo la información de error. Especifique Errors_And_Changes para visualizar la información de errores y cambios. (String, opcional)
-validate
Especifica si validar el archivo de propiedades antes de aplicar los cambios. De manera predeterminada, el mandato valida el archivo de propiedades. Especifique false para inhabilitar la validación. (Boolean, opcional)
-zipFileName
Especifica el nombre del archivo comprimido que contiene los conjuntos de políticas que desea aplicar a la célula. (String, opcional)

Valor de retorno

El mandato no devuelve ninguna salida.

Uso del ejemplo de modalidad por lotes

  • Utilizando la serie Jython:
    AdminTask.applyConfigProperties('-propertiesFileName myPropFile.props -zipFileName myZipFile.zip -validate true')
  • Utilizando la lista Jython:
    AdminTask.applyConfigProperties(['-propertiesFileName', 'myPropFile.props', '-zipFileName',
    'myZipFile.zip', '-validate', 'true'])

Ejemplo de utilización de la modalidad interactiva

  • Utilizando Jython:
    AdminTask.applyConfigProperties('-interactive')

createPropertiesFileTemplates

El mandato createPropertiesFileTemplates crea archivos de propiedades de plantilla a utilizar para crear o suprimir tipos de objeto específicos. El mandato almacena el archivo de propiedades de plantilla en el archivo de propiedades especificado por el parámetro propertiesFileName.

Objeto de destino

Ninguno.

Parámetros necesarios

-propertiesFileName
Especifica el nombre del archivo de propiedades en el que se almacena la plantilla. (String, obligatorio)
-configType
Especifica el tipo de recurso para la plantilla a crear. (String, obligatorio)
  • Especifique Server para crear una plantilla de archivo de propiedades de tipo de servidor.
  • Especifique ServerCluster para crear una plantilla de archivo de propiedades de tipo de clúster de servidores.
  • Especifique Application para crear una plantilla de archivo de propiedades de tipo de aplicación.
  • Especifique AuthorizationGroup para crear una plantilla de archivo de propiedades de tipo grupo de autorización.

Parámetros opcionales

Ninguna

Valor de retorno

El mandato no devuelve ninguna salida.

Ejemplo de utilización de la modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.createPropertiesFileTemplates('-propertiesFileName serverTemplate.props -configType Servidor')
  • Utilizando la lista Jython:
    AdminTask.createPropertiesFileTemplates(['-propertiesFileName', 'serverTemplate.props', 
    '-configType', 'Server'])

Ejemplo de utilización de la modalidad interactiva

  • Utilizando Jython:
    AdminTask.createPropertiesFileTemplates('-interactive')

deleteConfigProperties

El mandato deleteConfigProperties suprime las propiedades de la configuración tal como se designa en un archivo de propiedades. El sistema elimina los atributos o los datos de configuración que corresponden a cada propiedad del archivo de propiedades.

Objeto de destino

Ninguno.

Parámetros necesarios

-propertiesFileName
Especifica el nombre del archivo de propiedades que se va a suprimir. (String, obligatorio)

Parámetros opcionales

-variablesMapFileName
Especifica el nombre del archivo de correlación de variables. Este archivo contiene valores para variables que utiliza el sistema del archivo de propiedades. (String, opcional)
-variablesMap
Especifica los valores de las variables que se van a utilizar con el archivo de propiedades. (Properties, opcional)
-reportFileName
Especifica el nombre de un archivo de informe que contiene la salida para el mandato. (String, opcional)
-reportFilterMechanism
Especifica el tipo de mecanismo de filtro de informes. Especifique All para visualizar toda la información del informe. Especifique Errors para visualizar sólo la información de error. Especifique Errors_And_Changes para visualizar la información de errores y cambios. (String, opcional)
-validate
Especifica si validar el archivo de propiedades antes de aplicar los cambios. De manera predeterminada, el mandato valida el archivo de propiedades. Especifique false para inhabilitar la validación. (Boolean, opcional)

Valor de retorno

El mandato no devuelve ninguna salida.

Uso del ejemplo de modalidad por lotes

  • Utilizando la serie Jython:
    AdminTask.deleteConfigProperties('-propertiesFileName miArchivoProp.props')
  • Utilizando la lista Jython:
    AdminTask.deleteConfigProperties(['-propertiesFileName', 'miArchivoProp.props'])

Ejemplo de utilización de la modalidad interactiva

  • Utilizando Jython:
    AdminTask.deleteConfigProperties('-interactive')

extractConfigProperties

El mandato extractConfigProperties extrae los datos de configuración con el formato de un archivo de propiedades. El sistema exporta los datos y atributos de configuración que se utilizan más habitualmente, convierte los atributos en propiedades y guarda los datos en un archivo. Puede especificar el recurso de interés con el objeto de destino o el parámetro configData. Utilice el parámetro configData para especificar una instancia de servidor, nodo, clúster, conjunto de políticas o aplicación. Si no se especifica ningún objeto de configuración, el mandato extrae la configuración del perfil.

Objeto de destino

Especifique el nombre de objeto del objeto de configuración de interés, en el formato siguiente: Node=nombreNodo:Server=nombreServidor

Parámetros necesarios

-propertiesFileName
Especifica el nombre del archivo de propiedades que se va a extraer. (String, obligatorio)

Parámetros opcionales

-configData
Especifica la instancia del objeto de configuración con el formato Nodo=nodo1. (String, opcional)
-options
Especifica las opciones de configuración adicionales, como GENERATETEMPLATE=true. (Properties, opcional)
-filterMechanism
Especifica la información de filtro para la extracción de las propiedades de configuración. (String, opcional)
  • Especifique All para extraer todas las propiedades de configuración.
  • Especifique NO_SUBTYPES para extraer las propiedades del objeto dado sin incluir los subtipos.
  • Especifique SELECTED_SUBTYPES para extraer los subtipos de objeto de configuración concretos especificados con el parámetro selectedSubTypes. Esto puede incluir cualquier subtipo para un objeto de configuración o cualquier tipo WCCM que exista dentro de la jerarquía de tipo de objeto.
-selectedSubTypes
Especifica las propiedades de configuración a incluir o excluir cuando el mandato extrae las propiedades. Especifique este parámetro si establece el parámetro filterMechanism en NO_SUBTYPES o SELECTED_SUBTYPES. Las series siguientes son ejemplos de subtipos: ApplicationServer, EJBContainer. (String, opcional)
Tabla 2. Subtipos y extensiones de extractConfigProperties -selectedSubTypes. Puede configurar las propiedades de los tipos y subtipos de objeto.
Tipo de objeto de configuración Subtipos Extensiones
AdminService Ninguna Ninguna
Despliegue ApplicationName Ninguna
ApplicationServer TransactionService, DynamicCache, WebContainer, EJBContainer, PortletContainer, SIPContainer, WebserverPluginSettings Ninguna
AuthorizationGroup Ninguna Ninguna
AuthorizationTableExt Ninguna Ninguna
Cell VirtualHost, DataReplicationDomain, ServerCluster, CoreGroup, NodeGroup, AuthorizationGroup, AuthorizationTableExt, Security, J2CResourceAdapter, JDBCProvider, JMSProvider, MailProvider, URLProvider, EventInfrastructureProvider, ObjectPoolProvider, WorkManagerProvider, TimerManagerProvider, SchedulerProvider, Node, VariableMap Ninguna
CoreGroup Ninguna Ninguna
CoreGroupBridgeService Ninguna Ninguna
DynamicCache Ninguna Ninguna
EJBContainer Ninguna Ninguna
EventInfrastructureProvider Ninguna Ninguna
EventInfrastructureService Ninguna Ninguna
HAManagerService Ninguna Ninguna
J2CResourceAdapter Ninguna Ninguna
JDBCProvider Ninguna Ninguna
JMSProvider Ninguna Ninguna
JavaVirtualMachine Ninguna Ninguna
Biblioteca Ninguna Ninguna
MailProvider Ninguna Ninguna
NameServer Ninguna Ninguna
Node Server, J2CResourceAdapter, JDBCProvider, JMSProvider, MailProvider, URLProvider, EventInfrastructureProvider, ObjectPoolProvider, WorkManagerProvider, TimerManagerProvider, SchedulerProvider, VariableMap La extensión NodeMetadata extrae las propiedades de metadatos de nodo.
NodeGroup Ninguna Ninguna
ObjectPoolProvider Ninguna Ninguna
ObjectRequestBroker Ninguna Ninguna
PMEServerExtension Ninguna Ninguna
PMIModule Ninguna Ninguna
PMIService Ninguna Ninguna
PortletContainer Ninguna Ninguna
SIPContainer Ninguna Ninguna
SchedulerProvider Ninguna Ninguna
Seguridad JAASAuthData Ninguna
Server PMIService, AdminService, CoreGroupBridgeService, TPVService, ObjectRequestBroker, ApplicationServer, NameServer, J2CResourceAdapter, JDBCProvider, JMSProvider, MailProvider, URLProvider, EventInfrastructureProvider, ObjectPoolProvider, WorkManagerProvider, TimerManagerProvider, SchedulerProvider, VariableMap, EventInfrastructureService, PMEServerExtension, Library, HAManagerService, PMIModule, Security La extensión lista las aplicaciones desplegadas para un servidor concreto.
ServerCluster J2CResourceAdapter, JDBCProvider, JMSProvider, MailProvider, URLProvider, ObjectPoolProvider, WorkManagerProvider, TimerManagerProvider, SchedulerProvider, VariableMap La extensión lista las aplicaciones desplegadas para un clúster concreto.
TPVService Ninguna Ninguna
TimerManagerProvider Ninguna Ninguna
TransactionService Ninguna Ninguna
URLProvider Ninguna Ninguna
VariableMap Ninguna Ninguna
VirtualHost Ninguna Ninguna
WebContainer Ninguna Ninguna
WebserverPluginSettings Ninguna Ninguna
WorkManagerProvider Ninguna Ninguna
-zipFileName
Especifica el nombre del archivo comprimido del que desea extraer conjuntos de políticas. (String, opcional)

Valor de retorno

El mandato devuelve el nombre del archivo de propiedades que crea el sistema.

Ejemplo de utilización de la modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.extractConfigProperties('-configData Node=myNode -propertiesFileName myNodeProperties.props -zipFileName myZipFile.zip')
  • Utilizando la lista Jython:
    AdminTask.extractConfigProperties(['-configData', 'Node=myNode', '-propertiesFileName', 'myNodeProperties.props', '-zipFileName', 'myZipFile.zip'])

Ejemplo de utilización de la modalidad interactiva

  • Utilizando la serie Jython:
    AdminTask.extractConfigProperties('-interactive')
Nota: Debido a la forma en que funciona el filtrado, cuando se extraen muchos objetos que no están relacionados jerárquicamente a partir de una célula de gran tamaño o ámbito de nodo utilizando SELECTED_SUBTYPE, el sistema explora partes de la célula o nodo que pueden no contener una instancia del tipo de objeto de destino. Puede lograr un mejor rendimiento extrayendo de forma repetida cada elemento y, a continuación, estableciéndolo como destino de forma explícita. Por ejemplo, si el objetivo es extraer todos los hosts virtuales en una célula (en comparación con establecer destino a toda la célula para extraer y filtrar en el subtipo del sistema principal virtual), el rendimiento mejora mediante consultas para todos los hosts virtuales como una operación y, a continuación, estableciendo como objetivo cada host virtual en un bucle, tal como se muestra en el ejemplo siguiente :
for vhost in AdminConfig.list( 'VirtualHost' ).splitlines() : 
   name = AdminConfig.showAttribute( vhost, 'name' ) 
   parms = '[-propertiesFileName ' + name + '.properties -configData VirtualHost=' + name + ' 
   -options [[PortablePropertiesFile true]] ]'
   AdminTask.extractConfigProperties(parms)
Este ejemplo genera un archivo &ltVIRTUALHOSTNAME>.properties virtualHost para host virtual en la célula.

validateConfigProperties

El mandato validateConfigProperties verifica que las propiedades del archivo de propiedades son válidas y que se pueden aplicar correctamente a la nueva configuración.

Objeto de destino

Ninguno.

Parámetros necesarios

-propertiesFileName
Especifica el nombre del archivo de propiedades que se va a validar. (String, obligatorio)

Parámetros opcionales

-variablesMapFileName
Especifica el nombre del archivo de correlación de variables. Este archivo contiene valores para variables que utiliza el sistema del archivo de propiedades. (String, opcional)
-variablesMap
Especifica los valores de las variables que se van a utilizar con el archivo de propiedades. (Properties, opcional)
-reportFileName
Especifica el nombre de un archivo de informe que contiene la salida para el mandato applyConfigProperties. (String, opcional)
-reportFilterMechanism
Especifica el tipo de mecanismo de filtro de informes. Especifique All para visualizar toda la información del informe. Especifique Errors para visualizar sólo la información de error. Especifique Errors_And_Changes para visualizar la información de errores y cambios. (String, opcional)
-zipFileName
Especifica el nombre del archivo comprimido que contiene los conjuntos de políticas que desea aplicar a la célula. (String, opcional)

Valor de retorno

El mandato devuelve un valor de true si el sistema valida el archivo de propiedades o el archivo .zip del conjunto de políticas.

Ejemplo de utilización de la modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.validateConfigProperties('-propertiesFileName myNodeProperties.props -zipFileName myZipFile.zip -reportFileName report.txt')
  • Utilizando la lista Jython:
    AdminTask.validateConfigProperties(['-propertiesFileName', 'myNodeProperties.props', '-zipFileName', 
    'myZipFile.zip', '-reportFileName', 'report.txt'])

Ejemplo de utilización de la modalidad interactiva

  • Utilizando Jython:
    AdminTask.validateConfigProperties('-interactive')

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_7propbasedconfig
File name: rxml_7propbasedconfig.html