Upgrade Notes

Software upgrades are included for all current Angelfish customers.

The upgrade retains all your existing report data.  

Please follow the recommendations in this article when upgrading your Angelfish instance(s).

Please open a support ticket and let us know if you need the Windows or Linux installer.

A backup lets you quickly recover from upgrade errors.

Things to backup:

- make a copy of the entire /data/ directory & subdirs

- if TLS/SSL is enabled, backup the /certs/ directory

If you run Angelfish on Linux, run the upgrade in the screen utility.  It avoids unnecessary problems, like network issues.

Outbound Link: https://linuxize.com/post/how-to-use-linux-screen/

The /log/ directory under the Angelfish Installation Directory contains a file that stores the console messages from the upgrade.  If any errors were encountered during the upgrade, they will be listed here.  The filename is:

If you see any errors in the upgrade log, please open a support ticket and let us know - we're here to help!

This article covers key changes when upgrading from v2.33 and earlier:

Help Article: What's New in v2.4?

Look at the Settings section in this article:

Help Article: Admin Tasks: First Login

The AYA feature lets Global Admins delegate management of Profiles to Collection Managers.  We highly recommend using this feature.

Help Article: Enable Ask Your Admins

Angelfish has a set of Internal Search reports that show you how users interact with the search function on your website.  These reports are configured in the Settings tab of each Profile, in the Internal Search section.

Help Article: Internal Search Overview

If you use the search term parameter in the Page Query Parameters field, you can remove it - it's no longer necessary.

The "Clickable Page Prefix" field in the Settings tab of each Profile makes Pages & Documents clickable in the reports.  Very handy.

Learn some new admin tips!  For example: the copy button is an underused gem.

Help Article: Advanced Info & Tips

The Sample Profile is replaced by the "Demo Profile" in v2.4+.  We recommend deleting the Sample Profile so it doesn't count against your Profile Limit.

You're already here!

If any of your Profiles use the AGF Tracking Method, now is a good time to update angelfish.js to the current version.  Older versions of angelfish.js don't work with some of the new features in v2.4+.

You can grab the current file here:

Outbound Link: https://analytics.angelfishstats.com/tracking-code-generator/

Help Article: How to Use Angelfish in your Organization