citect anywhere web client user guide · vijeo citect keyboard...

Citect Anywhere

Web Client User Guide

November 2015

Legal Information

DISCLAIMER

Schneider Electricmakes no representations or warranties with respect to thismanual and, to themaximumextent permitted by law, expressly limits its liability for breach of anywarranty that may beimplied to the replacement of thismanual with another. Further, Schneider Electric reserves the right torevise this publication at any time without incurring an obligation to notify any person of the revision.

Schneider Electric gives no expresswarranties, guarantees or conditions and to the extent permittedunder applicable laws, Schneider Electric disclaims all implied warranties, including any impliedwarranties of merchantability, fitness for a particular purpose or non-infringement of third parties’intellectual property rights.

Schneider Electric shall not be liable for any direct, indirect or consequential damages or costs of anytype arising out of any action taken by you or others related to the Example Projects.

COPYRIGHT

© Copyright 2015 Schneider Electric All rights reserved.

TRADEMARKS

Schneider Electric hasmade every effort to supply trademark information about company names,products and servicesmentioned in thismanual.

Citect, CitectHMI, Vijeo Citect, Vijeo Citect Lite, PowerSCADA Expert and CitectSCADA are eitherregistered trademarks or trademarks of Schneider Electric.

Pelco, Spectra, Sarix, Endura, are registered trademarks of Pelco, Inc.

IBM, IBMPC and IBMPC AT are registered trademarks of International BusinessMachinesCorporation.

MS-DOS,Windows,WindowsNT, Microsoft, and Excel are either registered trademarks or trademarksof Microsoft Corporation in the United States and/or other countries.

DigiBoard, PC/Xi and Com/Xi are trademarks of Digi International Inc.

Novell, Netware and Netware Lite are either registered trademarks or trademarks of Novell, Inc. in theUnited States and other countries.

dBASE is a trademark of dataBased Intelligence, Inc.

All other brands and products referenced in this document are acknowledged to be the trademarks orregistered trademarks of their respective holders.

GENERAL INFORMATION

Some product names used in thismanual are used for identification purposes only andmay betrademarks of their respective companies.

09/01/2015 edition for Schneider Electric Citect Anywhere Version 1.0.0.

Manual Revision Version 1.0.

PLEASE NOTE

Electrical equipment should be installed, operated, serviced, andmaintained only by qualified personnel.No responsibility is assumed by Schneider Electric for any consequences arising out of the use of thismaterial. © 2015 Schneider Electric. All Rights Reserved.

Validity Note

The present documentation is intended for qualified technical personnel responsible for theimplementation, operation andmaintenance of the products described. It contains information necessaryfor the proper use of the products. However, those whowish tomake amore "advanced" use of ourproductsmay find it necessary to consult our nearest distributor in order to obtain additional information.

The contents of this documentation are not contractual and in no way constitute anextension to, or restriction of, the contractual warranty clauses.

Contact Schneider Electric today at www.schneider-electric.com

http://www.citect.schneider-electric.com/

Contents

Contents 4

Safety Information 6

Chapter 1: Using Schneider Electric Citect Anywhere 8

About Citect Anywhere 8

Supported Browsers 9

Browsers Tested with Citect Anywhere 9

Important Notes 9

Chapter 2: Viewing a Vijeo Citect Client with Citect Anywhere 12

Logging on to Citect Anywhere 12

Configuring Advanced Settings 13

Changing the Display Language 14

Securely Connecting to Citect Anywhere 16

Checking Connectivity 16

Viewing a Citect Anywhere Session 17

4

Citect Anywhere Web Client User Guide

Citect Anywhere Toolbar 18

Ending a Citect Anywhere Session 18

Session Auto-logoff 19

Automatic Reconnect 19

Chapter 3: Using Citect Anywhere on Portable Devices 20

Tablet and Smartphones 20

Gestures Support 21

Automatic Display Resize 22

Running Citect Anywhere on Different Web Browsers 22

Android Operating System 22

Google Chromebooks 23

Chromebook Keyboard 24

iOS 24

5


Safety Information

Read these instructions carefully, and familiarize yourself with Citect Anywhere beforetrying to install, operate, or maintain your system. The following special messagesmayappear throughout this documentation or on the Citect Anywhere application to warn of potentialhazards or to call attention to information that clarifies or simplifies a procedure.

This is the safety alert symbol. It is used to alert you to potential personal injury hazards.Obey all safety messages that follow this symbol to avoid possible injury or death.

The addition of this symbol to a Danger or Warning safety label indicates that anelectrical hazard exists, which will result in personal injury if the instructions are notfollowed.

DANGER

DANGER indicates an imminently hazardous situation which, if not avoided, will result in death or

serious injury.

WARNING

WARNING indicates a potentially hazardous situation which, if not avoided, can result in death or

serious injury.

CAUTION

CAUTION indicates a potentially hazardous situation which, if not avoided, can result in minor or

moderate injury.

Sa fe t y I n f o rma t i o n • 6


CAUTION

CAUTION, used without the safety alert symbol, indicates a potentially hazardous situation which, if

not avoided, can result in equipment damage.

Please Note

Electrical equipment should be installed, operated, serviced, andmaintained only by qualifiedpersonnel. No responsibility is assumed by Schneider Electric for any consequences arising out ofthe use of thismaterial.

A qualified person is one who has skills and knowledge related to the construction and operation ofelectrical equipment and the installation, and has received safety training to recognize and avoidthe hazards involved.

7 • S a fe t y I n f o rma t i o n


Chapter 1: Using Schneider Electric CitectAnywhere

This guide describes how to use Schneider Electric Citect Anywhere (hereafter referred to asCitect Anywhere) to remotely connect to a Vijeo Citect client bymeans of an HTML5-compatibleweb browser.

About Citect Anywhere

Citect Anywhere enables you to remotely access a running Vijeo Citect client with amobile deviceincluding tablets and smartphones, and laptop computers. You can view and control the clientthrough a secure web browser without needing to install it on your portable device. You caninteract with the Vijeo Citect client from anywhere in real-time.

Citect Anywhere provides the following features:

l Provides user access and interaction with Vijeo Citect clients from any device that has anHTML5-compatible web browser

l Provides accesswithout the need to install, configure, update, or patch any software on aportable device

l Works on platforms that support only web applications such as theGoogle Chrome operatingsystem

Citect Anywhere Secure Gateway provides the following alternative functionswith CitectAnywhere Server:

l Provides accesswithout the need to purchase, install, configure, andmanage a VPN

l Accesses internal resources using a single Secure Gateway that is installed in a perimeternetwork, while all other resources reside securely behind an internal firewall

C h a p te r 1 : U s i n g S c h n e i d e r E l e c t r i c C i t e c t A n yw h e r e • 8


l Installs a single Secure Socket Layer (SSL) digital certificate on the Secure Gateway nodeinstead of installing on every host that needs to be accessed

Supported Browsers

With Citect Anywhere, users can access remote Vijeo Citect fromHTML5 compatible webbrowsers on any device including smartphones, tablets, and laptop computers. To start a session,navigate to the start.html file that is installed on the Citect Anywhere Server. To do this, point abrowser to the Citect Anywhere Server URL:

https://computer name or IP address:8080

Browsers Tested with Citect Anywhere

l Microsoft Internet Explorer 10 and 11

l Microsoft Edge

l Google Chrome 33

l Safari 8 on Apple iOS

Note: Browser extensions and toolbarsmay inject JavaScript code into web pages, which canadversely impact the behavior of certain web pages. If Citect Anywhere is not working properly,disable or uninstall any active browser extensions or tool bars. Restart the web browser afteruninstalling or disabling an extension to confirm that it is no longer active.

Important Notes

Certain versions of the above listed browsers, such as Safari 5 and 6, and Chrome 11-27 are intheory functionally compatible with Citect Anywhere. Youmay be able to use them, but specificbehaviors are unknown because these browser versions have not been tested with CitectAnywhere.We strongly recommend that you upgrade to one of the versions listed.

Note: Later browser versionsmay also work with Citect Anywhere, but have not been tested.

9 • S u p p o r t e d B r o w se r s


Although Citect Anywhere supports the listed browsers, you should review the Running CitectAnywhere on DifferentWeb Browsers section of this guide on page 22 for behaviors andalternatives specific to each browser.

Multiple Citect Anywhere sessionsmay be opened in different tabswithin the web browser, or indifferent browser windows.When a session is not in use (its tab or window is not displayed), it willreduce its CPU andmemory utilization on the server.

Im p o r t a n t N o te s • 1 0


11


Chapter 2: Viewing a Vijeo Citect Client withCitect Anywhere

This chapter describes how to log on to Citect Anywhere from any device with an HTML5-compatible web browser. It includes a step-by-step procedure to log on, advanced connectionsettings, and how to securely connect to Citect Anywhere.

Logging on to Citect Anywhere

To log on to the Citect Anywhere ConnectionWeb Page, follow these steps:

Note: If you have any trouble remotely connecting to the Citect Anywhere environment, seeChecking Connectivity on page 16 for help.

1. Navigate to https://<Citect AnywhereServer Node Name>:8080/. The logon form appears.

2. Enter the connection parameters.


12

Note: When using a Secure Gateway server, theUser Name andPassword fields aremandatory, otherwise they are optional.

CONNECTION

PARAMETERSDESCRIPTION

User NameCredentials to log on to the RDP host. It can optionally contain domainspecification, for example, domain\user. If it is not specified, you will beprompted for credentials by the RDP host.

PasswordCorresponding password for the user name. For security reasons, this valueshould not be saved for future connections. If it is not specified, you will beprompted for credentials by the RDP host.

Remember PasswordSelect this option to save the specified password for the next session.This option can be hidden from the web page.

3. Tap or click Connect to initiate the connection. The following progress indicator is displayed beforeconnection is established.

Configuring Advanced Settings

To configure advanced settings:

1. Click . The options appear as shown below:

1 3 • C o n f i g u r i n g Ad v a n c e d Se t t i n g s


2. Complete the following options:

OPTIONS DESCRIPTION

Enable SSLencryptionfor remotesession

Select this option to allow the client to use Secure Socket Layer (SSL) encryptedWebSocket communication to the Citect Anywhere Server.As a default, this option is selected.

CompressionandAcceleration

Select this option to enable lossy image compression for the session. The level is set bytheAcceleration Quality property.

Acceleration/ Quality

The acceleration, or degree of quality loss can be specified by selecting options from adrop down list. Faster acceleration will result in lower quality images.

ScreenResolution

Sets the resolution size of the Citect Anywhere session. Select a value from the dropdown list of values. For example: "800 x 600". For best results, select a screen resolutionthat matches your Citect project. The default may be configured by the administrator toalready match your Citect Project.

3. Click anywhere to return to the connection details.

4. Tap or click Connect to initiate the connection. The following progress indicator is displayed beforeconnection is established.

Changing the Display Language

To change the language in which the logon form and settings are displayed:

1. Click .

2. From theDisplay language list, select the required language.

C h a n g i n g th e D i s p l a y L a n g u a g e • 1 4


Note: The Display Language only applies to the logon web page, and is not propagated to theVijeo Citect client.

Note: For details about the version of Citect Anywhere you are running, click .

Depending upon the privileges your administrator has assigned, a Vijeo Citect View-only client orControl client will be launched.

A View-only client is a computer configured with view-only access to the Vijeo Citect runtimesystem. No control of the system is possible, but full access to datamonitoring is performed.

A Control client is the interface between the Vijeo Citect runtime system and an operator. If youare using Vijeo Citect on a network, all Vijeo Citect computers (on the network) are control clients.

Access to the either client depends upon the permissions granted to you by your administrator. Formore information, refer to the Citect Anywhere Installation and Configuration Guide.

Note: Click to view the Citect AnywhereWebClient User Guide.

1 5 • C h a n g i n g th e D i s p l a y L a n g u a g e


Securely Connecting to Citect Anywhere

Citect Anywhere is compatible with most VPNs. SSL and VPNs that do not support WebSocketswill require the Secure Gateway aswell. Juniper IVE version 7.4 supportsWebSockets, so theSecure Gateway is not required.

Citect Anywhere has been tested with Juniper's SA SSL VPNs. For more information aboutJuniper’s VPNs, see theSSL VPN Configuration section in the Citect Anywhere ServerInstallation and Configuration Guide. Configuration with other third-party SSL VPN applianceswillbe similar to the procedures described here (differences aremostly in terminology).

Checking Connectivity

If you have any trouble connecting remotely to Citect Anywhere, connect to the Citect Anywheredemonstration site on the Internet with the following URL:

http://www.citect-demo.schneider-electric.com/Anywhere/

If the demo site appears and you can successfully launch Vijeo Citect, the browser is compatiblewith Citect Anywhere. If the demo site works, verify that the following are true:

l You can locally connect at the Citect Anywhere node itself by using a browser listed in theBrowsers Tested section on page 6.

l TheCitect Anywhere service is running.

l Windows Firewall is configured correctly.

l TheCitect Anywhere port between your browser and the Citect Anywhere environment isavailable. The default port is 8080.

l A trusted certificatemay be required for the Citect Anywhere Secure Gateway or the CitectAnywhere Server.

l Verify network connectivity.

l Verify that the client device can reach the Citect Anywhere Server or the Citect AnywhereSecure Gateway node. The Ping and Traceroute commands come in handy in a

Se cu r e l y C o n n e c t i n g to C i t e c t A n yw h e r e • 1 6


http://www.citect-demo.schneider-electric.com/Anywhere/

Windows-based system. Third party tools exist for certain mobile devices to provide equivalentfunctionality. If you cannot reach a node by name, try using its IP address.

Viewing a Citect Anywhere Session

After successfully logging on, an RDP session is launched and Vijeo Citect starts at the remotemachine. The Vijeo Citect client appears within a browser window as shown below.

While it is connected, Citect Anywhere intercepts themouse, button, and keyboard events, andtransmits them to the RDP host. As a result, various keyboard keys andmouse buttons that areusually handled by the browser will behave differently. For example, clicking the F5 buttonnormally causes the browser to reload the current page, but when using Citect Anywhere F5 willnot reload the page. Instead, the keyboard commandwill be transmitted to and handled by theremote Vijeo Citect client.

Note: In most browsers, clicking theBack, Forward, orReload browser buttonswill cause CitectAnywhere Server to display amessage asking if you wish to leave the current page. If you decideto proceed, the remote session will be disconnected. (Some browsersmay not prompt forconfirmation).

When accessed byCitect Anywhere, a Vijeo Citect client cannot beminimized. If the remote VijeoCitect client is shut down at the server end, your session will be terminated automatically inapproximately three seconds. Closing the browser in your remote session will end the

1 7 • V i e w i n g a C i t e c t A n yw h e r e Se s s i o n


RDP session, close the client and return a Citect Anywhere license that can be used by anotheruser.

Citect Anywhere Toolbar

After connection to a Vijeo Citect client is established, click , and then click < to view the

Citect Anywhere w toolbar.

To close the toolbar, click >.

The Citect Anywhere toolbar provides the following buttons:

BUTTON DESCRIPTION

Closes the Vijeo Citect client

Navigates to the next element in the tab order

Ends the Citect Anywhere session

Displays details about the version of Citect Anywhere running on the computer

Ending a Citect Anywhere Session

To log out or disconnect, click . A message appears prompting you to confirm the action.

C i t e c t A n yw h e r e To o l b a r • 1 8


The browser returns to the connection dialog after you clickYes.

No trace of a session remains on your device after ending a session. For additional security, closethe browser tab or window that previously ran the Citect Anywhere Server session.

Session Auto-logoff

A session is logged off when you close the Vijeo Citect client. Citect Anywhere Server includes anauto-logoff feature that automatically logs off the session if nothing is displayed on the screen for aspecified period.

Automatic Reconnect

Active Citect Anywhere sessions automatically attempt to recover from temporary networkoutages by reconnecting to your session. Youmay experience a slight delay during the reconnectattempt, but after the session is re-established, you can continue working without having to logback on to the session.

1 9 • S e s s i o n Au to - l o g o f f


Chapter 3: Using Citect Anywhere on PortableDevices

This chapter describes the behavior and functionality of Citect Anywhere on different mobiledevices, web browsers, and operating systems.

Tablet and Smartphones

Citect Anywhere can operate on portable deviceswith an HTML5-compliant browser (forexample, Safari on iPad). For the list of supported browsers, see Browsers Tested with CitectAnywhere on page 9.

Mobile devices enable you to remotely access and interact with Vijeo Citect clients. Touchgestures are used to perform the tasks normally done by amouse using a desktop or laptopcomputer. Built-in software keyboards are used instead of physical keyboards. Certain mouseevents do not have an equivalent on a touch device. Software keyboards in mobile devices do nothave F1-F12, CTRL, or ALT keys. In addition, mouse hover and tool tips are not supported ontouch devices.

It is important to be aware of these differenceswhen using Citect Anywhere to remotely view theVijeo Citect client. It is also important to become familiar with the way your device implementstouch interfaces. Keep this in mind for the design of Vijeo Citect projects for use with CitectAnywhere. For example, Input animations should not need to invoke a Vijeo Citect or Windowskeyboard asmobile devices have their own.

For existing Vijeo Citect clients that make use of mouse events, keys, and/or key combinationswithout a supported equivalent in a touch environment, youmaywant to modify your client to usealternate events that will work in a touch environment.


20

The following list provides tips on using Citect Anywhere on a tablet or smartphone device withouta physical keyboard or mouse. Functionality will vary across different devices and somecommandsmay not be available.

l Single Tap performs a left click.

l Single long Tap performs a right-click.

l Tap + Hold + Drag performs a select then drag/scroll function.

l Double Tap, or tapping once with two fingers, performs double-click.

l Tapwith three fingers sends Back command to a remote browser.

l Swipe downwith three fingers is Page Up.

l Swipe up with three fingers is Page Down.

l Drag left or right with three fingers performs a left arrow and right arrow respectively.

l Tap the keyboard icon (upper right-hand corner of window) to open/close the virtual keyboard.

l Swipe and pinch gestureswill apply to the Citect Anywhere session (i.e. zoom in with pinch in).

Note:(iOS only) When saving a Citect Anywhere icon to the iOS desktop, the shortcut will openthe Citect Anywhere session in full-screenmode. The browser’s toolbar will be hidden and therewill bemore remote desktop area available.

Gestures Support

Citect Anywhere supportsmany different gestureswhen used on a touch device, such as a tablet.Tap theGestures help icon in the Toolbar to see the full list of supported gestures.

2 1 • Ge s tu r e s Su p p o r t


Automatic Display Resize

Citect Anywhere supports automatic display re-size. Whenever a browser window is re-sized, theCitect Anywhere session automatically adjusts itself to the new dimensions. To re-size a browserwindow, drag any corner of the browser window and release it when the desired dimensions arereached. If a browser is placed into full screenmode, the Citect Anywhere session willautomatically expand to the full screen.

Running Citect Anywhere on Different Web Browsers

This section describes browser-specific behaviors in Citect Anywhere. The issues are grouped byoperating systems. Alternative solutions are provided when available.

Android Operating System

This table shows the behavior of different Android browsers.

Au toma t i c D i s p l a y R e s i z e • 2 2


BROWSER(S) BEHAVIOR TYPE DESCRIPTION

All Drag and drop

Youmay experience difficulty dragging and droppingpop-up windows on the Android operating system. As aworkaround, using a stylus to perform the drag and dropoperations may improve the functionality.

Chrome Scroll bars

Scroll bars in Vijeo Citect cannot be scrolled by tappingor pressing and dragging the scroll button. Tapping onthe gray area of the scroll bar itself will provide scrollfunctionality.

Chrome Text display

When an Android tablet runs low onmemory, text in awindow can appear blurred. As a workaround, youshould close all the running applications and restart thedevice.

Chrome Text input

Typing double-byte language characters using thenative Android software keypad are always rendered asthe questionmark character (?) in a Vijeo Citect dataentry field. As a workaround, configure Citect AnywhereServer to use theWindows Keyboard option. Double-byte language characters can be entered correctly fromthe Android keypadOR by using a paired Bluetoothhardware keyboard.

Google Chromebooks

Citect Anywhere operates onGoogle Chromebook and Chromebox just like it doeswith a GoogleChrome browser. Here are some tips to keep inmind when using Citect Anywhere with aChromebook or Chromebox.

FUNCTION DESCRIPTION

Mouse Left-click Click the Chromebook trackpad with one finger.

Mouse Right-click Click the Chromebook trackpad with two fingers

Scrolling a document or websiteDrag two fingers on the Chromebook trackpad up or down toscroll

Configure Chromebook In the address field: chrome://settings

2 3 • Go o g l e C h r ome b o o k s


Chromebook Keyboard

TheChromebook keyboard lacks several keys that are used byWindows. ChromeOS providesstandardmappings that use existing keyswith theALT key to represent certain missing keys.Citect Anywhere supports these key combinations:

COMMAND KEY COMBINATION

Delete (DEL) ALT+Backspace

Page Up ALT+Up

Page Down ALT+Down

Home CTRL+ALT+Up

End CTRL+ALT+Down

In addition, Citect Anywhere provides special non-standardmappings for additional keycombinations on ChromeOS.

COMMAND KEY COMBINATION

F1 CTRL+1

F2, … CTRL+2, …

ALT+TAB ALT+`

ALT+SHIFT+TAB ALT+SHIFT+`

CTRL+Home CTRL+ATL+Left

CTRL+End CTRL+ALT+Right

iOS

This table shows the specific behavior of Safari browsers running on the iOS operating system.

BEHAVIOR

TYPEDESCRIPTION

AccessingCitectAnywhere

Youmay experience difficulty accessing Citect Anywhere. This can occur if the PrivateBrowsing option is left in Enabled state. Private browsing is enabled if Safari bars appearblack or dark instead of blue or gray. As a workaround, navigate to Settings, then Safari, anddisable private browsing.

C h r ome b o o k Ke y b o a r d • 2 4


BEHAVIOR

TYPEDESCRIPTION

Refreshcurrentpage

When you click to refresh or navigate away from the current page while connected to theCitect Anywhere server, you will not be prompted to confirm your action, whichmay result inunwanted page navigation. There is no workaround.

InvokingVijeoCitectkeyboard

A user input animationmay not bring up the Vijeo Citect keyboard and the alphabetic re-sizeable keyboard is not functional. The recommended workaround is to use the device'sbuilt-in keyboard.

Movingbetweentext boxes

The Next and Previous buttons are not enabled tomove between text boxes on dialog boxeswith multiple text boxes. As a workaround, use a touch gesture to transfer focus.

Text inputDouble-byte language characters do not appear in a Vijeo Citect data entry field when typedusing the native iPad software keypad.

2 5 • i OS


citect anywhere web client user guide · vijeo citect keyboard...

Documents