OCAT – Microsoft Outlook Configuration Analyzer Tool 2.0 agora é OffCAT–Office Configuration Analyzer Tool

OffCAT

Há algum tempo, publiquei um post sobre o OCAT. Lembram dele? Pois é…  Hoje venho informar que a ferramenta foi substituída pelo OffCAT – Office Configuration Analyzer Tool. Administradores de TI que implantam e gerenciam ambientes de mensageria com Outlook podem, agora, ter a mão uma ferramenta mais completa e usar isso a seu favor pois agora ela passa a dar suporte para Access, Excel, PowerPoint e Word também.

image

Imagem 1.1 Ao pesquisar no Microsoft Download Center pela ferramenta OCAT é informado sobre a substituição.

O Office Configuration Analyzer Tool fornece um método rápido e fácil para analisar vários programas do Microsoft Office para configurações comuns que podem causar problemas. Isso pode ser muito útil para a equipes de Help Desk quando os usuários finais pedem ajuda com programas do Office, ou quando você deseja identificar de forma preventiva possíveis problemas.

O bacana é que ele já é compatível com a versão 2013 do Office. O programa não precisa de instalação. Basta extraí-lo em uma pasta de seu HD e inicia-lo. Dentro dele, você pode escolher cada programa da suíte de aplicativos e realizar um escaneamento. O Office Configuration Analyzer, então retorna resultados do que existe de errado ou está causandoalgum tipo de problema no programa especificado.

A ferramenta OffCAT foi desenvolvida por uma equipe de engenheiros de suporte da Microsoft com uma experiência combinada de mais de 30 anos de suporte para Microsoft Office, Microsoft Outlook e Microsoft Exchange Server. Com base na experiência de suporte e ao Microsoft Office, um conjunto de regras de detecção foram compiladas para configurações de programas do Office que, ao longo de um período de feedbacks recolhidos, apontam-se como possíveis fontes de problemas.

Com OffCAT, você pode executar as seguintes ações para ajudá-lo a detectar possíveis problemas com os programas do Office:

• Varredura de configurações de um programa do Office
• Abrir uma varredura de OffCAT (ou OCAT) executada anteriormente no seu computador
• Importar uma varredura de OffCAT (ou OCAT) de outro computador
• Usar vários formatos de relatórios para exibir os resultados da verificação
• Enviar feedback para a equipe do OffCAT
• Atualizar sua instalação OffCAT com novas regras de detecção
• Atualizar sua instalação OffCAT com novos recursos ou correções de aplicativos
• Acessar recursos para ajudar a resolver problemas refernte à ambiente de Office 365
• Iniciar a ferramenta Microsoft Exchange Connectivity Analyzer Tool para analisar problemas de conexão do Outlook
• Varredura de computadores usando um script que executa uma versão de linha de comando do OffCAT

Não preciso nem dizer que o OffCAT é uma ferramenta extremamente útil à administradores de Office 365. Gostaria de reproduzir aqui informações detalhadas sobre o ReadMe do OffCAT:

Key Features included in OffCAT

All of the original features included in OCAT are also found in OffCAT. We have also added new features to OffCAT to improve its usability and reliability (compared to OCAT).

Here are the key features included in OffCAT:

· Scanning for Access, Excel, Outlook, PowerPoint, and Word

In OffCAT v1, you can scan individual Office programs — if installed on your computer. If you have multiple versions of Office installed on the same computer, you will be prompted to select the version of the program you want to scan.

Note: Support for scanning other Office programs is planned for a future version of OffCAT.

· Automatic downloading of new detection rules

As we create new rules to detect issues or to collect additional information about your Office program configurations, we will post a new updated rule file to the Internet. With the default OffCAT configuration, OffCAT will automatically check for a new rule file and provide a mechanism to update OffCAT if a new file is found.

Please see the Automatically update OffCAT with new detection rules or application files section of this document for additional details.

· Automatic downloading of OffCAT installation files

As we update and fix the core OffCAT application, we will post a new Windows Installer package file (.Msi) to the Internet. With the default OffCAT configuration, OffCAT will automatically check for a new installer file and provide a mechanism to update OffCAT if a new file is found.

Please see the Automatically update OffCAT with new detection rules or application files section of this document for additional details.

· “Installation” using files in a .zip file from the Microsoft Download site

You must be a local administrator in order to install OffCAT using the .msi file from the Microsoft Download site. If you are not a local administrator on your computer, you can instead download the OffCAT.zip file from the Microsoft Download site and then extract the files into a folder on your computer. Then, you can simply run OffCAT using OffCAT.exe in this folder.

· Inclusion of the CalCheck tool

The Calendar Checking Tool (CalCheck) for Outlook is a command-line program that checks Outlook Calendars for problems. This tool is included in OffCAT to scan for and report on any known problems with items on your primary Calendar. It is only used if you scan Outlook with the OffCAT tool.

Please see the following article in the Microsoft Knowledge Base for additional information about the CalCheck tool.

2678030 Information about the Calendar Checking Tool for Outlook (CalCheck)
http://support.microsoft.com/kb/2678030/EN-US

· Over 300 detection rules

At last count, there were over 230 different detection rules for Outlook in the OCAT tool. All of these rules are included in OffCAT, plus at least 20 new rules for Outlook. As the OffCAT tool is not only focused on Outlook, there are an additional 70+ rules for other Office programs.

· Command-line version of OffCATcmd.exe

Included in the installation of OffCAT is a command-line version of OffCAT (OffCATcmd.exe). Administrators can use it to scan computers in their organization and upload the resulting scan report to a network share. Please see the Generating a Scan using the Command-line version of OffCAT section of this article for details.

· Office 365 resources

To help Office 365 customers with Outlook problems, we included a link on the Start an Outlook Scan page to a KB article that provides a list of resources to help with top issues and how-to problems in Office 365. We also have detection rules specific to Office 365 issues.

· Modern user interface

The colors, fonts, and icons in OffCAT mirror those seen in Windows 8. While we developed OffCAT, we received positive comments about the new interface. We hope you like it too.

· Group policy support

The Microsoft Download site also includes a group policy template (Offcatv1.adm) that you can use to administer some of the user settings in OffCAT.

Please see the How to administer OffCAT settings using group policy section of this document for complete details.

Support for OffCAT

There is no available support for OffCAT. This tool is provided as-is.

If you encounter any problems when you use OffCAT, you can send a detailed email message to OffCATsupp@microsoft.com. We appreciate your feedback; however, we cannot reply to your email message. We will review your feedback and determine whether any changes or issues can be incorporated or fixed in a later version of OffCAT.

However, before sending email to the OffCAT team, please review the Current Issues/FAQ section of the following article in the Microsoft Knowledge Base:

2812744 Office Configuration Analyzer Tool (OffCAT) information
http://support.microsoft.com/kb/2812744

This article is updated frequently with new issues as they are discovered, and workarounds are provided when available.

Periodically, OffCAT will be updated to include new detections rules and new features. You can follow the OffCAT team on Twitter to receive news of any publicly available OffCAT updates.

How to install OffCAT

There are two methods for getting OffCAT onto your computer.

· Installation using a .msi file

· File extraction from a .zip file

We recommend using the .msi file to install OffCAT, but if you are not a local administrator on your computer, you can use the .zip file from the Download site to extract the files into a folder on your computer.

System requirements for using OffCAT

Before you install or use OffCAT, make sure that your computer meets the following system requirements.

· Supported operating systems:

o Windows 8

o Windows 7

o Windows Vista Service Pack 2

o Windows XP Service Pack 3

· This download works with the following Microsoft Office programs:

o Microsoft Office 2013 (32-bit or 64-bit) (Click-to-run or msi installs)

o Microsoft Outlook 2010 (32-bit or 64-bit)

o Microsoft Office Outlook 2007

o Microsoft Office Outlook 2003 (Offline Scans only)

· The following minimum version of the Microsoft .NET Framework is required:

o Microsoft .NET Framework Version 2.0

If you do not have the required version of .NET Framework installed, your experience depends on whether you are trying to install OffCAT using the OffCAT.msi file or you are launching OffCAT.exe from the OffCAT.zip file you downloaded.

OffCAT.msi experience

If you are installing OffCAT using the OffCAT.msi file, the Setup program prompts you to install the Microsoft .NET Framework version 2.0 if it is not already installed.

1

If you click Yes, you are directed to the download page for Microsoft .NET Framework 2.0 Service Pack2 on the the Microsoft Download Center.

http://www.microsoft.com/en-us/download/details.aspx?id=1639

2

Tip: There are three downloads available. Please make sure to install the one that matches the bitness of your Windows installation. For example, if you are using a 32-bit version of Windows, then you should install NetFx20SP2_x86.exe.

OffCAT.zip experience

If you added OffCAT to your computer using the OffCAT.zip file from the Microsoft Download site, you will see the following alerts (depending on your version of Windows).

On Windows 8

3

Click Install this feature to install .NET Framework 3.5 and then try to start OffCAT again.

On Windows 7, Windows Vista, or Windows XP

If you have a version of Windows that is earlier than Window 8, you will receive an error indicating you need to install .NET Framework. For example, the following error is shown on Windows 7 when you start OffCAT without the required version of .NET Framework installed.

4

To install the required version of .NET Framework, please use one of the following methods:

On Windows 7

1. Open Control Panel.

2. Click Programs and Features.

3. In the left panel, click Turn Windows features on or off.

4. In the Windows Features dialog box, select Microsoft .NET Framework 3.5.1, and then click OK.

On Windows Vista or Windows XP

To install the required version of .NET Framework, use the following steps.

1. Click the following link.

http://www.microsoft.com/en-us/download/details.aspx?id=1639

2. Then, on the Service Pack 2 for .NET Framework 2.0 page, click Download for the file that matches the bitness of your Windows installation.

For example, if you are using a 32-bit version of Windows, then you should install NetFx20SP2_x86.exe.

5

After the system requirements for the .NET Framework are met, you can install the Office Configuration Analyzer Tool.

· The .NET Programmability Support feature of Office is also required to be installed.

If you do not have the .NET Programmability Support feature installed as part of your Office installation, you will receive the following error when you start a scan for Outlook:

6

Please use the following steps to add the .NET Programmability Support feature to your Office installation.

Windows 8, Windows 7 and Windows Vista

1. Exit Outlook.

2. Open Control Panel.

3. In Control Panel, click Programs.

4. Then, click Programs and Features.

5. In the list of installed products, select your Microsoft Office product and then click Change.

6. When prompted, select Add or Remove Features and then click Continue.

7. In the Installation Options feature tree, expand the node for Microsoft Outlook.

8. Click the icon next to .NET Programmability Support and then select Run from My Computer, and then click Continue. This setting is shown in the following figure.

a

9. Click Close when the installation update is finished.

Windows XP

1. On the Start menu, point to Settings, and then click Control Panel.

2. Double-click Add/Remove Programs.

3. In the list of currently installed programs, select your Microsoft Office product, and then click Change.

4. When prompted, select Add or Remove Features and then click Continue.

5. In the Installation Options feature tree, expand the node for Microsoft Outlook.

6. Click the icon next to .NET Programmability Support (shown in the above figure) and then select Run from My Computer, and then click Continue.

7. Click Close when the installation update is finished.

OffCAT setup

As mentioned earlier, there are two ways to get OffCAT onto your computer using the files available on the Microsoft Download site.

Installing OffCAT using the OffCAT.msi file

NOTE 1: OffCAT is the replacement tool for OCAT. If you have OCAT installed on your computer, it will be uninstalled automatically when you install OffCAT.

1. To start the installation of OffCAT, locate the following file you saved from the Download site to your hard disk.

OffCAT.msi

2. Double-click OffCAT.msi.

3. On the Welcome page for the Setup wizard, click Next.

7

4. If you agree with the license terms for OffCAT, click to select I Agree, and then click Next.

8

5. Select the installation folder for OffCAT, and then click Next.

9

6. Click Next to start the OffCAT installation.

10

7. Click Close when the installation is finished.

11

Using the OffCAT.zip file to “install” OffCAT

The Microsoft Download site also includes a download for OffCAT.zip.

Because the Setup process included in OffCAT.msi runs several important requirement checks, we recommend using the OffCAT.msi file to install OffCAT. But, if you are not a local administrator on your computer, you can use the .zip file to extract the files into any folder on your computer.

Upgrading from OCAT

This section of the document discusses the user experience with OffCAT if there is an existing installation of the OCAT tool. Your OffCAT experience will vary (slightly) depending on how you put OffCAT onto your computer.

Tip: If you do not have OCAT installed, you can skip this section and move on to the How to start OffCAT section.

Msi installs of OffCAT

When you install OffCAT using the OffCAT.msi file from the Microsoft Download center, OCAT is automatically uninstalled if it is currently installed on your computer. OffCAT is the replacement tool for OCAT. All detection rules originally found in OCAT are included in OffCAT. Because all new rules for Outlook will only be integrated into OffCAT, you should now use OffCAT instead of OCAT.

Even though OCAT is uninstalled by the OffCAT installation, you can still view all of your previous OCAT scans in OffCAT. If the OCAT scans do not appear in OffCAT, just import them into OffCAT.

Reminder: By default, OCAT saves its scan report as an xml file in the following folder:

%AppData%\Microsoft\OffCAT

This equates to the following folder, based on the Windows version:

In Windows 8, Windows 7 and in Windows Vista

C:\Users\<username>\AppData\Roaming\Microsoft\OCAT

In Windows XP

C:\Documents and Settings\<username>\Application Data\Microsoft\OCAT

First launch of OffCAT using the contents of the .zip download

If you put OffCAT onto your computer by extracting the files in OffCAT.zip from the Microsoft Download center, you will first receive a prompt to accept the End-User License Agreement.

12

If you accept the license agreement, OffCAT will start. If you do not accept the license agreement, OffCAT will exit.

You will then receive a prompt to uninstall OCAT (if installed) any time you launch OffCAT. This prompt is shown in the following figure.

13

We recommend you click Yes so that OCAT is uninstalled and this prompt is never displayed again.

OffCAT is the replacement tool for OCAT. All detection rules originally found in OCAT are included in OffCAT. Because all new rules for Outlook will only be integrated into OffCAT, you should now use OffCAT instead of OCAT.

How to start OffCAT

To start the Office Configuration Analyzer Tool, click the Start menu (Windows 7 and earlier) or Start screen (Windows 8), and then click the OffCAT 1.0 icon.

· Windows 7 or earlier

14

If you do not see the OffCAT 1.0 icon on the Start menu, look for the icon on your All Programs menu under Microsoft Office Configuration Analyzer Tool.

15

· Windows 8 Start screen

16

If you cannot locate the shortcut for OffCAT, you can also start OffCAT by using the OffCAT executable file (OffCAT.exe). The following figure shows this file in the default installation location on a 32-bit version of Windows 7.

17

How to generate an OffCAT report

Once you have started OffCAT, use the following steps to generate an OffCAT report for an Office program:

1. In the left panel, click Start a scan to generate a report for an Office program.

18

2. From the list of detected Office programs, select the Office program to scan.

19

Note: If you are going to scan Outlook, it should be running before you start an OffCAT scan.

If Outlook is not running when you start a scan, OffCAT displays the following notification.

Outlook is not running.

Please start Outlook and click here when done, or choose Offline Scan in the Task drop-down list.

An example of this notification is shown in the following figure.

20

Note If you are using Outlook 2003, the following warning is displayed when you start a scan:

Offline scan is enforced. Full scan is not supported with versions earlier than Outlook 2007.

This warning is shown in the following figure.

21

Please see the How to generate an offline scan report section of this document for details on performing an offline scan.

3. In the Enter the scan label box, enter a name for your scan.

22

4. If you have more than one version of Office installed, also select the version of the Office program you want scanned.

23

The following figure indicates both Office 2010 and Office 2013 are installed.

5. After you have selected the Office program and version of the program to be scanned, click Start scanning.

24

6. For an online scan of Outlook, you may receive the following prompt to allow OffCAT to access information that is stored in Outlook. To allow this access, click to select Allow access for, specify 1 minute, and then click Allow.

25

Note: This warning may not automatically take focus. To display this warning, click the Outlook icon on the Task bar.

7. After the scan is complete, click View a report of this configuration scan to display the report that is generated by OffCAT.

26

How to specify Active Directory Domain Services credentials for Outlook scans

Tip: You can skip this section if you are not scanning Outlook, or you are logged into the same domain as the mailbox you are scanning with OffCAT.

Some information that OffCAT collects during an Outlook scan is maintained in the Active Directory Domain Services (AD DS) environment. If your computer is not joined to the same AD DS domain as your Exchange mailbox, OffCAT cannot use the default scan configuration to retrieve this information. In this case, your report will contain information that resembles the following.

27

In this scenario, you can add your mailbox credentials in OffCAT so all available information can be retrieved from the AD DS environment. To provide your mailbox domain credentials in OffCAT, follow these steps:

1. On the Start an Outlook Scan page, click Show Credentials for Active Directory Logon.

28

2. Click to select the Enable credentials when mailbox account does not match Windows account check box, and then enter your mailbox domain credentials.

29

3. Click Start scanning.

Be aware that, even when you specify your domain credentials by using these steps, you will probably still see an error in the scan results that indicates that you do not have access to a writeable global catalog server. This is expected in this configuration.

30

How to generate an offline scan report for Outlook

Tip: Always perform a Full Scan for Outlook unless you, for example, Outlook is crashing when it starts.

If you cannot keep Outlook running long enough to start a scan, you can still perform a basic (Offline) scan. To do this, in the Task drop-down list, select Offline Scan, and then click Start scanning.

31

The report that an offline scan generates contains only information that is available on your computer, such as registry data, Application log details, a list of installed updates, and local file details.

Although an offline scan does not contain as many profile details as an online scan, an offline scan may provide enough information to help you resolve any problems that you are experiencing with Outlook.

Note: if you have more than one version of Outlook installed on the computer where you are running OffCAT, you cannot perform an Offline scan.

32

Generating a Scan using the Command-line version of OffCAT

When you install OffCAT using the OffCAT.msi file from the Microsoft Download site, a command-line version of OffCAT (OffCATcmd.exe) is added to the folder in which you installed OffCAT (by default, the \Program Files\Microsoft OffCAT folder).

33

The command-line version of OffCAT is useful in situations where administrators need to remotely run OffCAT on several machines in their organization.

This can be done, for example, by incorporating the following actions in a logon script:

1. Copy all of the OffCAT files (except OffCAT.exe) to the target computer.

2. Launch OffCATcmd.exe.

3. Scan the specified Office program and version using command-line switches for OffCATcmd.exe.

4. Save the scan report file to a network share.

Important Note: OffCATcmd.exe is NOT included in the files extracted from OffCAT.zip that is downloaded from the Microsoft Download Center

Running OffCATcmd.exe

The following steps can be used with OffCATcmd.exe to run an OffCAT scan without any user interface.

1. Install OffCAT on any computer (or download and extract the files from OffCAT.zip).

2. Copy all of the files (except OffCAT.exe) in the \Microsoft OffCAT folder to the computer on which you will be running OffCATcmd.exe.

3. Open a command-prompt.

4. In the command-prompt window, navigate to the folder in which you copied the OffCAT files.

5. Run OffCATcmd.exe using one or more of the switches discussed in the Switches for OffCATcmd.exe section below.

Tip: If you are in an organization where this needs to be performed on multiple computers, you can write a script that automates the above steps.

Switches for OffCATcmd.exe

The following list includes the currently available switches you can use to control OffCATcmd.exe.

l <label>

The –l switch is used to specify a label for the OffCAT report. The label is independent of the filename for the output file and is used in the OffCAT user interface to help you better identify one scan among several scans.

34

-dat <path and filename>

Use the -dat switch to specify the path and filename for the output (.xml) file generated by OffCAT. If the -dat switch is not used, the output file is created in the same folder location as the full-UI version of OffCAT (%AppData%\Microsoft\OffCAT).

-cfg <Office program>

If you are using Offcatcmd.exe to scan an Office program, you must use the –cfg switch to specify the Office program that is going to be scanned. The following is the current list (for OffCAT v1) of available values you can use with the -cfg switch:

Access

Excel

Outlook

Powerpoint

Word

-gs <global substitution values>

The -gs switch provides control over two important parameters that need to be used on computers where you have more than one version of Office installed.

Tip: If you only have one version of Office installed on a computer, you do not have to use the -gs switch.

· MajorVersion

The MajorVersion parameter of the -gs switch controls the version of the Office program you want scanned. You can use the following values for MajorVersion.

Value for MajorVersion Office program version to be scanned
15 Office 2013 programs
14 Office 2010 programs
12 Office 2007 programs
11 Office 2003 programs

· InstallType

The InstallType parameter is used to specify the method used to install the version of Office being scanned. You can use the following values for InstallType.

Value for InstallType Method of Office installation
MSI .msi file (most common for Office 2010 and earlier versions)
ClickToRun Click-to-run (most common for non-enterprise Office 2013 consumers)

Having multiple Office versions installed on a computer will be more common when you install the Click-to-run version of Office 2013. Click-to-run versions of Office 2013 do not remove previous versions of Office.

-u <context>

The -u switch is used when you need to specify domain credentials for an Outlook scan. This is equivalent to specifying credentials in the OffCAT interface when the mailbox account does not match the currently logged on Windows account.

35

Note: The -u switch can only be used for Outlook scans.

-r <option>

Use the -r switch to specify either a Full scan or an Offline scan for Outlook. If you do not use the -r switch a Full scan is performed. This is the same option available on the Start an Outlook scan screen.

36

Note: The -r switch can only be used if you are scanning Outlook

-?

The -? switch is used to output the list of all switches available with OffCATcmd.exe, as in the following example:

C:\Users\TestUser>”C:\OffCAT\OffCATcmd.exe” -?

Usage: C:\OffCAT\OffCATcmd.exe [<options>]

Options:

-dat <file> Write the output data to <file>. The default is

output.<label>.<timestamp>.xml in the offcat output directory.

-l <label> Specify a <label> in the output.

-u <context> [<domain>\]<user> (<password>|*) …

Provides separate credentials per context.

-r <option>[=<value>][,…]

Restrict the collection/analysis to include the specified

restriction. The default is “” (full scan), for an offline scan

pass “Offline Scan”.

-cfg <application>

Specify the Office application to scan.

-gs MAJORVERSION <version> INSTALLTYPE <installation type>

Specify the version of the Office application to scan

(11 for 2003, 12 for 2007, 14 for 2010, 15 for 2013)

and the installation type (MSI or ClickToRun).

-? Display this information.

Example: OffCATcmd.exe -dat output.xml -u ADLOGON Domain\administrator P@ssw0rd -cfg outlook -gs MAJORVERSION 14 INSTALLTYPE MSI

Example: OffCATcmd.exe -dat output.xml -l “New Offline Scan” -r “offline scan” -cfg outlook -gs MAJORVERSION 14 INSTALLTYPE MSI

Example: OffCATcmd.exe -dat output.xml -l “New Word 2010 Scan” -cfg word
-gs MAJORVERSION 14 INSTALLTYPE MSI

Example: OffCATcmd.exe -dat output.xml -l “New Excel 2013 C2R Scan” -cfg
excel -gs MAJORVERSION 15 INSTALLTYPE ClickToRun

Valid restrictions options:

“Offline Scan” (only valid for Outlook)

Valid security contexts:

ADLOGON (only valid for Outlook)

Examples:

Here are some examples of switches you might find useful when using OffCATcmd.exe.

· Scan Word 2013 (from an Office 2013 Click-to-run install) using a custom label and custom output location.

Example machine configuration: Office 2013 Click-to-run installed (no other Office versions installed)

The report will have a custom label of “example 1” and the output file will be created as Example1-Test.xml in the C:\offcatfiles folder.

Offcatcmd.exe -dat “C:\offcatfiles\Example1-Test.xml” -l “example 1”

-cfg Word

Result:

18:35:32.118: Starting Collecting Data phase

18:39:22.119: Scan type: Full Scan.

18:35:33.948: Completed Collecting Data phase.

18:35:36.778: Starting Postprocessing Rules phase.

18:35:40.639: Completed Postprocessing Rules phase.

18:35:43.325: Saving data to file c:\offcatfiles\Example1-Test.xml

· Scan Excel 2010 using a custom label and custom output location.

Example machine configuration: Both Office 2013 Click-to-run and Office 2010 are installed

The report will have a custom label of “example 2” and the output file will be created as Example2-Test.xml in the C:\offcatfiles folder.

Offcatcmd.exe -dat “C:\offcatfiles\Example2-Test.xml” -l “example 2”

-cfg Excel -gs MajorVersion 14 InstallType msi

Result:

18:35:32.118: Starting Collecting Data phase

18:39:22.119: Scan type: Full Scan.

18:35:33.948: Completed Collecting Data phase.

18:35:36.778: Starting Postprocessing Rules phase.

18:35:40.639: Completed Postprocessing Rules phase.

18:35:43.325: Saving data to file c:\offcatfiles\Example2-Test.xml

· Run an Offline scan for Outlook 2010

Example machine configuration: Office 2010 installed (no other Office versions installed)

The report will have a custom label of “example 3” and the output file will be created in the default folder location (%AppData%\Microsoft\OffCAT) using the default filename.

Offcatcmd.exe -l “example 3” -r “offline scan” -cfg Outlook

Result:

18:39:24.676: Starting Collecting Data phase.

18:39:24.692: Scan type: Offline Scan.

18:39:34.400: Completed Collecting Data phase.

18:39:34.510: Starting Postprocessing Rules phase.

18:39:34.540: Completed Postprocessing Rules phase.

18:39:34.660: Saving data to file C:\Users\administrator\AppData\Roaming\Microsoft\OffCAT\

OffCAT_Results.example 3.201206011839212912.data.xml

· Run a Full scan for Outlook 2013, using credentials for someone other than the logged on user.

Machine configuration: Both Office 2013 (msi) and Office 2010 installed (msi)

The report will use the default label and default file location. The credentials for Contoso\User1 will be used instead of the currently logged on user’s credentials.

Offcatcmd.exe -u ADLOGON Contoso\User1 P@ssw0rd -cfg Outlook
-gs MajorVersion 15 InstallType msi

Result:

18:49:38.070: Starting Collecting Data phase

18:49:38.080: Scan type: Full Scan.

18:52:08.932: Completed Collecting Data phase.

18:52:11.741: Starting Postprocessing Rules phase.

18:52:15.471: Completed Postprocessing Rules phase.

18:52:18.025: Saving data to file C:\Users\Administrator\AppData\Roaming\Microsoft\OffCAT\

OffCAT_Results.201206011849348824.data.xml

How to understand an OffCAT report

The report that OffCAT generates can, in most cases, provide lots of information about the configuration of the Office program that was scanned. To help you better understand and use this information, this document provides a high-level description of the different views that are available in your scan report.

· List Reports

The List Reports view is the default presentation of your scan data.

37

In this report view, there are up to three tabs that are available to view different snapshots of this data.

38

o All Issues

OffCAT has built-in rules that look for issues in your Office program configuration, and these issues are classified as either a warning ( ) or a critical ( ) issue. The All Issues tab is the default tab displayed when you view an OffCAT scan as it displays all the warning and critical issues that are detected in your Office program configuration.

39

The entries in this view are not static. If you want to see more details about the item, click the row for that item to expand the row.

40

For even more information about the issue, click the Click here to see possible solutions to this issue link.

41

In this example, the following article is opened in your browser.

42

If you use the information that is provided in this article, this issue should not appear in your next scan report.

o Critical Issues

The Critical Issues tab displays only those issues that are considered critical by the detection rules that are built into OffCAT.

43

These are the same critical issues that are displayed on the All Issues tab. They are broken out on the Critical Issues tab for convenience.

NOTE: If OffCAT finds no critical issues, you do not see a Critical Issues tab.

o Informational Items

All scans have an Informational Items tab for the List Reports view.

44

This view of the scan data shows you items that are considered “Informational” (according to OffCAT rules) because these items are useful to most people. However, these items do not necessarily indicate any problems. They are displayed just to provide general information about your profile.

The entries in this view are not static. If you want to see more details about the item, click the row for that item to expand the row.

45

You can also use the Find feature to search for particular items. To perform a search, click , and then enter your search string in the Look for box.

46

Only the items that match the search string are displayed in the view.

47

All other items are hidden while the results are displayed. To redisplay the hidden items, click the on the right side of your search criteria.

48

· Tree Reports

The Tree Reports view of your scan report provides tree-control functionality to view your scan results.

49

In this report view, two tabs are available to view different snapshots of this data.

50

o Detailed View

The Detailed View tab exposes all the available configuration data that OffCAT collects.

Therefore, if you want to see informational and critical issues plus all relevant configuration settings for your scanned Office program, use the Detailed View tab to review your scan results.

You can also copy the contents of an expanded node by right-clicking the node and selecting Copy Node.

52

Then, you can paste the information into a text file, email message, or other document where you need to either save or share this information.

The Detailed View also provides additional data if you rest the pointer over some items that contain more information than can be displayed in the tree window. For example, the following figure shows the AutoDiscoverXML data that OffCAT retrieved in an Outlook scan.

53

 

Resting the pointer over AutoDiscoverXml in the report displays all the results in a pop-up window.

54

You can also copy the Autodiscover XML results by selecting the AutoDiscoverXml entry in the Tree Report, pressing CTRL+C (to copy), and then pasting the information into a text file.

Because OffCAT collects lots of data that is displayed on the Detailed View tab, you can use the Find feature to quickly locate the data that is important to you.

55

Click Find, enter your search criteria in the Look for box, and then click or to locate the items that match your search criteria.

56

o Summary View

The Summary View tab uses the same tree structure as the Detailed View tab. However, the Summary View tab only shows you a subset of the data that is found on the Detailed View tab.

57

This information is useful because it might not be as overwhelming as the information that is found on the Detailed View tab. If you locate information on the Summary View tab that is important to you, switch over to the Detailed View tab if you want more details about that particular item.

· Other Reports

The information under Other Reports is mostly a running log of the actions that OffCAT took. Generally, you will not use this information to analyze the information that is collected about your Office program.

58

How to open a previously generated OffCAT report

By default, OffCAT saves its scan report as an xml file in the following folder.

In Windows 8, Windows 7 and in Windows Vista

C:\Users\<username>\AppData\Roaming\Microsoft\OffCAT

In Windows XP

C:\Documents and Settings\<username>\Application Data\Microsoft\OffCAT

Tip: The quickest way to access this folder is to use

%AppData%\Microsoft\OffCAT.

You do not have to manually locate the scan files in these folders because the folder location is only provided here for reference.

How to view a report that was originally created on your computer

If you are running OffCAT on the same computer where you generated the scan, follow these steps to view the scan report at any time:

1. Start OffCAT.

2. In the left panel, click Select a scan to view.

59

3. Then, select the scan to be viewed from the list of available scans.

4. Finally, click View a report of this scan.

60

How to view a report that was created on another computer

If someone else created an OffCAT scan report on his or her computer, you can view this report using the follow these steps.

Note: You can skip steps 1-5 if you used the command-line version of OffCAT to generate the report file.

1. Start OffCAT on the computer where the scan was performed.

2. In the left panel, click Select a scan to view.

3. Then, select the scan to be viewed from the list of available scans.

4. Click Export this scan.

Tip: you can also export an OffCAT report from a report that you are currently viewing. To do this, use the Export report link on the View report page.

64

5. In the Export report dialog box, specify a file name and a folder location.

6. Copy the .xml file that you saved in step 5 to the computer from which you will be viewing the report.

7. On the computer to which you copied the file in step 6, start OffCAT.

8. In the left panel, click Select a scan to view.

9. On the Select a scan to view page, click Import scan.

65

10. Browse to the folder that contains the .xml file that you copied in step 6, and then click Open.

The scan is opened automatically for viewing.

Automatically update OffCAT with new detection rules or application files

When you launch OffCAT, the default configuration will check to see if new detection rules or application files are available.

66

This check can be cancelled by clicking Cancel this check while OffCAT is checking for updates. If no updates are available, you will see the default screen where you can start a new scan or open an existing scan. If an update is available, you will receive a prompt to update OffCAT with new rules.

If you do not have access to the Internet or OffCAT is unable to access the Internet location where the updated files reside, OffCAT will display the following error after the update check finishes.

An error occurred trying to access the web.

This error is shown in the following figure.

67

Rule Updates

If new rule file updates are available, then you will see a prompt, similar to the one shown in the following figure, when you start OffCAT (with automatic updating enabled) or when you manually check for updates.

68

Click Download the latest updates to download the latest rules file.

Updated location of the <application>.config.xml file

When you download an updated version of the rules file, OffCAT will copy the updated <application>.config.xml file to the \%AppData%\Microsoft\OffCAT\En folder if both of the following conditions are true:

· You are using Windows 7 or Windows 8

· You installed OffCAT into the default folder (\Program Files\Microsoft OffCAT)

This occurs because of the special security considerations given to the \Program Files folder on Windows 7 and Windows 8.

The following figures shows updated configuration rule files in \%AppData%\Microsoft\OffCAT\En folder from a Windows 8 client.

69

If you are using Windows XP, or you installed OffCAT on Window 7 (or Windows 8) to a folder that is not a subfolder of \Program Files, the updated rules file is copied into the \En subfolder of your OffCAT installation folder.

OffCAT rules file versioning

You can determine the version of the rules file by opening <application>.config.xml in a text editor such as Notepad. The version information can be seen in the value for ConfigVersion in the .xml file.

<Configuration ConfigName=”Access Configuration”

ChangeDescription=”2013/02/09″

ConfigVersion=”1.0.1302.9″

Automatic rules file update for the command-line version of OffCAT

The command-line version of OffCAT will also check to see if updated rule files are available, and if so, automatically download and use the updated rule files.

If OffCATcmd.exe is unable to retrieve the updated files, errors similar to those shown below will be displayed in the command-prompt window.

>C:\OffCAT\OffCATcmd.exe -cfg Word -gs MajorVersion 15 InstallType msi

21:50:31.227: Starting Collecting Data phase.

21:50:33.898: The specified domain either does not exist or could not be contacted

21:50:33.898: The specified domain either does not exist or could not be contacted

21:50:37.278: Completed Collecting Data phase.

21:50:37.668: Starting Postprocessing Rules phase.

21:50:37.793: Completed Postprocessing Rules phase.

21:50:38.324: Saving data to file C:\Users\user1\AppData\Roaming\Microsoft\
OffCAT\OCAT_Results.201303032150302598.data.xml

This does not prevent OffCATcmd.exe from performing a scan as the local versions of the <application>.config.xml files are used for the scan.

Application Updates

If an application update is available, then you will see one of the following prompts when you start OffCAT (with automatic updating enabled) or when you manually check for updates. The prompt you see depends on the method you used to put OffCAT on your computer.

OffCAT installed from .msi file

If you installed OffCAT using the .msi file from the Microsoft Download site, you will see the following prompt if a newer version of OffCAT is available for download.

A new version of the tool has been found. The Microsoft Office Configuration Analyzer Tool <build number>

· Exit the tool so you can manually install the update from …

· Update the tool in place (you will need to restart the tool when this completes)

· Continue without making any updates.

To update OffCAT, click Update the tool in place (you will need to restart the tool when this completes), and then follow the instructions as they are provided during the OffCAT installation.

After the update is finished, start OffCAT.

Note: The automatic application update does not occur if you are using the command-line version of OffCAT (OffCATcmd.exe).

OffCAT from the .zip download

If you put OffCAT on your computer using the .zip file from the Microsoft Download site, you will see the following prompt if a newer version of OffCAT is available for download.

A new version of the tool has been found and you can replace your files with the updated files. Microsoft Office Configuration Analyzer Tool <build number>

· Exit the tool so you can manually download the updated files from the Microsoft Download site

· Continue without making any updates

In this situation, use the following steps to update OffCAT on your computer.

1. Exit OffCAT if it is running.

2. Go to the Microsoft Download site (http://www.microsoft.com/download).

3. Download the OffCAT.zip file from the site to your computer.

4. Extract the files from the .zip file to a folder on your computer.

5. Run OffCAT.exe from this new folder.

Configuring OffCAT Automatic Update Settings

OffCAT update settings can be viewed and modified by clicking OffCAT Updates in the left panel of the OffCAT window.

70

The following options are available on the OffCAT Updates page.

· Check for updates on startup (recommended)

This is the default OffCAT configuration as we feel the latest files and rules will give you the most updated report on your Office configuration.

· Do not check for updates on startup

If you do not want OffCAT to automatically check for updates when you start OffCAT, select the Do not check for updates on startup option. If you have this option enabled, you can manually check for updates by clicking Check for updates now on the OffCAT Updates page.

71

How to administer OffCAT settings using group policy

Some of the user-configurable settings in OffCAT can be managed by group policy so administrators can control these settings on behalf of users. To configure OffCAT settings through group policy, download the group policy template (Offcatv1.adm) from the page on the Microsoft Download site from where you downloaded OffCAT.msi (or OffCAT.zip). Then, import the Offcatv1.adm template into your group policy editor, as demonstrated in the following figure.

72

The following OffCAT settings can be configured using group policy.

· Alternate folder location for report files

This setting does not have a corresponding setting in the OffCAT interface. It is used to specify a folder location in which scan results are automatically saved.

With this policy enabled, scan result files are saved to the folder specified in the policy and they are also saved to the default %AppData%\Microsoft\OffCAT folder.

If you want scan result files to only be saved to the folder specified by this policy, please also enable the Delete local report file policy.

· Delete local report file

If enabled, this policy works in conjunction with the Alternate folder location for report files policy. If you specify an alternate folder location for report files using the Alternate folder location for report files policy and you do Not want a report file to also be saved in the default folder location, then enable this policy (Delete local report file).

Note: If you enable this policy without also enabling the Alternate folder location for report files policy, this policy is ignored because OffCAT needs to save at least one copy of the report file.

If you enable this policy and you specify a folder location using the Alternate folder location for report files policy, OffCAT prevents the user that runs a scan from viewing the results. This user experience is shown in the following figure.

73

· Always check for OffCAT updates when starting OffCAT

This policy setting controls the Check for updates on startup (recommended) option on the OffCAT Updates page in the OffCAT interface.

74

If this policy is enabled, OffCAT will always check for ‘rule’ file and ‘application’ file updates available from the Microsoft Download site, and users will not be able to turn off this option.

If you disable this policy, OffCAT will not automatically check for ‘rule’ file and ‘application’ file updates that may be available from the Microsoft Download site, and users will not be able to turn on this option. However, users will still be able to manually check for updates using the Check for updates now option on the OffCAT Updates page in the OffCAT interface.

74

· Show the Welcome screen when OffCAT is launched

By default, the Welcome to the Office Configuration Analyzer screen is shown when you start OffCAT.

75

76

Enable this policy if you want users to always see the ‘Welcome’ screen when OffCAT is launched.

If you prefer to have OffCAT default to the Select an Office Application to Scan screen, shown below, instead of the ‘Welcome’ screen, then disable this policy.

77

How to use the Exchange Remote Connectivity Analyzer

For convenience, OffCAT provides a link to the Exchange Remote Connectivity Analyzer tool on the Start an Outlook scan page.

78

Click this link to browse to the Internet site for the Remote Connectivity Analyzer.

79

Note: There is no technical connection between OffCAT and the Remote Connectivity Analyzer tool. The link is provided as a convenience for you to troubleshoot issues that cannot be resolved by using the information that is generated in an OffCAT scan report.

How to uninstall OffCAT

To uninstall OffCAT from a computer, follow these steps.

Note: These steps assume you installed OffCAT using the OffCAT.msi file. If you copied OffCAT.zip from the Microsoft Download Center, you can uninstall OffCAT simply by deleting the folder containing the OffCAT files.

For Windows 8, Windows 7 and for Windows Vista

1. Open Control Panel.

2. In Control Panel under Programs, select Uninstall a program.

3. In the list of currently installed programs, select Microsoft Office Configuration Analyzer Tool, and then click Remove.

4. Click Yes to confirm that you want to remove the program.

For Windows XP

1. Click Start, point to Settings, and then click Control Panel.

2. Double-click Add or Remove Programs.

3. In the list of currently installed programs, select Microsoft Office Configuration Analyzer Tool, and then click Remove.

4. Click Yes to confirm that you want to remove the program.

How to submit feedback about OffCAT

If you want to submit feedback or improvement suggestions for OffCAT , click the Tell Microsoft what you think about OffCAT link in the left panel.

80

When you click this link, a new email message is opened that is addressed to OffCATsupp@microsoft.com.

81

Please provide as many details as possible so we can give your request a thorough review.

Note: Please be aware that you will not be contacted after you submit feedback.

Mauricio Cassemiro

Profissional de TI desde 2010, especialista Microsoft, Microsoft Office Specialist (MOS) em Microsoft Outlook e MVP de Office Servers and Services no Brasil.

Website: https://www.mauriciocassemiro.com

Deixe uma resposta

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *