by SumWare Consulting
The Athenaeum Pro updater is a FileMaker utility, designed to run under FileMaker Pro versions 15, 15 or 16 and can be used to:
There are file format and external container folder changes for Athenaeum Pro 2017. This updater can only be used on those versions. When patching Athenaeum Pro 2017, a different updater must be used.
If you wish to update from an earlier version of Athenaeum Pro (or Light, for that matter), you must contact Athenaeum Library Software
Note: if you are running other FileMaker solutions on your FileMaker Server, then you can do this without affecting those.
Updating Athenaeum Pro is a relatively simple process.
Reset the “edit” password back to the original value in your existing Athenaeum Pro (if you have changed it, which you probably haven’t)
Download the updater files
Close down Athenaeum Pro and download or copy the Athenaeum Pro files to the update folder
Run the updater
Re-load the updated files
Please do this. Everyone will be happier if you do.
IF you have changed the edit account password in Athenaeum Pro (not likely), then open Athenaeum Pro, go to Admin, Accounts and Passwords and then reset the Edit account password back to the simple password “ed” (leave off the quotes).
This button is in admin-accounts and passwords, tucked away at the bottom of the screen:
Using the FileMaker Server Admin Console, you MUST:
Disconnect all Athenaeum Pro clients
close all Athenaeum Pro databases so that the databases show “closed”
Move the now closed Athenaeum filemaker files to a suitable upgrade folder on your computer (preferably not the server, if you running FileMaker Server). The Athenaeum files are those files whose names start with “ap_”.
if you are running FileMaker Server, then also move the folder inside the Athenaeum folder called RC_DATA_FMS into your new upgrade folder. Note that if you have configured FileMaker Server to use an additional “container data folder”, then RC_DATA_FMS will be in that location instead.
if you are running Athenaeum stand-alone, then move the folder inside the Athenaeum folder called “Files” into your new upgrade folder.
download the updater from the Athenaeum web site, extract the files from the zip folder and copy them into the folder above. The two files are “Athenaeum Pro Updater.fmp12” and “Updater Utility.fmp12”. The folder might look something like this snippet below. Note the Athenaeum files (the files whose names begin with ap_), the updater files and the external data (a folder named “Files” or “RC_DATA_FMS”) are all together.
Double click the file Athenaeum Pro Updater. (You do not need an account and password).
The updater tries to install the IDMA plug-in.
If you receive an error: “Attempted to install the IDMA plug-in resulted in error xxx”, then the upgrade can not proceed. Please contact us.
Athenaeum is supplied in 3 versions, differentiated externally by their file names.
The 3 versions and their filename prefixes are:
When the updater starts, it detects which version is in the same folder as the updater. You should only have 1 version in the same folder (due to issues with the external files).
You can select a different version to update from the pop-up menu if the updater incorrectly selected the wrong version (if it does, please advise).
If you are warned that FileMaker Pro cannot share files because networking is turned off, simply ignore the message and click OK every time you are prompted.
this normally happens when you run the updater on the same computer as the FileMaker Server
When the procedure has finished, results of the update are displayed in a scrolling list. Each import component should complete with a code of “0” (zero meaning no errors) and will state the number of records imported.
When the update is complete, the Athenaeum Pro 2017 files are immediately ready for use on the local computer. However, for FileMaker Server, the external container files must be re-organised.
Click the “Reorganise folders for FileMaker Server” button.
When this is done, the updater may display error warnings for folders that were not found during the re-organise process. This is not necessarily a problem as the library may not have any container objects of the type contained in the missing folders. If you are not sure, contact SumWare Consulting.
Not that the re-organise can only be done once.
_If you are interested in knowing more about this, details about the folder hierarchy can be found on this web page: http://www.librarysoftware.co.nz/downloadspro/doc/ap2017changes/200_catalogue_media_image_management.html_
Exit (quit) the FileMaker Pro application. This will ensure all files are properly closed and ready for upload.
You will have a folder that will look similar to this.
The new files are those whose names start with “ap_” and the folder called “Files”. These are the files that will be uploaded.
The “Old” folder contains the original Athenaeum files that you upgraded. The “Old RC_data_FMS” folder was the original source of external files if those files came from FileMaker Server
The folder called “athpro_data” contains external files for when Athenaeum Pro is run on a stand-alone computer.
The folder called “RC_data_FMS” contains external files for when Athenaeum Pro is loaded onto FileMaker Server.
The Athenaeum Pro Updater.fmp12 and Updater Utlity.fmp12 files are the files you used to update and are no longer required.
Simply copy the “ap_” files and the “athpro_data” folder to the desired (original) location if you are running Athenaeum on a single computer (that is, without FileMaker Server).
Simple copy the highlighted files and folder using Windows Explorer or Mac Finder, to the data directory of your FileMaker Server:
Note that you may need to adjust the operating system’s permissions and access for the files so that the FileMaker Server service can read and write to the data files.
Open the files using either the FileMaker Server Admin Console or the command line fmsadmin program.