The Vertica client drivers and tools for windows

• 1: System prerequisites
• 1.1: .NET framework
• 1.2: Microsoft visual studio
• 1.3: Microsoft SQL server
• 2: Download the client drivers and tools for windows
• 3: Install or upgrade client drivers and tools for windows
• 4: Post-installation steps for ODBC driver and vsql client
• 5: Uninstalling, modifying, or repairing the client drivers and tools

1 - System prerequisites

The Vertica Client Drivers and Tools for Windows has basic system prerequisite requirements. The pack also requires that specific Microsoft components be installed for full integration.

For a list of all prerequisites, see Client drivers support in the Supported Platforms document.

Fully update your system

Before you install the Vertica driver package, verify that your system is fully up to date with all Windows updates and patches. See the documentation for your version of Windows for instructions on how to run Windows update. The Vertica client libraries and vsql executable install updated Windows libraries that depend on Windows service packs. Be sure to resolve any issues that block the installation of Windows updates.

If your system is not fully up-to-date, you may receive error messages about missing libraries such as api-ms-win-crt-runtime-l1-1-0.dll when starting vsql.

1.1 - .NET framework

The .NET framework is not bundled into the Vertica Client Drivers and Tools for Windows. However, during installation, a web installer launches if Microsoft .NET 3.5 SP1 is not detected on your system. You then have the opportunity to download the framework. Also, if your operating system version includes .NET 3.5 SP1, but it is not turned on, the installer turns on the feature.

If you have Visual Studio 2010 or 2012 installed, your system already includes Microsoft .NET Framework 4.0 or 4.5, respectively. You also need Microsoft .NET 3.5 SP1 to use the Vertica Client Drivers and Tools for Windows integration features.

Use the following links to download the appropriate version of .NET framework directly from Microsoft:

• For .NET Framework 3.5 SP1:

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

• For .NET Framework 4.0:

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

• For .NET Framework 4.5:

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

1.2 - Microsoft visual studio

The Vertica Client Drivers and Tools for Windows installer provides a Visual Studio plug-in which allows you to use Vertica as a Visual Studio Data Source for Visual Studio 2008, 2010, 2012, 2013, or 2015. The connection properties for the plug-in are the same as ADO.NET connection properties.

After installing the plug-in, you can use it to access your Vertica database from within Visual Studio. If you do not have the SDK installed, download the SDK specific to your version of Visual Studio.

• For the Microsoft Visual Studio 2008 SDK:

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

• For the Microsoft Visual Studio 2008 SP1 SDK:

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

• For the Microsoft Visual Studio 2010 SDK:

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

• For the Microsoft Visual Studio 2010 SP1 SDK:

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

• For the Microsoft Visual Studio 2012 SDK:

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

• For the Microsoft Visual Studio 2013 SDK:

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

If the Microsoft Visual Studio SDK is missing when you begin the installation, a dialog box opens to tell you so. You can choose to ignore this dialog box.

Configuring BIDS or SSDT-BI integration

The Vertica Client Drivers and Tools for Windows installer provides BIDS (Visual Studio 2008) or SSDT-BI (Visual Studio 2010, 2012, 2013, or 2015) integration. To use BIDS or SSDT-BI, follow this process:

1. Install the BIDS or SSDT-BI development tool add-on for Visual Studio.

2. Verify that SQL Server is installed on the same or a different machine.

3. Verify that the SQL Server Shared Features for BIDS or SSDT-BI have been activated.

You can then develop packages using BIDS or SSDT-BI, creating your projects using SQL Server’s SSIS, SSAS, SSRS features. To use these features, you must connect to Vertica through the Vertica ADO.NET driver (for SSIS and SSRS) or the OLE DB driver (for SSAS).

For more information, see Microsoft components.

1.3 - Microsoft SQL server

Use SQL Server 2012, 2014 or 2016. The Vertica Client Drivers and Tools for Windows installer enables support for the following:

• SQL Server 2012, 2014, and 2016:

  • SQL Server Integration Services (SSIS)

  • SQL Server Reporting Services (SSRS)

  • SQL Server Analysis Services (SSAS)

• SQL Server using Visual Studio 2010, 2012, 2013, and 2015—SQL Server Data Tool - Business Intelligence (SSDT-BI)

  Note

  For SQL Server 2012, you can use either SQL Server 2012 or SQL Server 2012 SP1.

To use the enhanced Vertica .NET support, you must first install SQL Server. Then, you can install the Client Drivers and Tools for Windows. The following components must be installed on the SQL server:

2 - Download the client drivers and tools for windows

The Vertica driver downloads page has the client drivers for all currently-supported versions of Vertica. The installation package works on both 32-bit and 64-bit versions of Windows.

3 - Install or upgrade client drivers and tools for windows

You can install or upgrade the Windows client drivers and tools with the Windows installer or from the command line.

Windows installer

As Windows Administrator, double-click the Windows installer to start the installation. Follow the installer prompts as it guides you through each step of the process.

By default, the installer installs the client drivers and tools in C:\Program Files\Vertica Systems. You can change this location during installation.

Command-line

1. As Windows Administrator, open a command-line session.

2. Navigate to the folder that contains the installer.

3. Run this command:

   VerticaSetup.exe -q -install InstallFolder="C:\Program Files\Vertica Systems"
   

The client drivers and tools are silently installed in C:\Program Files\Vertica Systems.

4 - Post-installation steps for ODBC driver and vsql client

After you install the Vertica Client Drivers and Tools for Windows, there are additional steps you must take for the ODBC driver and vsql client to function correctly.

• ODBC Driver — After installing the ODBC driver, you must create a DSN to be able to connect to your Vertica database. For the procedure, see Creating an ODBC DSN for windows clients.

• vsql Client — The vsql client does not have a shortcut. Before you can start using vsql, you must add the vsql executable to the Windows PATH environment variable. The method for altering the PATH environment variable depends on the version of the Microsoft Windows operating system you are running. To start vsql and show the help list, open a command window, and type vsql -? at the command prompt. See Using vsql for windows users for important details about using vsql in a Windows console.

5 - Uninstalling, modifying, or repairing the client drivers and tools

To uninstall, modify, or repair the client drivers and tools, run the Client Drivers and Tools for Windows installer.

The installer provides three options:

Silently uninstall the client drivers and tools

1. As a Windows Administrator, open a command-line session, and change directory to the folder that contains the installer.

2. Run the command:

   VerticaSetup.exe -q -uninstall
   

The client drivers and tools are silently uninstalled.