Frevvo Forms 6.1

Home » Support Library » Developer Support » New Installation Guidelines » Frevvo Forms 6.1

Full install instructions: http://docs.frevvo.com/d/display/frevvo53/Installation+and+Configuration

Download Frevvo

Open Frevvo download page: http://www.frevvo.com/prod_download.

You should see the following part in the web page:

Download Frevvo

Click on “click here to download” link (the zip file will start to download).

Unzip the zip file into a location of your choice.

Ensure that you do not have another server running on port 8082 (Frevvo default port is 8082)​

Register for Trial License (If Needed)

Either acquire a Frevvo license  from the appropriate people at your company, or register for a 30-day evaluation.  To register for an evaluation, follow these steps:

Go to register page: http://www.frevvo.com/signupDL and register for new account.

After registration, on your email will be sent an email with activation link:

Register for Trial License (If Needed)

Click the Activation link to activate the account.

Login with your registered user name to access the License Manager and generate a 30 day license: https://app.frevvo.com/security/licensemgmt/login/form.  (Note: username is “username_that_you_enter_while_registration@d” without quotes).

Click on the link “Live Forms In-house Licenses”:

Live Forms In-house Licenses

There you will find your trial license under table with row “Key”:

trial license

How to Start and Stop Frevvo

Start: Go to your Frevvo installation folder.  Double click on “Start-frevvo.bat” for Windows, execute “Start-frevvo.sh” for Linux.  (Note: Server is started on port 8082 by default.)

Stop: Go to your Frevvo installation folder. Double click on “Stop-frevvo.bat” for Windows, execute “Stop-frevvo.sh” for Linux.

Update web.xml Context Parameters

  1. If Frevvo is installed on a VM with different external and internal URLs (very common for production deployments, e.g. “http://demo.armedianet.com/frevvo” for users, but “http://localhost:8082/frevvo” on the Frevvo host) you must update two context parameters in the Frevvo web.xml.
  2. cd to the Frevvo Tomcat webapps folder ($FREVVO/tomcat/webapps)
  3. unzip frevvo.war WEB-INF/web.xml
  4. edit the WEB-INF/web.xml file
  5. Find the context-parameter “frevvo.forms.server.external.url”. Update the value such that the URL is the one that works from the user network.  Do NOT include “/frevvo”.  Sample: http://demo.armedianet.com.
  6. Find the context-parameter “frevvo.internal.baseurl”. Update the value such that the URL is the one that works from the Frevvo; normally this will be “http://localhost:8082”. Do NOT include “/frevvo”.
  7. ​zip -r frevvo.war WEB-INF. The frevvo.war file should be updated with your updated web.xml file.
  8. rm -rf WEB-INF (to remove the web.xml you extracted before).
  9. Restart Frevvo server.

Activate Trial License

Start Frevvo server.  Navigate your browser to: http://localhost:8082/frevvo/web/login.  You will see the following page:

Activate Trial License

Enter the license key that you have from registration/activation process in the text area and click “Submit”.  After submitting the license key, you should be able to see the login page

Create ArkCase Tenant

Reference: ​http://docs.frevvo.com/d/display/frevvo61/Manage+Tenants

A new Tenant is required to be able to start using the Frevvo with other types of users (other than admin users). The default Tenant is “@d” and default admin user is “admin@d” with password “admin”.

Navigate your browser to: http://localhost:8082/frevvo/web/login.  Login with username “admin@d” and password “admin”.  Click on “Manage Tenants”:

Create ArkCase Tenant

There you will see default Tenant “d (Default tenant)”.  Click on “+” green icon to be able to add new Tenant:

Default tenant

The new form for adding Tenant will be shown. Enter required information (for example for Tenant id “armedia” with admin user “admin” and password “admin”).  The tenant name you enter here will be needed later during ArkCase configuration.

Create ArkCase User

Reference: http://docs.frevvo.com/d/display/frevvo61/Manage+Users

A new user is required to be able to start creating Forms. The admin user should not create or own forms.

Navigate your browser to: http://localhost:8082/frevvo/web/login​.  Log in with your new Tenant admin user (For example user “admin@armedia”)​.  Click on “Manage Users” link (if you cannot see the “Manage Users” link, click first on the “Manage” link that is located on top-right side of your screen):

Create ArkCase User

Click on the first use​r icon, which has the little green plus sign:

use​r icon

Fill all needed information and add Role “frevvo.Designer”.  Do not add any other Frevvo roles.

Apply ArkCase Rich Text Editor and User Picker to the Frevvo WAR file

Following instructions involve use of zip and unzip command line utilities.  To use graphical tools just make the necessary mental adjustments.

  1. Acquire 4 files from the ArkCase distribution site:
    1. frevvo/frevvo-war-file-additions/rich-textarea-plugin-v3.0.zip
    2. frevvo/frevvo-war-file-additions/libs.zip
    3. frevvo/frevvo-war-file-additions/user-picker-plugin-v1.1.zip
    4. frevvo/frevvo-war-file-additions/patch.zip
  2. Shutdown the Frevvo server
  3. cd to your $FREVVO/tomcat/webapps folder
  4. mkdir arkcase
  5. cd arkcase
  6. unzip /path/to/rich-text-area-plugin-v3.0.zip . (replace /path/to with the real path)
  7. unzip /path/to/user-picker-plugin-v1.1.zip . (replace /path/to with the real path)
  8. unzip /path/to/libs.zip . (replace /path/to with the real path)
  9. unzip /path/to/patch.zip . (replace /path/to with the real path)
  10. cd ..
  11. zip -r frevvo.war arkcase
  12. Start the Frevvo server

Upload Frevvo ArkCase Application

Acquire 1 file from the ArkCase distribution site:

  • frevvo/frevvo-forms/ACM_ArmediaCaseManagement_app.zip

Log into Frevvo as the application user (e.g. acm@armeda).

Navigate to “My Applications”.

Click on the Upload button:

My Applications

Choose the ACM_ArmediaCaseManagement_app.zip file

Be sure that “Copy” and “Replace” checkboxes are selected (if there are these kind of checkboxes) and click “Upload”.

You should see “ACM – Armedia Case Management” in the Applications list.  Click Edit.

You should see 14 forms.  For each form except “Rich Text Area Plugin” click “Deploy” button.  It will ask for a confirmation each time.  When finished, you should have 13 buttons with an Undeploy button, and one form with a Deploy button.

Linux Startup Script

On Linux, the Frevvo startup script should look something like this; make sure the bolded portions are correct for your system.

  • #!/bin/sh
  • # Starts, stops, and restarts Frevvo for ACM
  • #
  • # chkconfig: 345 91 09
  • # description: Starts and stops Frevvo for ACM
  • FREVVO_DIR=”/opt/frevvo“
  • FREVVO_USER=armdev
  • case $1 in
  •     start)
  •         echo “Starting Frevvo for ACM”
  •         su – $FREVVO_USER -c “cd $FREVVO_DIR ; ./Start-frevvo.sh > /dev/null 2>&1”
  •         ;;
  •     stop)
  •         echo “Stopping Frevvo for ACM”
  •         su – $FREVVO_USER -c “cd $FREVVO_DIR ; ./Stop-frevvo.sh”
  •         ;;
  •     restart)
  •         $0 stop
  •         sleep 10
  •         $0 start
  •         ;;
  •     *)
  •         echo “Usage: $0 {start|stop|restart}” >&2
  •         exit 1
  •         ;;
  • esac