Versions Compared

Key

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

On This Page:

...

  1. You must register for a account, generate a 30 day trial license and download the tomcat bundle from the  web site.
    1. Download the tomcat bundle to your local machine
    2. Generate a 30-day 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-home>/tomcat/bin/catalina.sh run. This starts tomcat on port 8443 with 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.

Warning

If you start before the Insight server, you will see this message when you browse the 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.

...

frevvo and solr can be installed and started/stopped as a Service.  Batch files provided in the <frevvo-home> directory can install, configure and monitor the  service:  Follow these steps.

Note

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

      Code Block
      [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

      Code Block
      [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

    Code Block
    sudo systemctl daemon-reload
  5. Start frevvo

    Code Block
    sudo systemctl start frevvo-tomcat.service
  6. Check frevvo status

    Code Block
    sudo systemctl status frevvo-tomcat.service
  7. Check solr status

    Code Block
    sudo systemctl status frevvo-solr.service
  8. Stop frevvo

    Code Block
    sudo systemctl stop frevvo-tomcat.service

...