Tuesday, April 1, 2008

Address Book Chaos

The following article will detail procedures for resolving common Address Book configuration issues.

  • Service Unavailable Issues
  • Address Book authentication issues
  • Address Book download errors

 

Service Unavailable Issue

Address Book access could be a direct result of a stopped IIS service on the ABS host.  Checking for a service outage is performed from a browser and IIS Manager console. 

Check that services are online:

  1. Open IIS Manger and navigate to the web site hosting "ABS" virtual directory.
  2. Check that the service for the web site is running.   If it is not then start up the web site and refresh to verify the service stays online.
  3. Next navigate to the "ABS" virtual directory, and open "Properties".
  4. Under the "Virtual Directory" tab, look to see which application pool the virtual directory is using. (Default is LSGroupExpAppPool)
  5. Click cancel to close the properties window
  6. Navigate to the "Application Pools" directory within IIS.
  7. Check the LSGroupExpAppPool (or whichever application pool was listed in step 4) and verify the service is running.  If it is not, open the Properties of the Application Pool and select the "Identity" tab.
  8. Verify that Configurable is selected and the Username and Password fields have values.  Common issue here is that the Username is populated; however the password field is blank.  This is usually a result of changed password for the service account listed. (Recommendation would be to make sure the service account listed is set within Active Directory as "Password Never Expires".
     AppPoolIdentity
  9. If the password is blank, enter the password for the account and start up the service.
  10. Verify service stays online. Even if the password is blank or incorrect the service may start however the next time the ABS service is accessed the application pools will disable itself.
  11. To test... Within IIS manager navigate to the ABS\ Int\Files directory and log down one of the address book service file names.  This filename will be appended to the URL entered in the following step.
  12. Open a browser and enter the URL to the address book server along with the full path the ABS file logged in the previous step.  Example:  Https://absserver.company.ad/abs/int/handler/F-0a2e3d.lsabs
  13. If the Identity configured above is correct and password is valid then you will get prompt for the downloading of the file.  It it was configured incorrectly you will receive the "Service Unavailable" page (listed below).LCSAppPool-disabled-ServiceUnav 
      

Address Book Authentication Issues

Authentication issues could range from multiple credential prompts for Address Book access, Synchronization errors, download failures, etc.  The following procedures have resolved majority of the Address Book issues I have encountered

Sample images of common ABS issues:

  • Multiple Credential Prompts (MOC)
    MOC-Prompt 
  • Synchronization errors (MOC)
    MOC-ABS-Error

ABSError

Note:  If you are experiencing Address Book issues ONLY on Windows VISTA machines and the XP or 2000 fine. Refer to my other article Address Book Download Issues (Vista machines).

Lets get started:

When starting Office Communicator, it will sign the user in but then present you with the following prompt to download the address book. Normally there is no prompt (Integrated Windows Authentication) and Communicator downloads the address book seamlessly.

When Office Communicator signs in it receives a referral from the OCS 2007 frontend to the address book URL.  The default is a HTTPS URL which requires a valid certificate assigned to IIS.  Before you begin troubleshooting, verify the Address Book URL that your clients are attempting to connect to.

Note:  This document focuses solely on resolving issues related to Internal Address Book service connection issues.  External connection issues to the Address Book service extend beyond this document, because many other factors can come into play (i.e. Reverse Proxy, Connectivity, Firewalls, etc.)

 

Check Internal Address Book URL and Output Location

Note:  This example is retrieving the address book url for an Enterprise Pool deployment.

  1. Open the Office Communication Server 2007 console and navigate the Enterprise Pool. You can see the address book URL  and share location in the status page for the pool .  Share Location is where the full and delta Address Book files are stored which MOC client downloads.
     ABSURL-Console
Address Book URL https://adhc-01.contoso.com/abs/int/handler

 

Verify permissions to the Address Book Files

Verify the security configuration of the UNC path specified.  Ensure that RTCUniversalGuestAccessGroup has the following permissions:

  • Share level: Read

  • NTFS level: Read & Execute, List Folder Contents, and Read.
  1. After verifying the permissions on the share, review the IIS settings for the virtual directory.  Below is an example of the structure for Abs.  The Files virtual directory should be referring to the UNC path in its properties. 
  2. After permissions are verified, run a query or lookup the membership to the RTCUniversalGuestAccessGroup. Log the membership to the group, as they will be referenced in the following section.

 

Verify the "Connect As" Account to the Address Book Files directory.

Ensure that we have set the correct account that will be used to access the UNC share in the virtual directory properties as in the example below.

  1. Referencing the same directory above "ABS\Int\Files", select Properties > Virtual Directory tab.
  2. Click the Connect As button. 
  3. Verify that the account listed is a member to the RTCUniversalGuestAccessGroup.  If another group was used in the previous section verify the "connect as" account is a member of that group.

 

Verify the Authentication Settings for the ABS Virtual Directory

Now that you have the actual location clients are attempting to access for Address Book downloads, open IIS manager and verify the Authentication Setting for that site.

  1. Open IIS Manager and navigate to the Web Site (ex. default website) hosting ABS virtual directory.
  2. Right click on the ABS virtual directory and select Properties.
  3. Click Directory Security tab and click Authentication and Access Control button.
  4. Check which authentication settings. (Internal ABS access would normally be set to Integrated Windows Authentication).  We are going to assume that Integrated Authentication is selected.  Continue to step 5.
  5. Integrated Windows Authentication will use Kerberos as the primary method of authentication, and in order for this to work the Service Principal Name (SPN) must be configured correctly for the url clients access otherwise authentication issues will exist. 

Check Service Principal Name (SPN) is registered correctly

To complete this test, you must have the Office Communication Server 2007 Resource kit is installed.  The tool used to check the SPN registration is the CheckSPN.vbs script. 

Kerberos authentication is not possible for services without properly set Service Principal Names (SPNs). SPNs are unique identifiers for services running on servers. Each service that uses Kerberos authentication needs to have an SPN set for it so that clients can identify the service on the network. It is registered in Active Directory under a user account as an attribute called Service-Principal-Name. The SPN is assigned to the account under which the service the SPN identifies is running. Any service can look up the SPN for another service. When a service wants to authenticate to another service, it uses that service’s SPN to differentiate it from other services running on that computer.

In general, only one SPN should be set for each service. Multiple SPNs can cause clients to connect to the wrong system or the ticket may be encrypted with the wrong key.

Note:  Common configuration problems are the use of a virtual FQDN listed for the certificate subject name (ex. ocspool.company.com) and/or SPN is registered with multiple user accounts.  Kerberos will choke when the name listed on the certificate is not an actual machine name within Active Directory and SPN is registered with multiple user accounts.

For this test you will first run the Checkspn.vbs tool against the name listed onthe ABS site's certificate subject name.

!!! The recommended configuration is one where the Subject Name on the certificate and the machine hosting ABS are one in the same.  Most common configuration no,no is to use the same certificate used for the enterprise pool.  This is a virtual machine name and kerberos will fail.

  1. Open a command prompt and navigate to where the CheckSPN.vbs file is located (default directory:  C:\Program Files\Microsoft Office Communications Server 2007\ResKit)
  2. Run the checkspn script:   /abs/int/handler">/abs/int/handler">/abs/int/handler">/abs/int/handler">/abs/int/handler">/abs/int/handler">/abs/int/handler">/abs/int/handler">http://<serverFQDN>/abs/int/handler 

    cscript checkspn.vbs /check /s:<serverFQDN>

    checkSPN
  3. Verify that you receive  "SUCCESS" results.  If you receive an error, reference the Office Communication Server 2007 Resource Kit Readme file for steps to resolve.  This document will be located within the same directory as Checkspn.vbs.  

In Addition to check modify SPNs you may have to use the SETSPN utility provide with the Windows 2Kx Support Tools.  For how to use this tool reference the following site(s).

Service Logon Failures due to incorrectly set SPNs: http://technet2.microsoft.com/windowsserver/en/library/579246c8-2e32-4282-bce7-3209d1ea8bf11033.mspx?mfr=true



Below is an example of an incorrectly registered SPN.  This error was generated because the name listed is a  virtual name and not an actual machine name registered in AD.  The following error was resolved by assigning the certificate Subject Name the name of the actual machine FQDN hosting ABS and changing the Address Book URL listed with OCS 2007 console.  To change Address Book URL location, proceed to the next section.

 checkSPN-err   

IMPORTANT!

Typically the ABS location, Meeting Content download location, and distribution list expansion virtual directories fall under the same Web Site, which in turn use the same certificate.  If for whatever reason the ABS URL Location is change, the meeting content download and distribution list expansion URL locations must also be modified to function properly. 

Change ABS URL Location(s)

Reasons for changing the ABS URL:

  • Resolving SPN issues
  • Moving ABS location to another server
  • Incorrect URL entered during installation of OCS 2007

Note:  ABS URL changes cannot be changed within the OCS console.  They have to be modified through WMI (wbemtest.exe).

  1. Logon to the Standard Edition or Enterprise Pool server with an account that is a member of the RTCUniversalServerAdmins group.
  2. From a command prompt run wbemtest.exe
  3. In the Windows Management Instrumentation tester window and click Connect
  4. In the Connect dialog box, in Namespace, type root\cimv2, and then click Connect
  5. In the Windows Management Instrumentation Tester dialog box, click Query button
    Enter the following query
    1. Standard Edition Server: In the Query dialog box, type the query, such as:

      Select * from MSFT_SIPAddressBookSetting where backend="(local)\\rtc"”
    2. Enterprise Pool: In the Query dialog box, type the query, such as:

      Select * from MSFT_SIPAddressBookSetting where backend = ”BackendServerName\\DatabaseInstanceName”. 
  6. In the query results box double-click the results.
  7. Select value you wish to edit. Example(ExternalURL), and then click Edit Property.
  8. In the Property Editor dialog box, click to select the NOT NULL option.
  9. In the Value box, type the external Web Farm URL in the following format, and then click Save Property and Save.
    https://externalURL.domain.com/abs/Ext/Handler
  10. Click Save Object and then click Close.
  11. Click Exit.

 
IMPORTANT!

If the Address Book URL has been changed you most likely will have to modify the Meeting Content Download URL, and Distribution List Expansion URLs.  To do this reference the following section.

 

Change WMI Setting for Meeting Content and Meeting Content Metadata folders

  1. Logon to the Standard Edition or Enterprise Pool server with an account that is a member of the RTCUniversalServerAdmins group
  2. From a command prompt run wbemtest.exe
  3. In the Windows Management Instrumentation tester window and click Connect.
  4. In the Connect dialog box, in Namespace, type root\cimv2, and then click Connect
  5. In the Windows Management Instrumentation Tester dialog box, click Query button.
  6. Enter the following query
    • Standard Edition Server: In the Query dialog box, type the query, such as:

      Select * from MSFT_SIPDataMCUCapabilitySetting where Backend = “(local)file://///rtc
    • Enterprise Pool: In the Query dialog box, type the query, such as:

      Select * from MSFT_SIPDataMCUCapabilitySetting where Backend = BackendServerName\\DatabaseInstanceName”.

      Example (If default instance): Select * from MSFT_SIPDataMCUCapabilitySetting where Backend = "SQLServer"
      Note: When entering the sql statement make sure to have a carriage return following the command.
  7. In the Query dialog box, click Apply.
  8. In the Query Result dialog box, double-click MSFT_SIPDataMCUCapabilitySetting
  9. In the Properties box select the property that you wish to change (i.e. MeetingMetadataLocation and MeetingContentLocation), edit the values and enter the correct UNC path and save property.
  10. Click Save Object, and then click Close.
  11. Click Exit

Change WMI Setting for Distribution List Expansion

  1. Logon to the Standard Edition or Enterprise Pool server with an account that is a member of the RTCUniversalServerAdmins group.
  2. From a command prompt run wbemtest.exe
  3. In the Windows Management Instrumentation tester window and click Connect
  4. In the Connect dialog box, in Namespace, type root\cimv2, and then click Connect
  5. In the Windows Management Instrumentation Tester dialog box, click Query button
  6. Enter the following query
    1. Standard Edition Server: In the Query dialog box, type the query, such as:

      Select * from MSFT_SIPGroupExpansionSetting where backend="(local)\\rtc"
    2. Enterprise Pool: In the Query dialog box, type the query, such as:

      Select * from MSFT_SIPGroupExpansionSetting where backend = BackendServerName\\DatabaseInstanceName”
  7. In the query results box double-click the results.
  8. Select value you wish to edit. Example(ExternalDLExpansionWebURL), and then click Edit Property.
  9. In the Property Editor dialog box, click to select the NOT NULL option.
  10. In the Value box, type the external Web Farm URL in the following format, and then click Save Property and Save. https://externalURL.domain.com/abs/Ext/Handler
  11. Click Save Object and then click Close.

No comments:

Post a Comment