The <PRODUCT_HOME>/repository/conf/etc/config-validation.xml
file contains the recommended system configurations for a server. When you start the server, the system configurations will be validated against these recommendations, and warnings will be published if conflicts are found. See more details on system requirements for your product on Installation Prerequisites, and the procedure for starting a server in Running the Product.
Given below are the default recommendations in the config-validation.xml
file. If required, you may change some of these recommendations on this file according to the conditions in your production environment.
...
If the values set for these parameters in your environment are less than the recommendations, the following warnings will be published when you start your server.
- WARN - ValidationResultPrinter CPU speed (MHz): <value> <systemCPU> of the system is below the recommended minimum speed : <recommended value>
- WARN - ValidationResultPrinter RAM size (MB): <systemRam> of the system is below the recommended minimum size :<recommended value>
- WARN - ValidationResultPrinter Swap Memory size (MB): <systemSwap> of the system is below the recommended minimum size :<recommended value>
- WARN - ValidationResultPrinter Maximum free Disk Space (MB): <value> <systemDisk> of the system is below the recommended minimum size :<recommended value>
- WARN - ValidationResultPrinter Open files limit : <openFileLimit> of the system is below the recommended minimum count :<recommended value>
JVM Validation
The following JVM heap size values are recommended by default in the config-validation.xml
file.
...
If these heap size values in your product startup script are less than the recommended values, the following warnings will be published when you start your server:
- WARN - ValidationResultPrinter initHeapSize ValidationResultPrinter Initial Heap Memory (MB) : <system value> value> of the system running JVM is set below the recommended minimum size :<recommended value>
- WARN - ValidationResultPrinter maxHeapSize ValidationResultPrinter Maximum Heap Memory (MB) : <system value> of the system running JVM is set below the recommended minimum size :<recommended value>
- WARN - ValidationResultPrinter maxPermGenSize ValidationResultPrinter Maximum PermGen space (MB) :<system value> value> of the system running JVM is set below the recommended minimum size :<recommended value>
System Property Validation
...
carbon.home
carbon.config.dir.path
axis2.home
The carbon.home
and carbon.config.dir.patch
properties are given in the product startup script as shown below. For For example, see the product startup script for Linux: <PRODUCT_HOME>/bin/wso2server.sh
.
Code Block |
---|
$JAVA_OPTS -Dcarbon.home="$CARBON_HOME" \ -Dcarbon.config.dir.path="$CARBON_HOME/repository/conf" \ |
The axis2.home property is given in the product startup script as shown below. For example, see the product startup script for Linux: <PRODUCT_HOME>/bin/wso2server.sh
.
Code Block |
---|
# Set AXIS2_HOME. Needed for One Click JAR Download
AXIS2_HOME=$CARBON_HOME |
If the values for these properties are null in the product startup script, the following warning message will be published when you start the server: "Value is not set for the required system property : <property-value>".
Supported OS Validation
The product has been tested for compatibility with the following operating systems, which are listed in the config-validation.xml
file. Therefore, by default, the system is validated against these operating systems.
...
If the OS in your environment is not included in this list, the following warning message will be published when you start the server: "WARN - ValidationResultPrinter The running OS : <value> is not a tested Operating System for running WSO2 Carbon."