In House Standalone War Installation Instructions

From Frevvodocs

Jump to: navigation, search

In case you want to install frevvo into your own Servlet container (eg. Tomcat, JBoss, Glassfish, etc) you can also install the frevvo.war without the prepackaged Tomcat bundle. This requires adding some jars into your container classpath and a few web application context parameters (each container has a specific way of setting context parameters). If you dont have the required expertise or permissions to configure your own web container, we strongly recommend the Tomcat bundle since it is setup to run frevvo Live Forms without any further configuration.

Upgrading Customers IMPORTANT For Upgrading Customers, please refer to Upgrading your Form Server. Customers upgrading from a prior Live Forms release... must copy their existing user and assets directories to $FREVVO_HOME/frevvo/data before starting v3 for the 1st time.

Note: The context path for the frevvo web application must be /frevvo.

  • Download the Tomcat bundle from the frevvo web site. You will need to login with your frevvo account. The Tomcat bundle is a working example of installing frevvo.war standalone and it has the added benefit of already bundling all the required dependencies (jars and configuration files) that you will need to use.
  • Unzip the bundle to a location of your choice. We'll refer to this directory below as $FREVVO_HOME. We are going to copy some files from this directory such as the frevvo.war, additional jars and a Tomcat configuration file.
  • Copy the $FREVVO_HOME/data folder to the location of your choice e.g. /var/frevvo/data ($FREVVO_DATA)
  • Copy the $FREVVO_HOME/tomcat/webapps/frevvo.war to the webapps folder of your Servet container (e.g. see $FREVVO_HOME/tomcat/webapps)
  • Copy the following Jars from the $FREVVO_HOME/tomcat/lib to your container lib folder: 
 * $FREVVO_HOME/tomcat/lib/slf4j-jdk14-1.5.6.jar
 * $FREVVO_HOME/tomcat/lib/slf4j-api-1.5.6.jar
 * $FREVVO_HOME/tomcat/lib/mail-1.4.1.jar
 * $FREVVO_HOME/tomcat/lib/activation-1.1.jar
  • Copy the following DB connection pooling related jars (or provide an alternate one based on your deployment configuration) to your container lib folder: 
 * $FREVVO_HOME/tomcat/lib/commons-pool-1.3.jar 
 * $FREVVO_HOME/tomcat/lib/commons-dbcp-1.2.2.jar
 * $FREVVO_HOME/tomcat/lib/commons-collections-2.1.1.jar
  • Copy one of the following jars (or all) depending on your database to your container lib folder: 
 * $FREVVO_HOME/tomcat/lib/hsqldb-1.8.0.7.jar (HSQLDB)
 * $FREVVO_HOME/tomcat/lib/jtds-1.2.2.jar (SQL Server)
 * $FREVVO_HOME/tomcat/lib/mysql-connector-java-5.1.6.jar (MYSQL)
  • Configure the following web application resources (use $FREVVO_DATA/tomcat/conf/Catalina/localhost/context.xml.default as your guide): 
 * jdbc/frevvoDS (javax.sql.DataSource)
 * mail/frevvoDS (javax.mail.Session)
  • Override at least the following context parameters (see $FREVVO_HOME/tomcat/conf/Catalina/localhost/context.xml.default as an example): 
 * frevvo.users.path to the $FREVVO_DATA folder chosen above (ex /var/frevvo/data/users on linux or c:\frevvo\data\users on windows), OR
 * alternatively, you can also set the users path using a Java system property with the same name (e.g. -Dfrevvo.users.path=/var/frevvo/data/users)
 * frevvo.mail.from.email (an email address)
 * frevvo.mail.bounce.email (an email address)
  • Make sure your container supports large HTTP headers (e.g. 32768 bytes is a safe number).
  • If using Tomcat, make sure that you set the useBodyEncodingForURI="true" in the Connector configuration.
  • Start your application server
  • In your browser, open frevvo's home page e.g. http://<server-name>:8082/frevvo.
  • On the page that is displayed, copy and paste the license that you generated and click Submit.
  • Follow the steps below if frevvo displays an Upgrade page:
    • Click the Continue button. frevvo will initialize itself.
    • The "installation complete" page will be displayed when initialization is complete.
    • Restart frevvo: Double click <frevvo-home>\Stop frevvo. When Tomcat has stopped, restart by double clicking <frevvo-home>\Start frevvo.
  • In your browser, go to http://<server-name>:8082/frevvo/web.
  • Login to frevvo as user "admin", password "admin". Change the admin password if you want.
  • We recommend that you do not use the admin user to create your own forms. Add a new user for that purpose.
  • Click the "manage" link in the top right menu.
  • On the page that is displayed, click the "Manage Users" link.
  • Click the Image:add.png icon, fill in the form and submit it. The user will be created.
  • Logout of the admin account and login as the new user.
  • Live Forms is installed and ready for use.


Retrieved from "http://docs.frevvo.com/docs/index.php/In_House_Standalone_War_Installation_Instructions"
Personal tools