Knowledgebase: Server Administration
How to Upgrade Adams 5.5.1 or later
Posted by Diane Hancock on 17 March 2017 11:19 AM

Upgrade Steps

  1. Download the latest Updates release
  2. Prevent access to Adams from all users
    • Block access to the database via the firewall
    • Stop the AdamsAdmin pool
  3. Backup
    • Backup the repository
    • Backup the database
  4. HealthCheck
    1. Run Healthcheck.exe
    2. Resolve any issues discovered by Healthcheck.exe.
  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)
    3. Run Configure Adams
      1. Open the Adams Admin Foray.Adams.config file
      2. 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/repository 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.
    4. Exit Configure Adams
  6. Update Adams Admin
    1. Delete all files and folders in the C:\Inetpub\wwwroot\AdamsAdmin\AdamsUpdates directory
    2. Run Adams Admin Setup.exe
    3. In IIS, stop the Adams Admin application pool even if you already stopped it because on some servers, it restarts after the installation
    4. Copy the Prerequisites folder to the C:\Inetpub\wwwroot\AdamsAdmin\AdamsUpdates directory
    5. Copy the EXE installer files to the C:\Inetpub\wwwroot\AdamsAdmin\AdamsUpdates directory
    6. Do not copy any MSI files.  The Adams Admin installer installs the MSI's required.  Do not delete these files.
    7. Make sure that the Adams Updates files have the correct permissions
      1. Right-click the AdamsUpdates directory and select Properties
      2. Select the Security tab
      3. Click Advanced
      4. Click "Change Permissions..."
      5. Check "Replace all child object permissions with inheritable permissions from this object"
      6. Click OK in all dialogs
    8. If the version upgrading from is pre-4.6, then in IIS, create a Virtual Directory called AdamsUpdates.  
      • The physical location is the Adams Admin AdamsUpdates directory (e.g. C:\Inetpub\wwwroot\AdamsAdmin\AdamsUpdates).
      • If you see the following error in the Event log, then make sure the AdamsUpdates virtual directory was setup.
      • The Foray Adams transfer job: C:\Windows\TEMP\Foray Updates\Update Service Setup.msi encountered an error.

        Description: HTTP status 404: The requested URL does not exist on the server.

    9. In IIS, restart the Adams Admin application pool
      • Note, anytime the prerequisites in the AdamsAdmin\AdamsUpdates folder are changed, the pool must be restarted in order for the changes to take effect.
    10. Run Configure Adams
      1. 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.
      2. 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.
  7. If upgrading from any version 5.6-5.8.3
    1. Uninstall Adams Web
    2. Install the new version of Adams Web
    3. This works around an upgrade bug in Adams Web 5.6-5.8.3
  8. 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.
  9. 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


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

For a manual installation:
You'll have to show hidden folders to see these folders.
For an automatic upgrade:
Example of log file names for Configure Adams on an x64 machine: 
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)