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
- Start wsadmin.sh.
wsadmin -lang jython
- Create, edit, and apply the properties file of the configuration object.
Instructions for creating and updating properties files of various configuration objects follow:
- Activity session service
- Application
- Application deployment
- Servlet cache
- Eviction policy
- Data replication service (DRS)
- Cache provider
- Data replication domain
- J2C resource adapter
- Java 2 Platform, Enterprise Edition (J2EE) resource property
- J2EE resource property set
- Java virtual machine (JVM)
- JDBC provider
- JMS provider
- Mail provider
- Object pool
- Scheduler provider
- Security
- Lightweight Directory Access Protocol (LDAP)
- Lightweight Third Party Authentication (LTPA)
- Java Authentication and Authorization Service (JAAS) configuration entry
- JAAS authorization data
- Secure Sockets Layer (SSL) configuration
- Retrieve SSL signer certificate
- Enable global security and configure a federated user registry
- Map users and resources using authorization group properties files
- Server
- Application server
- Custom service
- Dynamic cache
- End point
- Enterprise JavaBeans (EJB) container
- HTTP transport
- Listener port
- Object Request Broker
- Performance Monitoring Infrastructure (PMI) service
- Process definition
- SOAP connector
- Stream redirect
- Thread pool
- Trace service
- Transaction service
- Web container
- SIBus
- Timer manager provider
- Transport channel service
- URL provider
- Variable map
- Virtual host
- Web server
- Plug-in
- Plug-in server cluster
- Key store file
- Administrative server authentication
- Web server process definition
- Web server Java virtual machine (JVM)
- Web server JVM system
- Work area service
- Work manager provider
- Web services endpoint URL fragment
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