Installing the Aptify 5.5.3 Update
Errors When Running the Aptify 5.5.3 Setup
If you experience a problem installing Aptify 5.5.3, see Troubleshooting Aptify 5.5.3 Installation Problems for more information.
The following instructions provide a step-by-step guide for the installation of Aptify 5.5.3 to a system that already has one of the following versions of Aptify installed:
- Aptify 5.5.2
Your server must be running Aptify 5.5.2 prior to installing the Aptify 5.5.3 Service Pack. There is currently NO direct path to update from Aptify 5.0, 5.0 SP1, 5.0 SP2, 5.0 SP3, 5.5, and 5.5.1 to Aptify 5.5.3. Any system running these earlier versions will first be required to update to Aptify 5.5.2 prior to applying Aptify 5.5.3. See Installing the Aptify 5.5.2 Update.
Important Pre-Installation Considerations
- Review Troubleshooting Aptify 5.5.3 Installation Problems prior to installing Aptify 5.5.3. This guide provides information on issues that you may encounter running the Aptify 5.5.3 or Aptify Web 5.5.3 setup. If you know, for example, that you have a required field on the Persons entity that does not have a default value, this will need to be resolved prior to install to be successful for Aptify 5.5.3.
Installing Aptify 5.5.3 on the Aptify sample data set takes approximately three hours. Depending on the size of your database, the installation process may take up to six hours.
The increased installation process time is due to updating Globally Unique Identifiers (GUIDs) for several entities in this release.
- This installation can only be applied to a server running Aptify 5.5.2. If your server is running an earlier version, you must upgrade to Aptify 5.5.2 first before applying this versions.
- For best results, Aptify recommends that an organization install service packs, add-on applications, and new versions in the order in which they are released. For example, since Aptify e-Business 5.5.2 was released before Aptify 5.5.3, Aptify recommends that an organization using e-Business install e-Business 5.5.2 first before installing Aptify 5.5.3. Note that the e-Business 5.5.2 setup program will not run against an Aptify 5.5.3 database, due to the .NET Framework 4.5 update in Aptify 5.5.3. To install e-Business on 5.5.3, you need to use an e-Business 5.5.3 installer (available Summer 2015 - contact Aptify Technical Support for details).
Important Post-Installation Considerations
- If you are running one or more instances of an Aptify application server, you will need to run the Object Repository Synchronizer utility to update the application server's Program Files folder so it has the latest Aptify objects. The Object Repository Synchronizer is included in the service pack's Utilities folder. See Configuring Multiple Instances of the Aptify Asynchronous Processor for more information about running more than one instance of the Application Server.
- If you have an Aptify e-Business site installed, you will need to run the Object Repository Synchronizer utility to update the e-Business bin folder so it has the latest Aptify objects. The Object Repository Synchronizer is included in the service pack's Utilities folder. For e-Business 5.5 and higher, be sure to only download objects from the e-Business Sync Repository Objects record.
- Run the U.S. zip code update utility on your Aptify server. See Running the Update Utility for U.S. ZIP Codes.
- Check in the API bin folder for the ConfigManifestForm.dll file. If the file is there, delete it. This file may exist on systems that have gone through a major version upgrade. This file is not required by Aptify SOA or Aptify Web – it should be removed from the AptifyServicesAPI bin folder if it exists since it will force your app pool to run in 32-bit mode (without this file, which is not needed, your AptifyServicesAPI app pool can run in 64-bit mode).
- Verify that the correct versions of Crystal Reports have been installed. See Verifying the Installed Version of Crystal Reports for more information. If the incorrect version is installed, see Installing the Provided Version of Crystal Reports for more information.
- Aptify recommends that you consider enabling SQL Server snapshot isolation. Review the information in Enabling SQL Server Snapshot Isolation to determine whether enabling this function would improve your Aptify environment, and if needed,perform the steps to enable the function.
- If you have an Aptify Mobile Point of Sales installation, you will need to run the Object Repository Synchronizer utility to update the Aptify SOA bin folder so it has the latest Aptify objects. The Object Repository Synchronizer is included in the service pack's Utilities folder. Follow the object synchronization instructions in Step Four: Configuring Mobile Point of Sale Post-Installation to update the bin.
- If you are planning on installing the Aptify 5.5.3 Web interface, you must first install Aptify 5.5.3 database updates. See Implementing the Aptify Web Interface for more details on installing the web interface.
Installation Procedures
Perform the following procedures to install Aptify 5.5.3:
Copyright © 2014-2017 Aptify - Confidential and Proprietary