Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

This page covers the setup and management of remote clients for the software platform. It details the supported client types: Windows (WPF) Rich Clients, Windows (WPF) Smart Clients, and HTML5 Clients. Instructions for installation, configuration, and automatic startup of these clients are provided. The guide also explains how to configure remote client users and manage client settings using parameters. Additionally, details on utilizing Windows Rich Clients for application deployment are included.

Easy Heading MacroheadingIndent40navigationTitle

On this page:

selector

Table of Contents

h2,h3

maxLevel

wrapNavigationText

3

true

stylenone


Client Types

navigationExpandOptiondisable-expand-collapse This page presents information about remote clients setup.

Overview

The platform can accept multiple clients.They are:

  • Windows (WPF) Rich Clients
  • Windows Smart ClientsWindows Web (WPF) Smart Clients
  • HTML5 Clients
  • IOS Clients

We will describe what is required for the installation and configuration of each one of these clients.


Remote Client Users Setup

Windows Rich Clients

Rich clients are client applications that do a significant amount of processing on the client computer rather than on the server. You can deploy your application to be used by Windows rich clients.

Windows rich client deployment 

Installation

Install the platform on the client computer.

How to start

Run the TRichClient.exe program. For an example of how to automatically start the client when a user logs into Windows, see "Automatically Starting Windows Clients" in the previous section.

Execution

The project runs in its own window. This  This client type has strong user security and includes the ability to disable the user from using the Windows Task Switch functionality. The ability to use or not use the Windows Task Switch can be tied to the user login. When running the TRichClientt.exe program on 64-bit machines, the application runs in 64-bit native code. If you need to run the 32-bit version, you can use the TRichClient32.exe program; this can be used to ensure compatibility with legacy COM and Active-X components.

Communication

Communicates with the server using the Windows Communication Foundation (WCF) (port configurable, default 3101).

Windows Smart Clients

Smart clients are client applications that behave like rich clients , but either run from the web or can be installed painlessly with a single click. You can deploy your application to be used by Windows smart clients. The smart client runs like the rich client, but the smart client it uses ClickOnce™ installation. This technology allows you to have the same functionality as the rich client , but without having to install our platform on your computer. 

On the The first time you access the application, the system automatically downloads the components necessary to run the application. The next time you access the application, the system verifies if the local cache is the same version of the application that is on the server, and if necessary, updates the local cache before running the application. If the version is the same, the application starts immediately.

Windows smart client deployment 

Installation

No installation required. The client computer needs to have the .NET Framework 4.0 and Internet Explorer 8.0 or later. 
On the first time you start the application, it will automatically download the required components from the server. Every time the application starts, it automatically verifies if a new version is available on the server.

How to start

From Internet Explorer (or a shortcut) go to the URL:
http://<ServerIPAddressorName:Port>/smartclient/  

http:/<ServerIPAddressorName>/fs-2018/127.0.0.1/ TSmartClient.application  :3101/smartclient
For an example of how to automatically start the client when a user logs into Windows, see Automatically Starting Windows Clients <<<<.insert link to the page>>>> in in the previous section.

Execution

Runs exactly the same as the rich client. The functionality of the rich client and the smart client are the same; only the installation and activation methods are different.

Communication

Communicates with the server using WCF (port configurable, default 3101).

Windows Web Clients

A web client accesses the application using a web browser. You can deploy your application for use by Windows web clients.

Windows web client deployment

Installation

No installation required. The client computer needs to have the .NET Framework 4.0 and Internet Explorer 8.0 or later. 
On the first time you start the application, it will automatically download the required components from the server. Every time the application starts, it automatically verifies if a new version is available on the server.

How to start

From Internet Explorer (or a shortcut) go to the URL:
http://<ServerIPAddressorName>/fs-2018.1 /TWebClient.Xbap
For an example of how to automatically start the client when a user logs into Windows, see Automatically Starting Windows Clients <<<<.insert link to the page>>>> in the previous section.

Execution

Runs inside a web browser window using "Partial Trust" (Sandbox Security).

Communication

Communicates with the server using HTTP or HTTPS (port 80).

Automatically Starting Windows Clients

Depending on the client type, you can create a shortcut to the appropriate executable to automatically start the application on a Windows client. You can create the shortcut on the desktop or put place it into in the Startup folder, as described below.

For web clients, you can configure the application as the home page for Internet Explorer.

Go to Start → All Programs, right-click the Startup folder, and select Open to open the Startup folder.

  • In the Startup folder, right-click and select New → Shortcut.
  • In the Create Shortcut window, paste the path into the input field that displays.
  • If you are not using redundancy, delete the redundancy part of the text.
  • Do one of the following:
    • For rich clients—At the beginning of the command line, enter or paste the full path to the platform's installation folder and put quotes around it. It should look something like this: "C:\Program Files (x86)\Tatsoft\FactoryStudio\fs-2018.1\ TRichClient<installFolder>TRichClient.exe" /ip1:<IP_address>
    • For smart or web clients—At the beginning of the command line, enter or paste the full path to the Internet Explorer Browser installation folder and put quotes around it. It should look something like this: "C:\Program Files (x86)\Internet Explorer\iexplorer.exe" http:<IP_address>/fs-2018.1/TSmartClient.application "C:\Program Files (x86)\Internet Explorer\iexplorer.exe" http:<IP_address>/fs-2018.1/TWebClient.Xbap
  • Click Next.
  • Enter a name for the shortcut.
  • Click Finish.

The next time you restart the computer, the project will start automatically.

iOS Clients

You can deploy your application for use by iOS clients: iPad, iPhone, and iTouch. For other tablet devices, contact support.

iOS deployment 

Installation

Install the SCADA HMI Client app from the Apple Store.

How to start

Start the SCADA HMI Client app and follow the initial setup options.

Execution

It runs natively on iOS. Thus, it provides higher performance, enhanced security, and access to native graphical components. This is compared to other applications using Terminal Client, Remote Desktop, or HTML web.

Communication

Communicates with the server by calling a web service using port 80. The server must be on the same VPN or local network as the iOS device, or it can be a public IP address, as long as HTTP access is enabled.

To deploy your project on an iOS device:

  • From your iOS device, tap the App Store icon. You can also go to the Apple App Store from iTunes.
  • Search for and install the SCADA HMI Client app.
  • Start the SCADA HMI Client app.
  • Enter the following information:

Field

Description

Host Server

IP address or name of the project server.

Port

Port 80.

Polling

Defines the refresh rate between the client and the server, expressed in quarters of a second. The default value of 1 means the client gets new data from the server every 250 ms. When connecting to servers located on the internet or low bandwidth networks, this value should be increased. For more information, refer to the app's help section.

User

Project user name as it is configured in the project. The default is guest.

Password

Project password associated with the user name.

Project

Project name on the remote project server.

  • Tap Login. The application's graphics and displays download before the application starts. The application may take longer than normal to startup the first time the application is started.

Auto-Start SmartClient or HTML5 clients

Helping to deliver maximum uptime for your users, the Auto-Start SmartClient (ASSC) is a self-healing watchdog application that helps ensure your remote SmartClient applications are always up and running.

The Auto-Start SmartClient can also act a WatchDog Application, restoring automatically all the connected clients then the server

  1. The ASSC periodically checks to ensure the TSmartClient is running.
  2. If not, then the ASSC checks to see if it can reach the Project on the Project Server.
  3. And if it can, the ASSC will restart the TSmartClient automatically for you!

Image Added



Configuration Overview

The Auto-Start SmartClient watchdog application is used to automatically start the TSmartClient in your project's remote stations. When installing the software, the file AutoStartSmartClient.exe will be added to the installation folder.

In the current version, the files AutoStartSmartClient.exe and AutoStartSmartClient.exe.config must be manually copied from the server station's installation folder to a folder on the remote station. After copying the ASSC application to the remote station, the user must configure the .config file; otherwise, the ASSC will start up with several parameters that will take priority over any parameters in the .config file.

Note

The Remote Station must have already installed Microsoft .Net Framework 4.0 or 4.5.


When the ASSC application is running on the remote station, it will check every 30 seconds to see if the TSmartClient is running, or the user can set a time parameter for how often the application checks.

If the TSmartClient is not running, the ASSC application will refer to its configuration parameters to check for any communication with the server station. If the ASSC application is able to connect with the project through the TServer on the server station, it will restart the TSmartClient on the remote station using the URL parameter.


Image Added



Parameters Configuration

Before running the application, you need to set the parameters in the AutoStartSmartClient.exe.config file. You can also pass the parameters by using a shortcut file.

The available parameters are:

Info
  • url : The SmartClient url that is found at Info → Redundancy
  • hidden: A flag (true or false) used to set whether a popup is visible or runs in the background.

   TRUE: window runs in background

   FALSE: window is visible (default)

  • browser : The browser that will be used to run SmartClient. Internet Explorer is the default browser.
  • timer : The time (in seconds) between each attempt to retry the connection. 
  • ip: The computer IP for the computer running the runtime service, TServer.exe. 
  • port: The SmartClient listening port.  By default, TServer.exe runs on port 3101. 
  • username: The RuntimeUser that is logged in. The default username is guest. 
  • password: A user created custom password.
  • viewonly: A flag (true or false) to see if a project can be edited or is view only.

   TRUE: Project is view only

   FALSE: Project can be modified (default)



Configuration Example

To pass the parameters in the AutoStartSmartClient.exe file, you must create a shortcut to the file in a folder on the remote station. To do so, go to the installation folder and search for the executable.

Right-click on the file and select Create Shortcut. Then, place it in the desired folder. In order to finalize the configuration, right-click the newly created shortcut and select Properties.

Configure the file path as:

Code Block
AutoStartSmartClient.exe /url:http://<IP Address>/<binary folder>/TSmartClient.application /timer:<seconds>

E.g.: AutoStartSmartClient.exe /url:http://192.168.15.31/xx-8.1/TSmartClient.application /timer:30


The url can be copied from the Engineering environment at Runtime → Smart Client url field. See the image below:

Image Added


After setting the configurations, double-click the shortcut file and keep it running. You should see a window open with a message saying the application is waiting for the TServer to run. Once the project is executed, the TSmartClient will open automatically.

Note

The TSmartClient needs a WebServer (ISS or TWebServer) running properly on the server computer.


Image Added



In this section:

In this section...

Page Tree
root@parent
spacesV10