Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Note
titleNote Concerning Out of Memory Error When Running the Aptify 5.5.2 3 Setup

Under certain circumstances, the setup may fail due to a memory utilization restriction. You will know this occurs if you find the following line in the InstallationStatusLog.txt file (found in the top-level directory of the setup):

Exception Message: Exception of type 'System.OutOfMemoryException' was thrown. 

If this occurs, see Setup May Fail Due to Memory Utilization for an alternate installation method. If you continue to experience problems, contact Aptify Technical Support for assistance.

...

The Aptify 5.5.3 database setup may fail if a form template or dashboard circular reference error is found. In Aptify 5.5, Aptify added the Unique Identifier for form templates to prevent circular reference errors, so you should not see this error on systems that originated from 5.5 and 5.52. 1. However, you may see this issue if you database was at one point an earlier version (5.0 SP3 and earlier).

...

You can then re-run the setup, you do not need to restore the database to prior to previous installation attempt. 

Anchor
_ReqField
_ReqField
Scenarios Where Setup May Fail Due to Entity Updates and Required Fields

...

If an entity has a field that is not part of the base view, the installation may fail. For example, Aptify5Aptify 5.5.3 adds a new field to Companies called Logo. This can be a problem for certain databases whose Companies entity meets these conditions:

...

If an organization’s Companies entity meets all of the conditions listed above, then the 5.5.3 update to the Companies entity will fail. The workaround is as follows for the example above:

...

Run each install (Aptify 5.5.12, CES, Aptify Web Server Components, Aptify 5.5.3) one at a time (starting with the first item). By default the installer checks the boxes of the elements not installed yet.

For example, for a 5.5.2 to 5.5.3 install (with no CES or Aptify Web components already installed):

  1. Check only Select 5.5.1 2 and complete the setup. Take a backup.
  2. This time, 5.5.1 is unchecked by default. Uncheck Clear Aptify Web Components and 5.5.3, leaving only CES checked and complete the setup. Take a backup.
  3. Run the setup again. Check Aptify Web Server Components (i.e., uncheck clear Aptify 5.5.3) and complete the setup. Take a backup.
  4. Run the 5.5.3 setup.

...