Upgrade Notes: v2.4+

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

Pre-Upgrade


BACKUP YOUR DATA DIRECTORY
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.


LINUX: RUN UPGRADE IN SCREEN
If you run Angelfish on Linux, run the upgrade in the screen utility.  It avoids unnecessary problems, like network issues.



Post-Upgrade


CHECK THE UPGRADE LOG
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.

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


WHAT'S NEW IN v2.4?
This article covers the key changes:

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


ADMIN TASKS: FIRST LOGIN
Look at the Settings section in this article:



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



CONFIGURE INTERNAL SEARCH REPORTS
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.


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


PERUSE ADVANCED INFO & TIPS
Learn some new admin tips!  The copy button is an underused gem.

Help Article: Advanced Info & Tips

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

Next Steps


BROWSE THE NEW HELP CENTER
You're already here!



UPDATE ANGELFISH.JS
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:


Creation date: 5/15/2022 10:15 PM      Updated: 10/19/2022 9:26 AM