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.

...

  1. Login to  as the tenant admin.
  2. On the page that is displayed, click the "click Manage Roles" link.
  3. There are four five default roles listed, frevvo.Designer, frevvo.Editor, frevvo.Publisher, frevvo.Reports and frevvo.ReadOnly.
  4. Click theicon, then fill in the form and submit it to create new roles. Minimally create Create Employee, Manager and HR roles , if you are planning on trying some of the  Tutorials.
  5. Click the 'Back to Manage Tenant" link.
  6. On the page that is displayed, click the "Manage Users" link.
  7. There is a single user (the administrative user you defined when you created the tenant). By default, only users beginning with the letter A are displayed. Note that you will have to click the link to display All Click All to display all users.
  8. To add more users, click the icon, fill in the form and submit it. Assign roles to the user as desired. Note that you You must assign the frevvo.Designer role to any users who wish to design forms.
  9. Create as many users as needed and assign them roles as needed. If you want plan to try the Employee On Boarding Tutorial, you will need a designer user who can create forms/flows, a user that does not have an assigned role, a user with the Manager Role role and a user with the the HR role of HR.
  10. Logout of the tenant admin account.
  11. Login as one of the newly created users with the frevvo.Designer role by filling in the User, Password and Tenant Username (user@tenant) and Password fields. Start building forms and workflows immediately.

You can find examples on creating your own workflows on the Tutorials page.

Installing

...

frevvo as a Windows Service

To frevvo recommends that you install as a Windows service only on a 32 or 64 bit Windows , follow system. Follow the instructions listed here. If your operating system is 64 bit, there is an additional step that must be performed.Windows (32/64 bit)

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

...

  • Install-Service.bat file - Double click this file to install the service.
  • Configure-Service.bat - Double-click this file to edit the Shutdown/Startup mode and set both of them to Java instead of jvm if installing on a Windows x64 system. Change change the Startup type to Automatic or change the name of the service if desired. See below:
  • Monitor-Service.bat - Double-click this file to monitor the bundle service.
  • Remove-Service.bat - removes the service. You may have to close the Windows Services panel and reopen it to see the change.

...

Follow these steps to install  as a Windows Service:

Warning

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

  1. Verify that these steps have been performed to add
  2. .
  3. JAVA_HOME as a system Environment Variable with the appropriate path to your JDK or JRE installation directory.
  4.  
  5. Navigate to the directory where the batch files are located: usually <frevvo-home>. Execute the Install-Service batch file by double clicking on it.
  6. The Install-Service batch file will put the frevvoforms service in the Services list in manual startup mode.
  7. Find the Services list for your operating system. The service should be listed. Start the Service.

Image Removed

Warning

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

Additional Step for Windows (64 bit)

If you want to install  as a service on a x64 installation of Windows , you will need to perform these additional steps.  

Make sure you have completed step 1 to configure the JDK Home environment variable with the correct path as discussed above.

  1. Navigate to the directory 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. 
  2. Navigate to the directory where the batch files are located: i.e.usually <frevvo-home>\frevvo.   Right click the Install-Service batch file and select Run As as Administrator. Execute the batch fileThe 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.
  3. Image Removed
    Right click the Configure-Service batch file and select Run as Administrator. Execute the batch file.

      A properties panel will display. Click on the Startup tab. Modify the service properties to change the Startup mode from jvm to Java.

      Image Removed
      Click on the Shutdown tab. Modify the service properties to change the Shutdown mode from jvm to Java. Click 'OK'.

      Image Removed

    1. Now try to start the service. Check the frevvoforms-stderr.YYYY-MM-DD,log,  frevvoforms-stdout.YYYY-MM-DD.log, common-daemon.YYYY-MM-DD.log files located in <frevvo-home>/tomcat/logs and the Windows System Event log if the service does not start. See below for some troubleshooting tips.

    ...

      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.
    1. 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
    2. 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 Added

    frevvo fails to install/start as windows service

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

    If this fails to solve the problem even with setting of JAVA_HOME , the tomcat service may not be able to find msvcr71.dll even though it is in the bin directory of your JDK or JRE installation, copy . Copy msvcr71.dll from the bin directory of your java installation the bin directory of your tomcat installation or to your C:\WINDOWS\System32 directory. You may see these errors in the windows service log file:

    Code Block
    [174 javajni.c] [error] The specified module could not be found. [986 prunsrv.c] [error] Failed creating java C:\Program Files\Java\jdk1.6.0_07\jre\bin\server\jvm.dll [1260 prunsrv.c] [error] ServiceStart returned 1

    If you are seeing the following error when stopping the service on an x64 install,  make sure the Startup/Shutdown mode was changed from jvm to java. See above for the details.

    Code Block
    Error 109: The pipe has been ended

     If you see the error message shown when starting the service on an x64 install,  make sure the Startup/Shutdown mode was changed from jvm to java. See above for the details.

    Image Removed

    Windows Binaries

    Previous versions of the Windows binaries (executables and dlls) found in the <frevvo-home>/tomcat/bin folder were built for x86 (32-bit) architectures and will not work on a x64 architecture (64-bits). We are now bundling the tomcat version 8 binaries for the two architectures inside <frevvo-home>/tomcat/bin folders:  <frevvo-home>\tomcat\bin\x64 and <frevvo-home>\tomcat\bin\x86.

    How do I know if I need to update the Windows binaries in my install? Are you seeing these errors?

    Code Block
    [2011-09-13 11:29:51] [info] Commons Daemon procrun (1.0.2.0) started [2011-09-13 11:29:51] [info] Running Service... [2011-09-13 11:29:51] [info] Starting service... [2011-09-13 11:29:51] [206 javajni.c] [error] %1 is not a valid Win32 application. [2011-09-13 11:29:51] [985 prunsrv.c] [error] Failed creating java C:\Program Files\Java\jdk1.6.0_25\jre\jdk11.0.2\bin\server\jvm.dll [2011-09-13 11:29:51] [1280 1260 prunsrv.c] [error] ServiceStart returned 1 [2011-09-13 11:29:51] [info] Run service finished. [2011-09-13 11:29:51] [info] Commons Daemon procrun finished.

    If so, the binaries in <frevvo-home>\tomcat\bin may need to be replaced. Here are the steps:

    ...

    1

    ...

     

    ...