In House Bundle Windows Installation Instructions

From Frevvodocs

Jump to: navigation, search


Contents

[edit]

Windows Installation

frevvo provides a bundle that includes Tomcat V6 and has the frevvo web application, the database connector web application and the Google connector web application pre-deployed and pre-configured. The bundle works on Windows, Linux and Mac systems without any further configuration. If you are evaluating frevvo Live Forms, we strongly recommend the bundle.

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.

  1. Download the software from the frevvo web site. You will need to login with your frevvo account. Download the Tomcat bundle.
  2. Ensure that you do not have another server running on port 8082.
  3. The Live Forms tomcat bundle can run either with a JRE or JDK
    1. For a JRE, make sure that the JRE_HOME environment variable is set to the installation directory of your JRE, for example, C:\Program Files\Java\jre1.6.0_5, and that JAVA_HOME is not set
    2. For a JDK, make sure that the JAVA_HOME environment variable is set to the installation directory of your JDK, for example, C:\Program Files\Java\jdk1.6.0_5
  4. Unpack the frevvo.zip file to the location of your choice: e.g. c:\frevvo. We'll refer to this directory below as <frevvo-home>.
  5. Start frevvo: Double click <frevvo-home>\Start frevvo. This starts Tomcat on port 8082 with frevvo pre-configured and displays the Tomcat log in a command prompt.
  6. In your browser, go to http://<server-name>:8082/frevvo/web.
  7. On the page that is displayed, copy and paste the license that you generated and click Submit.
  8. Follow the steps below if frevvo displays an Upgrade page:
    1. Click the Continue button. frevvo will initialize itself.
    2. The "installation complete" page will be displayed when initialization is complete.
    3. Restart frevvo: Double click <frevvo-home>\Stop frevvo. When Tomcat has stopped, restart by double clicking <frevvo-home>\Start frevvo.
  9. In your browser, go to http://<server-name>:8082/frevvo/web.
  10. Login to frevvo as user "admin", password "admin". Change the admin password if you want.
  11. We recommend that you do not use the admin user to create your own forms. Add a new user for that purpose.
  12. Click the "manage" link in the top right menu.
  13. On the page that is displayed, click the "Manage Users" link.
  14. Click the Image:add.png icon, fill in the form and submit it. The user will be created.
  15. Logout of the admin account and login as the new user.
  16. Live Forms is installed and ready for use.
[edit]

Other Installation Tasks

[edit]

Installing as Windows Service

Live Forms can be installed and started/stopped as a Windows Service.

  1. Edit <frevvo-home>\tomcat\conf\Catalina\localhost\context.xml.default
  2. Set frevvo.users.path
  3. Set the forms database path
  4. Install frevvo service: Double click <frevvo-home>\Install Service.bat

Here's an example of setting the frevvo.users.path:

<Parameter name="frevvo.users.path" value="c:\frevvo v3.3\frevvo\data\users" override="false"/>

Once installed you can now start/stop frevvo as a windows server. The service is named Apache Tomcat "frevvo"

[edit]

frevvo fails to install/start as windows service

Running c:\frevvo\Install Service, fails to install the frevvo service and the frevvo fails to run as a windows service. This problem is solved by adding %JAVA_HOME%/bin to the system PATH Environment Variable.

If this fails to solve the problem even with setting of JAVA_HOME the tomcat service may not be able to find msvcr71.dll even though it is in the bin directory of your JDK or JRE installation, copy msvcr71.dll from the bin directory of your java installation the bin directory of your tomcat installation or to your C:\WINDOWS\System32 directory.

You may see these errors in the windows service log file: 

[174  javajni.c] [error] The specified module could not be found.
[986  prunsrv.c] [error] Failed creating java C:\Program Files\Java\jdk1.6.0_07\jre\bin\server\jvm.dll
[1260 prunsrv.c] [error] ServiceStart returned 1
Retrieved from "http://docs.frevvo.com/docs/index.php/In_House_Bundle_Windows_Installation_Instructions"
Personal tools