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.


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


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.  You can grab the current file here:



REPLACE SAMPLE PROFILE
In v2.4+ the Sample Profile has been replaced by the Demo Profile, which is used in training videos and referenced in help articles.

To replace your Sample Profile, please open a support ticket and we'll send over data files and instructions.
Creation date: 5/15/2022 10:15 PM (Angelfish Support)      Updated: 6/30/2022 10:33 AM (Angelfish Support)