Versions Compared

Key

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

...

  1. Follow the Windows installation instructions in the Quick Start Installation Guide: Live Forms™ frevvo™ in-house.
  2. You may configure  as a Windows Service. Follow the instructions below for the configuration details
  3. Continue to Database Setup for more configuration information.

Next Steps

Your Live Forms 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 on creating your own workflows on the Tutorials page.

Installing

...

frevvo as a Windows Service

frevvo recommends that you install  as as a Windows service only on a 64 bit Windows system. Follow the instructions listed here.

...

  1. Verify that these steps have been performed to add JAVA_HOME as a system Environment Variable with the appropriate path to your JDK or JRE installation directory.
  2. Copy the x64 Windows Binaries, tomcat9.exe, tomcat9w.exe and tcnative-1.dll from the <frevvo-home>\tomcat\bin\x64 directory. Replace the existing binaries in the <frevvo-home>/tomcat/bin folder with the binaries from the <frevvo-home>\tomcat\bin\x64 directory. 
  3. Navigate to the directory where the batch files are located: usually <frevvo-home>. Right click the Install-Service batch file and select Run as Administrator. The Install-Service batch file will put the frevvoforms service in the Services list in manual startup mode. The  service will be called frevvoforms but the display name can be changed when you run the Configure-Service Batch file.
  4. Right click the Configure-Service batch file and select Run as Administrator. Execute the batch file.
    1. Change the Display Name of the frevvoforms service, if desired, and change the Startup Type to Automatic
    2. Click Apply and then ok to save your changes.
  5. Find the Services list for your operating system. The service should be listed. Verify that the newly installed frevvo service is listed.
    Image AddedImage Added
  6. Double click on the Service and go to the Log On tab. Notice that Log on as is set to This Account: Local Service. This is a Tomcat default security setting. 
    Image Added
    You must make one of the following changes:
    1. To continue running as "Local Service", you have two choices.
      1. Give "full control" to the "Local Service" account for the frevvo installation folder (e.g. using File Explorer on Windows 10: properties->Security -> Advanced -> Add -> Select a Principal -> Enter "Local Service"), or
      2. Use this command to give specific access to only the Administrators, SYSTEM, and LocalService (replace the frevvo-install-directory placeholder with the actual folder path):

        Code Block
        "%SystemRoot%\system32\icacls.exe" "<frevvo-Install-Directory>" /inheritance:r /grant *S-1-5-19:(OI)(CI)(F) /grant *S-1-5-32-544:(OI)(CI)(F) /grant *S-1-5-18(OI)(CI)(F)
    2. Or, switch the Log on as setting to "Local System account"

      Info

      The windows documentation describes the security implications as "The LocalSystem account has broad permissions, including the ability to write to the event log. Use this account with caution, because it might increase your risk of attacks from malicious software. For other tasks, consider using the LocalService account, which acts as a non-privileged user on the local computer and presents anonymous credentials to any remote server". 

    3. Start the Service.

Image Modified

...

frevvo fails to install/start as windows service

If running c:\frevvo\Install Service fails to install the  service and fails to run as a windows service, make sure the %JAVA_HOME%/bin is added to the system PATH Environment Variable.

...