{section}
{column}

h1. Introduction

In this section, you will find:
* how to adjust your system to get the best of Petals ESB,
* and how to adjust Petals ESB to your system.

{column}

{column:width=35%}
{panel:title=Table of contents}{toc:outline=true}{panel}
{panel:title=Contributors}{contributors:order=name|mode=list|showAnonymous=true|showCount=true|showLastTime=true}{panel}
{column}

* {color:red}configuration files have not to be manually written,{color}
* {color:red}separated [filesystem|http://en.wikipedia.org/wiki/File_system] for log files:{color}
** {color:red}to avoid empty file system error when dumping payload content,{color}
** {color:red}select an efficient journaling filesystem to write small files to store MONIT log files and payload dumps,{color}
** {color:red}select an efficient journaling filesystem to write big files to store the global log file.{color}

h1. Adjusting Petals ESB to your system

Several system parameters can be set to the Java virtual machine running Petals ESB. These parameters must be set in the environment file, ie. {{$PETALS_HOME/conf/env.sh|bat}}:
{code}
# JVM memory sizing
PETALS_JAVA_OPTS="$PETALS_JAVA_OPTS -Xmx1024m -XX:MaxPermSize=256m"

...
{code}

{tip}
If Petals ESB was installed using Debian packages, the environement file is defined by the property '{{petals.environment.config.file}}' of the local container configuration, ie. {{server.properties}}. The default value of the property is {{/etc/petals-esb/default-env.sh}}.
{tip}
# if not defined, the file.

By default, Petals ESB comes with the following adjustments:
* JVM heap size: 1Go,
* JVM perm size: 256Mo,
* TCP/IP v4 is used preferentially, instead of TCP/IP v6.

h2. Adapting Petals ESB to the IP Network Stack

On some machine, the network IPv4/IPv6 dual-stack is available.
It may be enabled, even if the network is configured to be an IPv4 network.

Besides, by default, the JVM uses IPv6 if it is available.
In this case, for performances reasons, the Petals ESB startup script forces the usage of the IPv4 stack.

If your network is a full IPv6 network, you must update the environnement configuratin file, ie. {{$PETALS_HOME/conf/env.sh|bat}}, and remove the option *-Djava.net.preferIPv4Stack=true* or set it to *{{false}}*.
{code}
# If TCP/IPv4 and TCP/IPv6 are available on the host, we prefer TCP/IPv4
PETALS_JAVA_OPTS="$PETALS_JAVA_OPTS -Djava.net.preferIPv4Stack=false"
{code}

{info}
More information on network properties of the JVM can be found on [Oracle's web site|http://download.oracle.com/javase/6/docs/technotes/guides/net/properties.html].
{info}