Section |
---|
Column |
---|
configuration parameters are located in three places: - config.properties - created by the System Administrator to override parameters in a container web.xml file. This is most often used when the container is not tomcat. See below for details.
- <frevvo-home>\tomcat\conf\Catalina\localhost\frevvo.xml - recommended file to override context-parameters in the web.xml file when using the tomcat container.
- WEB-INF\web.xml - this configuration file is included in the <frevvo-home>\tomcat\webapps\frevvo.war zipfile. Modifications to this file require unzipping/rezipping the frevvo.war file after the modifications have been made. See below for the instructions. OEM partners can use this file to customize the product in many ways. See Installation Customizations for more information.
The parameters that are most commonly modified and discussed in the sections below are in frevvo.xml. The less commonly modified parameters are in web.xml. Any parameter in web.xml can be duplicated in frevvo.xml and the value in frevvo.xml takes precedence over the value in web.xml. If you plan to override the web.xml context parameter values and you are using the frevvo Tomcat bundle, we suggest doing so in frevvo.xml. This keeps all your modified parameters in one place and makes it easy to upgrade frevvo to newer releases. A config.properties file in a deployment using tomcat seems redundant since it basically does the same thing as the frevvo.xml file. If it does exist , the configuration parameters in the config.properties file will override the frevvo.xml and web.xml files. Modifying the frevvo.xml file. Follow these steps to modify context parameters in the frevvo.xml file. You can also set up your database in this file as well. If you are using tomcat, making your configuration changes here, will make it easier when you upgrade to : - Stop if it is running.
- Navigate to <frevvo-home>\tomcat\conf\catalina\localhost\frevvo.xml.
- Open the file with a text editor.
- The installation tasks listed below will reference the frevvo.xml and web.xml files when appropriate. You can configure anything in frevvo.xml that you can configure in web.xml. When you add parameters to the file, use the same syntax as the ones already there. Here is an example of a parameter to control the Maximum Size of Attachments that users can upload.
Code Block |
---|
<Parameter name="frevvo.attachment.maxsize" value="10485760" override="false"/> |
5. Save the file after all your changes are made. Restart . Modifying the web.xml fileThe web.xml file is included in the <frevvo-home>\tomcat\webapps\frevvo.war. The frevvo.war must be unzipped/rezipped after modifications have been made as outlined in the steps below: - Stop if it is running.
- Unpack the frevvo.war file to a temporary location of your choice: e.g. c:\tmp\frevvo-war. Change the file extension from .war to .zip if necessary.
- Edit c:\tmp\frevvo-war\WEB-INF\web.xml.
- Make the desired configuration changes - see appropriate sections of this page for information on specific parameters. Save the changes to the web.xml file.
Rezip all the files in the c:\tmp\frevvo-war directory, even the ones you did not edit — if you change directories or zip them differently, Live Forms may not load correctly: This is the correct structure for the frevvo.war zipfile. ![](https://frevvo-docs.atlassian.net/wiki/download/thumbnails/521241418/WarFile-V5.png?version=1&modificationDate=1338321527000&cacheVersion=1&api=v2&width=600)
Make sure you create the zipfile with the directory structure as shown in the image above. It is an easy mistake to include the containing directory in the zipfile. If you do this, Live Forms may not load correctly. Zip will often give your zipfile a .zip extension. Make sure you change this to a .war extension. - Copy the updated frevvo.war file to <frevvo-home>tomcat\webapps.
- Restart your server.
If you accidentally delete <frevvo-home>\tomcat\conf\Catalina\localhost\frevvo.xml, restart tomcat and a new copy will be created from a pristine one stored in frevvo.war!META-INF/context.xml . |
|
...
Note |
---|
There will be three additional logfiles when running Tomcat as a Windows service: - frevvoforms - stderr.YYYYMMDD and frevvoforms - stdout.YYYYMMDD for standard error messages and standard output stream, respectively. This is the default Tomcat behavior.
- commons-daemon.YYYY-MM-DD.log for Windows Service errors
|
...
The following screen displays when a user tries to submit a form from a timed out session.
![](https://frevvo-docs.atlassian.net/wiki/download/thumbnails/521241418/sessiontimeout-submit.png?version=1&modificationDate=1332850174000&cacheVersion=1&api=v2&width=500)
Editing Submissions
Submissions can be edited via the Submissions Page. This feature is disabled by default for in-house users. To enable this feature, add the frevvo.submissions.edit.link configuration parameter to the <frevvo-home>/WEB-INF/web.xml. For more
details on the feature that this parameter controls see Editing Submissions. The web.xml file must be unzipped from the frevvo.war before it can be edited. See above for the details.
...
Or, of course, comment out the HTTPS connector altogether if it is not needed.
Also, to parse license files, the BountyCastle JCE provider should be downloaded and placed in the web container classpath. For the Tomcat servlet, copy the jar into the tomcat/lib folder. Once this jar is there, the provider will be picked up automatically by through the context parameter in web.xml: frevvo.security.provider shown below. This parameter defaults to org.bouncycastle.jce.provider.BouncyCastleProvider. It is ignored when the jar is not present.
Here is the link to the Bounty Castle download page: . The jar that needs to be downloaded is the JDK 1.5 - JDK 1.7 provider: bcprov-jdk15on-148.jar. You can download it from here.
Code Block |
---|
<!-- JSSE Provider -->
<context-param>
<param-name>frevvo.security.provider</param-name>
<param-value>org.bouncycastle.jce.provider.BouncyCastleProvider</param-value>
<description>
Set the Class name or JCE provider name to use when parsing license files.
If the class doesnt exist in the ClassPath, it will be ignored.
This setting is needed when running frevvo on IBM J9 JVM: just add Bounty Castle
JCE provider to the classpath and restart the server.
</description>
</context-param> |
OEM Branding
There are several installation and configuration tasks and consideration that are typically done only by OEM partners embedding into there own product. Please see Installation Customizations for more details.
...