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.
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.