Here is a list of issues you may encounter with Petals ESB but that are not bugs.
These problems may be due to a hardware configuration or to operating system restrictions.

h1. Petals is unreacting or freezed

*Operating system:* Windows (verified on XP and 7)

*Symptoms:*
* The Petals command line does not display anything new anymore.
* The last lines may be a normal log entry or an exception stack trace.
* JMX commands seems without effect. When you execute them (from the JConsole, from the Petals web console), there is no response.
* Other Petals scripts do not change anything. _stop.bat_ and _shutdown.bat_ do not work.

\\
*Solutions to try:*
* Go in the Petals command line, give it the focus and type in _Enter_.

\\
*Explanations:*
You have probably selected something in the DOS shell (e.g. the JMX URL of Petals).
This selection has blocked the underlying process (Petals). Consequently, all the requests have been waiting for the process to _come back_. By giving it the focus back (_enter_), the process is unblocked.

*Symptoms:*

When installing a component or deploying services, I get the following error message:


{code}
The remote resource [http://server:port/context] is not a valid JBI archive: text/htm
{code}
*Explanations:*
If the installed archive is downloaded from Internet and it is needed to download it through a HTTP(s) proxy, perhaps have you forgotten to to configure your HTTP(s) proxy settings.

*Solution:*

Configure your HTTP(s) proxy settings editing the startup script to add your properties as JAVA_OPTS. Available properties to configure your HTTP(s) proxy are listed on the Java documentation: [Java networking and Proxies|http://download.oracle.com/javase/6/docs/technotes/guides/net/proxies.html].
{code}
if [ -z "$JAVA_OPTS" ]; then
JAVA_OPTS="-Xmx1024m -XX:MaxPermSize=256m -Djava.net.preferIPv4Stack=true -Dhttp.proxyHost=proxy.company.com -Dhttp.proxyPort=8080"
fi
{code}