Install Data Collect

Hide Topic ContentsShow Topic Contents
  1. Install ATS Inspect Data Collect
    1. Command Line Options

Install ATS Inspect Data Collect

For computers that require Inspect Data Collect, a separate installer is provided.  This provides a quick and convenient method of deploying the application to the shop floor.  Should a previous version exist, it must be uninstalled before proceeding.

You must run the Inspect installation with administrative rights. In Windows 10 and above you must also have elevated rights.

Install the latest ASP.NET Core Runtime 9.0.0 x64 and .NET Desktop Runtime 9.0.0 x64 executables.

Download .Net 9 Installers

Run the ATS-Inspect-Data-Collect-x.x.x.x.exe.  The following screen will be displayed.

Click Next.

If required, change the installation location.

Select “I agree to the License terms and conditions" and click Next to proceed.

Enter the endpoint for the Data Service.

The format of the endpoint must be https://machine.domain:portnumber.

Either tick the Prompt for station checkbox or enter a Station code.

If the Prompt for station checkbox is ticked, a popup window opens when Data Collect is run and enables the operator to select the station. This option can be changed later in Cockpit.

Press Next.

Press Install.

When the installation is complete, press Finish to close the installation program.

It may be necessary to update Microsoft Edge WebView2 following installation.  To download the latest version, please visit the following link.
Microsoft Edge WebView2

Command Line Options

The following command line options can be specified when running the Inspect Client installer from the command line. Their values will be written to the .config files of the relevant applications and will be used when running the application:

Option

Description

Default Value

DATASERVICE_ENDPOINT

The hostname/IP that Data Service will run on.

localhost

DATASERVICE_BASEPORT

The port that Data Service will run on.

8500

PROMPTFORSTATION_DC

Prompt for a DC station

True

SUPPRESS_LICENSE_CERT

Suppress the installation of the license certificate.

False

INSTALLLEVEL

Set the install level (which features get installed)

1

To perform an unattended Inspect Client installation, run the following command line as an administrator:

"ATS-Inspect-Data-Collect-x.x.x.x.exe" /qn DATASERVICE_HOST="192.168.0.1" INSTALLLEVEL="1" PROMPTFORSTATION_DC="False" STATIONCODE_DC="Trim"

Replace the values in the above example to match your configuration.

For further information on command line options, please click the link .

SUPPRESS_LICENSE_CERT - Use customer certificate

In the instance where a customer wishes to use their own certificate and leverage the SUPPRESS_LICENSE_CERT command during installation, a couple of configuration changes are required.

Global Settings Table

The wcf_license_svc_endpoint in the global_settings table in the Inspect database needs to be appended with |certificate subject.

net.tcp://INSPECTAPPSERVER1.domain.local:8011/ATSLicensingServer/Licensing|INSPECTAPPSERVER1.domain.local

Load SQL Managment Studio and login.

Browse to Databases, the Inspect Database, Tables and load the global_settings table.

In the wcf_license_svc_endpoint field append the certificate subject.

Tab to the next line to apply the changes.

LicenseServiceHost.exe.config

The LicenseServiceHost.exe.config file has to be updated to include the server name.

Browse to C:\Program Files (x86)\Applied Tech Systems\ATS Licensing Server\ATS Licensing WCF Communicator.

Open the LicenseServiceHost.exe.config file.

Browse to the following section.

<setting name="CertificateName" serializeAs="String">
   <value>ATS Licensing</value>
</setting>

Change the text between the value tags to the server name (FQDN).

<setting name="CertificateName" serializeAs="String">
    <value>servername.domain</value>
</setting>

<setting name="CertificateName" serializeAs="String">
    <value>INSPECTAPPSERVER1.domain.local</value>
</setting>

Save the file.

Can we improve this topic?