From BR Wiki
Jump to navigation Jump to search

The BRListener.exe file is a C++ application which serves as the connection agent for Business Rules! Client Server installations.

GENERAL: You must be logged in as Administrator in order to run BRListenerInstaller.exe, or superuser/sudo on Linux.

Installation Procedure On Windows

  1. If your previous installation was done using InstallShield, you can remove it by using the Add/Remove Programs feature in the Control Panel. In this case, your BRConfig.sys and license file will not be removed. This is to make them available for subsequent use.
  2. The normal way to install BRlistener.exe no longer uses Installshield.
  3. Prepare your brlistener.conf file and place it in the Windows directory.
  4. Place either the 64 bit BRlistener.exe in the System32 directory or the 32 bit BRlistener.exe in the SysWOW64 directory.
  5. As administrator.. execute the corresponding 64 or 32 bit BRlistenerInstaller program with no parameters.
  6. if your brlistener.conf file specified a log file you should have listener startup messages in it that will confirm its status.

That's it. You're good to go.

Uninstall Procedure

  1. Run BRlistenerInstaller.exe /RELEASE
  2. Manually remove the brlistener.conf and BRlistener.exe files installed above.

Multiple Listeners

On rare occasions it is necessary to operate with 2 different versions of BRlistener.exe. In this case the following brlistener.conf statements will enable this capability. The listeners recognize a qualifying prefix on CONF file statements. This supports having different listeners active at the same time which permits testing in production client-server environments. The following brlistener.conf statements refer to BRlistener version numbers.

@release = 1.2        PORT=8555
@release = 2.0        PORT=8557

The full syntax for the Windows brlistenerinstaller is:

brlistenerinstaller [/RELEASE] [/ALTERNATE alternate] [brlistener-path]

[/RELEASE] removes the service in Windows. It does not remove any programs.

[/ALTERNATE alternate] uses an alternate service name. This will result in a service named BR_Listener-(alternate).

[brlistener-path] The default path is described above in step 4 above. This can be overridden with the brlistener-path parameter, and should be used to distinguish between the two BRlistener.exe files.

The second brlistener must be installed using the ALTERNATE keyword followed by a number. Under Linux this is handled by naming the listeners differently.

Multisession Mode

Multisession refers to the ease of accessing multiple sequential client server sessions. When MULTISESSION is specified in a brlistener.conf label definition, A client session ID is stored in the registry on the client side and associated with the user login name. This is maintained in memory by the BRlistener along with the user's login-name and password. The listener first checks the user's client session ID before prompting for login info.

[BRclient] communicates with [BRlistener] over TCP encrypted by TLS.