On This Page:

Unix Installation

frevvo provides a bundle that includes the supported Tomcat version, 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, we strongly recommend the bundle.

1. You must register for a frevvo account, generate a trial license and download the tomcat bundle from the frevvo web site.
   
   1. Download the tomcat bundle to your local machine
   2. Generate a trial license. You will receive an email with a link to activate your account. Click the link in the email and follow the prompts.
2. Ensure that you do not have another server running on ports 8443 or 8983.
3. Unpack the frevvo.zip file to the location of your choice: e.g. /Users/me/frevvo. We'll refer to this directory below as <frevvo-home>.
4. Ensure that the scripts are executable: chmod 755 <frevvo-home>/tomcat/bin/*.sh
5. Navigate to <frevvo-home>/solr/bin. Run this command to make the solr startup file executable:
   chmod +x solr
6. Navigate back to the solr directory
   cd .. 
7. Start the Insight server by typing:
   bin/solr start - this starts the Insight server in the background.
8. Browse http:<your server:port>/solr to verify the Insight server is running. The default values for the server and port are localhost:8983. Change them to point to the server and port where the Insight server is running if it is different from the default values. You will see the Insight server (Solr) dashboard with the current status:
   
   
   
   
9. Start frevvo: <frevvo-home>/tomcat/bin/catalina.sh run. This starts tomcat on port 8443 with frevvo pre-configured.
10. In your browser, go to https://<server-name>:8443/frevvo/web.

11. Install your License Key

12. A current license is required. If frevvo does not accept your license after multiple attempts, please try restarting your frevvo server after the license install. <frevvo-home>/tomcat/bin/catalina.sh stop. When tomcat has stopped, restart using <frevvo-home>/tomcat/bin/catalina.sh run.
    
    

Installing as a Linux Service

frevvo and solr can be installed and started/stopped as a Service. Follow these steps.

1. Create two service files:

   1. /etc/systemd/system/frevvo-tomcat.service
      

      [Unit]
      Wants=frevvo-solr.service
      
      [Service]
      User=frevvo
      Group=frevvo
      Environment=JAVA_HOME= /usr/lib/jvm/java-11-openjdk
      Environment=CATALINA_PID=/opt/frevvo/tomcat/temp/tomcat.pid
      Environment=CATALINA_HOME=/opt/frevvo/tomcat
      Environment=CATALINE_BASE=/opt/frevvo/tomcat
      WorkingDirectory=/opt/frevvo/tomcat
      ExecStart=/opt/frevvo/tomcat/bin/catalina.sh run
      ExecStop=/opt/frevvo/tomcat/bin/shutdown.sh
      PIDFile=/opt/frevvo/tomcat/temp/tomcat.pid
      SyslogIdentifier=frevvo-tomcat
      Restart=on-failure
      
      [Install]
      WantedBy=multi-user.target

   2. /etc/systemd/system/frevvo-solr.service
      

      [Unit]
      PartOf=frevvo-tomcat.service
      
      [Service]
      Type=forking
      User=frevvo
      Group=frevvo
      Environment=JAVA_HOME= /usr/lib/jvm/java-11-openjdk
      WorkingDirectory=/opt/frevvo/solr
      PIDFile=/opt/frevvo/solr/bin/solr-8983.pid
      ExecStart=/opt/frevvo/solr/bin/solr start
      ExecStop=/opt/frevvo/solr/bin/solr stop
      SyslogIdentifier=frevvo-solr
      Restart=on-failure
      LimitNOFILE=65000
      LimitNPROC=65000
      
      [Install]
      WantedBy=multi-user.target

2. Copy frevvo-tomcat.service and frevvo-solr.service to /etc/systemd/system/ folder
3. Adjust the following in both frevvo-tomcat.service and frevvo-solr.service files:
   1. frevvo installation path
   2. Java installation path
   3. User and Group

4. Reload systemd

   sudo systemctl daemon-reload

5. Start frevvo
   

   sudo systemctl start frevvo-tomcat.service

6. Check frevvo status

   sudo systemctl status frevvo-tomcat.service

7. Check solr status
   

   sudo systemctl status frevvo-solr.service

8. Stop frevvo
   

   sudo systemctl stop frevvo-tomcat.service

Next Steps

Your frevvo server installation is complete. You are now ready to create your first tenant, users, forms, and workflows. See the documentation for creating a tenant and users.

You can find examples of creating your own workflows on the Quick Start Video Guide page.