Properties used by scripted administration
This article explains the Java properties that are used by scripted administration. Three levels of default property files load before any property file that is specified on the command line.
The first level represents an installation default, located in the properties directory for each WAS profile called wsadmin.properties.
The second level represents a user default, and is located in the Java user.home property. This properties file is also called wsadmin.properties.
The third level is a properties file that is pointed to by the WSADMIN_PROPERTIES environment variable. This environment variable is defined in the environment where the wsadmin tool starts.
If one or more of these property files is present, they are interpreted before any properties file that is present on the command line. These three levels of property files load in the order that they are specified. The properties file that is loaded last overrides the ones loaded earlier.
The following Java properties are used by scripting:
- com.ibm.ws.scripting.classpath
Searches for classes and resources, and is appended to the list of paths.
- com.ibm.ws.scripting.connectionType
Determines the connector to use. This value can either be SOAP, RMI, or NONE. The wsadmin.properties file specifies SOAP as the connector.
- com.ibm.ws.scripting.host
Determines the host to use when attempting a connection. If not specified, the default is the local machine.
- com.ibm.ws.scripting.port
Specifies the port to use when attempting a connection. The wsadmin.properties file specifies 8879 as the SOAP port for a single server installation.
- com.ibm.ws.scripting.defaultLang
Indicates the language to use when running scripts. The wsadmin.properties file specifies Jacl as the scripting language.
- com.ibm.ws.scripting.traceString
Turns on tracing for the scripting process. The default has tracing turned off.
- com.ibm.ws.scripting.traceFile
Determines where trace and log output is directed. The wsadmin.properties file specifies the wsadmin.traceout file that is located in the logs directory of each WebSphere Application Server profile as the value of this property.
If multiple users work with the wsadmin tool simultaneously, set different traceFile properties in the user properties files. If the file name contains double-byte character set (DBCS) characters, use a unicode format, such as \uxxxx, where xxxx is a number.
- com.ibm.ws.scripting.validationOutput
Determines where the validation reports are directed. The default file is wsadmin.valout which is located in the logs directory of each WebSphere Application Server profile.
If multiple users work with the wsadmin tool simultaneously, set different validationOutput properties in the user properties files. If the file name contains double-byte character set (DBCS) characters, use unicode format, such as \uxxxx, where xxxx is a number.
- com.ibm.ws.scripting.emitWarningForCustomSecurityPolicy
Controls whether the WASX7207W message is emitted when custom permissions are found.
The possible values are true and false. The default value is true.
- com.ibm.ws.scripting.tempdir
Determines the directory to use for temporary files when installing applications.
The Java virtual machine API uses java.io.temp as the default value.
- com.ibm.ws.scripting.validationLevel
Determines the level of validation to use when configuration changes are made from the scripting interface.
Possible values are: NONE, LOW, MEDIUM, HIGH, HIGHEST. The default is HIGHEST.
- com.ibm.ws.scripting.crossDocumentValidationEnabled
Determines whether the validation mechanism examines other documents when changes are made to one document.
Possible values are true and false. The default value is true.
- com.ibm.ws.scripting.profiles
Specifies a list of profile scripts to run automatically before running user commands, scripts, or an interactive shell.
The wsadmin.properties file specifies securityProcs.jacl and LTPA_LDAPSecurityProcs.jacl as the values of this property. If Jython is specified with the wsadmin -lang option, the wsadmin tool performs a conversion to change the profile script names that are specified in this property to use the file extension that matches the language specified. Use the provided script procedures with the default settings to make security configuration easier.