30-3001-835 Webclient Planning and Installation Guide
30-3001-835 Webclient Planning and Installation Guide
30-3001-835 Webclient Planning and Installation Guide
Client
Planning and Installation Guide
for Version 1.94
© 2012, Schneider Electric
The information in this document is furnished for informational purposes only, is subject
to change without notice, and should not be construed as a commitment by Schneider Elec-
tric. Schneider Electric assumes no liability for any errors or inaccuracies that may appear
in this document.
On October 1st, 2009, TAC became the Buildings Business of its parent company Schneider
Electric. This document reflects the visual identity of Schneider Electric. However, there
remain references to TAC as a corporate brand throughout the Andover Continuum soft-
ware. In those instances, the documentation text still refers to TAC — only to portray the
user interface accurately. As the software is updated, these documentation references will
be changed to reflect appropriate brand and software changes. All brand names, trade-
marks and registered marks are the property of their respective owners.
Schneider Electric
One High Street
North Andover, MA 01845
(978) 975-9600
Fax: (978) 975-9782
http://www.schneider-electric.com/buildings
Andover Continuum web.Client
Planning and Installation Guide
30-3001-835
Version 1.94
Contents
6 Schneider Electric
Configuring DCOM Default Security Settings ......................... 102
Configuring Default Launch and Access Permissions ..... 102
Disabling HTTP Keep-Alives ...................................................... 105
Resetting Timeout and Live Events Via web.config File .......... 105
Inactivity Timeout .............................................................. 106
Live EventView .................................................................. 106
Establishing SSL Support for Confidential Information .......... 107
Using SSL Online Documentation .................................... 107
Changing IE Security Internet Options to Accommodate
SSL ...................................................................................... 110
Enabling SSL for web.Client ............................................. 111
Setting Up SSL for web.Client Pinpoint ........................... 111
Changing the Default TCP Port Number .................................. 114
8 Schneider Electric
About this Manual
Revision History
This manual documents web.Client, Version 1.94.
Revision History
Document Revision Software Version Date
1.94 1.94 May 2012
1.93 1.93 March 2011
1.92 1.92 December, 2010
1.91 1.91 February, 2010
1.9 1.9 August, 2008
1.82 1.82 January, 2008
1.81 1.81 June, 2007
1.8 1.8 December, 2006
1.74 1.74 August, 2006
1.73 1.73 January, 2006
1.71 1.71 May, 2005
1.7 1.7 December, 2004
1.62 1.62 March, 2004
1.6 1.6 August, 2003
1.52 1.52 December, 2002
1.5 1.5 October, 2002
Related Documentation
For additional or related information, refer to these documents.
Related Documents
Document
Document Number
Andover Continuum CyberStation Installation Guide 30-3001-720
CyberStation Access Control Essentials Guide 30-3001-405
CyberStation HVAC Essentials Guide 30-3001-1000
web.Client online help (Version 1.94)
10 Schneider Electric
About this Manual
Symbols Used
The Notes, Cautions, Warnings, and Hazards in this manual are
defined, as follows.
CAUTION
Type of hazard
How to avoid hazard.
Failure to observe this precaution can result in injury or equipment
damage.
WARNING
Type of hazard
How to avoid hazard.
Failure to observe this precaution can result in severe injury.
DANGER
ELECTRIC SHOCK HAZARD
How to avoid hazard.
Failure to observe these instructions will result in death or serious
injury.
12 Schneider Electric
Chapter 1
Introduction to web.Client
z web.Client Overview
z web.Client User Documentation
z A Typical System before web.Client
z A Typical System Implementing web.Client
z Differences between web.Client and CyberStation
Overview
This manual provides you, the system administrator, with general
information for planning, installing, and configuring your Andover
Continuum web.Client system, version 1.94.
CAUTION
This manual is for system administrators.
To use the installation and setup procedures in this manual you must be a system
administrator with experience in setting up a web server. You must also have
experience using Microsoft system software and understand that there are graphical
user-interface differences between the different Windows platforms. For detailed
information about Microsoft software, please see your Microsoft Windows online help
and visit www.microsoft.com and other Microsoft web sites.
Failure to observe this precaution can result in incorrect system
configuration.
Note: The procedures in this manual presume you and your users are installing or
upgrading to web.Client version 1.94. You must meet the software and
hardware requirements compatible with version 1.94. Refer to Chapter 2,
System and Pre-Installation Requirements.
web.Client Overview
web.Client is an application that provides you with web-enabled access
everywhere, all the time. By using a standard browser, your authorized
personnel can access the Continuum facility management system in
real time across your site’s local area network (LAN) or across your
wide-area network (WAN).
With the basic web.Client Personnel Manager option, your users can:
14 Schneider Electric
Chapter 1: Introduction to web.Client
16 Schneider Electric
Chapter 1: Introduction to web.Client
z A database server
z Dedicated workstations for configuration
z A dedicated web.Client application server
z PCs running Internet Explorer 8.0 connecting web.Client
Note: You will be installing either a web.Client for a LAN system or a standalone
with web.Client. A LAN system has two servers: a database server and a
web.Client application server. In a standalone system, the database and
web.Client application reside on one server. Chapter 2, System and Pre-
Installation Requirements, provides detailed requirements for both systems.
You use the dedicated workstation, and the authorized personnel use
web.Client on their own computers.
18 Schneider Electric
Chapter 1: Introduction to web.Client
Doors X X
Controller Web Pages X
1. Video can be modified, but not saved. For example, you can change cameras,
show/hide time, change focus, zoom, but you will lose these changes if the
page is refreshed or you open another editor.
20 Schneider Electric
Chapter 2
System and Pre-Installation
Requirements
Standalone 1 2 2 2 2 1 1
22 Schneider Electric
Chapter 2: System and Pre-Installation Requirements
1. A total of three machines (web.Client browser PCs plus CyberStations) is the maximum num-
ber allowed on a standalone system. This means the following combinations are valid: Two
web.Client connections and one CyberStation, one web.Client connection and two CyberSta-
tions, or three CyberStations (if there are no web.Client connections).
If your system has no more than 25 users, select one server as the
web.Client IIS server. This IIS server should be dedicated to running
the web.Client application. For a larger LAN system (at least for any
system having more than 25 users) your site must have more than one
IIS server.
Depending on your particular LAN installation, the IIS server can be:
See also:
The following table shows the hardware and software requirements for
the IIS server and the client browser on LAN systems.
Note: Every connection to the IIS server by a browser PC accessing web.Client uses 5
MB of RAM on the IIS server. (For example, two browser PCs connected to the
IIS server accessing web.Client use 10 MB of RAM on the IIS server. For this
configuration, Schneider Electric recommends a minimum of 512 MB plus 10
MB (used by the two PCs) or a minimum of 522 MB of RAM on the IIS Server.)
24 Schneider Electric
Chapter 2: System and Pre-Installation Requirements
Video-Specific Requirements
Minimum Recommended
100 Mbps network port 1 Gb network port
Graphics card with DirectX 9.x or later DirectX 10 graphics device with WDDM
with 256 Mb of dedicated RAM 1.0 or higher driver with 512 Mb of
dedicated RAM
Note: Andover Continuum uses stream 2 to display video through video interfaces.
Per standard Pelco Endura video configuration, you should configure stream 2. When
doing so, be sure to set a lower resolution and smaller frame rate. Otherwise, the
performance of your PC may be negatively affected. Be aware that Andover
Continuum only supports H.264 and MPEG4 video formats.
1. Internet Explorer, IIS, and TCP/IP are included with the Microsoft operating systems.
Upgrades and service packs are available free of charge from Microsoft’s web site,
www.microsoft.com.
26 Schneider Electric
Chapter 2: System and Pre-Installation Requirements
The following table shows the Browser PCs that are recommended for
LAN systems.
Note: The standalone system can accommodate two user connections (browser PCs).
If you require more than two users, then you must upgrade to a LAN system
with Windows Server 2003 (maximum 25 users).
web.Client version 1.94 will upgrade any previous version’s IIS server.
web.Client 1.94 includes Cyberstation 1.94, and installing it upgrades
the IIS machine to 1.94. Workstations other than the IIS server that
are not at version 1.94 must be upgraded before installing web.Client.
See also:
The following table lists hardware and software requirements for the
IIS workstation and the client browser on standalone systems.
Note: Every connection to the IIS server by a browser PC accessing web.Client uses 5
MB of RAM on the IIS server. For example, two browser PCs connected to the
IIS server accessing web.Client use 10 MB of RAM on the IIS server. In this
configuration, Schneider Electric recommends a minimum of 512 MB plus 10
MB (used by the two PCs) or a minimum of 522 MB of RAM on the IIS Server.)
28 Schneider Electric
Chapter 2: System and Pre-Installation Requirements
Video-Specific Requirements
Minimum Recommended
100 Mbps network port 1 Gb network port
Graphics card with DirectX 9.x or later DirectX 10 graphics device with WDDM
with 256 Mb of dedicated RAM 1.0 or higher driver with 512 Mb of
dedicated RAM
Note: Andover Continuum uses stream 2 to display video through video interfaces.
Per standard Pelco Endura video configuration, you should configure stream 2. When
doing so, be sure to set a lower resolution and smaller frame rate. Otherwise, the
performance on your PC may be negatively affected. Be aware that Andover
Continuum only supports H.264 and MPEG4 video formats.
30 Schneider Electric
Chapter 2: System and Pre-Installation Requirements
The following table shows the browser PCs that are recommended for
standalone systems.
CAUTION
Microsoft system experience required.
To perform this standard Microsoft procedure, you must have administrative
experience using Microsoft system software and understand that there are differences
in the graphical user interfaces between different Windows platforms. User interface
illustrations are not always provided. Please see your Microsoft Windows online help
and visit www.microsoft.com and other Microsoft web sites.
Failure to observe this precaution can result in incorrect system
configuration.
To avoid this problem, be sure that IIS has been installed on the server
before Microsoft .NET Framework 2.0 is installed.
C:\Windows\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis.exe -i
32 Schneider Electric
Chapter 2: System and Pre-Installation Requirements
3. In the Add Roles Wizard, Before You Begin page, click Next.
34 Schneider Electric
Chapter 2: System and Pre-Installation Requirements
36 Schneider Electric
Chapter 2: System and Pre-Installation Requirements
38 Schneider Electric
Chapter 2: System and Pre-Installation Requirements
40 Schneider Electric
Chapter 2: System and Pre-Installation Requirements
12. In the Select Role Services page, check the IIS 6 Management
Compatibility checkbox.
42 Schneider Electric
Chapter 2: System and Pre-Installation Requirements
For Windows Server 2003: Follow this procedure to install IIS 6.0:
44 Schneider Electric
Chapter 2: System and Pre-Installation Requirements
3. In the tree, right click on the machine name, and select Properties
from the popup menu. The Properties dialog appears.
4. Click the MIME Types button. The MIME Types dialog appears.
6. In the Extension field, enter .pin and in the MIME type field,
enter pinfiles/plain.
8. Click OK.
46 Schneider Electric
Chapter 2: System and Pre-Installation Requirements
5. When the selection control appears in the second column, click this
button.
7. Click OK.
48 Schneider Electric
Chapter 2: System and Pre-Installation Requirements
3. In the content pane, under IIS, double click MIME Types. The
Add MIME Type dialog appears.
8. Click OK.
50 Schneider Electric
Chapter 2: System and Pre-Installation Requirements
Changing the Default TCP Web Port Number for the IIS PC
Normally, the IIS PC defaults to Internet TCP port 80. Some Internet-
access providers do not use port 80. You can change this port number
from 80 to another port number. This can be done before or after
web.Client installation. For more information, please see Changing the
Default TCP Port Number in Chapter 3
1. From the Windows Control Panel, double click WSP Client. The
Microsoft WinSock Proxy Client dialog appears.
Note: After installing web.Client, be sure you configure Distributed COM (DCOM)
default security settings and disable HTTP keep-alives. For those Microsoft
procedures, see Chapter 3, Installing and Configuring web.Client on the IIS
PC. See also Appendix A, web.Client Security and Troubleshooting Tips for
troubleshooting tips.
52 Schneider Electric
Chapter 2: System and Pre-Installation Requirements
You should also ensure that you disable Windows Firewall for all
Windows operating systems. For Windows Server 2008 and Windows 7,
follow these instructions:
54 Schneider Electric
Chapter 2: System and Pre-Installation Requirements
10. In Control Panel, click System and Security and then Action
Center.
11. Disable the anti-virus software. For more information, see the anti-
virus product documentation.
12. Install the Andover Continuum software. Be sure to run the setup
as administrator.
Users\<Username>\AppData\Local\VirtualStore\Program
Files\Continuum\NewGraphicsFiles
Users\<Username>\AppData\Local\VirtualStore\Program Files
(x86)\Continuum\NewGraphicsFiles
CAUTION
If you are an Andover Continuum administrator, you resolve this
issue by either turning off User Account Control or allowing
read\write permissions to the Program Files\Continuum or Program
Files (x86)\Continuum folder for all of your Standard users.
56 Schneider Electric
Chapter 3
Installing and Configuring
web.Client on the IIS PC
z Overview
z Installing web.Client on the IIS PC
z web.Client Video System Upgrades
z Configuring Your Video Servers
z Configuring Graphics Folders for web.Client: Windows XP and
Windows Server 2003
z Configuring Graphics Folders for web.Client: Windows Server 2008
and Windows 7
z Establishing Pinpoint Folders
z Configuring DCOM Default Security Settings
z Disabling HTTP Keep-Alives
z Resetting Timeout and Live Events Via web.config File
z Establishing SSL Support for Confidential Information
z Changing the Default TCP Port Number
Overview
This chapter provides instructions for installing and configuring
web.Client version 1.94 on the IIS PC, defined as follows:
z The IIS PC on a LAN system is the IIS server with Windows Server
2003, Windows Server 2008, Windows XP Professional workstation,
or Windows 7.
z The IIS PC on a standalone system with web.Client is the single
machine (Windows XP Professional workstation, Windows Server
2003, or Windows 7) on which both IIS and Continuum database
reside.
CAUTION
Microsoft system experience required.
To perform this standard Microsoft procedure, you must have administrative
experience using Microsoft system software and understand that there are differences
in the graphical user interfaces between different Windows platforms. User-interface
illustrations are not provided. Please see your Microsoft Windows online help and visit
www.microsoft.com and other Microsoft web sites.
Failure to observe this precaution can result in incorrect system
configuration.
58 Schneider Electric
Chapter 3: Installing and Configuring web.Client on the IIS PC
Note: If you do not have the correct Microsoft service pack installed, you will receive a
warning message, asking you to install the correct software. See Chapter 2 for
software requirements.
If your key is not enabled for web.Client, you will receive a warning
message. You may continue with the installation or cancel.
60 Schneider Electric
Chapter 3: Installing and Configuring web.Client on the IIS PC
The Enter Text screen asks you to provide the web.Client Virtual
Directory Alias. Keep the default alias (WebClient) or provide your
own alias. Click Next to continue.
62 Schneider Electric
Chapter 3: Installing and Configuring web.Client on the IIS PC
Then, you are asked if you would like to read the latest web.Client
release notes. Click Yes or No.
Finally, you are asked if you would like to run the Database
Initialization program now. Click Yes or No.
64 Schneider Electric
Chapter 3: Installing and Configuring web.Client on the IIS PC
CAUTION
Close all applications on your computer before installation.
After SQL Express is installed, your PC restarts immediately. You cannot restart your
computer later. Be sure to close all open applications on your computer.
Failure to observe this precaution will result in the loss of your work.
66 Schneider Electric
Chapter 3: Installing and Configuring web.Client on the IIS PC
Note: If you are upgrading to Version 1.94, and you accepted the pre-1.94 default
password, Pyramid97, you must enter Pyramid97 here. If you are installing
web.client for the first time, use a password of your choice.
This password must meet Microsoft SQL Server rules for the
composition of a password:
The password must be at least eight characters long.
The password must not contain all or part of the user’s account name
(three or more alphanumeric characters).
The password must not contain the following characters: comma (,),
period (.), hyphen (-), underscore (_), or number sign (#).
The password must contain characters from three of the following four
categories:
Uppercase letters (A...Z)
Digits 0...9
13. In the Windows User Name field, enter your Microsoft Windows
system user name here. This is necessary with SQL Express. You
must have administrative access in order to run the automated
scripts that are part of the database initialization process.
14. Enter your Microsoft Windows system password and confirm that
password in the Windows Password and Confirm Password
fields, respectively.
CAUTION
The password you enter here is required to execute scheduled SQL Server tasks. Should
you later change your Windows password, these scheduled tasks will no longer execute.
To correct this, access the Scheduled Tasks in Windows and change their password with
the Set Password button in their Properties dialog
Note: Be sure the Create Default List Views, Create System List Views, Create
System Alarm Enrollments, and Enhanced Alarm Logging boxes are
checked. If you leave them unchecked, CyberStation does not import the
necessary dump files. The dump files generate all of the default views, so the
listviews and alarms are not created. In addition, faster alarm logging is not
activated. The dump file import happens as soon as the workstation is started
for the first time after installation and the appropriate files are placed in
folders. For more information on Listviews, alarms, and alarm logging, please
see the Continuum CyberStation online help.
a. Create Default List Views - Check this box to import and create list-
views (from the ASCII dump file, DefaultListViews.dmp) for all Cyber-
Station object classes.
68 Schneider Electric
Chapter 3: Installing and Configuring web.Client on the IIS PC
b. Create System List Views - Check this box to import and create list-
views (from the ASCII dump file, List.dmp) for system information
other than object class defaults (for example, all events).
c. Create System Alarm Enrollments - Check this box to import con-
figured system AlarmEnrollment objects (from the ASCII dump file,
SystemAlarms.dmp). These define the basic conditions under which
CyberStation points go into alarm.
d. Create/Update Graphical Report Settings - Check this box to
import graphical report templates. CyberStation supplies many
Report templates that include bar-chart templates, pie-chart tem-
plates, and trend templates, giving Reports a certain default “look and
feel.” If you do not check this box, then these report templates will not
be available. For more information on Reports, see the Continuum
CyberStation online help.
e. Enhanced Alarm Logging - Check this box to activate an enhanced
method that automatically speeds up the process of logging alarms
with workstations. Without enhanced alarm logging, configuration of
workstation recipients in EventNotification objects becomes more
cumbersome.
Note: If the Enhanced Alarm Logging checkbox is not checked, the Enhanced
Alarm Delivery checkbox becomes unselectable.
For more information about extended logs, please see the Continuum
CyberStation online help.
For first time installations, you should see this dialog. If, in the
very unlikely event, you do not see this dialog, it means SQL
Express is already on your computer for some other reason.
17. Select the Install SQL now radio button and click OK. SQL
Express is then installed automatically.
70 Schneider Electric
Chapter 3: Installing and Configuring web.Client on the IIS PC
18. Accept the default path, or use the browse button to select a
directory in which to install SQL Express, and click OK.
Note: If you left DB File Location at its default path, then you MUST leave SQL
Express at its default path when it is installed. If you browsed a different path
for DB File Location, then you must browse SQL Express to the same file
path
Note: Be sure that the drive you have selected has a minimum of 2 GB of free space
available.
Note: Reboot happens immediately. You do not have the choice of doing this later.
20. After rebooting, a screen telling you that SQL script is running
then appears. This screen closes automatically after a few minutes.
Note: If the SQL Server Service Manager icon is not present in the system tool
tray, try running it from the Windows Start menu. Click Start, select
Programs and Startup. The SQL Server Service Manager icon should be
there. If this does not work, contact the Schneider Electric Technical Support
department for further instructions.
72 Schneider Electric
Chapter 3: Installing and Configuring web.Client on the IIS PC
5. Click OK.
6. Click Close.
74 Schneider Electric
Chapter 3: Installing and Configuring web.Client on the IIS PC
4. Fill in the fields as shown below if you are adding a new server to a
LAN system. If this is a server upgrade, they will be populated
automatically. The Server Name field should be set to the name of
your Continuum database server.
6. Run web.Client on this machine. This will create the final objects
in the Continuum database for this workstation.
76 Schneider Electric
Chapter 3: Installing and Configuring web.Client on the IIS PC
Note: Should you choose not to learn servers and cameras now, you will need to learn
them later in Video Administrator. For more information on learning cameras ,
see the Video Administrator Settings tab in the CyberStation online help.
If you click Yes, the Learn All Video Servers - Status dialog,
shown on the next page, displays. It shows a count of the servers
and cameras as they are learned.
78 Schneider Electric
Chapter 3: Installing and Configuring web.Client on the IIS PC
3. Use the Recipient field’s browse button and the browse dialog to
search for and select the workstation that is on the IIS PC.
Note: For additional enhanced alarm delivery, ensure that the Enhanced Alarm
Delivery checkbox is checked via the Database Initialization dialog. For
detailed information on the checkboxes in the Database Initialization dialog,
please see the Andover Continuum CyberStation Installation Guide, 30-3001-
720.
1. From the system tray in the lower right corner of your screen,
right-click on the Continuum icon, and select Security from the
popup menu to open the Security editor.
80 Schneider Electric
Chapter 3: Installing and Configuring web.Client on the IIS PC
5. For each user group, edit each web.Client action to grant or deny
permission to access the web.Client feature. To grant access, click
to display a key, as shown above. To deny access, leave the lock, or
if unlocked, click to display a lock.
Note: VideoServer and VideoLayout objects are created on CyberStation. Though you
may modify a VideoLayout in web.Client, you cannot save your modifications
in web.Client; only on CyberStation.
Your users must access web.Client Pinpoint graphics file folders as URL
web-address locations on the Internet. This section presents the
following procedures:
Note: web.Client does not support multiple network interface cards (NICs).
1. Using your Windows Explorer, search for and select the folder that
you wish to access as a URL web address. For example, suppose the
folder name is NewGraphicsFiles.
2. Right click on the folder. The Properties dialog appears (in this
example, entitled NewGraphicsFiles Properties).
4. Click the Share this folder radio button. The Edit Alias dialog
appears.
82 Schneider Electric
Chapter 3: Installing and Configuring web.Client on the IIS PC
6. Click OK. This graphics folder can now be accessed via the web
address:
http://ServerName/NewGraphicsFiles
http://www.ServerName.com/NewGraphicsFiles
http://ServerName:PortNumber/NewGraphicsFiles
where ServerName is the IIS PC and where PortNumber is an
integer representing the number of the desired port.
http://ServerName.com:PortNumber/NewGraphicsFiles
Note: You can also permanently change the default TCP port number. See Changing
the Default TCP Port Number later in this chapter.
6. From the popup menu, select New, then Virtual Directory. The
Virtual Directory Creation Wizard appears.
8. In the Alias field, enter an alias name that you want to use to gain
access to this virtual web directory.
10. In the Directory field, enter (or use the Browse button to search
for) the network server/drive and path containing the graphics
files.
12. Enter a user name and password to gain access to the network
resource.
84 Schneider Electric
Chapter 3: Installing and Configuring web.Client on the IIS PC
15. Check the Read, Write, Browse, and Run Scripts checkboxes.
http://www.ServerName.com/NewGraphicsFiles
Note: You can also permanently change the default TCP port number. See Changing
the Default TCP Port Number later in this chapter.
3. In the tree, expand your machine name, expand Web Sites, and
expand Default Web Sites.
7. Click OK.
86 Schneider Electric
Chapter 3: Installing and Configuring web.Client on the IIS PC
Note: For 64-bit systems, when you are directed to enter a graphics file path, specify
the following: C:\Program Files (x86)\Continuum\NewGraphicsFiles.
4. Right click over Default Web Site, and select Add Virtual
Directory from the popup menu.
C:\Program Files\Continuum\NewGraphicsFiles
7. Click OK.
88 Schneider Electric
Chapter 3: Installing and Configuring web.Client on the IIS PC
1. Using your Windows Explorer, search for and select the folder that
you wish to access as a URL web address. For example, suppose the
folder name is NewGraphicsFiles.
2. Right click on the folder. The Properties dialog appears (in this
example, entitled NewGraphicsFiles Properties).
5. Click Permissions.
10. In the Search results list, double click Everyone and click OK.
11. Check the Full Control checkbox to add full control for everyone
as shown.
12. Click OK. This graphics folder can now be accessed via the web
address:
http://ServerName/NewGraphicsFiles
http://www.ServerName.com/NewGraphicsFiles
90 Schneider Electric
Chapter 3: Installing and Configuring web.Client on the IIS PC
http://ServerName:PortNumber/NewGraphicsFiles
where ServerName is the IIS PC and where PortNumber is an
integer representing the number of the desired port.
http://ServerName.com:PortNumber/NewGraphicsFiles
Note: You can also permanently change the default TCP port number. See Changing
the Default TCP Port Number later in this chapter.
Note: Since these are the defaults, no typing is needed if you are using the IIS PC to
store your .pin files.
http://ser8web/NewGraphicsFiles
92 Schneider Electric
Chapter 3: Installing and Configuring web.Client on the IIS PC
http://ser8web/NewGraphicsFiles2
94 Schneider Electric
Chapter 3: Installing and Configuring web.Client on the IIS PC
Note: In Windows 7, there is a permissions issue with User Account Control and
graphics in Andover Continuum. If you do not have permission to write to the
NewGraphicsFiles folder, the write operation is redirected to the
Users\<Username>\AppData\Local\VirtualStore\Program
Files\Continuum\NewGraphicsFiles folder. For more information and a
resolution for this issue, see “Windows 7 and User Account Control Data
Redirection” on page 55.
96 Schneider Electric
Chapter 3: Installing and Configuring web.Client on the IIS PC
8. In the Select User or Group dialog, specify the location for the
object (Everyone). Make sure the computer name appears beneath
From this location, and click Find Now.
C:\Windows\System32\inetsrv\config\
to:
C:\\Program files\Continuum\DNWACServerFactory\.
98 Schneider Electric
Chapter 3: Installing and Configuring web.Client on the IIS PC
Note: Be sure to edit the “machine name” to your PC name (in this example,
WORKSTATION1).
Note: Due to page size limitations, the line starting with <wellknown mode= and
ending with .soap” /> is shown on 3 different lines here. Be aware that this text
needs to be on a single line in your Web.config file.
19. In the Internet Options dialog, select the Connections tab and
click LAN Settings.
20. In the Local Area network (LAN) Settings dialog, make sure
the Automatically detect settings checkbox is cleared.
http://ServerName/NewGraphicsFiles/imagelibrary
and
http://ServerName/NewGraphicsFiles/backgrounds
Note: Ensure that you have given accessible sharing privileges to the above three
folders so that all client machines can view the graphics. To ensure the paths
you entered are correct, click the Check button.
CAUTION
Manually changing an IP address
If you use a specific IP address in the Graphics (Pin Files) field, instead of
ServerName, and then manually change the IP address (in the IP Address field of the
Default Web Site Properties dialog, accessed via the Control Panel’s
Administrative Tools - Internet Services Manager - Default Web Site properties)
the Graphics URL no longer works. You must go back and change the path in the
Graphics (Pin Files) field in the Options dialog to match what was changed in the IP
Address field, or enter a server name. To map the local host to this new IP address, you
must also edit, and place this new entry into the LMHOSTS.SAM file located in:
C:\WINNT\system32\drivers\...
5. Stop and then restart your IIS server, or reboot the machine.
Note: If you are installing web.Client Version 1.94 for the first time on a PC that does
not contain any Adobe Acrobat product, you will likely receive a DCOM
warning regarding Adobe Acrobat Reader, which is installed automatically
with web.Client. The warning states that a class ID is not recorded in
\\HKEY_CLASSES_ROOT\AppId. When you are asked “Do you wish to
record it?” click Yes.
1. From the Windows Start menu, select Run, and run the DCOM
configuration utility. (In the Run dialog, enter dcomcnfg, and
click OK.)
7. Click the Locations button, and from the Locations dialog, select
the IIS PC (computer) name. It usually appears at the top of the
list. Click OK.
You can also specify an object type via the Object Types button.
9. Click the Find Now button. The window at the bottom of the
dialog becomes populated with the names and locations of users
and groups.
ComputerName\ASPNET (ASP.NET)
For Windows Server 2003, IIS 6.0, and Windows Server 2008, and
Windows 7, IIS 7.0, highlight and add these accounts:
NETWORK SERVICE
INTERACTIVE
IUSR
IWAM
11. Click OK, and OK again to close the Select Users, Computers,
or Groups dialog.
Note: In Windows XP, the ACCXMLAuto application may have the following global
unique identifier name:
{08B49494-6EF2-11D5-82F7-00500462D6CE}
Note: After installing web.Client, check that the default document on the web.Client
virtual directory is set. (See Tip 5 - Enabling the Default Document in
Appendix A.)
4. Right click on the Default Web Site folder, and from the popup
menu select Properties. The Default Web Site Properties
dialog appears.
5. In the Web Site tab, remove the check from the HTTP Keep-
Alives Enabled checkbox, and click OK.
C:\Program Files\WebServer
For more information about session timeout and EventViews, see the
web.Client online help.
Inactivity Timeout
The “timeout” default is 20 minutes, but it can be reset to a different
time period by editing the web.config file:
Live EventView
The “maxEventViewRows” default value is 1000, but you may want
edit the web.config file to reset it to a smaller number to save time
while the event view list rebuilds:
This includes:
For example:
z An overview of certificates
z Setting up SSL on your server
z Using the security task wizards
z Obtaining a server certificate
If you plan to connect the web server internally with a private IP address, you
need only use a NetBIOS name. For example, use the following: (netBios)
System name (private).
The URL of the site name must comprise the same server name and domain
name to which your client machine browsers connect:
https://ServerName.DomainName.com
For example:
https://yourpc.schneider-electric.com/webclient (public IP
address)
https://yourpc/webclient (private IP address)
Otherwise, if these do not match, errors will result and SSL won’t work. To test
the URL, ping it from your machine and ensure there is a reply.
Note: In order to use SSL encryption from the client machine, a web.Client user must
access web.Client with the prefix:
https://
instead of http://
4. In the Security level for this zone section, click the Custom
Level button.
2. On the Trusted sites dialog, enter the web address in the Add
this Web site to the zone field.
3. Click OK.
9. Click OK.
12. In the ASP.NET version field, make sure the version is 2.0.50727.
c:\program files\continuum\dnwacserverfactory\bin\
Note: If you are using SSL with Pinpoint graphics, the SSL port
must be 443.
17. Restart your computer.
18. After restarting your computer, test the Certificate and its
compatibility with Pinpoint by accessing the following page:
https://ServerName/dnwacserverfactory/bin/TestWPinpointSSL.htm
19. A Security Alert appears. Click Yes to the question, Do you want
to proceed? This accepts the Certificate.
20. If the Certificate is valid with Pinpoint, the following page appears:
5. On the Default Web Site Properties dialog, select the Web Site
tab.
7. Click OK.
If you do not permanently change the TCP Port number, you can
override the default, 80, by entering the desired port number
directly into a URL web address. For example, if you want to
connect to web.Client:
https://ServerName.com:PortNumber/webClient
Note: The “s” in the https:// URL is used when an authorized SSL Certificate is
installed on the IIS PC.
z Overview
z Testing Access to and Installing web.Client on a Client PC
z Before Getting Started
z Launching Internet Explorer in Windows 7
z Installing the web.Client Utilities Control
z Installing Microsoft .NET Framework 2.0
z Installing web.Client Pinpoint
z Installing the Video Layout Control and .NET Framework 3.5
z Setting Browser “Zone” Permissions for .NET Framework
z Server Proxy Applications
z Logging Out of web.Client
Overview
When your web.Client users log on to web.Client via their client-
machine browsers for the first time, it is likely that several applications
will be installed (automatically or via user prompts).
Note: The procedures in this chapter presume you and your users are installing or
upgrading to web.Client version 1.94 and have Internet Explorer version 8.0,
and meet the other software and hardware requirements presented in
Chapter 2, System and Pre-Installation Requirements.
4. Restart this workstation and other client PCs before logging onto
web.Client for the first time.
Note: All web.Client users must have a password to log in. web.Client users are
created in CyberStation.
Note: Skip this procedure if your client users have Windows XP or Sever 2003;
proceed to Installing the web.Client Utilities Control.
Note: Your users need only perform this step once in order to install
ActiveX components and web.Client Pinpoint. Once they do so,
they can run web.Client as that user (it is profile dependent)
without being asked to specify the administrator account or run
IE as administrator.
5. Click OK.
https://SiteServer1/WebClient
Note: If the IIS server does not have Internet connectivity, it may take between 30
and 90 seconds for this installation prompt to appear.
Note: The web.Client Log On screen, shown on the next page, appears in the
background, beneath this Security Warning dialog, but you cannot enter your
user name and password until the web.Client Utilities Control is installed.
3. Click the Yes button (or the Install button on Windows XP) on the
Utilities Control Security Warning dialog to begin the
If you are upgrading from Version 1.73 to 1.94, go to the next step.
3. Click the Yes button (or the Install button on Windows XP) to
install the file. Another Security Warning dialog appears, asking
if you want to install and run the WebClient Pinpoint graphics
package.
If your IIS PC Uses IIS 6.0 and Windows Server 2003, Windows Server
2008, or Windows 7
If your IIS PC uses IIS 6.0 and Windows Server 2003, Windows Server
2008, or Windows 7, be aware that IIS resources are recycled after a
long period of time (29 hours) by default. This means that your
web.Client Pinpoint windows, including web.Client itself, are
disconnected after this long period of time expires. Please take this into
account if your users need Pinpoint running continuously for more than
a day.
If you need to run Pinpoint continuously for more than 29 hours, you
may lengthen that time via the Windows Internet Information
Services (IIS) Manager. For a procedure on how do to this, please see
the section, Tip 8 - Changing IIS / Windows Server 2003 Resource
Recycle Time, in Appendix A, web.Client Security and Troubleshooting
Tips.
After .NET Framework 3.5 is installed, both versions 2.0 and 3.5 reside
on the client machine.)
Note: The video feature requires network access to a digital video recorder. This may
require you to open port 18772 or establish a Virtual Private Network (VPN)
connection if there is a firewall.
At least 72 MB of disk space are needed for the Video Layout Control,
which comprises the file, WebClientVideo.cab, and .NET Framework
3.5. (See also Appendix B, web.Client Applications that Are Installed.)
To install the Video Layout Control and .NET Framework 3.5, perform
the following procedure:
2. Explore and search for a list of video paths, and click the name of
the VideoLayout object you want.
3. Click Install.
4. Click Install.
On the client side, .NET Framework 2.0 controls do not run in the IE
browser’s Internet or Trusted zone with their default permission
settings. Therefore, users must add full trust to these zones.
On each client machine, you can do so in one of the following two ways:
5. Click the Permission Set tab, and from the Permission set
dropdown menu, select FullTrust.
6. Click OK or Apply
You can also change the default permission set or create a new
permission set that has the following specific permissions.
As an alternative, you can add full trust to the zones by executing the
Microsoft Code Access Policy tool (caspol.exe) located in:
C:\Windows\Microsoft.NET\Framework\v2.0.50727\
To add full trust to the Internet zone in .NET Framework 2.0, execute
the following:
To add full trust to the Trusted zone in .NET Framework 2.0, execute
the following:
CAUTION
Manually closing the ACWebServerProxy
Do not manually close the ACWebServerProxy window.
If anyone manually closes the ACWebServerProxy window, all users
are disconnected from the application.
CAUTION
Closing sessions without logging out
Users should not close their sessions without logging out.
If the session is closed without logging out, the client license will not
be available for a different user until after the timeout period has
expired.
z Overview
z web.Client Security Basics
z Scenario 1: A Single-Building Company
z Scenario 2: A Global Company
Overview
Having installed and tested web.Client version 1.94 on an Internet
browser, you are now ready to use this powerful, web-based facility
management tool. For example, web.Client can distribute personnel
records, view and edit schedules and points, integrate video, display
live events, provide convenient access to reports for managers, monitor
BACnet loops, and download TrendLog records. (For complete
information, please see the web.Client online help.)
z What Folder and Device Level (FDL) security should be used for
these folders?
z What group level security should the security delegates have to
limit their ability to view only certain object classes or perform only
certain tasks?
z What object level security should be set up to limit the security
delegate to specific groups of objects?
This chapter details two scenarios in which the above questions were
answered and decisions were made on how to set up the Continuum
system. Use these examples to aid in planning for your scenario.
z Admin only
z Admin and Engineering Managers
z Admin, Engineering Managers, and Sales Managers
Users: Users created with the Continuum system are assigned to one
or more security groups. Since a user may be a member of more than
one security group, security groups may be set up to focus on a small
set of permissions. Setting up security groups with a modular
approach, makes assignment of security groups to users much easier. If
a user is assigned to more than one security group with conflicting
permissions, the “unlocked” permissions take precedence and the user
will be granted the permission.
Folder and Device Level Security (FDL): provides the user with
the ability to apply a security level to a collection of child objects by
placing them in a folder (the parent) so that they inherit the parent’s
security level. When you configure security using FDL, consider the
following:
For example, a site with three roles and two partitions would have six
groups.
Log in as each user once and verify that the right areas are granted or
denied according to your configuration plan.
z Administrative
z Engineering
z Sales
z IT
The areas of the building are:
z Main lobby
z East stairwell
z West stairwell
z Fitness room
z Human Resources department
z Administrative offices
z Engineering lab
Since this setup requires that each delegate have different sets of
permissions, it requires four security groups (one for each user /
delegate). These groups will be: Admin, Eng, Sales, and IT (where the
HRDel serves as the Admin delegate).
Also, since only one security level can be applied per folder or object, it
is recommended that you create separate security levels for each folder.
This will make it easier to organize permissions specifically for the
contents of the folder.
Recommended Set Up
Security Groups Personnel Folders Area Folders Security Levels Users
Admin AdminPersonnel CommonAreas CommonAreasSL HrDel
Eng EngPersonnel AdminAreas AdminAreasSL EngDel
Sales SalesPersonnel EngAreas EngAreasSL SalesDel
IT ITPersonnel SalesAreas SalesAreasSL ITDel
AdminPersSL
EngPersSL
SalesPersSL
ITPersSL
z Andover personnel
z England personnel
z France personnel
z Germany personnel
z Hong Kong personnel
z Mexico personnel
z Andover
z England
z France
z Germany
z Hong Kong
z Mexico
GlobalViewer Global delegate with permissions only to view all personnel records and areas.
Since this setup requires that each delegate have different sets of
permissions, this scenario requires eight administrative groups (one for
each user / delegate).
Also, since only one security level can be applied per folder or object, it
is recommended to create separate security levels for each folder. This
will make it easier to organize permissions specifically for the contents
of the folder.
1. All Security Levels will also be unlocked for the Global Viewer with the excep-
tion that the keys (in the security settings) will be locked for the change, edit,
create, and delete functions.
Recommended Setup
Security Personnel Area Folders Security Levels Users
Groups Folders
Andover AndoverPersonnel AndoverAreas AndoverAreaSL AndoverAdmin
Administrator EnglandPersonnel EnglandAreas EnglandAreaSL EnglandAdmin
FrancePersonnel GermanyAreas FranceAreaSL FranceAdmin
England GermanyPersonnel HongKongAreas GermanyAreaSL GermanyAdmin
Administrator HongKongPersonnel MexicoAreas HongKongAreaSL HongKongAdmin
MexicoPersonnel MexicoAreaSL MexicoAdmin
France GlobalPersonnel AndoverPersonnelSL GlobalPersonnel
Administrator EnglandPersonnelSL Admin
FrancePersonnelSL Global Viewer
Germany GermanyPersonnelSL
Administrator HongKongPersonnelSL
MexicoPersonnelSL
Hong Kong GlobalPersonnelSL
Administrator
Mexico
Administrator
Global Personnel
Administrator
Global Viewer
Tips
This appendix provides some tips for keeping your web.Client system
secure and for troubleshooting some common problems that may arise.
CAUTION
Microsoft system experience required.
To perform the Microsoft-related procedures, you must have administrative experience
using Microsoft system software and understand that there are differences in the
graphical user interfaces between different Windows platforms. User-interface
illustrations are not provided. Please see your Microsoft Windows online help and visit
www.microsoft.com and other Microsoft web sites.
Failure to observe this precaution can result in incorrect system
configuration.
Note: Although it is unlikely you would use all of them, CyberStation provides a
maximum of 1024 user security groups.
Be sure at least one user is assigned to both the first and your highest-
numbered security groups. This ensures that at least one user will have
full access to the system in case of an inadvertently locked action.
When adding new personnel using web.Client, the New Person dialog
displays all of the CyberStation system folders for which that logged-on
user has permissions to view.
1. From the Windows Start menu, select Run. The Run dialog
appears.
Note: There is a virtual directory under the default web site that is used for
web.Client, and by default it is called “WebClient”. During the installation of
web.Client, this directory name can be changed.
Note: If you are unsure which directory it is, click them, one at a time, to list the
contents in the right-hand pane. The web.Client virtual directory will have two
ACCWebMgr files in the list in the pane.
The utility DCOMCNFG allows you to set the default permissions for
*ALL* COM and OLE objects on your machine. You can use this utility
to provide OLE and COM access to the IUSR_<servername> account as
well as all user accounts that might be impersonated by your IIS
configuration. You can even grant permissions to the “Everyone” group.
http://www.microsoft.com/windows2000/en/server/iis/htm/asp/
eadg4n77.htm?id=231.
C:\windows\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis.exe -i
If your IIS PC uses IIS 6.0 and Windows Server 2003, please be aware
that IIS resources are recycled after a long period of time (29 hours) by
default. This means that your web.Client Pinpoint windows, including
web.Client itself and other resources, are disconnected after this long
period of time expires. Please take this into account if your users need
Pinpoint and/or web.Client running continuously for more than a day.
You may lengthen this resource-recycle time via the Windows Internet
Information Services (IIS) Manager. On the IIS PC (Windows Server
2003) perform this procedure:
9. Click OK.
Your resources are now automatically disconnected when this new time
expires.
Should you receive a Simple Object Access Protocol (SOAP) error when
attempting to access the test http://ser8web/NewGraphicsFiles2 web
location in “Setting Up an Application for Graphics on Windows Server
2008 and Windows 7”:
C:\\Program files\Continuum\DNWACServerFactory\.
<system.webServer>
<security>
<requestFiltering allowDoubleEscaping=”True”/>
</security>
<directoryBrowse enabled=”true”/>
</system.webServer>
Installed Applications
The following table lists the applications that web.Client installs on the
client PCs and the file size of each application.
Upgrade Guidelines
This appendix presents guidelines for upgrading web.Client to version
1.94. A quick procedure is provided below, but please refer back to the
procedures and requirements in Chapter 2, Chapter 3, and Chapter 4.
Refer also to the Andover Continuum CyberStation Installation Guide,
30-3001-720. As with any upgrade, it is good practice to ensure, before
you begin, that you have a known good backup of the database.
Note: web.Client version 1.94 supports Microsoft Windows Server 2003, in addition
to Windows XP Professional Workstation.
If you are running version 1.9 or higher, however, you will not need
to update your security key; your key is already enabled to support
version 1.94.
3. Reboot your PC before inserting the version 1.9CD, and start the
web.Client Install program. Perform the installation over the
previous version’s application. Reboot your PC, when prompted.
Note: If you do not have the database engine, SQL Express, already installed, or if
you have an older version of the database engine, then SQL Express is
installed for you automatically during the database initialization process.
Note: During the web.Client installation, if a client machine does not already have
Microsoft .NET Framework 2.0 installed, a user must install it as he/she logs
on to web.Client for the first time. web.Client operates in a .NET Framework
environment.
When a user is logged onto web.Client and tries to bring up a video layout for
the first time, he/she may be prompted to install .NET Framework 3.0 on the
client machine, if it is not already installed. The web.Client Video Control
requires the client machine to have .NET Framework 3.0, just as web.Client
overall requires .NET Framework 2.0. For more information see Installing the
Video Layout Control and .NET Framework 3.5 in Chapter 4.
z Overview
z SQL Express Installation Error Messages
Overview
This appendix provides a list of error messages that may appear if
certain problems occur during the installation of the database engine,
SQL Express. (SQL Express is installed or upgraded automatically on a
standalone system during the Continuum database initialization
process.)