Knowledgebase: Applications
How to Upgrade Adams 5.10+
Posted by Mont Rothstein on 21 September 2018 06:06 PM

Upgrade Steps

  1. Health Check
    1. Run HealthCheck.exe
    2. Resolve any issues discovered by HealthCheck.exe
  2. Download the latest Updates release
  3. Prevent access to Adams from all users
    • Block access to the database via the firewall
    • Stop AdamsAdminPool and AdamsWebPool
  4. Backup
    • Backup the repository
    • Backup the database
  5. Update Configure Adams
    1. On the server running the database, run Configure ADAMS Setup.exe
    2. If Adams Update Service is not running on that server and you are updating from 32-bit (i.e. pre-5.5) to 64-bit, copy the Foray.Adams.Config.xml from the 32-bit install location (e.g. C:\Program Files (x86)\Foray) to the 64-bit install location (e.g. C:\Program Files\Foray)
  6. Upgrade the Database
    1. Run Configure Adams
    2. Open the Adams Admin Foray.Adams.config.xml file. Do not open a config file that points to Adams Admin because the pool has been stopped.
    3. Click Load Central Config
      1. If a database upgrade is needed then a message box will inform you and ask you to make sure you have a backup and that no one is using the system.
        1. If a backup has been done and if no one is using the system then allow the database upgrade to continue.
        2. After this database upgrade no one will be able to use the system until their software has been upgraded to the current version.
      2. If a database has been updated or if an update is not needed a prompt may appear to upgrade the Repository
        1. Click OK
        2. You may continue with these instructions, and users may use the system, while the Repository is being upgraded.
      3. After any upgrades the central configuration will be displayed.
    1. Exit Configure Adams
  7. If upgrading from any version 5.6-5.8.3
    1. Uninstall the following apps: Adams Web, Acquisition Service, Archive Service, Purge Service, WAN Connect Service
    2. These are re-installed later
  8. Update Adams Admin
    1. *STOP* - Once Adams Admin Setup.exe is run all machine running Adams Update Service will automatically begin to update all installed Adams applications.
    2. Run Adams Admin Setup.exe
    3. Run Configure Adams
      1. This is to verify that Adams Admin is running properly
      2. Make sure the config file opened is pointing to Adams Admin rather than directly to the DB.  Do not open the Adams Admin config file.
      3. If you get an Adams Admin error, try these steps to resolve it.
        1. In the Adams Admin bin directory (e.g. C:\inetpub\wwwroot\AdamsAdmin\bin), delete the Atalasoft.dotImage.WinControls.dll file if it exists.
        2. Restart the Adams Admin pool in IIS.  
        3. Close and reopen Configure Adams.
  9. If upgrading from any version 5.6-5.8.* (continued from earlier)
    1. Install the new version of any apps uninstalled in Step 6: Adams Web, Acquisition Service, Archive Service, Purge Service, WAN Connect Service
    2. This works around an upgrade bug in Adams Web 5.6-5.8.*
  10. Adams Update Service
    1. The Foray Adams Update Service, running on client and server machines, checks every 15 min for updates so to force a machine to download its updates either reboot the machine or re-start the Foray Adams Update Service.
    2. Note, the Foray.Adams.Config.xml used by the Foray Adams Update Service must specify an Adams Admin url or the service will write a warning to the Event log and terminate without updating anything.
  11. Adams Web - Authentication mode
    • After Adams Web is updated, the applicable authentication mode needs to be re-enabled in IIS.  
      1. IIS > Sites > Default Web Site > AdamsWeb > IIS Authentication > select the Forms OR Windows authentication (whichever is the site's requirement) > Enable
      2. Recycle the AdamsWeb application pool

Troubleshooting

If an installation or automatic upgrade fails, get the log files.  Here's where to find them.

For a manual installation:
 
C:\Users\<username>\AppData\Local\Temp
 
You'll have to show hidden folders to see these folders.
 
For an automatic upgrade:
 
C:\Windows\Temp
 
Example of log file names for Configure Adams on an x64 machine: 
 
Foray_Configure_Adams_<datetime_info>_Setupx64.log
 
Foray_Configure_Adams_<datetime_info>.log
 
Sort by "Date modified" to get the latest log.  If there is more than one around the same time, get all of them.  Get the log with the "Setupx64" suffix and without.

Comments (0)