Upgrade Notes: v2.4+

If you're a current Angelfish customer, please use the below recommendations before and after upgrading.

If you have enough free disk space, make a copy of the entire /data/ directory.  This isn't a required step, but it's a really good idea to make a backup before upgrading.

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 "upgrade-<version>.log"

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

This article covers the key changes:

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.

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!  The copy button is an underused gem.

Help Article: Advanced Info & Tips

The Sample Profile has been made obsolete by the "Demo Profile" (new to v2.4+).

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/