This blog article will discuss the steps you may find yourself having to perform to get a BES server to connect correctly to an OCS CWA server. As you may know, Blackberry telephony devices have been able to support a mobile Office Communicator for a while now – so IM and presence can be used on a Blackberry phone. (Get the bits here: http://na.blackberry.com/eng/services/server/exchange/ocs2007.jsp)
Windows Mobile devices have been using Communicator Mobile for quite some time. WinMobile clients use the Access Edge OCS server to communicate to the OCS pool, but Blackberry phones cannot use the Edge server infrastructure – they must connect via the RIM servers to the company BES server, which in turn looks to the CWA server to make the connection to the pool (or standard OCS server.) This article discusses the tasks and knowledge you may have to go through to successfully accomplish this.
Article Assumptions:
This article assumes several things –
- The OCS front end server is called OCS01
- The OCS CWA server is called OCSCWA. The CWA virtual server has been installed with both forms based authentication and Windows authentication during the install – this is shown below:
Figure 1 - Virtual Server Authentication
- The BES server is called BES01
- The CWA server has already had its virtual servers created on it via the OCS CWA wizard. The CWA server is working fine, and to prove it you should be successful at hitting this CWA web site by using both HTTP and HTTPS from a web browser. All certificates are properly placed on the CWA servers' web site for 443.
- All certificates are placed properly for the front end server – or pool servers.
- The BBIM Collaboration service has been successfully installed on the BES server. Configuration within the BBIM service will point to the CWA server and will use port 443. It is also assumed the name the BBIM service uses matches the name on the SSL certificate bound to the virtual server being used by the BES server.
As an example, the screen below shows a lab BES server with the Collaboration service configured to point to the CWA URL of: OCSCWA.Child.Contoso.Com over port 443 and using protocol HTTPS.
Figure 2 - BBIM Collaboration Service Configuration
Because documentation is a little weak in the area of BES and CWA configuration, you may not be aware of a text file you will want to modify on the BES server. The file – krb5.conf – is a text file located here:
C:\BlackBerry Enterprise Server\BBIM\Servers\BES01\config
You will want to modify the file in the following way – the # remark lines indicate to change the COMPANY.COM line to read the domain name to match the domain name the CWA server belongs to. In my example below, it's CHILD.CONTOSO.COM. Make sure you enter the text in all capital letters, as shown. Also, you will be required to provide in the text file the name of an Active Directory domain controller for the BES server to use. In my example, my server is called ADDC01. The default port used is 88.
It is important to note that RIM doesn't support – to my knowledge – a way to provide more than one KDC server or domain controller. So, in my example, if the DC called ADDC01 fails, the krb5.conf file has no other server to reference and the BES to CWA process will likely fail. RIM doesn't support adding two, three or more KDC servers to the text file.
Make sure you leave the { and } characters as they are on the lines they are on. Notice the ending } character is on a line by itself.
One other note, it has been shown that if the kdc = line containing your DCs name can contain either the host name or the FQDN. If you have problems with getting the BES server to connect successfully to the CWA server, you may want to replace the host name of the DC with the FQDN of the DC. In my example, my file contains the host name only of ADDC01, but if I wanted to I could enter the FQDN of ADDC01.CHILD.CONTOSO.COM. Note these are entered in all capital letters.
Figure 3 - krb5.conf File
Save and close the editor and restart the BBIM service which will use the realm and kdc server you specified in the krb5.conf file.
Verbose Logging Support
If you want to increase the logging during troubleshooting time, you will find a text file called rimpublic.property also in the same directory path as the krb5.conf file. To enable verbose logging, add the last two lines as shown below in my screen.
Figure 4 - rimpublic.property File
The last two lines to add are the following:
Logging.file.log.level=5
BBIM.logging.verbose=true
Save and close the editor and restart the BBIM service which will enable verbose logging.
The BBIM log files are stored in the following path by default: C:\Blackberry Enterprise Server\Logs\
The log files are contained in folders representing each day as shown in the example below.
Figure 5 - BES Log Files
Inside the folder of the day of interest, you will find several log files. The one specific to the BBIM collaboration service is named with the BES servers name, the BES service and the date of the log with an incremental to indicate the log of that day. For example, these are BBIM log files for 12/17/08:
BES01_BBIM_01_20081217_0001.txt
BES01_BBIM_01_20081217_0002.txt
BES01_BBIM_01_20081217_0003.txt
The BES01 is my BES servers name, the BBIM is the service, the 01_20081217 is the date of the logs, and the last four characters represent the specific log of 12/17.
Logon Syntax
The syntax used on the Blackberry phone devices can vary, but I've found different success using different syntax and I don't know why. The following examples will assist. Of course, the SIP URI for the user must be entered correctly. If you don't know this, check the OCS front end server OCS MMC for the user's SIP. You can also determine the SIP URI for the user by running Active Directory Users and Computers from the console of the OCS front end server as well.
SIP URI: mark_myers@contoso.com
AD User name: _myersm@child.contoso.com
or
SIP URI: mark_myers@contoso.com
AD User name: child.contoso.com\_myersm
or
SIP URI: mark_myers@contoso.com
AD User name: global\_myersm
I hope this article presents information to assist in getting your CWA server and your BES server to communicate properly.
Mark Myers
Senior Consultant
Project Leadership Associates
