Installation Instructions
From Frevvodocs
If you have upgraded to Live Forms v2 please see the v2.x documentation.
Contents |
Installing frevvo Live Forms™ in-house
frevvo Live Forms is available in both a hosted version and a downloadable version that you may install in-house. If you are trying to decide which version is right for you needs please refer to [SaaS or Download?]. There is nothing to install for the hosted version. Just point your browser to http://www.frevvo.com to get started building and using your forms.
Instructions
The following instructions apply to frevvo's downloadable version.
When you [sign up] for the downloadable version you will automatically be sent an activation email which contains a license key and a link to the download. Clicking on the download link takes you back to www.frevvo.com where you will download frevvo.zip to your local computer.
THERE ARE TWO CHOICES. One button labeled Download and the other labeled Download Tomcat Bundle. The bundle includes Tomcat 6.0.14 and only works on Windows systems. If you are planning to install a trial version of frevvo on Windows, we strongly recommend the Tomcat bundle since it is setup to run frevvo Live Forms without any further configuration.
Videos
For help installing the downloads, please watch the [Tomcat Bundle installation video] and the [Standalone frevvo installation video].
Prerequisites
The following prerequisites must be satisfied in order to run frevvo in-house.
- JDK 1.5 (Update 8 or higher) or JDK 1.6 are supported.
- Servlet 2.4 or higher container. frevvo recommends Tomcat 5.5 or higher (not required for bundle)
- http(s) connectivity to http://www.frevvo.com for licensing and software update.
Once you have a machine that satisfies the above requirements, please follow these steps:
frevvo-Tomcat bundle
These instructions only apply to Windows computers.
Set up the environment
- Make sure that the JAVA_HOME environment variable is set to the installation directory of your JDK, for example, C:\Program Files\Java\jdk1.5.0_12
Unpack the download zip
- Unzip the frevvo.zip file into c:\ (Note: you must extract the zip file into c:\).
- Ensure that you do not have another server running on port 8080.
- In a windows explorer go to c:\frevvo and double-click Start frevvo. This should start Tomcat on port 8080 with frevvo correctly pre-configured.
- Note that the Tomcat Manager user name/password are preset to frevvo/frevvo. If you wish to change the password, you may do so by editing the file c:\frevvo\tomcat-5.5.23\conf\tomcat-users.xml in any text editor.
Install your customer license key
- Open frevvo's home page in your browser. e.g. http://localhost:8080/frevvo/web/login. If you are using a browser on a different machine replace localhost with the name of the server machine but see host-port configuration below.
- This will create an empty customer license file - $users/.frevvo/customer.lic
- Edit customer.lic and copy the license key you received in your activation email into the file
- Note: The customer.lic should contain nothing else but the key prefixed with the string "customer.key=". For example:
customer.key=_EAsa4P32op95322GMcPQobQ
- Restart the frevvo web application
host:port configuration
This step is not required if you are accessing frevvo using http://localhost:8080/frevvo/web/login.
- Login to frevvo as: user admin , password admin
- Click on the applications link in the header
- Edit the Admin application and click on the properties in the header
- Edit the Form Action and Doc Action base URLs
- In particular, replace localhost with the name of your server.
- For example, if your server is named gandalf, you will need to change the URLs to http: //gandalf:8080/
- Note: The trailing / is important.
Changing the admin user password
Perform the following steps still logged in as the admin user.
- Click on applications link to get back to the main menu
- Then, click on the users link in the header
- Click on the
icon for the admin user. You will see a profile form appear
- Use this form to change the password and click submit. You should see a success message. It may take a while for the update to succeed.
Add a new user
The admin user should not be used for creating your own forms. Add a new user for that purpose.
- Make sure you are still logged in as the admin user
- Click on the users link in the header, to navigate to the Users page
- Click the
icon. You should see a form appear
- Fill in all form fields. You should see User xxx was successfully added, where xxx is the user id you selected.
- After the user is created, make sure you click the "enabled" checkbox in the user's profile. If you do not, the user
will be automatically disable after the 30 day trial period expires.
- Logout as the admin user.
- Login as the xxx user above. You should be able to login successfully and begin creating and using your own forms
Standalone frevvo (without Tomcat)
Unpack the download zip
- Create a directory where you want to unzip frevvo
- Unzip frevvo.zip. This extracts frevvo.war, a users folder and a lib folder.
- Move the users folder to the location of your choice e.g. /var/frevvo/users (Referred to below as $users)
- Move the lib folder to the same location (parallel to the users folder) e.g. /var/frevvo/lib.
- Deploy frevvo.war to a servlet container e.g. Tomcat
- Edit web.xml as follows:
- Set frevvo.users.path to the $users folder chosen above
- If you have a mail server, set the mail host, user name, password, from, bounce, subject, and message
- If your web server is not running on port 80, you will need to uncomment and edit the following context parameter (replace 8080 with your port number):
<context-param>
<description>Application port</description>
<param-name>frevvo.app.port</param-name>
<param-value>8080</param-value>
</context-param>
- The servlet container should automatically restart the frevvo web application.
Install your customer license key
- Open frevvo's home page in your browser. e.g. http://<myserver>:8080/frevvo/web/login
- This will create an empty customer license file - $users/.frevvo/customer.lic
- Edit customer.lic and copy the license key you received in your activation email into the file
- Note: The customer.lic should contain nothing else but the key prefixed with the string "customer.key=". For example:
customer.key=_EAsa4P32op95322GMcPQobQ
- Restart the frevvo web application
host:port configuration
- Login to frevvo as: user admin , password admin
- Click on the applications link in the header
- Edit the Admin application and click on the properties in the header
- Verify that the Form Action and Doc Action base URLs are correct
- In particular, you may need to change/add a port number.
- For example, if your server is named gandalf and is running on port 8000, you will need to change the URLs to http: //gandalf:8000/
- Note: The trailing / is important.
- Edit the Add User form
- Click on the Rules tab and expand the User Exists rule
- Once again, you will need to set the correct port on which your server is running. You can leave this as localhost.
Changing the admin user password
Perform the following steps still logged in as the admin user.
- Click on applications link to get back to the main menu
- Then, click on the users link in the header
- Click on the icon for the admin user. You will see a profile form appear
- Use this form to change the password and click submit. You should see a success message. It may take a while for the update to succeed.
Add a new user
The admin user should not be used for creating your own forms. Add a new user for that purpose.
- Make sure you are still logged in as the admin user
- Click on the users link in the header, to navigate to the Users page
- Click the icon. You should see a form appear
- Fill in all form fields. You should see User xxx was successfully added, where xxx is the user id you selected.
- After the user is created, make sure you click the "enabled" checkbox in the user's profile. If you do not, the user
will be automatically disable after the 30 day trial period expires.
- Logout as the admin user.
- Login as the xxx user above. You should be able to login successfully and begin creating and using your own forms
Need Help?
Contact Us
If you need help with the installation and configuration process contact us.
Troubleshooting
Here are several common configuration error that can be easily solved.
Login page display "Unable to renew license"
You see the following error message on frevvo's login page when you try to access the login page in your browser at http://<yourhost><port>/frevvo/web/login
"Unable to renew license for 1 attempt(s). Your license will expire in 2 day(s). Please contact frevvo for help."
You will also see the following error in the tomcat log file:
WARNING: License monitor: failed to authorize start up for 0 attempts. Next attempt in 1 hours.
This is often caused by running your web app container (ex: tomcat) under a SUN JRE that is not version 1.5.0 update 8 or later. Verify that you are running with the required JRE. If not, to solve this, download & install JRE 1.5.0 version 8 or later from http://www.sun.com. Set your JAVA_HOME on windows to the JRE install directory on your computer. Then restart your web app container.
This may also be caused by an incorrect string content in your customer.lic file. Look in the location where you put your frevvo users directory. Verify that a a customer.lic file exists in a subdirectory named .frevvo. Edit the customer.lic file and verify that the content is correct. This file must contain a single line which is the license key sent to you via email when you downloaded frevvo.zip. And it must have a prefix of "customer.key=". Verify that the content looks as follows:
customer.key=<your license key>
where <your license key> is replaced by the string sent to your in the download activation email. For example:
customer.key=_EAsa4P32op95322GMcPQobQ
