Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Section


Column


Panel
borderColor#88AACC
bgColor#F0F0F0
titleColorwhite
borderWidth1
titleBGColor#88AACC
borderStylesolid
titlefrevvo On Premise Quick Start Installation Guide

frevvo provides a downloadable version for local installations that runs frevvo without further configuration on a Windows systems. This bundle includes an HSQL embedded database. Once you have downloaded frevvo and obtained your trial license key, follow these steps to install in frevvo in your environment.



Column
width400px


Panel
borderColor#88AACC
bgColor#F0F0F0
titleColorwhite
borderWidth1
titleBGColor#88AACC
borderStylesolid
titleInstallation Guides

 On This Page:

Table of Contents



...

The steps below describe the Tomcat frevvo Tomcat bundle installation on a Windows system.

...

The following prerequisites must be satisfied in order to run On frevvo On Premise.

...

  1. Download the Tomcat Bundle from the frevvo Software Downloads Directory.
  2. Unzip the frevvo zip file into a location of your choice: e.g. c:\frevvo. We'll refer to this directory below as <frevvo-home>.

Start the Insight Server

 requires frevvo requires the Insight server for the Reporting feature. The Insight server is included in the tomcat bundle. You should start the Insight server first before starting frevvo. Further configuration is not necessary for the trial period. Follow these steps:

...

4. Browse http://<your server:port>/solr to verify the Insight server is running. The <server:port> default values are localhost:8983. Change <your server>  to the server name and <your port> to the port the Insight server is running on if they are different than the defaults. Do not include the angle brackets <>. You will see the Insight server (Solr) dashboard with the current status:


Warning

If you close the Insight server (Solr) startup window, the server will stop running. Leave the window open or set up frevvo and the Insight Server to run as Windows services.

...

Start frevvo

  1. Navigate to <frevvo-home>\frevvo and double-click Start-frevvo. This starts tomcat on port 8443 with  prewith frevvo pre-configured.
  2. Open the  home frevvo home page in a new browser window. e.g. https://localhost:8443/frevvo/web/login.

    Info
    • We recommend that you use https and not http. Https is a secure channel.
    • You may see security warnings in your browser. This is because the he frevvo tomcat bundle you downloaded from www.frevvo.com is pre-configured with a self-signed certificate for development and testing. This self-signed certificate enables frevvo to handle HTTPS connections out of the box. However before deploying your forms to production you may want to replace this with your own certificate.


  3. Login to  with frevvo with username admin@d and password admin.
  4. Enter the license key from the confirmation email in the License Key box when prompted. Click Submit. The  login frevvo login screen will display.

Expand
title Click here if you see an error about Insight Server Configuration when you browse the login URL.


Warning

If you start before frevvo before the Insight server, you will see this message when you browse the login frevvo login URL. Follow these steps to start the servers in the correct order:

  1. Navigate to your <frevvo-home> directory.
  2. Run the stop-frevvo batch file.
  3. Open a command prompt. Navigate to <frevvo-home>\solr. 
  4. Type bin\solr.cmd start to start the Insight server.
  5. Browse https://<your server:port>/solr to verify the Insight server is running. The <server:port> default values are localhost:8983. Change <your server> to the server name and <your port> to the port the Insight server is running on if they are different than the defaults. Do not include the angle brackets <>.
  6. Navigate to your <frevvo-home> directory.
  7. Run the start-frevvo batch file.


Create a New Tenant

  1. Click the Manage Tenants link on the page that displays.
  2. There is a single tenant named "d." This is the default tenant.
  3. Click the  icon to create a tenant. Fill in the form and submit it. The new tenant will be created.

...

  1. Click the  icon, to administer the newly created tenant.
  2. On the page that is displayed, click the Manage Users link.
  3. There is a single user (the administrative user you defined when you created the tenant). 
  4. Click the  icon to create a new user. 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.
  5. Create as many users and assign them roles as needed.
  6. Logout of the admin account.
  7. Congratulations!  frevvo is installed and ready for use. You can start building forms and workflows right away.

...

  1. Login as one of the newly created users with the frevvo.Designer role by filling in the user@<your tenant> ex: designer@mycompany and the password that you assigned to this user on the Login screen. The page that displays is called the Projects Home Page.
  2. If you are new to  and to frevvo and have not created any projects yet, you will see the following message. Click the  Guided Tour icon to quickly familiarize yourself with the basics.
  3. You can find examples on creating your own workflows on the In-Depth Tutorials page. Refer to Getting Started for the next steps to follow to create forms/workflows. 


Info
titleSecurity Managers

Trial tenants are configured to use the frevvo Default Security Manager by default. Once you have purchased a license for your tenantfrevvo tenant, you can switch the Security Manager of your tenant and retain forms/workflows, users, roles and submissions.

If you are planning to switch the Security Manager of your tenant to LDAP or SAML Security Managers in the future, make sure the users created in the default security manager tenant have the same user names as the users in your LDAP server or identity provider.

Detailed Installation Instructions

When you have completed the trial period and you are ready to customize your server frevvo server software, please see the detailed In-house Installation Guide.

Warning

The bundle frevvo bundle includes an HSQL embedded database. If you use the HSQL database during your trial period, you cannot migrate the data (user, roles, applications) automatically from HSQL to your production database. Once your production database is in place, you must manually: 

  1. Create your tenant.
  2. Use csv upload feature to move your users/roles to the tenant.
  3. Download and upload the applications from designer user accounts in the trial database to the designer users in the new database.