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. As of Aptify 5.5.1, 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.

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 5.0 or 5.5) 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 attributes 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"/>

   Note

   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.