PropertiesBasedConfiguration command group for the AdminTask object using wsadmin scripting

You can use the Jython scripting language to manage your system configuration using properties files. Use the commands in the PropertiesBasedConfiguration group to copy configuration properties from one environment to another, troubleshoot configuration issues, and to apply one set of configuration properties across multiple profiles, nodes, cells, servers, or applications.

applyConfigProperties

The applyConfigProperties command applies properties in a specific properties file to the configuration. The system adds attributes or configuration data to the configuration if a specific properties do not exist. If the properties exist in the configuration, the system sets the new values for the attributes.

Target object

None.

Required parameters

-propertiesFileName
Specifies the name of the properties file to apply. (String, required)

Optional parameters

-variablesMapFileName
Specifies the name of the variables map file. This file contains values for variables that the system uses from the properties file. (String, optional)
-variablesMap
Specifies the values of the variables to use with the properties file. (Properties, optional)
-reportFileName
Specifies the name of a report file that contains the output for the applyConfigProperties command. (String, optional)
-reportFilterMechanism
Specifies the type of report filter mechanism. Specify All to display all report information. Specify Errors to display error information. Specify Errors_And_Changes to display error and change information. (String, optional)
-validate
Specifies whether to validate the properties file before applying the changes. By default, the command validates the properties file. Specify false to disable validation. (Boolean, optional)
-zipFileName
Specifies the name of the .zip file that contains the policy sets that you want applied to the cell. (String, optional)

Return value

The command does not return output.

Batch mode example usage

Interactive mode example usage

createPropertiesFileTemplates

The createPropertiesFileTemplates command creates template properties files to use to create or delete specific object types. The command stores the template properties file in the properties file specified by the propertiesFileName parameter.

Target object

None.

Required parameters

-propertiesFileName
Specifies the name of the properties file where the template is stored. (String, required)
-configType
Specifies the resource type for the template to create. (String, required)
  • Specify Server to create a server type properties file template.
  • Specify ServerCluster to create a server cluster type properties file template.
  • Specify Application to create an application type properties file template.
  • Specify AuthorizationGroup to create an authorization group type properties file template.

Optional parameters

None

Return value

The command does not return output.

Batch mode example usage

Interactive mode example usage

deleteConfigProperties

The deleteConfigProperties command deletes properties in your configuration as designated in a properties file. The system removes the attributes or configuration data that corresponds to each property in the properties file.

Target object

None.

Required parameters

-propertiesFileName
Specifies the name of the properties file to delete. (String, required)

Optional parameters

-variablesMapFileName
Specifies the name of the variables map file. This file contains values for variables that the system uses from the properties file. (String, optional)
-variablesMap
Specifies the values of the variables to use with the properties file. (Properties, optional)
-reportFileName
Specifies the name of a report file that contains the output for the the command. (String, optional)
-reportFilterMechanism
Specifies the type of report filter mechanism. Specify All to display all report information. Specify Errors to display error information. Specify Errors_And_Changes to display error and change information. (String, optional)
-validate
Specifies whether to validate the properties file before applying the changes. By default, the command validates the properties file. Specify false to disable validation. (Boolean, optional)

Return value

The command does not return output.

Batch mode example usage

Interactive mode example usage

extractConfigProperties

The extractConfigProperties command extracts configuration data in the form of a properties file. The system exports the most commonly used configuration data and attributes, converts the attributes to properties, and saves the data to a file. You can specify the resource of interest with the target object or the configData parameter. Use the configData parameter to specify a server, node, cluster, policy set, or application instance. If no configuration object is specified, the command extracts the profile configuration data.

Target object

Specify the object name of the configuration object of interest in the format: Node=nodeName:Server=serverName

Required parameters

-propertiesFileName
Specifies the name of the properties file to extract. (String, required)

Optional parameters

-configData
Specifies the configuration object instance in the format Node=node1. (String, optional)
-options
Specifies additional configuration options, such as GENERATETEMPLATE=true. (Properties, optional)
-filterMechanism
Specifies filter information for extracting configuration properties. (String, optional)
  • Specify All to extract all configuration properties.
  • Specify NO_SUBTYPES to extract the properties of the given object without including the subtypes.
  • Specify SELECTED_SUBTYPES_AND_EXTENSIONS to extract only properties of the given object type without including the subtypes. This option also prevents the command from extracting properties using extensions, if extensions exist for the object type.
  • Specify SELECTED_SUBTYPES to extract specific configuration object subtypes specified with the selectedSubTypes parameter. This can include any subtype for a configuration object or any WCCM type that exists under the object type hierarchy.
-selectedSubTypes
Specifies the configuration properties to include or exclude when the command extracts the properties. Specify this parameter if you set the filterMechanism parameter to NO_SUBTYPES or SELECTED_SUBTYPES. The following strings are examples of subtypes: ApplicationServer, EJBContainer. (String, optional)
Table 1. extractConfigProperties -selectedSubTypes subtypes and extensions. You can configure properties of the object types and subtypes.
Configuration object type Subtypes Extensions
AdminService None None
Application JDBCProvider,VariableMap None
ApplicationServer TransactionService, DynamicCache, WebContainer, EJBContainer, PortletContainer, SIPContainer, WebserverPluginSettings None
AuthorizationGroup None None
AuthorizationTableExt None None
Cell VirtualHost, DataReplicationDomain, ServerCluster, CoreGroup, NodeGroup, AuthorizationGroup, AuthorizationTableExt, Security, J2CResourceAdapter, JDBCProvider, JMSProvider, MailProvider, URLProvider, EventInfrastructureProvider, ObjectPoolProvider, WorkManagerProvider, TimerManagerProvider, SchedulerProvider, Node, VariableMap None
CoreGroup None None
CoreGroupBridgeService None None
DynamicCache None None
EJBContainer None None
EventInfrastructureProvider None None
EventInfrastructureService None None
HAManagerService None None
J2CResourceAdapter None None
JDBCProvider None None
JMSProvider None None
JavaVirtualMachine None None
Library None None
MailProvider None None
NameServer None None
Node Server, J2CResourceAdapter, JDBCProvider, JMSProvider, MailProvider, URLProvider, EventInfrastructureProvider, ObjectPoolProvider, WorkManagerProvider, TimerManagerProvider, SchedulerProvider, VariableMap The NodeMetadata Extension extracts node Metadata properties.
NodeGroup None None
ObjectPoolProvider None None
ObjectRequestBroker None None
PMEServerExtension None None
PMIModule None None
PMIService None None
PortletContainer None None
SIPContainer None None
SchedulerProvider None None
Security None None
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 The extension lists deployed applications for a specific server.
ServerCluster J2CResourceAdapter, JDBCProvider, JMSProvider, MailProvider, URLProvider, ObjectPoolProvider, WorkManagerProvider, TimerManagerProvider, SchedulerProvider, VariableMap The extension lists deployed applications for a specific cluster.
TPVService None None
TimerManagerProvider None None
TransactionService None None
URLProvider None None
VariableMap None None
VirtualHost None None
WebContainer None None
WebserverPluginSettings None None
WorkManagerProvider None None
-zipFileName
Specifies the name of the .zip file into which you want to extract policy sets. (String, optional)

Return value

The command returns the name of the properties file that the system creates.

Batch mode example usage

Interactive mode example usage

validateConfigProperties

The validateConfigProperties command verifies that the properties in the properties file are valid and can be successfully applied to the new configuration.

Target object

None.

Required parameters

-propertiesFileName
Specifies the name of the properties file to validate. (String, required)

Optional parameters

-variablesMapFileName
Specifies the name of the variables map file. This file contains values for variables that the system uses from the properties file. (String, optional)
-variablesMap
Specifies the values of the variables to use with the properties file. (Properties, optional)
-reportFileName
Specifies the name of a report file that contains the output for the applyConfigProperties command. (String, optional)
-reportFilterMechanism
Specifies the type of report filter mechanism. Specify All to display all report information. Specify Errors to display error information. Specify Errors_And_Changes to display error and change information. (String, optional)
-zipFileName
Specifies the name of the .zip file that contains the policy sets that you want applied to the cell. (String, optional)

Return value

The command returns a value of true if the system validates the properties file or policy set .zip file.

Batch mode example usage

Interactive mode example usage




Related tasks
Extracting properties files using wsadmin scripting
Applying properties files using wsadmin scripting
Validating properties files using wsadmin scripting
Creating server, cluster, application, or authorization group objects using properties files and wsadmin scripting
Deleting server, cluster, application, or authorization group objects using properties files
Creating and deleting configuration objects using properties files and wsadmin scripting
Extracting properties files to troubleshoot your environment using wsadmin scripting
Managing environment configurations with properties files using wsadmin scripting
Reference topic    

Terms of Use | Feedback

Last updated: Oct 21, 2010 10:04:34 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-nd-mp&topic=rxml_7propbasedconfig
File name: rxml_7propbasedconfig.html