Installation procedure

Warning

Installation requires an administrator or user with administrator rights logged into Windows. Make sure you have the latest Windows updates and drivers installed.

  • Insert the CD into the CD drive, click on open folder and start the installation by executing the visionCATS.exe file.

  • Follow the instructions.

../_images/install.jpg

Important

Installation decision: server or client.

  • In the server/client option screen:

    For the first installation (cluster or standalone installation), choose Server.

Warning

When updating, always update the server before the client(s).

Note

Do not change the server and instrument server port without any serious reason! If you have to change the ports, note the changed values in the log-book of the software or at a respective document.

  • Choose the location of the program, the images and other data:

../_images/location.png

Warning

The data will be accessed with the Local System account. Network drive will not be accessible. Please check that this account has access to the specified folder.

  • User Management option

Note

Only available for the server as it is common for the whole system.

../_images/option.png
  • Install the client(s)

    For each succeeding installation in the same cluster choose Client and search for the respective machine the server is installed on. A client can be installed with or without an instrument service (you need an instrument service if you want to connect one or more instrument on the computer). If you want to install several visionCATS clients in office places, where you will never connect any instrument, these clients can be installed without instrument service, so that only needed instrument services would be registered in the system.

Important

In order for your visionCATS server to appear, the client and server hosts should be on the same network and have File Sharing enabled (available in Network and Sharing Center).

Installer options

visionCATS also gives the ability to configure the installer execution by setting command line arguments. Command line arguments are intended to be used in mainly 2 cases:

  • The installer doesn’t find the server in the list of available servers when trying to install a visionCATS client.

  • The installer has to be launched automatically (batch installation/update or automatic installation/update without human interaction).

Examples

  • Install a server without human interaction with all parameters set to default values:

visionCATS.exe /automode
  • The regular visionCATS installer doesn’t find a server named (tlcServer.domain.com) when trying to perform a client installation:

visionCATS.exe /automode /servermode:false /serverhostname:tlcServer.domain.com
  • Install only visionCATS server:

visionCATS.exe /serveronly:true

Full usage parameters

USAGE:

visionCATS.exe [/?] [/install|/uninstall] [/automode] [/domain:<domainName>] [/serverhostname:<hostname>|<IP Address>] [/servermode:<true>|<false>] [/serveronly:<true>|<false>] [/instrumentservice:<true>|<false>] [/serverport:<value>] [/instrumentserviceport:<value>] [/installationpath:<value>] [/imagepath:<value>] [/usermanagement:<true>|<false>]

/?

Display the help message.

/install|/uninstall

Launch an installation/uninstallation. This is usually not required, as the installer automatically detects whether a visionCATS installation already exists on the current machine.

/automode

Perform an automatic installation (without human interaction). In this mode the visionCATS installer starts automatically with the installation’s phase and closes itself when the installation is finished.

Important

Even with /automode, the UAC will request administrator rigths for the installer. To avoid this blocking popup, you should start the command line window with administrator rigths, therefore the installer will directly start with these rigths.

/quiet

Perform an installation without any user interface. /automode is mandatory (or any other option which implies /automode).

/domain

Specify on which domain the server should be searched (has no effect in /automode). The default value is empty, meaning that the installer searches visionCATS installations on the current domain.

/domain:camag.ch  or  /domain:camag
/serverhostname

Specify the hostname or IP of the server (required in /automode when /servermode:false). When not in /automode, this fills the server name when choosing a client installation (useful when the automatic detection doesn’t find the desired server).

/serverhostname:tlcServer  or  /serverhostname:192.168.1.1
/servermode

Determine whether a server or a client installation must be launched. The default is false. Implies /automode.

/servermode:true
/instrumentservice

With /servermode:false, indicates whether the client installation will have its own instrument service. The default is true. Implies /automode.

/instrumentservice:true
/serveronly

Indicates whether the installation is a pure server installation, e.g. no client nor instrument service will be installed. The default is false. Implies /automode and /servermode:true.

/serveronly:true
/serverport

Indicates the port of the server about to be installed when /servermode:true, or the port of the server to add a client to when /servermode:false. The default is 10501. Implies /automode.

/serverport:12501
/instrumentserviceport

Indicates which port will be used by the instrument service (if any). The default is 10502. Implies /automode.

/instrumentserviceport:12502
/installationpath

Indicates the installation path. The default is %Program Files%/CAMAG/visionCATS. Implies /automode.

/installationpath:"D:\CAMAG\visionCATS"
/imagepath

Indicates the images path. The default is c:/Users/Public/CAMAG/Images. Implies /automode.

/imagepath:"D:\CAMAG\Images"
/usermanagement

Indicates whether the user management is activated. The default is false. Implies /automode.

/usermanagement:true