|
Please read the following upgrade steps prior to starting the migration.
frevvo recommends that you test the upgrade process on your test server before performing it on your production server. Contact your frevvo Account Manager for information if you do not have a test environment. |
If upgrading from a version prior to v10.1, install Chrome on that same server as your frevvo installation. This is required for PDF Snapshot generation to work in your v11 installation.
PDF Snapshot Generator: Install Chrome/ChromiumA stable version of chrome or chromium browser needs to be installed on same server where frevvo is installed. First, check to see if Chrome is already installed. If not, use one of the following links to install Chrome or a Chromium browser. The snapshot generator looks for the chrome browser at the following paths. If found, it launches the browser.
If the browser is not installed at any of these paths then set the CHROME_PATH environment variable to point to the correct path of the browser binary or set frevvo.chrome.path property in frevvo-config.properties file. Windows Os:
MacOs/Linux
|
Stop frevvo with one of the methods listed below:
Execute <frevvo-home>\stop-frevvo.[bat,sh]
Stop the Insight Server by closing the window or if you are using the tomcat bundle by typing these commands in the <frevvo-home>\solr directory of your existing installation.
bin\solr.cmd stop -all
Stop frevvo and the Insight Server through the Computer Management Services console if they are running as Window's services.
Back up the current frevvo server's installation directory so that you have a copy of all custom configuration parameters.
Customers using Oracle DB should grand the following permission before upgrading.
GRANT EXECUTE ON SYS.DBMS_CRYPTO TO <frevvo user>; |
If you do not do this, you may see an error like "liquibase.exception.DatabaseException: ORA-00904: "DBMS_CRYPTO"."HASH": invalid identifier" in the log file while upgrading, and the upgrade will fail.
Install Upgraded Version
Refer to the Configure the Connection URL topic to point to your current frevvo database. If you are using SQL Server, remember to add the sendStringParametersAsUnicode property with a value of false to your database connection URL if it is not already there.
All database initialization and/or required upgrades will be automatically done by frevvo.war as part of the frevvo v11.0.x startup. |
See Installation Tasks for commonly used properties. Read the Detailed Release Notes to be sure that all properties you are using are valid in the upgraded version.
If there was not a solr upgrade between the versions you upgrading from and to, you may restore the contents of the <frevvo-home>\data\solr directory from the previous installation directory backup that you made in the Prepare for the Upgrade section to your latest version's <frevvo-home>\data directory. |
Follow the steps to start the Insight server BEFORE starting frevvo.
You will see this message:
If you close the Insight server (Solr) startup window, the server will stop running. Leave the window open or see these instructions to remove existing services and set up frevvo and the Insight Server to run as Windows services: |
Browse http://<your server:port>/ solr to verify the Insight server is running. The <server:port> default values are localhost:8983. Change localhost to the server name and 8983 to the port the Insight server is running on if they are different than the defaults. Do not include the angle brackets <>. You will see the Insight server (Solr) dashboard with the current status.
Start the frevvo v10.1.x server by running the start-frevvo.bat or start-frevvo.sh files (depends on your Operating system) in the <frevvo-home>\frevvo directory. Then follow these instructions to login and enter your upgrade license key.
If you are running frevvo and the Insight Server (Solr) as Windows services, you must delete the existing services then reinstall them for the services to run properly.
Type this command: If your service name has spaces in it, use quotes around the service name.
sc delete <ServiceName> |
The message "DeleteService SUCCESS' will display when successful.
Remove the frevvo service by running the <frevvo-home>\Remove-Service batch file.
Perform these steps to reinstall the Insight Server and frevvo services.
Ensure you upgrade to the supported version of the connectors for your upgraded version of frevvo. Version information can be found at the links below.
Recent browser versions (especially Chrome v80+), by default, allow cookies to be sent only with top-level navigation and GET request initiated by third-party websites. When you need to expose cookies to a third party site, such as using the SAML security manager or embedding in an iframe, you need to use https (Chrome only) and explicitly set the samesite attribute of the cookie to "none". frevvo includes a tomcat version that allows configuring the cookie processor with this attribute. This documentation provides more information and details across browsers.
The sameSite value "none" is not supported prior to iOS 13 (macOS before version 10.15). Setting sameSite to "none" in tomcat may require iPhone/iPad to be upgraded. |
For third party access, you must use https and update the provided tomcat/conf/context.xml CookieProcessor element to add the sameSiteCookies attribute.
<CookieProcessor className="org.apache.tomcat.util.http.LegacyCookieProcessor" allowEqualsInValue="true" sameSiteCookies="none"/> |
On premise customers who do not want to make these updates need to turn on the legacy behavior in the chrome browser. Please see this Chrome documentation for details.
Verify that any frevvo Connectors are up and running.
Login as the superuser admin.
If you start frevvo before the Insight server, you will see this message when you browse the frevvo login URL. Follow these steps to start the servers in the correct order: Navigate to your <frevvo-home> directory. Run the stop-frevvo.bat or stop-frevvo.sh file depending on your Operating system to stop frevvo. Open a command prompt. Navigate to <frevvo-home>\solr-6.6.2 Start the Insight server. Refer to Start the Insight Server above for the instructions. Browse http://<your server:port>/solr to verify the Insight server is running. The <server:port> default values are localhost:8983. Change localhost to your server name and 8983 to the port the Insight server is running on if they are different from the defaults.Do not include the angle brackets <>. Start frevvo. |
If you're applying a minor patch update, for example, applying patch v11.0.x to your installed v11.0.2 frevvo server, you can follow these simple steps instead of the more lengthy upgrade steps.
The latest major frevvo version and the compatible frevvo connectors are available from the frevvo Software Downloads Directory. |
If you are applying a patch release that includes an Apache Tomcat upgrade to your installed v11.0 frevvo server, follow these modified upgrade instructions. Refer to the sections above for detailed steps.
Stop frevvo.
Back up the current frevvo server's installation directory so that you have a copy of all custom configuration parameters.
Restore the contents of the <frevvo-home>\data\solr directory from the previous installation directory backup that you made in Step 2 to your latest version's <frevvo-home>\data directory. Then, start the Insight Server.