Extracting properties files to troubleshoot your environment using wsadmin scripting

Use this topic to create a properties file that displays configuration information for a node, application server, application, or other resource. You can use this file to troubleshoot a problem in your environment.

About this task

To debug problems in your environment, you can use the wsadmin tool to create a properties file to review your configuration. The properties file includes the most commonly used attributes or configuration data and values for the resource of interest. You can create a properties file for any of the following resources:
  • Nodes
  • Profiles
  • Application servers
  • Virtual hosts
  • Authorization tables
  • Data replication domains
  • Variable maps
  • Java™ Database Connectivity (JDBC) providers
  • Uniform Resource Locator (URL) providers
  • Mail providers
  • Resource environment providers
  • Java 2 Connector (J2C) resource adapters

Use properties files to troubleshoot your configuration. If you cannot resolve the error, you can provide IBM Support with a copy of the properties file.

Procedure

  1. Start the wsadmin scripting tool.
  2. Extract the application server configuration of interest.
    Table 1. extractConfigProperties parameter descriptions. Run the extractConfigProperties command with parameters to extract a specific object configuration.
    Parameter Description
    -propertiesFileName Specifies the name of the properties file to extract. (String, required)
    -configData Specifies the configuration object instance in the format Node=node1. This parameter is required if you do not specify the configuration object name as the target object. (String, optional)
    -options Specifies additional configuration options, such as GENERATETEMPLATE=true. (Properties, optional)
    -filterMechanism Specifies filter information for extracting configuration properties. Specify All to extract all configuration properties. Specify NO_SUBTYPES to exclude properties specified with the selectedSubTypes parameter. Specify SELECTED_SUBTYPES to extract specific configuration properties specified with the selectedSubTypes parameter. (String, optional)
    -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 sever subtypes: ApplicationServer, EJBContainer. (String, optional)
    The following example extracts the properties configuration in the ConfigProperties_server1.props file for the server1 application server:
    AdminTask.extractConfigProperties('-propertiesFileName ConfigProperties_server1.props -configData Server=server1')

    The system extracts the properties file, which contains each of the configuration objects and attributes for the server1 application server.

Results

The system creates a properties file based on the resource configuration of interest.

Task topic    

Terms and conditions for information centers | Feedback

Last updated: April 17, 2014 10:32 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-express-iseries&topic=txml_7propsfile
File name: txml_7propsfile.html