7.1.2.Installation & Configuration

There are two installation types to consider:

Installation of the ADO.Net Provider Client on Windows

The Virtuoso ADO.Net Provider is part of the Virtuoso Client Connectivity Kit installer, and if the target Virtuoso Server installation already exists on the network this is the only component that needs to be installed.

  1. Download and run the Virtuoso Client Connectivity Kit installer for your target Windows OS:

  2. Choose the "run" button to allow the signed "Virtuoso Client Connectivity kit" installer to start.

    Figure7.1.Run

    Run

  3. Choose the "Next" button to begin the installation process.

    Figure7.2.Installation: Next

    Installation: Next

  4. Check the "I agree with license agreement" checkbox and choose the "Next" button.

    Figure7.3.Installation: Agree license

    Installation: Agree license

  5. Choose the "Custom" option to manually select what components are installed and in which location, or choose the "Typical" or "Complete" options as recommended and skip to step 7.

    Figure7.4.Custom Install

    Custom Install

  6. If the "Custom" option what chosen, select the installation directory or leave default and choose the "Next" button to continue.

    Figure7.5.Installation

    Installation

  7. Select which of the ADO.NET Providers are to be installed and choose "Next" to continue.

    Figure7.6.ADO.NET Providers

    ADO.NET Providers

  8. The installer is now ready to begin the installation, choose the "Install" button to commence the process.

    Figure7.7.Install

    Install

  9. The installation was successfully completed.

    Figure7.8.Completed installation

    Completed installation

  10. The installation of the Provider can be verified by checking the %WINDOWS%\assembly folder and checking that the Provider(s) chosen for installation is(are) listed - "virtado3" and/or "virtado2".

    Figure7.9.Provider

    Provider

The installation of the ADO.Net Provider Client is complete.

Uninstallation
  1. If you attempt to run the installer again, the following message will be displayed.

    Figure7.10.Installer message

    Installer message

  2. The Provider can be uninstalled from the "Control Panel" -> "Programs and Features" menu, by selecting the "Virtuoso Client Connectivity kit" from the list of installed components and clicking the "unistall" option presented.

    Figure7.11.Uninstall

    Uninstall

  3. Choose "Yes" to uninstall the Virtuoso ADO.Net Provider.

    Figure7.12.Uninstall

    Uninstall

Installation of the ADO.Net Provider Client and Virtuoso Universal Server on Windows

If both the ADO.Net Provider client and Virtuoso Server are to be installed on the same Windows machine, then the Virtuoso Universal Server installer can be used as it includes all the Virtuoso client and server components available in a single installer. An instance in which this particular installation type is require would be when using the Provider to provide Entity Framework connectivity to the remote database schema objects.

  1. Download and run the Virtuoso Universal Server installer for your target Windows OS:

  2. Choose the "run" button to allow the signed "Virtuoso Universal Server" installer to start.

    Figure7.13.Run

    Run

  3. Choose the "Next" button to begin the installation process.

    Figure7.14.Next

    Next

  4. Check the "I agree with license agreement" checkbox and choose the "Next" button.

    Figure7.15.Agree license

    Agree license

  5. Choose the "Custom" option to manually select what components are installed and in which location, or choose the "Typical" or "Complete" options as recommended and skip to step 7.

    Figure7.16.Custom option

    Custom option

  6. If the "Custom" option what chosen, select the installation directory or leave default and choose the "Next" button to continue.

    Figure7.17.Installation directory

    Installation directory

  7. Select which of the ADO.NET Providers are to be installed and choose "Next" to continue.

    Figure7.18.ADO.NET Providers

    ADO.NET Providers

  8. The installer is now ready to begin the installation, choose the "Install" button to commence the process.

    Figure7.19.Begin installation

    Begin installation

  9. The installation was successfully completed.

    Figure7.20.Installation completed

    Installation completed

  10. Post installation the Virtuoso Server can be started by running the "Virtuoso Service Manager" which gets added to the Windows "Icons Tray" in the status bar.

    Figure7.21.Post installation

    Post installation

  11. Double click on the "Virtuoso Service Manager" icon in the "Icons Tray" to load the application, select the "OpenLink Virtuoso Server" instance and press the "Start" button to run the Service.

    Figure7.22.Virtuoso Service Manager

    Virtuoso Service Manager

  12. Once the Virtuoso service has successfully started, it is *recommended* that the default "dba" and "dav" passwords be changed to secure values by loading the URL "http://example.com/install" in a Web Browser which loads the following page for making these changes.

    Figure7.23.Defaults

    Defaults

  13. The Virtuoso Server is now available for use.

    Figure7.24.Virtuoso Server

    Virtuoso Server

  14. The installation of the ADO.Net Provider can be verified by checking the %WINDOWS%\assembly folder and checking that the Provider(s) chosen for installation is(are) listed - "virtado3" and/or "virtado2".

    Figure7.25.Installation verification

    Installation verification

The installation of the ADO.Net Provider Client and Virtuoso Universal Server is complete.

Uninstallation
  1. If you attempt to run the installer again, the following message will be displayed.

    Figure7.26.Installer message

    Installer message

  2. The Provider can be uninstalled from the "Control Panel" -> "Programs and Features" menu, by selecting the "Virtuoso Client Connectivity kit" from the list of installed components and clicking the "unistall" option presented.

    Figure7.27.Uninstall

    Uninstall

  3. Choose "Yes" to uninstall the Virtuoso ADO.Net Provider.

    Figure7.28.Uninstall

    Uninstall