Installing Multiple BrightServer Instances

BrightServer instances running on the same machine must have the following properties:

Therefore, when installing BrightServer on a machine with an instance already installed, please perform the following steps:

  1. Locate the Enterprise Edition 32/64 Bit Self Extracting Zip file for BrightServer on the Downloads page of the BrightXpress website. Unzip this file to a different location to existing BrightServer instances.

  2. In the installation folder, open the service directory.

  3. Open the wrapper.conf file for editing, located in the 'service' directory. This file contains the parameters for installing and running BrightServer as a Windows service.

  4. At the start of the file, under the 'Application Parameters' section, add the following line, or similar, such that the server will start on separate ports:

    wrapper.app.parameter.7=--http 8081 --https 8443 --tracer 12922

  5. *In the above example, the ports configured are 8081, 8443 and 12922 for HTTP, HTTPS and remote tracing ports respectively.

  6. Near the end of the file, find the wrapper.ntservice.name property and change the name to something that will identify the service, such as “BrightServer <Version No>”. Optionally, it is also recommended to edit wrapper.ntservice.displayname and wrapper.ntservice.description in this section. For example:

    # Name of the service

    wrapper.ntservice.name=BrightServer 8

     

    # Display name of the service

    wrapper.ntservice.displayname=BrightServer 8

     

    # Description of the service

    wrapper.ntservice.description=BrightServer(TM) Mobile Data Gateway (Version 8)

  7. Now return to the service directory and run InstallBrightServerService.bat.  This will use the parameters in wrapper.conf that you just edited.

  8. Go to Windows Services and verify that the new Windows service is now installed with names specified above.

  9. Start the newly installed service. It will run on the ports specified in the wrapper.conf file.

  10. Repeat this process for each additional instance that you want to run on the same machine.

Please note that the line configuring ports in step 4 will force these ports for BrightServer every time the server starts. It is thus advised to remove this line after installing BrightServer successfully.