2 Installing the ADO.NET Data Providers : Using the Program Group

Using the Program Group
A DataDirect Connect for ADO.NET 4.0 program group is created during installation. The program group provides the following shortcuts:
The following sections provide additional information about the Administration Tool and the Processor Information Utility.
Administration Tool
The Connect for ADO.NET Administration Utility window allows you to customize the final installation package. It includes the following parts:
Using the Performance Counters Tab
All DataDirect Connect for ADO.NET data providers install a set of PerfMon counters that let you tune and debug applications that use the data provider. The data provider's counters are located in the Performance Monitor under a category name, for example, DataDirect Oracle ADO.NET Data Provider.
The performance counters are created automatically the first time an application uses the provider. However, if the application is run as a user who does not have sufficient permissions to create the counters (for example, the IIS user), counter creation may fail silently.
This utility allows you to manually create the performance counter categories as the current user.
To manually create the performance counters:
1
Select the Administration Tool icon from the DataDirect Connect for ADO.NET 4.0 program group.
2
Select the Performance Counters tab. In the following figure, the current user has permissions for four data providers. The Sybase counters are not installed.
Performance Counters tab of the Administration Utility. Use the utility to manually create the performance counters.
3
4
Click Close.
Using the Visual Studio Integration Tab
The Progress DataDirect Connect for ADO.NET data providers support integration into Microsoft Visual Studio. This means that developers can use the graphical user interface of Visual Studio to perform a variety of tasks.
If Visual Studio is present when the providers are installed, integration is automatically configured. If Visual Studio is installed after the providers have been installed, or if integration has been removed due to an uninstall, the Integration Tool can be run to re-integrate the data providers with Visual Studio.
The Administration Tool integrates the product components into Visual Studio when:
You install the DataDirect Connect for ADO.NET data providers before installing Visual Studio and you subsequently install it
You uninstall DataDirect Connect for ADO.NET version 4.0 data providers, and you have an existing installation of DataDirect Connect for ADO.NET version 3.5 data providers.
To integrate the installed data providers into Visual Studio 2008:
1
2
Select the Administration Tool icon from the DataDirect Connect for ADO.NET 4.0 program group.
3
Select the Visual Studio Integration tab, then click the Install provider integration link.
4
Click Close.
If you click the Install provider integration link before installing Visual Studio, a command shell window appears and displays the following error message:
The code base does not exist.
To integrate the data provider help files into Visual Studio 2010
The Help Setup Wizard integrates the online help for the data providers into Visual Studio. The steps in the Wizard are similar for Visual Studio 2008, Visual Studio 2010, and Visual Studio 2012. The following procedure shows the steps in Visual Studio 2010:
1
2
Select the Administration Tool icon from the Progress DataDirect Connect for ADO.NET 4.0 program group.
3
Select the Visual Studio Integration tab, then click the Visual Studio 2010 Help Integration link.
4
Click Next. The Select Installation Folder window appears.
This window allows you to change the installation directory from the default location, and specify who can use the help you are installing. This step is optional.
To change the installation directory, click Browse... and select the new installation directory path. Then, click OK to return to the Browse for Installation Directory window.
NOTE: If the data providers are already integrated into Visual Studio 2010, the Wizard asks if you want to repair or remove HelpSetup10. Select the appropriate radio button and click Finish, and then click Close to close the Wizard.
5
Click Next. The Confirm Installation window appears.
6
Click Next. The help files are integrated into Visual Studio 2010. This process takes several minutes.
7
Click Close. The help files are available through the Contents tab.
8
Open the Visual Studio 2010 help, and select Progress DataDirect from the Filtered by drop-down list.
Processor Information Utility
Progress customer support may, on occasion, ask that you use the Processor Information Utility to identify the type of license you need.
From the DataDirect Connect for ADO.NET 4.0 program group, select Processor Information Utility. The tool automatically determines the number and type of processors in your machine and displays the information in a command shell window. The message also includes the type of license required for your Progress DataDirect product. Provide this information to Progress DataDirect customer support when requested.