Help Center>Foundation Help

Applies to:

Installing Winshuttle SAP Integration Server 11.x 

1. Installing the Service Bus

Winshuttle SAP Integration Server uses RabbitMQ (an application messaging platform) as its queuing architecture, and RabbitMQ is built upon the Erlang OTP programming language. These components comprise the Service Bus for Winshuttle SAP Integration Server.

  1. Open the Winshuttle SAP Integration Server Installer, and then click Next.
  2. Accept the license agreement, and then click Next.
  3. Select Service Bus, and then click Next.
  4. To accept the default installation locations for the Service Bus (i.e Erlang and RabbitMQ), click Next. Or, click Change to change the destination path/folder, and then click Next
  5. Note: Erlang and RabbitMQ must be installed on the same machine and the same drive.

  6. Click Install.
  7. Note: If you are re-installing RabbitMQ and Erlang, you must completely uninstall them prior to re-installation. See Uninstalling RabbitMQ and Erlang OTP for more information.

Verifying the integrity of the Erlang cookie file

After installing Erlang OTP and RabbitMQ, you need to verify the integrity of the Erlang OTP cookie.

  • Erlang nodes use a cookie to determine whether or not they are allowed to communicate with each other. For two nodes to communicate, they must have the same cookie.
  • The cookie is a randomly generated string of alphanumeric characters.
  • Erlang automatically creates this cookie when the RabbitMQ server starts.

During installation of RabbitMQ, two cookie files are created. The default locations for these cookie files are:

  • %SystemRoot%\.erlang.cookie (for example: C:\Windows\.erlang.cookie)
  • %HOMEDRIVE%%HOMEPATH%\.erlang.cookie (for example: C:\Users\[username]\.erlang.cookie)

Sometimes (due to permissions or other reasons) these files are not the same.

If the cookie files are different, manually copy the file .erlang.cookie from %SystemRoot% to %HOMEDRIVE%%HOMEPATH%.