On-Premise App Deployment Guide

Configuring the On-Premise Application Deployer is very simple:

  1. Apache Tomcat v7 Download:  Download and install Apache Tomat v7.
  2. On-Premise App Deployer Download:  Login to the FoxWeave Console and go to Settings -> On-Premise.  From there, you can read the License Agreement and download the FoxWeave On-Premise deployer application.
  3. On-Premise App Deployer Deploy:  Copy the On-Premise deployer to the Tomcat webapps directory.
  4. Apache Tomcat v7 Start:  Open a command terminal (cmd on Windows).  Change to the bin directory in Tomcat.  Start Tomcat by running ./catalina.sh run (Mac/Linux/Unix) or catalina.cmd run (Windows).  Make sure you are using version 6 of the Oracle/Sun JDK.
  5. On-Premise App Deployer Configure:  Open a browser and go to http://localhost:8080/foxweave-deployer-tomcat7/.  Copy the FoxWeave API credentials from your account on the FoxWeave Console (Settings -> API) and press the Save button.
  6. (Optional) Turn on FINE/Debug Logging:  To turn on FINE logging of FoxWeave in Tomcat, simply add com.foxweave.level = FINE to a new line at the bottom of Tomcat’s logging configuration file conf/logging.properties.  This is particularly useful if you are developing an extension for FoxWeave.  If you turn this on later, make sure to restart Tomcat again.
  7. Apache Tomcat v7 Restart:  Return to the command terminal and restart Tomcat (Ctrl-C to stop and then start it again as per #4 above).
Heads Up: You must run the Tomcat start scripts (#4 and #7 above) from the Tomcat bin directory, as outlined above. The FoxWeave deployer expects the cwd to be the Tomcat bin directory. Do NOT use any OS specific launchers for starting Tomcat (e.g. on Windows). Always follow the above steps exactly!!

And that’s it… you can now deploy FoxWeave Integration Apps On-Premise. Please check out the following short 2 minute video. It demonstrates the steps outlined above.

Comments are closed.