+

Search Tips   |   Advanced Search

Manage specific configuration objects using properties files

Use wsadmin.sh to change configuration properties and manage configuration objects of the environment using properties files.

Determine the changes to make to the server configuration or its configuration objects.

Read Properties file syntax so that changes made to properties files use the supported syntax.

Using a properties file, we can create, modify, or delete a configuration object.

Extracted properties files identify all required properties and default values for an object of a given type. Required properties have the comment # required following a property setting. Properties that have default values have the comment #object_type,default(default_value) following a property setting. When a property that has a default value is deleted, the value of that property is set automatically to the default value. If a property does not have default value, it is not shown. Because extracted properties files contain information about all required and default properties, we can verify that property values are set properly before applying the properties file to create, modify, or delete an object.

For example, an extracted properties file of type JDBCProvider identifies all required and default properties:

#
# SubSection 1.0 # JDBCProvider attributes #
ResourceType=JDBCProvider
ImplementingResourceType=JDBCProvider
ResourceId=Cell=!{cellName}:ServerCluster=!{clusterName}:JDBCProvider=Derby JDBC Provider (XA)
#
 #
# Properties #
classpath={${DERBY_JDBC_DRIVER_PATH}/derby.jar}
name=Derby JDBC Provider (XA) # required
implementationClassName=org.apache.derby.jdbc.EmbeddedXADataSource # required
isolatedClassLoader=false #boolean,default(false)
nativepath={}
description=Built-in Derby JDBC Provider (XA)
providerType=Derby JDBC Provider (XA) #readonly
xa=true #boolean,default(false)

  1. Start the wsadmin scripting tool.

    To start wsadmin using the Jython language, run the following command from the bin directory of the server profile:

      wsadmin -lang jython

  2. Create, edit, and apply the properties file of the configuration object.

    Instructions for creating and updating properties files of various configuration objects follow:

    The instructions contain examples to create, delete and modify WebSphere configuration objects using the properties file based configuration tool. Instructions are provided for many configuration objects but not all the supported configuration objects.

    We can use interactive mode with a command to extract, edit, or apply a properties file. Run the command with the interactive option:

      AdminTask.command_name('-interactive')

    (dist)(zos) Avoid trouble: We cannot apply a z/OS operating system properties file directly to a distributed operating system. Similarly, we cannot apply a distributed operating system properties file directly to a z/OS operating system. See the topic on applying portable properties files across multiple environments.gotcha


What to do next

Save the changes to the configuration.


Subtopics


Related tasks

  • Extracting properties files
  • Validating properties files
  • Create server, cluster, application, or authorization group objects using properties files and wsadmin scripting
  • Delete server, cluster, application, or authorization group objects using properties files
  • Extracting properties files to troubleshoot the environment
  • Manage servers and nodes

  • Properties file syntax
  • PropertiesBasedConfiguration (AdminTask)