Ode Server TroubleShoot.md

ODE Server running troubleshooting

- Installing the tools

After download Tomcat server and ODE deployable distribution (war).

1. Download an Apache Tomcat Server at http://tomcat.apache.org/.

2. Install Tomcat to a directory of your choice. For example "C:\tomcat-5.5.26." This directory will be referred to as TOMCAT_INSTALL_DIR.

3. Download a war deployable Apache ODE file from http://ode.apache.org/getting-ode.html. Use the apache-ode-war-1.2.zip available at that site. Extract the zip file to a temporary directory. In that temporary directory, you will find a file called ode.war. Copy ode.war to the "TOMCAT_INSTALL_DIR\webapps" directory.

4. Open a command prompt and point it to "TOMCAT_INSTALL_DIR\bin" directory. Type catalina run and hit ente. This will configure and start the tomcat server.

5. In order to verify that ODE has been successfully installed, check the "TOMCAT_INSTALL_DIR\webapps" directory. It should now have a subdirectory “ode”.

6. Stop the tomcat server

- Configuring Server in Eclipse

1. Create new Ode Server in Servers tab, and create de Runtime pointing to the root of TOMCAT_INSTALL_DIR and ODE folder created inside TOMCAT_INSTALL_DIR/webapps.

If when you try to start the server the following error appears in console.

Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/juli/logging/LogFactory
  at org.apache.catalina.startup.Bootstrap.<clinit>(Bootstrap.java:54)
Caused by: java.lang.ClassNotFoundException: org.apache.juli.logging.LogFactory
  at java.net.URLClassLoader$1.run(URLClassLoader.java:217)
  at java.security.AccessController.doPrivileged(Native Method)
  at java.net.URLClassLoader.findClass(URLClassLoader.java:205)
  at java.lang.ClassLoader.loadClass(ClassLoader.java:323)
  at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:294)
  at java.lang.ClassLoader.loadClass(ClassLoader.java:268)
  at java.lang.ClassLoader.loadClassInternal(ClassLoader.java:336)
  ... 1 more
Could not find the main class: org.apache.catalina.startup.Bootstrap. Program will exit.

This error occurs because it misses the tomcat-juli.jar in the server build path.

To fix this, double click on the installed Ode v1.x Server in the Server View to see the configuration.

Click on ** Open launch configuration → Classpath tab **→ Then click in User Entries → Add External JARs → [TOMCAT_INSTALL_DIR]\bin\tomcat-juli.jar. Then Ok.

If you changed the port of the ODE v1.x Server when creating the Runtime Environment for example (port:9999), you could experiment the following error when starting the server.

Server Ode v1.x Server at localhost was unable to start within 480 seconds. If the server requires more time, try increasing the timeout in the server editor

To fix it you should change the connector port in the APACHE-TOMCAT server, open the file "TOMCAT_INSTALL_DIR\conf\server.xml" and change the Conector port:to the same port configured in ODE Runtime while creating the ODE Server.

<!-- A "Connector" represents an endpoint by which requests are received
         and responses are returned. Documentation at :
         Java HTTP Connector: /docs/config/http.html
         Java AJP  Connector: /docs/config/ajp.html
         APR (HTTP/AJP) Connector: /docs/apr.html
         Define a non-SSL/TLS HTTP/1.1 Connector on port 8080
    -->
    <Connector port="9999" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" />