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
- Start the wsadmin scripting tool.
- 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
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.
You can also use the extractConfigProperties command
to extract a specific object configuration from a deployment manager,
as the following Jython example displays:
AdminTask.extractConfigProperties('-propertiesFileName ConfigProperties_server1.props -configData Server=dmgr')
The
system extracts the properties file, which contains each of the configuration
objects and attributes for the dmgr deployment manager.
Results
The system creates a properties file based on the resource
configuration of interest.