Important Update Information
Support for Ares 4.7 ends 1 September 2022
Released: August 10th, 2020
Highlights
As promised on the Ares Roadmap, here are the main features/enhancements of Ares 5.0:
- Ares API
- Multiple Instructor Support per Course
- Integrated Support for Secure Item Uploads
- Security Enhancements
There are several bug fixes and several underlying component updates to continue supporting external systems in this release.
Considerations Before You Update
Review Ares 5.0 FAQ
For frequently asked questions and additional information regarding the 5.0 features and fixes, please see the Ares 5.0 FAQ. For all other questions, please contact support at support@atlas-sys.com.
Updating During Normal Working Hours
Please consider running updates and installations during standard support hours 8 am - 5 pm eastern time (business days: Monday - Friday) so that help is readily available if any issues are encountered.
Updating Procedures
Before you begin updating, please review the Hardware and Software Requirements for Version 5.0. For specific instructions on updating, see Updating Ares to Version 5.0: For Server Admins and Updating Ares to Version 5.0: Updating the Client.
New Folder Locations
- Addons: User-specific documents folder (e.g., C:\Users\{username}\Documents).
- DBC File (recommendation):
- Per-Machine: Under C:\Program Files (x86)\Ares (NOTE - you'll need to run SQL Alias Manager as an administrator to do this), or under C:\Users\Public.
- Per-User: Under the Documents\Ares folder (will not be accessible to other users).
- Print Templates:
- Per-User custom print templates: %AppData%\Local\Apps\Ares\Client\Print\.
Point Releases
Bug fixes and new features are added periodically as point releases. See 5.0.x point releases below:
- 09 September 2020 (5.0.1) Server Release
- 28 September 2020 (5.0.2) Server Release
- 25 January 2021 (5.0.2) Client Release
- 18 March 2021 (5.0.3) Client Installer Release
- 03 January 2022 (5.0.3) Web DLL Release
- 01 March 2022 Server and Client (5.0.3) Release
- 25 July 2022 Ares Client (5.0.4) and Server (5.0.6) LTI 1.3 & CCC Release
- 29 August 2022 Ares Client (5.0.5) and Server (5.0.7.1) Release
- 21 November 2022 Ares Server (5.0.8) Release
- 30 November 2022 (1.3.3) SQL Alias Manager Release
- 23 January 2023 Ares Client (5.0.7) Release
- 23 February 2023 Ares Client (5.0.8) Release
For a list of current known issues, see UserVoice.
Ares 5.0 Features & Fixes
Addons | Ares API | Courses | Course & User Loads | Password & Security | Print Templates | Support for Multiple Course Instructors | Staff Client | SQL Alias Manager | System Manager | LTI | Web Interface | Web Service
Addons
| Changed |
Addons are no longer installed by default. If you are using addons and do not currently have the Atlas Helpers Library installed, you may need to download the file and install it to your MyDocuments\Ares\Addons\Atlas directory. Some addons, such as VuFind or Amazon Book Searches, are dependent on other addons to run properly and the helper library contains helper methods for use with user addons. For details and example scenarios that explain how the update impacts previously existing addons, see How Default Addons are Affected by the Ares 5.0 Update. |
|---|---|
| Changed |
The per-user install requires additional steps for backing-up and reinstalling addons due to required changes to the updater that allow for per-user installs. For instructions, see Updating Ares to Version 5.0: Updating the Client. Note: Installing the client per user will not install the 3 of 9 barcode font. The font can be downloaded and installed. |
Ares API
| New |
Added an Ares API to Lookup, update, and create items, users, courses, loan periods, sites, and enrollment by a configurable identifier. For more information, see Ares API. |
|---|---|
| New |
Added the new CustKey ClientUploadMethod option of API to handle uploading and downloading files within the Ares Client via the API. The process works similarly to FTP or FileShare. For more information and configuration instructions, see Uploading Electronic Files to the Web. |
| New |
Added the new MaxUploadSize Customization Key to determine the max file permitted for uploads, in MB. Default value: 150MB. |
Courses
| Fixed |
Fixed an issue where instructors would see the option to create duplicate courses via the web if the course validation table was displayed on the pages. Bug# 5995 & 4920 |
|---|
Course & User Loads
| Changed |
Improved error messages for data imports by including the following details in the log files and reporting grid for any course or user data loads:
This should make identifying where the error occurred during the importing process easier to troubleshoot. |
|---|---|
| Changed |
The Validation User data for course & user loads have been removed from the database script for new installs. Existing installs will not be affected. |
| Changed |
Courses created through the Ares Course Load process can now have zero instructors or multiple instructors assigned. |
Password & Security
| New |
After the Ares v5.0 update, all web users will be required to reset their password upon the first login after the update. There is a default complexity requirement of eight characters with at least one letter, & one number. This does not affect RemoteAuth users and there is no way to disable the automatic password change. For more information, see Changing a User's Password. |
|---|---|
| New |
A checkbox was added to the change password dialog on the Client user form, allowing staff to force a password reset for web users. |
| New |
The SLLoginFailed status line CustKey has been added to appear if a user attempts to login with an invalid username and password. The default verbiage is set to "Login failed. Please check your username and password before trying again." The CustKeys SLUsernameNotInDatabase and SLPasswordIncorrect have been removed and replaced with the new SLLoginFailed key to increase user security and account protection.
|
| New | The WebPasswordHashingIterations and StaffPasswordHashingIterations CustKeys have been added to set the number of hash iterations (default value: 156,000 iterations) when storing a password. All passwords will now utilize the Password-Based Key Derivation Function 2 (PBKDF2) hashing strategies. |
| New |
Added staff password expiration and the capability to set default dates for expiration. If the user's last password change exceeds the StaffPasswordExpirationDays, the user will be redirected to the change password form upon login to the Ares Client. |
| New |
Added capability to enable user password expiration and set default dates for expiration. If UserPasswordExpirationEnabled is 'Yes' and the user's last password change exceeds the value in UserPasswordExpirationDays, the user will be redirected to the change password form upon login. |
| New |
Added the ability to enforce staff password complexity requirements through the StaffPasswordComplexity CustKey. Staff administrators have the option to override password requirements when creating new staff accounts with an initial password. The complexity requirement is enforced when a staff user changes their own password and, optionally, when changing another staff user's password. The complexity requirements are not enforced when changing a user password. The default requirement is: (^(?=.*\d)(?=.*[a-z])(?=.*[A-Z]).{8,}$). |
| New | Added database changes to support the new password security measures. These changes include a new column, StaffPasswordId, in the Staff table, and a new StaffPassword table. For more information, see Ares Database Tables. |
| New | In the Staff Manager, when changing the password for a different staff user, a checkbox will display that will force that staff user to change their password the next time they log in. |
| New | A dialog has been added to the Ares Server installer that allows the server administrator to specify the database user account credentials used to access the Ares database (e.g., the account credentials that can be specified in SAM). For more information, see Ares 5.0 Server Installer Database Configuration. |
| Changed | The auto-completion feature has been disabled on all password fields in the default pages. This prevents the fields from storing and pre-populating secure information, such as passwords. |
| Changed | If a user's password is expired or if the Force Password Reset box in the Client is checked, staff will still be able to use the Logon to Web button in the Client without triggering a password reset. A password reset will still be required when the user attempts to login to the web normally. |
Print Templates
| Changed |
If Ares 5.0 is installed on a per-user basis, the default Ares print templates will need to be moved to the new location so users can utilize custom print templates. New default location: %AppData%\Local\Apps\Ares\Client\Print\. |
|---|
Support for Multiple Course Instructors
For more information about how to configure and use multiple instructors, see Multiple Instructors.
| New |
Three new email template tags have been added to populate email addresses in the 'To:' or 'CC:' fields of an email based on the instructor and proxy user privileges for the course. These tags include Course.InstructorsEmail, Course.FullProxiesEmail, and Course.CourseProxiesEmail. |
|---|---|
| Changed |
Support for User tags in Item-type email templates has been removed, as it is no longer possible to link an item to a specific individual when courses may have more than one individual as an instructor. The default email templates have been updated accordingly for new installs. Current installs upgrading to v5.0 will need to update their existing Item email templates. |
| Changed |
To support courses with several instructors and/or proxies, the size limit on the EmailTo, EmailFrom, EmailCC, and EmailBCC fields in the EmailCopies table has been increased to navchar(Max). Prior to implementing support for multiple instructors, these fields were limited to 500 characters. |
| Changed | A new Courses without Instructors line has been added to the System Information panel on the main form to show the current number of courses with no instructor assigned. |
| Changed | Updated the web pages to handle the new InstructorDisplayName field in the Courses table. If there is no value in the instructor field, a <#COURSE name="Instructor"> tag will use the auto-generated value in the InstructorDisplayName field. |
| Changed | A new Instructors and Full Proxies sub-tab has been added to the Course Users tab of the Course form. |
| Changed | The CourseSearch page will now display a text field search option for new installs. Existing installs will include both the text search and a drop-down option featuring all instructors listed in the CouseUsers table. |
| Changed |
New logic has been added for instructor and full proxy roles:
|
| Changed |
When cloning a course, the course creator can select any or all of the original course's instructors and proxies to be copied over. Additional users can be added to the Course detail form. |
| Changed |
New logic has been added for the CourseInstructor parameter:
For more details, see Multiple Instructors. |
Staff Client
| New |
The Ares Client will now automatically check to see if a newer version of the Client is available and prompt the user the update, which will download and execute the required installer. For more information, see Ares Auto Updater. Please note this feature is installed as part of the v5.0 update and earlier versions will not prompt to update to v5.0. |
|---|---|
| New |
Updated the underlying components to support the new Office 2016 Colorful skin. |
| Changed |
For new installations of Ares, the ClientUploadMethod CustKey will have a default value of API and an entry will be entered in the APIConfig table during installation for use within the Client. Current installations will need to configure the API client upload method. |
| Changed |
Added support to allow cloning items to multiple courses at the same time. |
| Fixed |
Fixed a bug that allowed users with a username of Instructor to see and modify instructor tags for a course. Bug# 4450 |
SQL Alias Manager
| Changed |
Version 1.3 of the Atlas SQL Alias Manager has been released. For details, see Atlas SQL Alias Manager. |
|---|
System Manager
| Changed |
The Ares System Manager will now check for web request items that need additional CCC processing, including requests in a canceled state (either Item Cancelled by Instructor or Item Cancelled by Staff) that have an active copyright order within the last sixty days. Any items that meet these criteria will have their corresponding CCC order cancelled. |
|---|
LTI
| New |
Two new web session types have been added and implemented in for LTI and 'Login as User' sessions that let the DLL know it should not enforce password hashing and expiration requirements released in v5.0:
|
|---|---|
| Fixed |
Fixed an issue that would cause the ShowLTIParams to incorrectly display the content key values. Bug# 4405 |
Web Interface
| Changed |
Free-text items and message board posts are now converted from HTML using the Html To Markdown Conversion Utility and saved in the Markdown format. |
|---|---|
| Changed |
Fixed an issue that would hide the 'LoanPeriod' and 'PickupLocation' fields on the Reserve Item Request Form. Handling was added for hiding the loan period upon the web page load, rather than on a field change for the 'PickupLocation' field. Bug# 4606 |
| Fixed |
Fixed an issue that would prevent special characters from displaying properly when used in the headerText or footerText attributes of tables by encoding the HTML entities. For example, the error would cause an to appear as instead of adding a non-breaking space. Bug# 3584 |
| Fixed |
Fixed a bug which made it possible to save a Username web alert without having to specify a username. Bug# 4743 |
Web Service
| Changed |
Modified the course search logic to include courses with no assigned instructors in the search results. |
|---|---|
| Fixed |
Fixed an issue that would remove the Username entry in a new item's first history tracking entry for items that are cloned from another course on the web. Bug# 4558 |
| Fixed |
Fixed an issue where custom routing rules were not being applied when cloning an item on the web. Added handling for custom routing rules to be applied to the duplicate item even if the original item has a final routing status (e.g., Request Finished). Bug# 5910 & 4559 |
| Fixed | Fixed an issue where an instructor would be redirected to a blank page after applying a shared list to a course. In addition, some items from the list were being added with an incorrect status. Bug# 7059 |
| Fixed | Fixed an issue where applying a shared list to a course on the web would only add the first item in the list and then log an error in the Ares DLL. Bug# 5666 |
Ares 5.0.x Point Release Notes
09 September 2020 (5.0.1) Server Release
| Fixed | Fixed an issue where cloning items in the web would cause the original item to be incorrectly routed to the status of "Item Submitted via Cloned Course". Bug# 8255 |
|---|---|
| Fixed | Removed the timeout constraint on the installer and we modified the SQL command so that it will not repeat itself on subsequent runs. This allows the SQL command used to set the new InstructorDisplayName field to the Courses table enough time to set the initial value for large datasets. Bug#8600 |
28 September 2020 (5.0.2) Server Release
The 5.0.2 Server download link replaces the server updater for both the 5.0.0 and 5.0.1 server point release.
| Fixed |
Fixed an issue where creating courses via the Course and User Load batch processing would not account for multiple instructors when creating the dictionaries of validation records to add. Bug# 8588 |
|---|
25 January 2021 (5.0.2) Client Release
| Fixed |
Fixed an issue where instructor tags added within the web would not appear in the Client's Item grids. Bug# 8609
|
|---|---|
| Fixed |
Fixed an issue where Ares assumed when creating an item, its processing location would also be the default pickup location. If the pickup location was not the same as the processing location, it would produce an error. The new behavior is as follows:
|
| Fixed |
Fixed an issue where removing a user as an instructor's full proxy would remove all of that user's enrollments.
Note: if the user was previously enrolled as a user and then made a proxy when they are removed as a proxy, they will have to be enrolled in the course again. Bug# 9992
|
| Fixed |
Fixed an issue that prevented a course from being cloned if it didn't have any instructors. Bug# 10054
|
18 March 2021 (5.0.3) Client Installer Release
| Changed |
The Ares Client Installer will now display a prompt asking the user to choose between per-user or per-machine installation, instead of installing Ares per-user by default. The installer will also cache this information along with the selected installation path, so that future installers (versions greater than 5.0.3) will be able to automatically default to the previously selected options. |
03 January 2022 (5.0.3) Web DLL Release
A new version of the Ares Web DLL (v5.0.3) is now available to implement an important security fix.
Update Procedure
Please follow the steps below to implement the DLL fix:
- Download the v5.0.3 Web DLL from the Ares Downloads page.
- Unzip the downloaded file.
- Stop the IIS service.
- Navigate to the DLL installation folder on your Ares Server (default path C:\Ares\Web\DLL\).
- Delete the older version of the Ares.dll file.
- Copy the new DLL file you unzipped in step 2 to this folder.
- Restart the IIS service.
Web DLL Changes (v5.0.3)
| Fixed | Fixed a potential security vulnerability found during a web application scan. |
01 March 2022 Server and Client (5.0.3) Release
Several Ares 5.0 server components and client applications have been updated to address a potential security vulnerability found in their external log4net component.
Update Procedure (These steps can be performed in any order)
-
To install the latest Ares 5.0 server components, please download and run the 5.0.3.0 Ares Server Installer file (available here) if self-hosted. Atlas-hosted sites will be contacted by Atlas via email regarding their server update.
Note: Self-hosted Ares sites may encounter an issue that causes the Ares Web Service to respond with Internal Service Errors for all requests after the server update. For information on resolving this issue, please see Resolving Web Service Errors After the March 2022 Ares 5.0 Server Update. - Follow the Client Automatic Update prompts within the Ares Client, or download and run the 5.0.4 Client Installer from the Ares Downloads page to install the new client applications (Note: The 5.0.4 Client Installer will install v5.0.3 of the Ares Client).
Server Component Updates
The Ares Server update includes the following new component versions:
- System Manager v5.0.3.0
- Web DLL v5.0.4.0
- Web Service v5.0.2.0
| Fixed | Updated the log4net component used in each Ares component to the latest secure version (v2.0.14). |
Client Application Updates
Performing the Ares Client update process will install the following new application versions:
- Ares Client v5.0.3.0
- Ares Customization Manager v5.0.3.0
- Ares Staff Manager v5.0.2.0
| Fixed | Updated the log4net component used in each application to the latest secure version (v2.0.14). |
25 July 2022 Ares Client (5.0.4) and Server (5.0.6) LTI 1.3 & CCC Release
The Ares Client and Ares Server will be updated to new versions to add new functionality to features such as the Ares API, update integrations with LTI and Copyright Clearance Center, and perform several important bug fixes. This release requires a separate client and server update performed according to the instructions below.
Prerequisites
Microsoft Visual C++ 2013 Redistributable is required to run the Ares Client. This component will not be installed automatically by the Ares Client Installer and may not be present by default on machines with newer operating systems. If necessary, it can be downloaded from Microsoft and manually installed.
Update Procedure
These steps must be performed in this order. Please note that the automatic update prompts in the Ares Client will only appear once the server update is completed.
-
To install the latest Ares 5.0 server components, please download and run the 5.0.6 Ares Server Installer file (available here) if self-hosted or contact support@atlas-sys.com to schedule your update if Atlas-hosted.
The following components will be updated to the listed version numbers during the server update process:
- Ares System Manager v5.0.4
- Ares Web API v1.0.4
- Ares Web DLL v5.0.5
- Ares Web Service v5.0.3
-
Follow the Client Automatic Update prompts within the Ares Client, or download and run the 5.0.5 Client Installer from the Ares Downloads page to install the new client applications (Note: The 5.0.5 Client Installer will install v5.0.4 of the Ares Client).
The following applications will be updated to the listed version numbers during the client update process:
- Ares Client v5.0.4
- Ares Customization Manager v5.0.4
- Ares Staff Manager v5.0.3
Update Required for CCC and LTI Users
This Ares update is required for users of the Copyright Clearance Center (CCC) processing tools in the Ares Client and for users maintaining a Learning Tools Operability (LTI) connection between Ares and an external course/learning management system (CMS) to avoid disruptions to these services when support for previous iterations of these integrations end:
- The CCC will phase out support for the old web service used by previous versions of the Ares Client. Please update Ares to the latest version to implement the new web service by Monday, October 31st, 2022 to continue using the CCC copyright processing functionality in Ares without future interruption
- Support for LTI 1.1 used by previous versions of Ares will be deprecated by IMS Global, but will be maintained in Ares after updating. Upgrading to Ares 5.0.4/5.0.6 will not break your LTI 1.1 connection and both an LTI 1.1 and 1.3 connection can be maintained simultaneously in Ares (support for simultaneous LTI 1.1/1.3 connections provided by your CMS may vary by CMS). However, a new LTI 1.3 connection should be configured as soon as possible to avoid losing connection due to the deprecation of this service by IMS Global.
If you do not use the CCC searching and ordering functions in Ares and also do not use the LTI to integrate Ares with a CMS, no update is required.
Administrative | Ares API | Copyright Processing | Course Management Systems | Customization Manager | Staff Client | Staff Manager | Web Interface
Administrative
| New |
Added the collection of telemetry data to the Ares Client and Web API. This feature will track the number of times each form and button is used in the Ares Client and each time an endpoint is used in the Ares API to assist with prioritizing features for future updates. Data collection will operate under the following restrictions and privacy considerations:
For more information on this feature, see Ares Telemetry Data Collection. |
|---|---|
| Fixed |
Fixed an issue preventing proper logging for semester start and end dates in certain cases. Bug# 7394 |
Ares API
| New |
Several new endpoints have been added to the Ares API to provide enhanced functionality. These endpoints can be used to:
Please use the link for each endpoint above to access its individual documentation. |
|---|---|
| New | Added OData support to the Semesters endpoint to help filter result data retrieved by the API. For more information on OData, see Ares API. |
| Fixed | Fixed an issue where items uploaded through the Ares API could not be routed using DocumentType. Bug# 9700 |
Copyright Processing
| Changed |
Updated Ares to use the new Copyright Clearance Center (CCC) web service in order to keep integration with this service functional. The changes made by the CCC to the APIs used in its new web service have required several changes to the CCC configuration settings in the Ares Customization Manager and to the copyright search and ordering process and controls in the Ares Client. Please review the Ares Copyright Processing Changes After the CCC Web Service Update for complete information on each of these changes.
CCC Account Now Required for Searching Valid CCC account credentials in the Ares Customization Manager's CCCUsername and CCCPassword keys are now required for performing CCC copyright searches in the Ares Client. If your institution does not use Ares to perform CCC copyright processing, please see Using Ares Copyright Processing Without a CCC Marketplace Account After the 5.0.4/5.0.6 Update for information on avoiding CCC-related error messages after updating the Ares Client. |
|---|---|
| Changed |
Updated the value of the CCCHomePage customization key used to open the Copyright Clearance Center's home page from the Staff Client to https://www.copyright.com/ to ensure that the link does not break due to future URL changes. |
| Changed |
Removed the CCCECCGatewayURI and CCCECCGatewayURL customization keys from the database. |
| Fixed | Fixed an issue where the Pages and Students fields were displayed as editable text fields for items selected on the Copyright forms, but any new values entered here were not used when pricing or placing the copyright order for the item. These fields are now read-only. Bug# 16348 |
| Fixed | Fixed an issue where history entries were not added when a copyright order was created from the Item form. Bug# 16347 |
| Fixed | Fixed an issue where pay-per-use fees for items covered by the Annual Copyright License were still added to the total copyright fees for the course displayed in the Current Course Copyright field. Bug# 15115 |
Course Management Systems
| New |
Updated the LTI connection used by Ares to integrate with external course/learning management systems (CMS) from LTI v1.1 to LTI v1.3. Whereas the previous LTI 1.1 connection was handled through the Ares Web Service, the new LTI 1.3 connection will be handled by the Ares API. The following changes have been made to the Ares LTI configuration tools to support this upgrade:
For complete information on configuring new LTI 1.3 connections and migrating your existing LTI 1.1 connection to LTI 1.3, please see Integrating Ares with LTI 1.3. Note: This process will also require configuring new LTI 1.3 tools within your CMS administrator interface. Please ensure that you work together with your local CMS and Ares administrators at your institution to prepare for this process. End of Support for LTI 1.1 by IMS Global Your previous LTI 1.1 connections will be maintained in the Ares after updating to avoid breaking existing Ares LTI integrations. As LTI 1.3 will use a different set of configuration tables in the Ares Customization Manager, upgrading to Ares 5.0.4/5.0.6 will not break your LTI 1.1 connection and both an LTI 1.1 and 1.3 connection can be maintained simultaneously in Ares (support for simultaneous LTI 1.1/1.3 connections provided by your CMS may vary by CMS). However, a new LTI 1.3 connection should be configured as soon as possible to avoid losing connection due to the deprecation of this service by IMS Global. |
|---|---|
| Fixed |
Fixed an issue where the Select button used to add a deep link to an Ares item from a Moodle course (also known as content item selection) would not properly load in the Moodle interface. Bug# 4402 To implement this fix, please download the latest set of Ares LMS Default Web pages from the Ares Downloads page and overwrite the ltiContentItem.js file located in the js folder in your Ares Web Directory with the updated file.
|
| Fixed |
Fixed an issue where creating a course through the LTI would fail when the course had a matching CourseValidation record, but no instructor users from the CourseUserValidation record. Bug# 11996 This fix will also apply to pre-existing LTI 1.1 integrations upon update.
|
| Fixed | Fixed an issue where a user's UserType could be incorrectly set to Instructor when navigating to a new course through the LTI. The UserType will no longer be updated during the course creation process in the Ares Web Service. Bug# 2079 |
| Fixed | Fixed an issue where using the LTI to select items with quotation marks or other special characters in the title field would cause web service errors. |
Customization Manager
| New |
Added multi-line text input to certain fields that may require longer text values to configure. This functionality will be available for the following fields in the new LTI configuration tables:
|
|---|---|
| Fixed | Fixed an issue where setting the StaffPreviousPasswordCount customization key to 0 would prevent all staff from being able to log into their accounts. Ares will now default to a value of 4 if 0 is entered into the key. Bug# 15241 |
Staff Client
| Fixed | Fixed an issue where the DateTime field in the ItemHistory and ItemTracking tables could not be used in custom searches. Bug# 13163 |
|---|
Staff Manager
| Fixed | Fixed an issue where newly created staff users would require a manual password change before they could log into their accounts. Bug# 8307 |
|---|
Web Interface
| Fixed |
Added the WebCookieSameSite key to the Customization Manager under Web | Settings that will configure the SameSite property on the SessionID cookie in order to fix an issue where users would be directed to the Ares login page if navigating to the Ares web pages from an external system, such as an LMS. For more information on configuring this key, see Persisting SessionID Using the WebCookieSameSite Key. The default value of this key will be set to None.
|
|---|---|
| Fixed | Fixed an issue where cloning items in the web interface would only copy course tags for the logged-in instructor instead of copying all course tags from the old course to the new course. Bug# 13853 |
| Fixed | Fixed an issue where batch personal tags added by students were not assigned a tag type value upon creation and did not display on the detailed item information page. Bug# 8794 |
29 August 2022 Ares Client (5.0.5) and Server (5.0.7.1) Release
The Ares Client and Ares Server have been updated to new versions to fix several issues with the new Copyright Clearance Center (CCC) web service API implemented in the previous version of Ares. This release requires a separate client and server update performed according to the instructions below.
Update Procedure
These steps must be performed in this order. Please note that the automatic update prompts in the Ares Client will only appear once the server update is completed.
-
To install the latest Ares 5.0 server components, please download and run the 5.0.7.1 Ares Server Installer file (available here) if self-hosted or contact support@atlas-sys.com to schedule your update if Atlas-hosted.
The following components will be updated to the listed version numbers during the server update process:
- Ares System Manager v5.0.5
- Ares Web API v1.0.5
- Ares Web Service v5.0.4
-
If self-hosted, please follow the instructions in the Removing Deprecated DLL File Installed by Ares Server Installers article to remove outdated Windows DLL files that will be installed upon updating the Ares Server.
-
Follow the Client Automatic Update prompts within the Ares Client, or download and run the 5.0.6 Client Installer from the Ares Downloads page to install the new client applications (Note: The 5.0.6 Client Installer will install v5.0.5 of the Ares Client).
The following applications will be updated to the listed version numbers during the client update process:
- Ares Client v5.0.5
| Changed |
Support for the previous version of the CCC web service has been reimplemented in Ares to fix an issue where orders placed using the prior versions of Ares could not be updated after upgrading to Ares 5.0.4/5.0.6. The following changes will be made to Ares in order to support both the previous and new CCC web services simultaneously:
Note: The Copyright Clearance Center plans to phase out support for the old web service soon. Additional action may be required to update legacy orders in Ares after support for the old web services ends and will be announced as soon as possible.
|
|---|---|
| New |
Added LegacyCCCUsername and LegacyCCCPassword customization keys to the Ares Customization Manager under System | Copyright that can be configured with separate CCC Marketplace credentials used to authenticate with the old CCC web service in Ares v5.0.3 and prior, if necessary. These keys should only be configured to contain your Marketplace credentials used to authenticate with the old CCC web service if you are using different CCC Marketplace accounts for the old and new web service (i,e., if you created a new Marketplace account to connect with Ares after upgrading to v5.0.4 or later). If the Marketplace accounts used by your institution are the same between web service versions, please do not configure these keys and continue to use the CCCUsername and CCCPassword keys to enter your credentials.
|
| Fixed | Fixed an issue where the Ares Client would fail to connect to the CCC if left open for two hours or more. |
21 November 2022 Ares Server (5.0.8) Release
The Ares Server has been updated to a new version to fix issues with the LTI and Copyright Clearance Center integrations. This release requires a server update performed according to the instructions below.
Update Procedure
-
To install the latest Ares 5.0 server components, please download and run the 5.0.8.0 Ares Server Installer file (available here) if self-hosted or contact support@atlas-sys.com to schedule your update if Atlas-hosted.
The following components will be updated to the listed version numbers during the server update process:
- Ares System Manager v5.0.6
- Ares Web DLL v5.0.5
- Ares Web API v1.0.6
- Ares Web Service v5.0.5
- If self-hosted, please follow the instructions in the Removing Deprecated DLL File Installed by Ares Server Installers article to remove outdated Windows DLL files that will be installed upon updating the Ares Server.
| Changed |
Removed session ID information from the LTI 1.3 redirect URLs used by the Ares API to display the Ares web pages from the course/learning management system without requiring user reauthentication. For enhanced security, LTI 1.3 integrations will now set this information using a session cookie in the user's browser. |
|---|---|
| Fixed |
Fixed an issue where the CCC Status Updater process run by the Ares System Manager would fail when checking for changes to items requiring Special Request copyright orders placed in the Ares Client. Bug# 19678 This fix only applies to the System Manager's CCC Status Updater process that runs nightly according to the time set in the CCCStatusUpdateRunTime customization key. An error may still display on the item record in the Ares Client if an immediate status update is triggered by opening the item record in the Client before the nightly System Manager process has run to update the status (Bug# 19852). This error will resolve itself once the System Manager process runs the following night: |
30 November 2022 (1.3.3) SQL Alias Manager Release
The Atlas SQL Alias Manager (SAM) has been updated to a new version (1.3.3) to fix an expired certificate issue that prevented the application from opening. A standalone SQL Alias Manager installer is available on the Ares Downloads page that should be used to update the SAM application to the latest version.
Update Procedure
To update the SQL Alias Manager to the latest version:
- Download the Atlas SQL Alias Manager v1.3.3 installer from the Ares Downloads page.
- Run the installer using the Run as Administrator option.
-
SAM v1.3.3 will be installed at the machine level at the following location: C:\Program Files (x86)\Common Files\Atlas Systems\ and replace the previous version of the application on the machine.
Note: SAM v1.3.3 will only be installed at the machine level using the standalone installer. If SAM had previously been installed at the user level, then running the SAM 1.3.3 installer will create a separate installation of the application at the machine level and a second desktop shortcut to the new installation. To ensure that the newer application is used, the desktop shortcut pointing toward the older, user-level SAM application should be deleted after running the SAM 1.3.3 installer.
| Fixed |
Updated the signing certificate used by the application to fix an issue that prevented the SQL Alias Manager from opening. |
|---|
23 January 2023 Ares Client (5.0.7) Release
The Ares Client has been updated to a new version to implement several important bug fixes. To perform this update, please follow the update procedure instructions below.
Update Procedure
Follow the Client Automatic Update prompts within the Ares Client, or download and run the 5.0.7 Client Installer from the Ares Downloads page to install the new client applications.
The following applications will be updated to the listed version numbers during the client update process:
- Ares Client v5.0.7
- Ares Customization Manager v5.0.6
- Ares Staff Manager v5.0.5
- SQL Alias Manager v1.3.3
| Fixed | Fixed an issue where the CCC Status Updater process would sometimes fail upon opening an item record associated with a Special Request copyright order in the Ares Client and temporarily display an error in the item's copyright information. Bug# 19852 |
|---|---|
| Fixed | Fixed an issue where pull slip printing would fail for items that contained a value in the CCC Project (OrderHeader) field if there was also any Rightsholder data in the Ares database. Bug# 20299 |
| Fixed |
Fixed an issue where copyright information would fail to show on item records associated with copyright orders placed through the CCC API if the API failed when checking for order updates. Ares will now display the existing copyright information saved to the database for the item and log an error when the API connection fails. Bug# 20638 |
| Fixed | Fixed an issue where the notification that an Ares Client update is available would sometimes appear behind the initial startup loading screen and could not be clicked. Bug# 16351 |
| Fixed | Fixed an issue where attempting to use the Bulk Edit Items form on a large number of items would cause an "out of memory" error. Bug# 5779 |
| Fixed |
Updated the Ares Client Installer to include the latest version of the SQL Alias Manager (v1.3.3) with the updated signing certificate. |
23 February 2023 Ares Client (5.0.8) Release
The Ares Client has been updated to a new version (5.0.8) to implement a fix for printing errors caused by an issue discovered in recent Microsoft Word updates.
Update Procedure
Follow the Client Automatic Update prompts within the Ares Client, or download and run the 5.0.8 Client Installer from the Ares Downloads page to install the new client applications.
| Fixed |
Changed the default mail merge method used by the Ares Client to fix an issue where attempting to print after updating to Microsoft Word version 2211 or above could potentially return an error stating "The OpenDataSource method or property is not available because a macro is currently running." Note: Updating the Ares Client will automatically enable the new mail merge method. No existing printing functionality will be affected or changed by this update. If you were not experiencing the Microsoft Word printing issue before the Client update and start experiencing different printing issues after updating, please attempt to resolve these issues as a short-term fix by checking the Use Legacy Mail Merge option on the new Print Settings section of the Client Options form, then contact support@atlas-sys.com for further troubleshooting: For detailed instructions, see Changing Print Settings.
|
|---|