WDF 1975033 - Run Multiple Instances of DI Proxy

WDF 1975033 - Run Multiple Instances of DI Proxy

Symptom

You would like to create multiple instances of DI Proxy for performance improvement. SAP strongly recommends:
  1. Using multiple instances of DIProxy service if you connect several SAP Business One company databases with the integration framework and/or Intercompany Integration solution, and the overall performance is slow, or the DIProxy service stops and restarts repeatedly
  2. Configuring separate DI Proxy for each level of Consolidation Company for optimal performance during the consolidation process with the Intercompany Integration solution
Multiple instances of DI Proxy are also required for using DI Proxy groups; check Note WDF 1993784 for information on how to deploy DI proxy groups. Using multiple DI proxy groups is indicated for better performance while replicating data across multiple SAP Business One companies, especially in the context of the Intercompany Integration solution.

Solution

To enable an additional instance of the DIProxy service, proceed as follows:

1. The default instance of DI Proxy uses port 2099, so you need to find another port which will be free/not blocked for the server on which DI Proxy will be installed (by default, it should be the same as for the Integration Framework service). In the example below, we are taking port 2098 to create a new instance of DIProxy.
2. To enable another configuration set for the second instance of DI Proxy, copy the DIProxy folder (C:\Program Files (x86)\SAP\SAP Business One Integration\DIProxy) and paste it inside (C:\Program Files (x86)\SAP\SAP Business One Integration\).
The system creates the DIProxy - Copy folder.
3. Rename the folder to DIProxy2098.
    In the ...\DIProxy2098 folder, open the service.ini file and change the following entries: 
    a. ServiceName = SAPB1iDIProxy2098 
    b. DisplayName = SAP Business One DI Proxy 2098 Service

4. In the ...\DIProxy2098 folder, open the diproxyserver.properties file. 
    Change the HTTPS_PORT parameter to 2098:
    a. HTTPS_PORT=2098 
5. Determine whether the default instance of DIProxy is using 32-bit or 64-bit. In the ...\DIProxy2098 folder, open the service.ini file; the 32-bit “JavaPath” would be for sapjre_32 and for the 64-bit it would be sapjre_64. 
6. Choose Start, right-click Command Prompt and choose Run as administrator. Enter “cd ...\DIProxy2098” to go to the installation folder of DIProxy2098 and press Enter.
     a. To run a 32-bit DIProxy: Run “service.exe -install”
     b. To run a 64-bit DIProxy: Check SAP Note 1955107 for a detailed description of the required settings and then run “service64.exe -install“
Note: For more instances, repeat the procedure above accordingly.

About Upgrading Integration Framework:

When you create additional instances with integration framework version 1.20.8 and lower:
  1. The upgrade program does not support multiple instances of DI Proxy. After the upgrade of integration framework, copy the *.jar files of the upgraded DIProxy folder to the same folders as for the other instances of DI Proxy.
  2. To enable the changes, stop and restart the additional instances.
As of integration framework version 1.20.9 and higher:
  1. The upgrade still does not exchange the JAR files; however, the procedure was changed to let the DI Proxy instances use only the files of the default instance (installed in the <installation folder>\DIProxy folder).
      This was achieved by changing the service.ini file: The path to *.jar files was changed, for example, from .\lib\ to ..\DIProxy\lib\.
      Thus, if you enabled additional instances with integration framework version 1.20.9 or higher, you no longer need to copy the *.jar files after an upgrade.
  1. However, you still have to stop and restart the additional instances.
Product
Product or Product Version
B1 INTERCOMPNY INTEGRATION 2.0
SAP B1 10.0 FOR SAP HANA
SAP B1 9.3 FOR SAP HANA
SAP BUSINESS ONE 10.0
SAP BUSINESS ONE 9.3

This document is referenced by :
WDF 1993784 - Multiple DI API connections for one company database