How do I reinstall or re-register the RepliGo Server BES Extension?

The RepliGo Server BES Extension plays a vital role in allowing users to view email attachments. It consists of a single DLL which is typically located at C:\Program Files\RepliGo Server\CerBESExt.dll. This DLL must be installed and registered with BES in order for attachment viewing to function properly. If your users are not able to open attachments with RepliGo, then this may be a sign that the DLL is not functioning properly.

Please note that RepliGo is not able to open attachments that arrived on the handset prior to RepliGo Server being installed. This is normal behavior, so you should make sure that any tests you perform are with brand new email messages and attachments.

Registration of the extension DLL happens automatically when you install RepliGo Server on your BES. Sometimes the DLL does not get loaded properly or registration information gets lost. The most common cause is forgetting to restart your BES Controller or Domino Server following installation. The second most common cause is performing a BES upgrade of some type.

The first thing you should check for is the existence of C:\Program Files\RepliGo Server\CerBESExt.dll on your BES. If you have this file, then you should look for a file called C:\Program Files\RepliGo Server\CerBESExt_log.txt, which is the extension’s log file. If this file does not exist or is not showing any recent activity, then there is a problem.

If you have just finished installing RepliGo Server for the very first time, you should make sure you have restarted your BlackBerry Controller or Domino Server. You do not have to reboot your Windows Server to do this. Just restart the appropriate service or server. This operation allows the extension DLL to be loaded into your BES and start functioning. Again, your CerBESExt_log.txt file will show activity if the DLL is functioning. You should also open this log file and look for any lines that contain warnings.

If your RepliGo Server was functioning properly and has suddenly stopped working, then you may need to reinstall or re-register the extension DLL. There are two options here. If you have installed RepliGo Server on a separate machine from your BES, then you can safely uninstall and reinstall the extension on your BES. Since you are only reinstalling the DLL on your BES, your separate installation of RepliGo Server will remain untouched and you will not lose any existing user information.

The second option involves a manual re-registration of the DLL’s registry entries. This is the best option if you have installed RepliGo Server directly and fully on a single BES machine. By manually re-registering the DLL, you will avoid an uninstall/reinstall scenario which would wipe out your existing RepliGo Server user information. Here’s how to perform a manual registration:

1. On your BES machine, get to a DOS command prompt and change to the RepliGo Server folder. (e.g., “C:\Program Files\RepliGo Server”). Here you should find a DLL named CerBESExt.dll.
2. From the command line, type “regsvr32 CerBESExt.dll“. This will register the BES extension into the registry.
3. Run regedit and get to the HKEY_LOCAL_MACHINE\SOFTWARE\Research In Motion\BlackBerry Enterprise Server\Agents\Plugins\CerBESExt key. Change the “Server” key to the hostname and port of RepliGo Server. For example, change it from “localhost:4080″ to “repligoserverhostname:4080″ where you substitute the host name for your machine where it says “repligoserverhostname”.
4. THIS STEP IS FOR BES 3.X ONLY AND IS NOT NECESSARY FOR BES 4.X. Add the following key to HKEY_LOCAL_MACHINE\SOFTWARE\Research In Motion\BlackBerry Enterprise Server\Servers\XX\Plugins\CerBESExt and assign a string value that is the full path to CerBESExt.dll, where XX is the name of the BES server.
5. Now restart the BES Controller Service if you are running on Exchange or GroupWise. For Domino, you will need to restart your Domino Server.