Updating the AptifyAsyncProcessor.exe File
In each release of Aptify, there is an updated version of the AptifyAsyncProcessor.exe file. Your Application Servers should be updated with the latest AptifyAsyncProcessor.exe file when you upgrade your Aptify environment. This topic describes how to update the AptifyAsyncProcessor.exe file on your Application Servers.
| Release | Description |
|---|---|
| Aptify 5.5.5 | Aptify 5.5.5 includes enhancements to the Aptify Async Processor to ensure that scheduled mail tasks are triggered as expected. To implement these changes, Aptify 5.5.5 includes an updated Aptify Asynchronous Processor. This requires that you apply an updated version of the AptifyAsyncProcessor.exe file to the Application Server. The updated AptifyAsyncProcessor.exe file is included in the Service Pack distribution package's Application Server Update folder. Note Concerning Duplicate Windows Tasks If you are applying Aptify 5.5.5 to an Aptify 5.5.2 environment that has pre-existing scheduled views, you may need to follow additional steps to ensure duplicate Windows Tasks are not executed on your application server. See Note Concerning Duplicate Windows Tasks for Scheduled Views for more details. |
| Aptify 5.5.4 | Aptify 5.5.4 includes enhancements to the Aptify Async Processor to ensure that scheduled mail tasks are triggered as expected. To implement these changes, Aptify 5.5.4 includes an updated Aptify Asynchronous Processor. This requires that you apply an updated version of the AptifyAsyncProcessor.exe file to the Application Server. The updated AptifyAsyncProcessor.exe file is included in the Service Pack distribution package's Application Server Update folder. Note Concerning Duplicate Windows Tasks If you are applying Aptify 5.5.4 to an Aptify 5.5.2 environment that has pre-existing scheduled views, you may need to follow additional steps to ensure duplicate Windows Tasks are not executed on your application server. See Note Concerning Duplicate Windows Tasks for Scheduled Views for more details. |
| Aptify 5.5.3 | Aptify 5.5.3 includes enhancements to the Aptify Async Processor so it is more robust when handling multi-threading issues. In addition, Aptify 5.5.3 creates a new Groups record named Application Servers. This group is used to secure entities and database objects that are intended only for application server processing. Starting with 5.5.3, the Aptify user accounts that are configured to run the Application Server service should be members of this group. To implement these changes, Aptify 5.5.3 includes an updated Aptify Asynchronous Processor. This requires that you apply an updated version of the AptifyAsyncProcessor.exe file to the Application Server. The updated AptifyAsyncProcessor.exe file is included in the Service Pack distribution package's Application Server Update folder. Note Concerning Duplicate Windows Tasks If you are applying Aptify 5.5.3 to an Aptify 5.5.2 environment that has pre-existing scheduled views, you may need to follow additional steps to ensure duplicate Windows Tasks are not executed on your application server. See Note Concerning Duplicate Windows Tasks for Scheduled Views for more details. |
| Aptify 5.5.2 | Aptify 5.5.2 includes enhancements to the Aptify Async Processor so it is more robust when handling multi-threading issues. In addition, Aptify 5.5.2 creates a new Groups record named Application Servers. This group is used to secure entities and database objects that are intended only for application server processing. Starting with 5.5.2, the Aptify user accounts that are configured to run the Application Server service should be members of this group. To implement these changes, Aptify 5.5.2 includes an updated Aptify Asynchronous Processor. This requires that you apply an updated version of the AptifyAsyncProcessor.exe file to the Application Server. The updated AptifyAsyncProcessor.exe file is included in the Service Pack distribution package's Application Server Update folder. Note Concerning Duplicate Windows Tasks If you are applying Aptify 5.5.2 to an Aptify 5.5 environment that has pre-existing scheduled views (or you have not applied the changes to the Aptify Async Processor included with the 5.5.1 service pack), you will need to follow additional steps to ensure duplicate Windows Tasks are not executed on your application server. See Removing Duplicate Windows Tasks for Scheduled Views for more details. |
| Aptify 5.5.1 | There may be occasions when an organization wants to run more than one Aptify Application Server process on the same server. For example, an organization may want to use the same application server for their test and development environments. Therefore, starting with 5.5.1, Aptify supports running multiple instances of the Aptify Asynchronous Processor on the same server. To implement these changes, Aptify 5.5.1 includes an updated Aptify Asynchronous Processor. This requires that you apply an updated version of AptifyAsyncProcessor.exe to the Application Server. The updated AptifyAsyncProcessor.exe is included in the Service Pack distribution package's Application Server Update folder. Note If you want to install more than one instance of the Aptify Asynchronous Processor on the same server, additional steps are required. See Configuring Multiple Instances of the Aptify Asynchronous Processor for more details. Note If you are applying Aptify 5.5.1 to an environment that has pre-existing scheduled views, you will need to follow additional steps to ensure duplicate Windows Tasks are not executed on your application server. See Removing Duplicate Windows Tasks for Scheduled Views for more details. |
| Aptify 5.5 | With Aptify, when operating in a multi-threaded environment, such as the Aptify Application Server with multiple worker threads, some processes can report errors that are related to the simultaneous (or near simultaneous) access of some resources. Aptify has identified several areas that do not handle multi-threaded operations correctly and 5.0 Service Pack 1 updates those assemblies to resolve problems that can occur when more than one thread is accessing an object at the same time in the same process. These changes provide a more robust business layer when operating in a multi-threaded environment. To implement these changes, Aptify has also made an update to the Aptify Application Server for Aptify 5.0 Service Pack 1. This requires that you apply an updated version of AptifyAsyncProcessor.exe to the Application Server. The updated AptifyAsyncProcessor.exe is included in the Service Pack distribution package's Application Server Update folder. Note If the database server is already running Aptify 5.0 Service Pack 1 and you have already applied the updated version of the Aptify AsyncProcessor.exe to the Application Server, it is not necessary to re-apply after installing 5.5. |
Follow these steps to install the updated AptifyAsyncProcessor.exe on the Aptify Application Server:
- Install the Aptify update on your database server.
Install and configure the Application Server components on the application server. See Installing an Application Server and Configuring an Application Server for details.
Note
Aptify recommends that you run the Object Repository Synchronizer utility to update the Application Server's Aptify program files folder (typically C:\Program Files\Aptify 5.5 or 5.0) so it has the latest Aptify objects. See Updating the Object Repository for Application Server for more information.
- Locate the updated AptifyAsyncProcessor.exe file which is included the Aptify distribution file. The file is in the Application Server Update folder.
Copy the updated AptifyAsyncProcessor.exe file to a temporary location on the Application Server.
Note for those updating to Aptify 5.5.1 and up
If you are only planning to use one instance of the async processor, you do not need to copy the updated version of the AptifyAsyncProcessor.exe.config. However, if you plan to install more than one instance of the async processor, you will also need to copy the AptifyAsyncProcessor.exe.config file to the Application Server to configure all additional instances. See Configuring Multiple Instances of the Aptify Asynchronous Processor for more details.
- From the Windows Services dialog (Start > Control Panel > Administrative Tools > Services), stop the Aptify 5.0 Asynchronous Processor or Aptify 5.5 Asynchronous Processor service (depending on the original version of the application server).
Replace the existing AptifyAsyncProcessor.exe file in the Aptify program files folder (for example, C:\Program Files\Aptify 5.0) with the updated version included with the Aptify update.
Note for those updating to Aptify 5.5.3 and up
IIf you are running more than one instance of the Aptify Application Server, you will need to replace the AptifyAsyncProcessor.exe for all instances. See Configuring Multiple Instances of the Aptify Asynchronous Processor for more details.
- From the Windows Services dialog, restart the Aptify 5.0 Asynchronous Processor service.
Copyright © 2014-2017 Aptify - Confidential and Proprietary