Article ID: 907792 - Last Review: April 4, 2008 - Revision: 2.0

Description of the Offline Address Book Integrity (OABInteg) tool

View products that this article applies to.
System TipThis article applies to a different operating system than the one you are using. Article content that may not be relevant to you is disabled.
Expand all | Collapse all

INTRODUCTION

This article describes the Offline Address Book Integrity (OABInteg) tool. The OABInteg tool was developed as a Lightweight Directory Access Protocol (LDAP) client and a MAPI client. Additionally, the OABInteg tool can simulate the logon process of a Microsoft Outlook client to download offline address book (.oab) files.

The OABInteg tool can connect to the public folder store and read the contents and properties of .oab files and folders. Additionally, the OABInteg tool can scan for Active Directory-related problems that cause the .oab file generation process to fail on a server that is running Microsoft Exchange 2000 Server or Microsoft Exchange Server 2003.

The OABInteg tool simulates the following:
  • The .oab file generation process that a Microsoft Outlook client uses to connect to the public folder store to download .oab files
  • The .oab file generation process that connects to the public folder store to rebuild .oab files

MORE INFORMATION

The Microsoft Exchange System Attendant is responsible for invoking OABGen.dll so that address lists can be built or rebuilt. OABGen.dll is a MAPI application that reads from Active Directory through Name Service Provider Interface (NSPI) calls.

A healthy and correctly configured Active Directory is required for successful offline address book generation.

Active Directory-related issues, such as replication problems, latency, and stale information, can frequently cause the .oab file generation process to fail. The OABInteg tool can scan Active Directory for these types of issues.

The following is the description of the usage and optional commands of the Offline Address Book Integrity (OABInteg) tool.

Usage: OABInteg.exe [/s:servername] [/t:testname] [/l] (enable file logging) [/v: 1,2 or 3] (1 = minimum | 2 = maximum logging | 3 = ErrorsOnlyLogging
Optional Commands [/d:OUSearchDN] [/p:# - Page Size] [/U:UserName] [/P:Password] [/r:Alias]

[/l] Logging output will go to c:\OABInteg.txt
[/v] Logging output will go to the screen. - Default logging is general - /v:1 for minimum | /v:2 for maximum logging. | /v:3 for ErrorsOnlyLogging (Proxytest only)
[/p:] Active Directory search page size. Default size is 64 and maximum is 512.
[/dn:] LDAP test only!! <Example: OU=Managers,DC=OrgName,DC=local>

Note If you do not specify a search /dn: a base query of DC=OrgName,DC=local is used.

[/U:] Username. If you will connect, use different credentials or connect to a different domain.
[/P:] Password. If you will connect, use different credentials or connect to a different domain.
[/r:] Alias. If you want to return one object from the global address list (GAL) for any MAPI test, use this command.

Active Directory Tests
Collapse this tableExpand this table
Test nameDescription
[storealtest]Validate if the information stores point to an Address list.
[altest]Finds all address lists in the organization.
[oaltest]Finds all offline address lists in the organization.
[abrtest]Finds the addressBookroots properties.
[rdntest]Scan for all legacyExchangeDNs that have a final RDN that is greater than 64 characters.
[templatetest]Scans Active Directory for any orphaned display templates.
[alltests]Runs all the LDAP tests | [-storealtest][-altest][-oaltest][-abrtest][-rdntest][-t emplatetest].
MAPI Tests
Collapse this tableExpand this table
Test nameDescription
[proxytest] - Scan for users who will be skipped during the oabgen process. <Checks for invalid legacy Dn's also>
[oabfldcheck] Log on to the public information store and check the OAB system folders, messages, and attachments.
[getabinfo_v2] Open the default address book for a selected profile and dump all entries using OAB V2 props.
[getabinfo_v3] Open the default address book for a selected profile and dump all entries using OAB V3a props.
[getabinfo_v4] Open the default address book for a selected profile and dump all entries using OAB V4 props.
[hierarchylist] Log on to the public information store and get the OAB Hierarchy list information. [dumpPDNtable] - Uses a MAPI profile to connect to the Active Directory and creates a PDN table.
[oabsizer_v3] Calculates the size for GAL objects using the oab_v3a properties.
[oabsizer_v4]- Calculates the size for GAL objects using the oab_v4 properties.
Registry Tests
Collapse this tableExpand this table
Test nameDescription
[getoabseqnum] - Check all user profiles and find the last downloaded OAB sequence number.
Mapi File Tests
Collapse this tableExpand this table
Test nameDescription
[scanmapisvc] - Scan the mapisvc.inf file for invalid values.
NOTES
Collapse this tableExpand this table
Test nameDescription
[proxytest] Run using an Online profile from the exchange server or client.
[oabfldcheck] Can be run (1. on the exchange server or 2. from a client.)
[hierarchylist] MUST be run against an exchange server from (1. on the exchange server or 2. From a client.)
[getabinfo_v2] Can be run (1. on the exchange server or 2. from a client.)
[getabinfo_v3] Can be run (1. on the exchange server or 2. from a client.)
[getabinfo_v4] Can be run (1. on the exchange server or 2. from a client.)
[oabsizer_v3] Can be run (1. on the exchange server or 2. from a client.)
[oabsizer_v4] Can be run (1. on the exchange server or 2. from a client.)
[getoabseqnum] MUST be run on the outlook client. This test reads from the registry.
[scanmapisvc] MUST be run on the outlook client. This test reads from the registry and profile.
[dumpPDNtable] Used a profile to connect to the active directory and creates a PDN table.
[storealtest][altest][oaltest][abrtest][rdntest][templatetest] & [alltests] - MUST be ran against a global catalog server.
For more information about the OABInteg tool, see the Web version of the OABInteg User's Guide (OABInteg-UserGuide.doc). To do this, visit the following Web site:
http://blogs.msdn.com/dgoldman/archive/2005/08/28/oabinteg-and-how-to-use-it-to-troubleshoot-oab-generation-issues.aspx (http://blogs.msdn.com/dgoldman/archive/2005/08/28/oabinteg-and-how-to-use-it-to-troubleshoot-oab-generation-issues.aspx)
To download OABInteg, visit the following Web site:
http://code.msdn.microsoft.com/oabinteg/Release/ProjectReleases.aspx?ReleaseId=726 (http://code.msdn.microsoft.com/oabinteg/Release/ProjectReleases.aspx?ReleaseId=726)
APPLIES TO
  • Microsoft Exchange Server 2003 Standard Edition
  • Microsoft Exchange Server 2003 Enterprise Edition
  • Microsoft Exchange 2000 Server Standard Edition
  • Microsoft Exchange 2000 Enterprise Server
Back to the top
Keywords: 
kbhowto KB907792