Updating Ares to Version 4.7

Follow

Before Getting Started (Can be performed the day(s) before)

Please consider blocking out 1 to 3 hours for this update.

Gather Information

  • Check server and workstation requirements for the new version by reviewing the Ares 4.7 Release Notes to ensure your hardware and software can support Ares 4.7
  • Have the IP(Intranet Protocol) and DNS(Domain Name System) for the Ares SQL Server and Web Server readily available
  • Know the SQL sa(System Administrator) username and password login information
  • Check your notes from past updates to see if there are any server/site considerations (e.g., custom SQL triggers, installations that are on different drives, multiple sets of Web Pages, if the default location of the AresDocs has changed, etc.).
  • Verify the version of .NET on the server is at least 4.6.2
    • If you do not see what version of .NET is installed via Windows\Control Panel, try running this Command Prompt: wmic /namespace:\\root\cimv2 path win32_product where "name like '%%.NET%%'”

    • If that doesn’t work, check the “Version” entry in the registry here:

      • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Client
        Or here:
        HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full

Download the Installer

  • Go to the Ares 4.7 Downloads to download the 4.7 Server Installer AresServerSetup.exe.
    • If you need the credentials to download this file, contact Atlas Systems Customer Service Representative (service@atlas-sys.com or 1-800-567-7401 ext. #1)

Complete a .NET Update

  • If necessary, update .NET to ensure the latest update is version 4.6.2 or above (Microsoft .NET Framework 4.6.2 Multi-Targeting Pack)

Uninstall Ares Client

  • Windows\Control Panel\Ares Client, right click on Ares Client, select Uninstall and Run as Administrator
  • If you would like to have a copy of the client installed on a Web Server, you will have to update have to update/install this copy separately after you finish updating the Server
    • Any future updates will have to be updated separately in the future as well

SQL Triggers

  • Make a copy of any custom SQL triggers so you can add them back later

The 4.7 Ares Update

  1. Make sure all users have logged out of out of Ares
  2. Run a manual back-up of the SQL Database
  3. Go to the downloaded AresServerSetup.exe, right click and run as Administrator
  4. A new window will pop-up, here you will have to fill in the Ares Web Server IP address or DNS name, click Next
  5. Type in the Ares Docs Path (i.e., c:\ares\docs\ or e:\AresDocs\), click Next
    1. Note: You do not need to put the PublicDocs here
  6. Select yes or no if the SQL server is on this machine, click Next
  7. Enter the Ares DB name (Default name for self-hosted servers-AresData), click Next
  8. SQL backup prompt "Would you like to complete a SQL back-up?"
    • If you have already performed an SQL back-up, choose No
    • If you haven't performed the back-up, choose Yes
  9. On the next window, you will need to fill in the SQL Server IP, sa username, and password, then click Next
    • Note: If the SQL server is over the alternate port, instead of port 1433, separate the port number with a comma on the server IP like this: 123.123.123.123,1344
  10. Hit the Install button and wait until you receive the screen that says you are done
  11. Once the update has completed, select finish
  12. An optional launch for the SAM(SQL Alias Manager) will appear
    • You may check the Alias manager to ensure the logon.dbc file is fine and then close the SAM
    • If you are a first time user you will need to launch the SAM to set-up the login .dbc file

      Note-The SAM will give the database credentials, communicate with the database, read & write data, etc.

  13. YELLOW BOX- If you did not update .NET prior to the 4.7 update, a prompt would appear to update it now
    1. As part of the .NET update, you will be prompted to restart the server, and then the installation will continue automatically

2. Restart your server (or perform an IISreset and start the Ares System Manager)

3. Reinstall any of your custom triggers

Update the IIS Manager

  1. Open the IIS(Internet Information Services)
  2. Double-click on the icon titled Handler Mappings. The Handler Mapping is recommended to be at the server level; however, it can be at the site level which is located on the left side navigation pane.
  3. On the right-hand side, click Add Module Mapping
  4. Fill in the Add Module Mapping box
    1. Request path: Type Ares.dll
    2. Module: Select IsapiModule
    3. Executable: Select the location of the dll on the C: drive (i.e., C:\Ares\Web\DLL\Ares.dll)
    4. Request Restrictions: Click the "Request Restrictions" button, then in the Mapping tab, uncheck "Invoke handler only if request is mapped to"                                                                                                                                                          
  5. In the Access tab, select the Execute button. Click okay, then click Okay again
  6. Another popup will appear, click Okay
  7. Highlight the new Ares DLL handler mapping, right-click and select Edit Feature Permissions on the right-hand side of the IIS
    • Check the boxes for Read, Script and Execute and then hit Okay
      • You may notice the ISAPI-dll handler enabled automatically, this is expected in IIS

  1. Open the ISAPI & CGI Restrictions Icon on the server level
    1. Verify the file path of the Ares DLL points to the correct location (e.g., C:\Ares\Web\DLL\Ares.dll) and check that it is set to Allowed
    2. Remove any old restrictions for Ares.dll including the TestWeb ares.dll
  2. On the tree to the left expand the triangles for Sites\Default Website\Ares
  3. To the column on the right-hand side of IIS, click Basic Settings
    • Make sure the Physical path is pointed to the actual location of the HTML pages (E.G., C:\inetpub\wwwroot\Ares\)and the Application Pool is Ares
  4. Back to the tree on the left, expand Ares, select the WebService folder and then click Basic Setting on the right-hand side of the IIS
    • Modify the Physical path with the new WebService directory (e.g., C:\ares\web\webservice) and verify the Application Pool is set to Ares WebService

      The new WebService application pool is worded Ares WebService, not to be confused with the old application pool AresWebService

  5. Back to the tree on the left, select TestWeb, then click basic settings on the right-hand side. Verify the Physical path points to the location of the web pages and the Application Pool is set to Ares
    • Repeat step 11 for any additional custom web directories
  6. On the left-hand tree, select Application Pools and remove any additional old Ares and Ares WebServices applications

    The only two Ares-related Application Pools should that should be left are "Ares DLL" and "Ares WebService"

  7. Highlight the Ares Application Pool, right-click and select Basic Settings
    • In the two drop-down boxes, choose No Managed Code and Integrated

Update the Files and Folders

  1. Open a File Explorer on the server
  2. Navigate to the Ares directory (e.g. C:\Ares), right-click on the new Web folder (e.g., C:\Ares\Web Folder) that is now available and set up the local IIS_IUSRS group with the following permissions: Read and Execute, List Folder Contents, and Read
  3. The new Ares.dll is now located in the same folder as the Ares installation (default: c:\Ares\Web), so it doesn't need to be anywhere else

    1. Remove any old Ares.dll files that existed in the Web Directories (e.g. C:\inetpub\wwwroot\Ares\Ares.dll, C:\inetpub\wwwroot\Ares\Testweb\Ares.dll, C:\inetpub\wwwroot\nonauth\Ares.dll, and any additional custom locations you may have)

    2. Sites using RemoteAuth have sometimes found that they do need to keep the Ares.dll inside the remoteauth protected folder

  4. The Webservice now lives in the new Web folder (e.g. C:\Ares\Web\WebService)
    1. Remove the entire WebService folder from your Ares web directory (e.g. C:\inetpub\wwwroot\Ares\WebService)
  5. Restart services
    1. Restart the System Manager: Go to Services and start the Ares System Manager.

    2. Restart IIS: Open a command prompt as administrator and type: iisreset

Install the Ares Client on the Server (Optional)

  1. Go to Ares 4.7 Downloads and download the Ares Client Installer 4.7
  2. Save the client installer file to the Desktop
  3. Right click on the icon, run as administrator
  4. When finished, select finish
  5. Delete the Ares Client Installer when complete

Note! Each staff member with a client will have to reinstall their client separately on their workstations

Test the Web Pages

Test the URLs for your Web Pages, TestWeb, and WebService to make sure they all work

In each location where the "site.areas.atlas-sys.com" appears, replace it with your DNS. These are examples of what your webpage URLs might look like.

https://site.ares.atlas-sys.com/ares (Click login to see if the dll responds or check the C:\Ares\Logs folder to see if the new Ares.dll is logging)
https://site.ares.atlas-sys.com/ares/testweb (Click login to see if the dll responds)
https://site.ares.atlas-sys.com/ares/webservice/areswebservice.asmx (Click "Get User Agent" to see if it is logging in the new logging location of C:\Ares\Logs)
https://site.ares.atlas-sys.com/ares/ares.dll?getversioninfo (Check the product version, you should see that you're on 4.7.0 for everything)
https://site.ares.atlas-sys.com/ares/ares.dll?getbuildinfo (Check the version and point release, you should see that you're actually on 4.7.1 DLL)

When you click login, the site will connect to the DLL. After you click login, you will notice the site will have a Ares.dll in the hyperlink

Web Edits

Show Tag Editor

This step is only necessary for the new default 4.7 pages, not in your live pages

To fix the "Show Tag Editor" button to be so where it appears on the right side of the page instead of up against the "Save Item Order" button on the left, add the text below to main.css right below the .float-left entry (default row 978)

.float-right {
 float: right;
 }

Non-Breaking Space Tag in CourseNumber & CourseCode

This step is required for both your existing live pages and the new default 4.7 pages.

For sites that use both the CourseNumber and the CourseCode fields, a non-breaking space tag ( ) is showing between them on the CourseInfo pages
  1. Each page will have to be opened in a notebook. Before you start open a notebook by right-clicking on the application and running as Administrator
  2. Next, in the notebook select file, open and choose one of the three HTML pages below that need to be fixed
    • include_defaultcourseinfo.html
    • UCourseInfo.html
    • UCourseTags.html
  3. Remove the non-breaking space tag ( ) in the code
  4. Replace it with just a blank space like this
    • Example of code location:

      <#COURSE field="CourseCode" headerText="&nbsp;(" footerText=")"/>
  5. Replace it with just a blank space like this:

    • Example of space change:

      <#COURSE field="CourseCode" headerText=" (" footerText=")"/>
  6. Repeat steps 2-5 for the other two HTML pages
  7. Do another IIS reset by opening a command prompt as administrator and typing iisreset

Other Related Information  

Demonstration Videos

Recommended videos for the changes made in Canvas

Creating the links to the Ares Courses
Creating Links in Canvas
Creating the LTI Content Item links
Creating LTI Content Item Links

Web Edits

There have been some default Web Page changes made from the 4.6 to the 4.7 update

 

4.7 Release Notes

Please read Ares 4.7 Release Notes.

 

 

0 out of 0 found this helpful

Comments

0 comments

Article is closed for comments.