Download the Tomcat bundle

1. Download the Tomcat bundle from the frevvo web site. You will need to login with your  account. 
2. Ensure that you do not have another server running on port 8082.
3. The  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:\.  A frevvo subfolder will be created and the bundle files will be extracted and placed in this directory. We'll refer to this directory c:\ frevvo as <frevvo-home>.
   
   

   
   
   
   

5. Start : Double click <frevvo-home>\Start frevvo. This starts Tomcat on port 8082 with  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  displays an Upgrade page:
   
   1. Click the Continue button.  will initialize itself.
   2. The "installation complete" page will be displayed when initialization is complete.
   3. Restart : 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  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 Tenants" link.
14. There is a single tenant named d. This is the default tenant.

Setup for Forms only

Please use Forms and Flows setup rather then Forms only setup.

1. Click the  icon, to administer the default tenant.
2. On the page that is displayed, click the "Manage Users" link.
3. There is a single user (admin).
4. Click the  icon, fill in the form and submit it. The user will be created.
5. Logout of the admin account and login as the new user.
6.  is installed and ready for use.

Setup for Forms and Workflows

View a 4 minute video on setting up your in-house server for workflows
by clicking here.

1. Click the  icon to create a new tenant, fill in the form and submit it. The new tenant will be created.
2. Click the  icon, to administer the newly created tenant.
3. On the page that is displayed, click the "Manage Roles" link.
4. There is a single role (frevvo.Designer).
5. Click the  icon, fill in the form and submit it to create new roles e.g. Employee or Manager.
6. Click the 'Back to Manage Tenant' link.
7. On the page that is displayed, click the "Manage Users" link.
8. There is a single user (the administrative user you defined when you created the tenant). Note that you will have to click the link to display All users. By default, only users beginning with the later A are displayed.
9. Click the  icon, fill in the form and submit it. Assign roles to the user as desired. Note that you must assign the frevvo.Designer role to any users who wish to design forms.
10. The new user will be created. Create as many users and assign them roles as needed.
11. Logout of the admin account and login as one of the newly created users with the frevvo.Designer role and start building forms and workflows.
12. Note that you must login using the syntax: userid@tenant for the user name. For example, if the newly created tenant was named example.com then all users in that tenant must login using the ID: user@example.com. Type in your password as before.
13.  is installed and ready for use.

You can find examples on creating your own workflows on the Tutorials page.

Installing as Windows Service

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

1. Install  service: Double click <frevvo-home>\Install-Service.bat

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

Live Forms fails to install/start as Windows Service 

Running c:\frevvo\Install Service, fails to install the frevvo service and the  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

Install as a service on Windows (x64) 

If you want to install  as a service on a x64 installation of Windows you will need to perform a few additional steps. This is so because out of the box the Windows binaries (executables and dlls) found in frevvo/tomcat/bin folder are built for x86 (32-bit) architectures and will not work on a x64 architecture (64-bits).

How do I know if I need to update the Windows binaries in my install? Are you seeing these errors:

[2011-09-13 11:29:51] [info] Commons Daemon procrun (1.0.2.0) started
[2011-09-13 11:29:51] [info] Running Service...
[2011-09-13 11:29:51] [info] Starting service...
[2011-09-13 11:29:51] [206 javajni.c] [error] %1 is not a valid Win32 application.
[2011-09-13 11:29:51] [985 prunsrv.c] [error] Failed creating java C:\Program Files\Java\jdk1.6.0_25\jre\bin\server\jvm.dll
[2011-09-13 11:29:51] [1280 prunsrv.c] [error] ServiceStart returned 1
[2011-09-13 11:29:51] [info] Run service finished.
[2011-09-13 11:29:51] [info] Commons Daemon procrun finished.

Here are the steps to replace the binaries:

• Replace tomcat6.exe, tomcat6w.exe and tcnative-1.dll found in frevvo/tomcat/bin with the ones found in frevvo/tomcat/bin/x64 (for 64-bit architectures) or the ones found in frevvo/tomcat/bin/i64 (for Itanium 64-bit architectures). We are now bundling the binaries for the three architectures inside frevvo/tomcat/bin folders. 
  • apache-tomcat-6.0.29-windows-x86.zip
  • apache-tomcat-6.0.29-windows-x64.zip
  • apache-tomcat-6.0.29-windows-i64.zip 
    
    
• If you are seeing the following error when stopping the service

Error 109: The pipe has been ended

then you will need to edit the service configuration and change the Shutdown mode from jvm to Java:

tomcat6w.exe //ES//frevvoForms

Now try to start and stop the service and remember to check the service logs both in frevvo/tomcat/logs/jakarta_service_* and in the Windows System Events log for any additional details.