frevvo™ On Premise Quick Start Installation Guide: 

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

Prerequisites

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

• Ensure your system meets the recommended hardware requirements and memory configuration for your frevvo On Premise server.

• Review the Supported Platforms list.
• Follow the instructions on the JDK Prerequisite page to install the supported version of Java/JDK on your system and the set the Java Home Environment variable.  

Return to this page and continue with Download the Bundle when the prerequisites are met.

Download the Bundle

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

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:

1. Ensure that you do not have another server running on ports 8443 or 8983
2. Open a command prompt. Navigate to <frevvo-home>\solr.
3. Type bin\solr.cmd start to start the Insight server. This starts the Insight server in the background, listening on port 8983.
   
   
   
   You will see this message when the Insight server is running:
   
   
   
   

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:

Start frevvo

1. Navigate to <frevvo-home>\frevvo and double-click Start-frevvo. This starts tomcat on port 8443 with frevvo pre-configured.

2. Open the frevvo home page in a new browser window. e.g. https://localhost:8443/frevvo/web/login.

   • 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 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 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 frevvo login screen will display.

Create a New Tenant

Your frevvo server installation is complete. Next you must create your first tenant.

1. Browse this URL - https://<server:port>/frevvo/web/login. Use the <server:port> where you installed frevvo. The default <server:port> is localhost:8443. 
   
2. Login to frevvo as user admin@d with the password admin. 
3. Click the Manage Tenants link on the page that displays.
4. There is a single tenant named "d." This is the default tenant.
5. Click the  icon to create a tenant. Fill in the form and submit it. The new tenant will be created.

We recommend that you do not use the admin user to create your own forms. Add a new user for that purpose.

Add a New User

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.

Start building forms and workflows

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 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.