Deploying Your VisionPro ApplicationCognex VisionPro

To run successfully, any VisionPro .NET program that you create depends on the proper installation of the VisionPro .NET assemblies. When you deploy your application, you need to verify that the target PC has the necessary files installed. The simplest and most reliable method to ensure this is to install VisionPro on the target machine by integrating the installation of the required VisionPro components with the installation procedure of your customized vision application.

This topic contains the following sections.

VisionPro 64-Bit Components

The following table shows the files included in the top-level directory of the VisionPro installation media that you must consider including as you deploy your customized vision application:

Table 1. VisionPro Installation Files for Deployment
File NameDescriptionRequired
0x0407.iniLanguage fileYes
0x0409.iniLanguage fileYes
0x0411.iniLanguage fileYes
0x0412.iniLanguage fileYes
0x0804.iniLanguage fileYes
1031.mstLanguage fileYes
1033.mstLanguage fileYes
1041.mstLanguage fileYes
1042.mstLanguage fileYes
2052.mstLanguage fileYes
Cognex VisionPro x64 (R) 9.3 msiInstaller package for VisionPro software. Use with the CAB file listed below.Yes
vpro32.cabVisionPro Development SoftwareNo
ISSetupPrerequisites/{44FCC612-A6E7-4369-903A-6CA265AC105F}/vcredist_x64.exeSupport fileYes
ISSetupPrerequisites/{47C4119B-3ADD-4803-B278-9ABA39415D83}/vc_redist.x86.exeSupport fileYes
ISSetupPrerequisites/{506A420F-1F74-4371-9E84-EFF365724DAA}/NDP46-KB3045557-x86-x64-AllOS-ENU.exeSupport fileYes
ISSetupPrerequisites/{6B1A5E34-475A-4039-94A2-76F8E38762A3}/vcredist_x86.exeSupport fileYes
ISSetupPrerequisites/{93A18296-3BF5-4F9D-BCDB-789FC6DC41B7}/vcredist_x64.exeSupport fileYes
ISSetupPrerequisites/{ABC6EF00-F360-4771-B87B-E76821BB5230}/CodeMeterRuntime64.msiSupport fileYes
ISSetupPrerequisites/{C89FAEA3-88AC-4F9F-ADB5-CAA7689CEB3A}/vcredist_x86.exeSupport fileYes
ISSetupPrerequisites/{D093EE4D-527D-4CC7-AB3C-DCE3219FA508}/vc_redist.x64.exeSupport fileYes
ISSetupPrerequisites/{D5538F3C-D9E4-45B9-966E-F628E5B7050C}/vcredist_x64.exeSupport fileYes
ISSetupPrerequisites/{E9B238C1-6181-470B-9405-90DBD0960946}/vcredist_x86.exeSupport fileYes
vpro.cabVisionPro softwareYes
setup.exeInstaller startupYes
Setup.iniInstaller startup dataYes
samples3d.cabVisionPro 3D sample programsNo
samples.cabVisionPro sample programsNo
doc.cabVisionPro documentationNo
dsfldcal.cabDS Field CalibratorNo
Visual Studio Prerequisites

The VisionPro installation does not redistribute the prerequisites installer for Visual Studio. If you wish to deploy a Visual Studio application, you must install the appropriate prerequisites installer for Visual Studio on the deployment PC.

Silent Installation with Setup.exe

This section contains the following subsections.

A silent installation lets you install VisionPro without displaying any windows or dialog boxes and without the need for user interaction.

Installing VisionPro Software

Use the following command to perform a silent installation using the setup.exe program from your VisionPro media:

setup /s /v"/qn ADDLOCAL=vpro INSTALLDIR=\"C:\Program Files\Cognex\""
  • You can use the /L option to specify a language other than that of the current OS for the installation. Use /L1033 for English, /L1031 for German, /L1041 for Japanese, /L1042 for Korean, or /L2052 for Chinese.
  • The INSTALLDIR string specifies the installation directory. If the path includes any spaces, then you must enclose it with backslash-quotes (\”…\”).
Installing Cognex Drivers

If you install VisionPro silently, then you must install the Cognex drivers with a separate command. You can install Cognex drivers independent of the VisionPro software. The following table shows the files in the \drivers directory of the VisionPro installation media that you must include in your deployed application to install the Cognex drivers:

Table 2. Cognex Driver Installation Files for Deployment
File NameDescription
setup.exeCognex drivers installation utility
Cognex x64 Drivers 5.10.msiInstaller package for Cognex drivers.
Data1.cabDriver software
1031.mstLanguage file
1033.mstLanguage file
1041.mstLanguage file
1042.mstLanguage file
2052.mstLanguage file
0x0407.iniLanguage file
0x0409.iniLanguage file
0x0411.iniLanguage file
0x0412.iniLanguage file
0x0804.iniLanguage file
Setup.iniSetup parameters

The Cognex Driver installer can install any supported driver. Specify a driver by name:

Table 3. Cognex Drivers
Feature NameDescription
_8504MVS-8500/8500e Driver
_8600MVS-8600 Driver
_gigeGigE Interface and CFG-8700 Driver
_commcardCognex Communication Card Driver

To install the Cognex drivers, use setup.exe and specify the features you want in the ADDLOCAL parameter:

setup /s /v"/qn INSTALLDIR=\"C:\Program Files\Cognex\Common\" ADDLOCAL=_gige,_commcard"

To install all the drivers, use ADDLOCAL=ALL.

Installing Asian Language Documentation

You can silently install Asian language versions of the VisionPro documentation after VisionPro has been successfully installed by running the following command from the vprolocalizeddocs directory:

setup/s /v/qn

The following table lists the files in the \vprolocalizeddocs directory of the VisionPro installation media that you must include in a separate directory of your deployed application to install the Asian language versions of the VisionPro documentation:

Table 4. Asian Language Documentation Files for Deployment
File NameDescription
setup.exeCognex documents installation utility
Cognex VisionPro x64 (R) 9.3 Asian Language Documents.msiInstaller package for Cognex VisionPro Asian Language Documents
Data1.cabDocument files
1031.mstLanguage file
1033.mstLanguage file
1041.mstLanguage file
1042.mstLanguage file
2052.mstLanguage file
0x0407.iniLanguage file
0x0409.iniLanguage file
0x0411.iniLanguage file
0x0412.iniLanguage file
0x0804.iniLanguage file
Setup.iniSetup parameters
Configuring VisionPro.ini

If your VisionPro application configuration requires any non-default settings in the VisionPro.ini configuration file, you must make sure that your deployment installation procedure installs the appropriate VisionPro.ini on each deployment system.

Uninstalling VisionPro

This section contains the following subsections.

During any interactive uninstall of VisionPro or the Cognex drivers, a dialog box similar to the following might appear:

Programming Deploying Deploying Deploying Uninstall 64

The default choice Automatically close applications and attempt to restart them after setup is complete is appropriate for most situations, and allows the uninstallation to continue without additional user interaction.

Uninstalling Silently

To perform a silent uninstall of VisionPro, use the following command from the 64-bit installation image downloaded from the Cognex Corporation support site:

setup /s /v"/qn REMOVE=all"

To uninstall the drivers silently, use the same command in the directory where you installed the Cognex drivers.

If you uninstall the Cognex drivers silently, then the uninstall process will automatically reboot your PC when it completes.

To uninstall the Asian language versions of VisionPro documentation, run the following command in the \vprolocalizeddocs directory:

setup /s /v"/qn REMOVE=all"
Uninstalling Silently Without Installation Image

To perform a silent uninstall of any VisionPro component without the installation image, use the Windows msiexec and the globally unique identifier (GUID) of the particular component, as listed in the following table:

Table 5. Silent Uninstallation without Installation Media
ApplicationUninstall with msiexec
Cognex VisionPro x64 (R) 9.3 SR1.msimsiexec /qn /X{794E6415-67A2-47B1-ABBB-56A8B43EE671}
Cognex VisionPro x64 (R) 9.3 SR1 Asian Documents.msimsiexec /qn /X{F7E41F88-CAB3-4188-9DBB-13E63F0F35A7}
Cognex x64 Drivers 5.10msiexec /qn /X{14E34774-1B38-497A-83CA-0D048792B373}
Creating Desktop Shortcuts

Various command line switches allow you to create a desktop short for VisionPro utilities:

Table 6. Command Line Switches for
UtilityExecutableCommand Line Switch
GigE Vision Configuratorgigeconfiggui.exeGIGECONFIGSHORTCUT=1
Comm Card ConfiguratorCognex.VisionPro.Comm.EthernetConfigurator.exeCOMMCARDCONFIGSHORTCUT=1

Command line switches can be combined on the command line. For example, the following command launches the VisionPro installer interactively and will include these desktop shortcuts:

setup /v”COMMCARDCONFIGSHORTCUT=1 GIGECONFIGSHORTCUT=1”

The following command installs VisionPro silently to the default install path and includes desktop shortcuts:

setup /s /v”/qn ADDLOCAL=vpro COMMCARDCONFIGSHORTCUT=1 GIGECONFIGSHORTCUT=1”