If you have a comment on this topic, contact Aptify Documentation. If you want to return to the Aptify Community Site, please click here.

Configuring Multiple Instances of the Aptify Asynchronous Processor

There may be occasions when an organization wants to run more than one Aptify Application Server process on the same computer. For example, an organization may want to use the same Application Server for their test and development environments.The multiple instances of the Aptify Asynchronous Processor can be run on the same computer.

Once the initial instance of the Application Server is installed and the version of Aptify Asynchronous Processor is copied over from the Aptify update, you can configure additional instances on the same computer as needed.

Note for those installing Aptify 6.0

If your Application Server was configured to run multiple instances of the Aptify Asynchronous Processor in a previous release, you do not have to perform the steps below after applying the updated version of the Aptify AsyncProcessor.exe file if the database server is already running the previous Aptify release and the Application Server is running the Aptify AsyncProcessor.exe file from the previous release. 


Follow the steps below to configure additional instances of the Aptify Asynchronous Processor on the same server.

  1. Create a second Aptify program files folder for the second instance on the application server.
    • This can be done by copying the contents and folder structure of the first instance (typically founds at: C:\Program Files\Aptify 6.0) to a new name and location (for example, C:\Program Files\Aptify Second Instance)
  2. If you have not already done so, copy the updated AptifyAsyncProcessor.exe and AptifyAsyncProcessor.exe.config files included the Aptify update distribution file. The files are located in the Application Server Update folder.
  3. Replace the existing AptifyAsyncProcessor.exe and AptifyAsyncProcessor.exe.config files in the second's instances Aptify program files folder with the new files.
  4. Open the AptifyAsyncProcessor.exe.config file and configure the new ServiceName and ServiceDisplayName attribute to provide a unique name and display name for the service on this application server.

    For example:

    <add key="Aptify.Framework.BusinessLogic.ProcessPipeline.AptifyAsyncProcessor.ServiceName" value="AptifyAsyncProcessorForSecondInstance"/>
    <add key="Aptify.Framework.BusinessLogic.ProcessPipeline.AptifyAsyncProcessor.ServiceDisplayName" value="Aptify Async Processor Second Instance"/>


    When adding an instance, at least one instance will need to have the ProcessUntargetedRuns setting in the AptifyAsyncProcessor.exe.config file updated (set to 1) to process runs that are not targeted at a specific Application Server. See About the Process Untargeted Runs Setting for more information. Users may also need to configure the additional attributes per the specifications in Modifying AptifyAsyncProcessor.exe.config.

  5. As a user with administrative rights, open a command prompt, navigate to following .NET Folder directory on your machine where InstallUtil.exe is located (generally it is located at C:\Windows\Microsoft.NET\Framework\v_number). Run the InstallUtil.exe utility against the second instance of the AptifyAsyncProcessor executable. Refer to the below command:

    C:\Windows\Microsoft.NET\Framework\ v4.0.30319{}InstallUtil.exe "FullPathtotheAptifyAsyncProcessorExecutable\AptifyAsyncProcessor.exe"

  6. From the Windows Services dialog, start the second instance of the Aptify Asynchronous Processor (as per the name specified in the AptifyAsyncProcessor.exe.config).
  7. Repeat above steps as needed to create additional instances of the Aptify Asynchronous Processor on the same server.


Copyright © 2014-2019 Aptify - Confidential and Proprietary