Install Configuration Clients

Hide Topic ContentsShow Topic Contents
  1. Install ATS Inspect Configuration Clients
    1. Command Line Options

Install ATS Inspect Configuration Clients

For users that are required to configure the Inspect system, a separate installer is provided.  The Configuration Client installer contains Inspect Cockpit, Form Composer and View Composer.  This provides a quick and convenient method of deploying the applications to administrative areas.  Should previous versions of these application exist, they 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-Configuration-Clients-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.

Select one of the following installation types:

Complete - All program features will be installed..

Custom - Allows users to choose which program features will be installed and where they will be installed. Recommended for advanced users..

The installation location can only be changed by using a Custom installation.

Clicking Custom will display the following screen is shown.

Select the required components as listed below.

Applications: Includes the following items:

Cockpit: This module allows you to configure all aspects of the ATS Inspect system and to enter the information required to carry out an inspection such as available concerns, products and components.

Cockpit Overview

Form Composer:  This module is a design and layout program for customizing the appearance of screens used at Inspect data collection stations.

Form Composer Overview

View Composer: This module allows users to create the views of the product that will be used by the operator to add defects.

View Composer Overview

Change the installation location by clicking Browse and selecting the installation folder.

Press Next.

Enter the FQDN of the server and port that hosts the Data Service.

Install Data Service 

Press Next.

Press Install.

Press Finish.

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

PROMPTFORSTATION_VDC

Prompt for a VDC station.

True

SUPPRESS_LICENSE_CERT

Suppress the installation of the license certificate.

False

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

"ATS-Inspect-Configuration-Clients-x.x.x.x.exe" /qn DATASERVICE_HOST="192.168.0.1" PROMPTFORSTATION_DC="True"

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

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

Select features to be installed from the command line

In addition to the options listed above, the ADDLOCAL property can be used to allow users to select which applications to install. The table below details the values to be used, which can be separated by commas.

Identifier

Description

CP

Cockpit

FC

Form Composer

VC

View Composer

For example, to install Cockpit and Form Composer, the following command could be executed:

"ATS-Inspect-Configuration-Clients-x.x.x.x.exe" /qn DATASERVICE_HOST="192.168.0.1" ADDLOCAL="CP,FC"

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?