Network Deployment (Distributed operating systems), v8.0 > Scripting the application serving environment (wsadmin) > Use properties files to manage system configuration


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 your server configuration or its configuration objects.

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

Use a properties file, you 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, you 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)


Procedure

  1. Start wsadmin.sh.

    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')
    
    We cannot apply a z/OS operating system properties file directly to a distributed operating system. Similarly, you 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.


What to do next

Save the changes to the configuration.
Extract properties files using wsadmin.sh
Validate properties files using wsadmin.sh
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
Extract properties files to troubleshoot the environment using wsadmin.sh
Manage servers and nodes with scripting


Related


Properties file syntax
PropertiesBasedConfiguration command group using wsadmin.sh

+

Search Tips   |   Advanced Search