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
- 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
- Examine los ejemplos documentados en la sección gestión de objetos de configuración específicos utilizando los archivos de propiedades.
- 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.
- 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.

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 |
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
NingunaValor 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')
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 <VIRTUALHOSTNAME>.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')