This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Configuring config-validation.xml

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.

System Validation

Following are the system parameter values recommended for the purpose of running a WSO2 product server.

ParameterParameter DescriptionParameter Value
CPURequired processor speed.800
RAMRequired RAM in your environment.2048
swapRequired space in hard disk to use for virtual memory.2048
freeDiskFree disk space required in your environment.1024
ulimit

The limit of resources per user. This value indicates the limit on the number of file descriptors a process may have.

This property is specified in the product startup script as shown below. For example, see the product startup script for Linux: <PRODUCT_HOME>/bin/wso2server.sh:

#ulimit -n 100000
4096

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):  <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): <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. 

ParameterDescriptionParameter Value
initHeapSizeThe initial heap size that applies if the JVM requires more memory than is allocated by default.256
maxHeapSizeThe maximum heap size that applies if the JVM requires more memory than is allocated by default.512
maxPermGenSizeThe maximum heap size of the permanent generation of heap.256

These parameters are specified in the product startup script as shown below, where, "-Xms", "-Xmx" and "-XX" correspond to "initHeapSize", "maxHeapSize" and "maxPermGenSize" respectively. For example, see the product startup script for Linux: <PRODUCT_HOME>/bin/wso2server.sh.

$JAVACMD \
-Xms256m -Xmx1024m -XX:MaxPermSize=256m \

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 Initial Heap Memory (MB) : <system value>  of the running JVM is set below the recommended minimum size :<recommended value>
  • WARN - ValidationResultPrinter Maximum Heap Memory (MB) : <system value> of the running JVM is set below the recommended minimum size :<recommended value>
  • WARN - ValidationResultPrinter Maximum PermGen space (MB) :<system value>  of the running JVM is set below the recommended minimum size :<recommended value>

System Property Validation

According to the config-validation.xml file, values are required to be specified for the following properties in your system. Note that it is not recommended to remove this validations as these are mandatory settings.

  • 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 example, see the product startup script for Linux: <PRODUCT_HOME>/bin/wso2server.sh.

$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.

# 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.

  • Linux
  • Unix
  • Mac OS
  • Windows Server 2003
  • Windows XP
  • Windows Vista
  • Windows 7
  • Mac OS X
  • Windows Server 2008
  • Windows Server 2008 R2
  • AIX

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."