View
370
Download
7
Category
Preview:
Citation preview
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
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
Citect Anywhere Web Client User Guide
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
Citect Anywhere Web Client User Guide
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
Citect Anywhere Web Client User Guide
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
Citect Anywhere Web Client User Guide
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
Citect Anywhere Web Client User Guide
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
Citect Anywhere Web Client User Guide
11
Citect Anywhere Web Client User Guide
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.
Citect Anywhere Web Client User Guide
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
Citect Anywhere Web Client User Guide
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
Citect Anywhere Web Client User Guide
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
Citect Anywhere Web Client User Guide
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
Citect Anywhere Web Client User Guide
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
Citect Anywhere Web Client User Guide
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
Citect Anywhere Web Client User Guide
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
Citect Anywhere Web Client User Guide
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.
Citect Anywhere Web Client User Guide
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
Citect Anywhere Web Client User Guide
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
Citect Anywhere Web Client User Guide
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
Citect Anywhere Web Client User Guide
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
Citect Anywhere Web Client User Guide
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
Recommended