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 product on Installation Prerequisites.
...
System Validation
Following are the system parameters recommended by default.
...
parameter values recommended for the purpose of running a WSO2 product server.
| Parameter | Parameter Description | Parameter Value | ||
|---|---|---|---|---|
| CPU | Required processor speed. | 800 | ||
| RAM | Required RAM in your environment. | 2048 | ||
| swap | Required space in hard disk to use for virtual memory. | 2048 | ||
| freeDisk | Free 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:
| 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): <value> of the system is below the recommended minimum speed :<recommended value>
- WARN - ValidationResultPrinter Swap Memory size (MB): <value> of the system is below the recommended minimum size :<recommended value>
JVM Validation
The following JVM parameters heap size values are recommended by default in the config-validation.xml file.
| Parameter | Description | Parameter Value |
|---|---|---|
| initHeapSize | The initial heap size that applies if the JVM requires more memory than is allocated by default. | 256 |
| maxHeapSize | The maximum heap size that applies if the JVM requires more memory than is allocated by default. | 512 |
| maxPermGenSize | The 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.
| Code Block |
|---|
$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 initHeapSize (MB): <system value> of the system is below the recommended minimum size :<recommended value>
- WARN - ValidationResultPrinter maxHeapSize (MB): <system value> of the system is below the recommended minimum size :<recommended value>
- WARN - ValidationResultPrinter maxPermGenSize (MB): <system value> of the system is below the recommended minimum size :<recommended value>
System Property Validation
The following properties According to the config-validation.xml file, values are required to be setup specified for the following properties in your system. Therefore, Note that it is not recommended to remove these validations from the config-validation.xml file.this validations as these are mandatory settings.
carbon.homecarbon.config.dir.pathaxis2.home
The 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.
| Code Block |
|---|
$JAVA_OPTS
-Dcarbon.home="$CARBON_HOME" \
-Dcarbon.config.dir.path="$CARBON_HOME/repository/conf" \ |
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.
LinuxUnixMac OSWindows Server 2003Windows XPWindows VistaWindows 7Mac OS XWindows Server 2008Windows Server 2008 R2AIX
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."