DocuPhase Forms latest - This documentation is for DocuPhase Forms v11.3. Not for you? Earlier documentation is available too.

Tomcat Bundle on Unix

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

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

  1. Naviagate to your <frevvo-home> directory.
  2. Run the stop-frevvo.sh script.
  3. Navigate to <frevvo-home>\solr.
  4. Type bin\solr start to start the Insight server.
  5. 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.
  6. Navigate to your <frevvo-home> directory.
  7. Run the start-frevvo.sh startup script.

Installing as a Linux Service

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

Make sure that the name of the directory where you installed frevvo does not have any spaces in it.

  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.