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 SELECTED_SUBTYPES to extract specific
configuration properties specified with the selectedSubTypes parameter. (String, optional) |
-selectedSubTypes |
Specifies the configuration properties to include when the command extracts
the properties. Specify this parameter if you set the filterMechanism parameter to
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.
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.