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, The multiple instances of the Aptify Asynchronous Processor can be run on the same computer.
...
| Note | ||
|---|---|---|
| ||
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. For example, if an Application Server was configured to run multiple instances of the Aptify Asynchronous Processor in 5.5.2, the steps below do not have to be performed when updating to Aptify 5.5.3 update if the 5.5.3 version of the Aptify AsyncProcessor.exe file has already been applied, and the database server is running 5.5.2. |
Follow the steps below to configure additional instances of the Aptify Asynchronous Processor on the same server.
- 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 56.0 or 5.5) to a new name and location (for example, C:\Program Files\Aptify Second Instance)
- This can be done by copying the contents and folder structure of the first instance (typically founds at: C:\Program Files\Aptify 56.0 or 5.5) to a new name and location (for example, C:\Program Files\Aptify Second Instance)
- 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.
- Replace the existing AptifyAsyncProcessor.exe and AptifyAsyncProcessor.exe.config files in the second's instances Aptify program files folder with the new files.
Open the AptifyAsyncProcessor.exe.config file and configure the new ServiceName and ServiceDisplayName attributes attribute to provide a unique name and display name for the service on this application server.
For example:No Format nopanel true <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 title 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.
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:
No Format nopanel true C:\Windows\Microsoft.NET\Framework\ v4.0.30319{}InstallUtil.exe "FullPathtotheAptifyAsyncProcessorExecutable\AptifyAsyncProcessor.exe"- From the Windows Services dialog, start the second instance of the Aptify Asynchronous Processor (as per the name specified in the AptifyAsyncProcessor.exe.config).
- Repeat above steps as needed to create additional instances of the Aptify Asynchronous Processor on the same server.
...