Witam Do wersji Desigo V3.0 moge polecić takie dwie załączone książki. Sam osobiście tego nie robiłem, ale może książki pomogą. Pozdrawiam
s
DESIGO WEB™
Principles, setup and installation, V3.0
Engineering manual
CM110510en_01
30.01.2007
Building Technologies
Siemens Switzerland Ltd.
Building Technologies Group
International Headquarters
Gubelstrasse 22
CH-6301 Zug
Tel. +41 41-724 24 24
Fax +41 41-724 35 22
www.siemens.com/sbt
© 2005-2007 Siemens Switzerland Ltd.
Subject to change
2 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
CM110510en_01
30.01.2007
Table of contents
1
About this document.................................................................................... 7
1.1
Revision history .............................................................................................. 7
1.2
Reference documents .................................................................................... 7
1.3
1.3.1
1.3.2
1.3.3
1.3.4
Before you start .............................................................................................. 9
Trademarks .................................................................................................... 9
Copyright ........................................................................................................ 9
Quality assurance........................................................................................... 9
Document use / request to the reader .......................................................... 10
1.4
Document validity ......................................................................................... 10
1.5
Target readers .............................................................................................. 10
1.6
Contents ....................................................................................................... 10
1.7
Document structure ...................................................................................... 11
1.8
Printing conventions ..................................................................................... 12
2
Principles of DESIGO WEB........................................................................ 15
2.1
2.1.1
2.1.2
2.1.3
2.1.4
DESIGO INSIGHT architecture .................................................................... 15
Requirements in terms of architecture.......................................................... 15
Interactive mode and DESIGO INSIGHT as a service ................................. 17
DI server with remote Web applications ....................................................... 19
Distributed architecture................................................................................. 20
2.2
2.2.1
2.2.2
2.2.3
2.2.4
Project topologies ......................................................................................... 21
Distribution of the software components ...................................................... 21
Reference topology for small DESIGO WEB sites ....................................... 22
Reference topology for medium-scale DESIGO WEB sites ......................... 22
Sample topology for large DESIGO WEB sites ............................................ 23
2.3
2.3.1
2.3.2
2.3.3
2.3.4
2.3.5
Network security ........................................................................................... 24
Protective measures..................................................................................... 24
General port settings for DESIGO INSIGHT ................................................ 25
Port settings for Web Project Creator........................................................... 25
Subsystem-specific port settings .................................................................. 26
Editing ports in Windows XP, SP2 firewall.................................................... 27
2.4
2.4.1
Access protection ......................................................................................... 28
Principle of operation.................................................................................... 28
2.5
2.5.1
2.5.2
DESIGO WEB licensing ............................................................................... 29
Licensing model............................................................................................ 29
Examples of the licensing of DESIGO WEB projects ................................... 31
3
Project engineering procedure ................................................................. 33
3.1
3.1.1
3.1.2
3.1.3
Overview....................................................................................................... 33
Planning the DESIGO WEB project.............................................................. 34
Installing the hardware/software................................................................... 34
Creating and commissioning the DESIGO WEB project .............................. 35
4
Planning a DESIGO WEB site.................................................................... 37
4.1
What to establish at the start of the project .................................................. 37
4.2
4.2.1
4.2.2
4.2.3
Influence of DESIGO WEB on project planning .......................................... 38
Installation .................................................................................................... 38
Distribution of the main components ............................................................ 38
IT environment.............................................................................................. 38
3 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Table of contents
CM110510en_01
30.01.2007
4.2.4
Selecting the optimum topology....................................................................39
4.3
4.3.1
Selecting the hardware/software components ..............................................40
Hardware/software requirements..................................................................40
4.4
4.4.1
Communication requirements .......................................................................41
IIS compression ............................................................................................43
5
Installing DESIGO WEB..............................................................................45
5.1
Prerequisites .................................................................................................45
5.2
5.2.1
.NET Framework...........................................................................................45
Installing the .NET Framework......................................................................46
5.3
5.3.1
5.3.2
5.3.3
Installing Web server (IIS).............................................................................47
Web server for DESIGO WEB ......................................................................47
Installing IIS components on a workstation...................................................48
Installing IIS components on a server...........................................................50
5.4
5.4.1
5.4.2
5.4.3
Installing DESIGO INSIGHT .........................................................................52
Prerequisites .................................................................................................52
Uninstall earlier version of DESIGO INSIGHT ..............................................52
Installing DESIGO INSIGHT .........................................................................52
5.5
5.5.1
Basic Web components ................................................................................53
Installing basic Web components .................................................................53
5.6
5.6.1
5.6.2
5.6.3
Web Project Creator .....................................................................................55
Web Project Creator .....................................................................................55
Installing Web Project Creator ......................................................................55
Miscellaneous ...............................................................................................56
6
Creating and backing up a Web project ...................................................57
6.1
6.1.1
Prerequisites .................................................................................................57
DESIGO INSIGHT project ready to run ........................................................57
6.2
6.2.1
Workflow .......................................................................................................58
Overview .......................................................................................................58
6.3
6.3.1
6.3.2
6.3.3
6.3.4
6.3.5
Working with Web Project Creator................................................................59
Introduction ...................................................................................................59
The user interface .........................................................................................60
Computer Settings ........................................................................................61
Project Settings.............................................................................................61
Creating the Web project ..............................................................................62
6.4
6.4.1
6.4.2
6.4.3
6.4.4
6.4.5
6.4.6
Creating a Web project manually..................................................................64
Starting point .................................................................................................64
Setting up the Web project manually on the Web server..............................65
Settings in the IIS Management Console .....................................................67
Configuring the WebInsight project in IIS......................................................69
Enabling user access to the WebInsight project ...........................................70
Modifying the configuration files ...................................................................72
6.5
Switching the ASP.NET version of the Web site ...........................................73
6.6
6.6.1
6.6.2
Backing up/restoring the Web project ...........................................................74
Creating a backup copy ................................................................................74
Restoring a backup copy ..............................................................................75
7
Importing the DESIGO INSIGHT plant graphics.......................................77
7.1
7.1.1
Principles ......................................................................................................77
Principle of Web-page creation.....................................................................77
7.2
7.2.1
DESIGO WEB graphics pages .....................................................................79
Plant pages and overview graphics ..............................................................79
4 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Table of contents
CM110510en_01
30.01.2007
7.2.2
7.2.3
Super genie pages in the HQ graphics standard.......................................... 79
Country-specific super genie pages ............................................................. 79
7.3
7.3.1
7.3.2
7.3.3
7.3.4
7.3.5
7.3.6
7.3.7
7.3.8
Working with Web DIGG .............................................................................. 80
Workflow for creating Web pages................................................................. 80
Preparing Web DIGG ................................................................................... 81
Setting the Web options ............................................................................... 82
Selecting pages to be converted .................................................................. 83
Generating Web plant pages........................................................................ 84
Updating modified graphics pages ............................................................... 84
Generating Web super genie pages............................................................. 85
Web DIGG reporting..................................................................................... 86
7.4
7.4.1
Diagnostics and troubleshooting .................................................................. 88
Web Plant Viewer diagnostic tool ................................................................. 88
7.5
7.5.1
7.5.2
7.5.3
7.5.4
Preparing local standard graphics libraries for Web conversion .................. 90
General......................................................................................................... 90
Definition of WebExclude / WebInclude ....................................................... 90
The Web.ini file............................................................................................. 90
The CicodeMappingTable.txt file .................................................................. 93
7.6
7.6.1
7.6.2
7.6.3
Adapting files: Some practical examples...................................................... 95
WebExclude ................................................................................................. 95
Cicode modifications .................................................................................... 98
New argument in ChangeValue function .................................................... 105
7.7
New Cicode function: OpenURL ................................................................ 106
7.8
7.8.1
CtApi........................................................................................................... 107
Cicode functions via CtApi.......................................................................... 108
7.9
Starting Web Plant Viewer via URL ............................................................ 109
7.10
Language localization of plant graphics ..................................................... 111
8
Commissioning DESIGO WEB ................................................................ 113
8.1
8.1.1
8.1.2
Setting up DESIGO INSIGHT user profiles ................................................ 113
Setting up DESIGO WEB users ................................................................. 113
Setting up DESIGO WEB user groups ....................................................... 114
8.2
8.2.1
8.2.2
8.2.3
8.2.4
DESIGO WEB Client .................................................................................. 116
Definition of DESIGO WEB client ............................................................... 116
Setting up a DESIGO WEB client............................................................... 116
DESIGO WEB client commissioning workflow ........................................... 117
Simultaneous access to several DESIGO WEB projects ........................... 120
9
Project-specific settings .......................................................................... 121
9.1
Configuration files....................................................................................... 121
9.2
9.2.1
Web.config.................................................................................................. 122
Setting the language conventions ( " culture " ).............................................. 122
9.3
9.3.1
9.3.2
Project.config.............................................................................................. 124
Project-specific and custom settings .......................................................... 124
Configuring the user functions.................................................................... 125
10
FAQs (Frequently asked questions) ....................................................... 129
Index
135
5 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Table of contents
CM110510en_01
30.01.2007
6 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Table of contents
CM110510en_01
30.01.2007
1
About this document
1.1
Revision history
Version
Date
Changes
Section
Pages
V3.0
CM110510en_01
30.01.2007
IIS version 5.1
4.3.1, 5.3.1
.NET Framework version 1.1
5.2
ASP.NET version
6.5
Project Settings
6.3.4
Windows 2000 deleted
V2.35
CM110510en
15.9.2005
Document update (Document no, document date,
version V2.35
V3.0)
New V2.35
1.2
Documents for
engineering and
operation
Reference documents
Refer to the following documents for further information on the engineering and
operation of DESIGO INSIGHT and DESIGO WEB:
Document title
Type of document
Order No.
DESIGO WEB
Web operation, V3.0, Getting started
DESIGO INSIGHT
Operating the management station, V3.0
DESIGO INSIGHT
Installation and configuration, V3.0
DESIGO INSIGHT
Engineering of user functions, V3.0
DESIGO INSIGHT
Graphics engineering, V3.0
DESIGO
Technical principles, System limits
Operating
instructions
Operating
instructions
Engineering guide
CM110511en_01
Engineering guide
CM110592en_01
Engineering guide
CM110593en_01
Technical
principles
CM110664en_02
CM110588en01_01
CM110588en02_01
CM110591en_01
7 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
About this document
CM110510en_01
30.01.2007
Complete
documentation
The product documentation has been extended significantly since DIV 2.3. The
following diagram gives an up-to-date overview of the complete DESIGO INSIGHT
documentation.
8 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
About this document
CM110510en_01
30.01.2007
1.3
Before you start
1.3.1
Trademarks
The trademarks used in this document are listed together with their legal owners in the
following table. The use of these trademarks is subject to international and national
statutory provisions.
Trademarks
BACnet™
CitectSCADA™
Microsoft …
Windows XP®
Windows 2003 Server®
MSDE
SQL Server 2005
SQL Server Express
Legal owner
American National Standard (ANSI/ASHRAE 135-1995)
Citect Pty. Ltd. see citect.com
Microsoft Corporation see
http://www.microsoft.com/TRADEMARKS/tmark/nopermit.htm
All the product names listed are trademarks (™) or registered trademarks (®) of their
respective owners, as listed in the table. Further to the notes in this section, and to
facilitate the reading of the text, these trademarks will not be indicated elsewhere in the
text (e.g. by use of symbols such as ® or ™).
1.3.2
Copyright
This document may be duplicated and distributed only with the express permission of
Siemens, and may be passed only to authorized persons or companies with the
required technical knowledge.
1.3.3
Quality assurance
These documents have been prepared with great care.
The contents of all documents are checked at regular intervals.
Any corrections necessary are included in subsequent versions.
Documents are automatically amended as a consequence of modifications and
corrections to the products described.
Please ensure that you are aware of the latest revision date of the documentation.
If you find any lack of clarity while using this document, or if you have any criticisms or
suggestions, please contact the product manager in your nearest branch office, or write
directly to the support team at Headquarters in Zug (see below).
Support address:
Siemens Switzerland Ltd.
Building Technologies Group
International Headquarters
Field Support 5500
Gubelstrasse 22
6301 Zug, Switzerland
Tel. +41 41 724 5500
Fax. +41 41 724 5501
E-mail: fieldsupport-zug.ch.sbt@siemens.com
9 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
About this document
CM110510en_01
30.01.2007
1.3.4
Document use / request to the reader
Before using our products, it is important that you read the documents supplied with or
ordered at the same time as the products (equipment, applications, tools etc.) carefully
and in full.
More information on the products and applications (e.g. system descriptions etc.) is
available on the intranet at
https://intranet.sbt.siemens.com/dbcom/en/db_porta/client.asp
We assume that the users of these products and documents have the appropriate
authorization and training, and that they are in possession of the technical knowledge
necessary to use the products in accordance with their intended application.
If, despite this, there is a lack of clarity or other problems associated with the use of the
documentation, please do not hesitate to contact the Product Manager at your nearest
branch office, or write directly to the support team at our Swiss headquarters.
E-mail: fieldsupport-zug.ch.sbt@siemens.com.
Please note that without prejudice to your statutory rights, Siemens accepts no liability
for any losses resulting from non-observance or improper observance of the points
referred to above.
1.4
Document validity
This document is valid for the DESIGO WEB software as an add-on to DESIGO
INSIGHT Version 3.0.
1.5
Target readers
The guide is written for qualified DESIGO INSIGHT engineers involved in the project
planning, installation, engineering and commissioning of DESIGO WEB.
1.6
Contents
In order to limit the scope of this document, it focuses exclusively on technical aspects
(e.g. software architecture, project topologies, network security, distribution of the main
components, hardware & software requirements and licensing) and on aspects of
engineering (e.g. engineering procedure, installing components, creating and setting up
DESIGO WEB projects, generating the Web plant graphics pages, commissioning and
diagnostics).
Scope not covered
For topics such as an overview of functions, marketing and sales information,
comparison between the DESIGO WEB and Terminal Server applications, user
documentation etc. please refer to the Marcom materials (sales brochures,
presentations, training documents etc.), and the full range of DESIGO INSIGHT
documentation. (Refer to " Other important documents " in this section).
This guide does not impart any general technical knowledge of IT environments or Web
core technologies (e.g. principles of the Internet, HTML, XML, SVG, JavaScript etc.). In
this context, you are referred to the locally available courses and general technical
literature on these subjects.
10 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
About this document
CM110510en_01
30.01.2007
Aim of this document
Reading this guide will enable the site engineer to install DESIGO WEB, commission it
and use it to run projects. The engineering procedure and the step-by-step workflow are
described.
Prerequisites
The site engineer must have experience of DESIGO INSIGHT project engineering, be
familiar with the DESIGO INSIGHT engineering documentation, and must have
attended a DESIGO WEB engineering training course.
1.7
Document structure
Document structure
This document is divided into the following sections:
About this document
Principles of DESIGO WEB
Project engineering procedure
Planning a DESIGO WEB site
Installing DESIGO WEB
Creating and backing up a DESIGO WEB project
Importing the DESIGO INSIGHT plant graphics
Commissioning DESIGO WEB
Project-specific settings
Frequently asked questions (FAQ)
Section 1
Section 2
Section 3
Section 4
Section 5
Section 6
Section 7
Section 8
Section 9
Section 10
11 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
About this document
CM110510en_01
30.01.2007
1.8
Printing conventions
Symbols used
Caution
Example: Users with authorized access are able to modify or even delete data. The
symbol shown here acts as a warning in cases where an action may result in
permanent loss of data.
Tip
Where you see this symbol, you will find information which will help you to make best
use – and correct use – of the software. The tips are based on practical experience,
and are therefore always worth consulting.
Important notes
Important notes are printed on a grey background.
Trade names
All registered trademarks and trade names mentioned in this document are used with
the sole intention of identifying the relevant products.
Typographical conventions
Keys and fields in this document are identified by means of the conventions listed
below.
Representation of
keyboard keys
Keys on the keyboard are shown between angular brackets & lt; … & gt; .
Example: & lt; Shift & gt; , & lt; Shift + N & gt;
Table of keys referred to in this manual:
Key
Shift key
Enter key
Control
Delete key
Insert
Spacebar
Backspace
" Alternative " key
Navigation keys
Alt and letter “A” key
Description
& lt; Shift & gt;
& lt; Enter & gt;
& lt; Ctrl & gt;
& lt; Del & gt;
& lt; Ins & gt;
& lt; Space & gt;
& lt; Backspace & gt;
& lt; Alt & gt;
& lt; Up & gt; , & lt; Down & gt; ,
& lt; Left & gt; , & lt; Right & gt;
& lt; Alt + A & gt;
12 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
About this document
CM110510en_01
30.01.2007
Elements of the
application interface
In this manual, the various elements of the application interface are represented as
follows:
Element
Dialog boxes, fields
and tabs
Description
The names of dialog boxes, tabs and fields in the Windows
interface are shown in bold type.
Example: In the Definitions dialog box, you can ….
Inputs in a field
In prompts inviting the user to enter a value, the value is
shown in italics:
Example: Enter " 13 " in the Series field.
Keyboard inputs are shown in inverted commas " … " .
Buttons
Buttons are indicated in bold type.
Example: Click Cancel in order to ….
Example: Save.
This invites the user to click the Save button.
Menus and
menu options
The names of menus and the associated commands are
shown in bold type.
Example: Click the New Meters menu option in the
Structures menu…
Command sequences
The individual steps in a sequence of instructions to be carried out in direct succession
are separated by the symbol & gt; .
Example: System & gt; Meters & gt; right click & gt; New Meters
This sequence is instructing you to right-click the Meters option in the System menu,
and to select New meters from the submenu which then appears.
Mouse clicks
Right-clicking and double-clicking is referred to explicitly in command sequences. In all
other cases, a left click should be assumed.
Context menus
In most cases, right-clicking an item causes a context-sensitive menu to open.
Date and time format
The date and time format depends on the settings in your Windows operating system.
13 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
About this document
CM110510en_01
30.01.2007
14 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
About this document
CM110510en_01
30.01.2007
2
Principles of DESIGO WEB
2.1
DESIGO INSIGHT architecture
2.1.1
Requirements in terms of architecture
In order to provide the new functions of DI V2.35, (specifically DESIGO INSIGHT
Terminal Server and DESIGO WEB), it was necessary to adapt the architecture of the
preceding version DESIGO INSIGHT V2.3. The main technical requirements of the new
architecture for remote desktop/DESIGO WEB client-server operation are:
• Operation of remote desktop or DESIGO WEB client on operator stations not
installed with DESIGO INSIGHT
• Extended client/server architecture, supporting concurrent use by several users
• The DESIGO INSIGHT must run without an interactive Windows user being
logged in
• The DESIGO INSIGHT Server must run in the background even without an active
desktop client application (such as the shell).
• The DESIGO INSIGHT Server must run in the background even without an active
Web client application.
• The period of operation of the DESIGO INSIGHT server process does not depend on
client applications.
• Client sessions can be operated both by different DESIGO INSIGHT users and by
different Windows users.
• The architecture must support the distribution of the DESIGO INSIGHT software
components (DESIGO INSIGHT server, Web server, SQL/MSDE, license server,
DESIGO WEB client applications and DESIGO INSIGHT desktop client applications)
to different operator stations.
The architecture of DESIGO INSIGHT V2.3 did not allow this, as there always had to be
a Windows user logged in, in order to start the DESIGO INSIGHT toolbar (shell) without
which the DESIGO INSIGHT server process cannot run. If no user starts the shell, the
DESIGO INSIGHT server stops running.
15 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Principles of DESIGO WEB
CM110510en_01
30.01.2007
The following diagram shows the architecture of DESIGO INSIGHT V2.3:
Windows Session 0 : Interactive User (WW020\RobertSmith)
DESIGO INSIGHT Shell
(INSIGHT .EXE)
Plant Viewer
(CITECT32.EXE)
I/O Server + Display
Client
Object Viewer
Log Viewer
Trend Viewer
Cicode
G, etc.
Alarm Viewer, Popup
Viewer
Engineering Tools
Citect Handler
System Configurator
DBImport
Server Process
(DIServer.exe)
License Server
(LicSvrM.exe)
Supervisor
Server
Alarm Server
Shell Server
Resource Server
Notification
Server
Graphics Server
Trend Server
Router Server
Popup Server
PDX &
Telephony Server
ACS
Archive Server
16 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Principles of DESIGO WEB
CM110510en_01
30.01.2007
2.1.2
Note
Interactive mode and DESIGO INSIGHT as a service
From the requirements above, it is clear that for Terminal Server/DESIGO WEB
applications, DI must run continuously as a service in the background. For single-user
applications, DESIGO INSIGHT can also be installed, as before, as a desktop
management station for operation in interactive mode. Hence, there are two different
types of DESIGO INSIGHT V3.0 setup, depending on the application.
See 5.4, Installing DESIGO INSIGHT.
Below are simplified diagrams, showing the architecture of DI V3.0 and the differences
between the two types of installation.
Interactive mode
Single-user mode as in DESIGO INSIGHT V3.0
Windows Session 0 : Interactive User(WW020\RobertSmith)
DESIGO INSIGHT Shell
( INSIGHT exe )
.
Session Process
(... Session. exe )
Plant Viewer
(CITECT32.EXE)
I/O Server + Display
Client
Object Viewer
Log Viewer
Trend
Viewer
Cicode
G, etc.
Shell Server
Alarm Viewer, Popup
Viewer
Graphics
Server
Engineering Tools
Citect Handler
System Configurator
DBImport
Server Process
(... Server
.Host. exe)
License Server
(LicSvrM.exe)
Supervisor
Server
Alarm
Server
Resource Server
Notification
Server
Trend
Server
Router Server
Popup
Server
PDX &
Telephony Server
ACS
Archive Server
A comparison of this diagram with Version 2.3 shows that the shell server and graphics
server have been removed from the DESIGO INSIGHT server process to a separate
session process.
17 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Principles of DESIGO WEB
CM110510en_01
30.01.2007
Service mode
If DESIGO INSIGHT is installed as a service, Plant Viewer is set up as an I/O server,
thereby completely separating the components on the client and server operator
stations. These extensions to the architecture make the DESIGO INSIGHT server
process independent of any logged-in interactive users, and enable it to run without the
need to start the shell. During installation, a local, non-interactive Windows user
(DESIGO SERVICE with Administrator rights) is set up for the operation of the server
(Session 0 in the diagram).
Windows Session 1 : Interactive User (WW 020 \RobertSmith )
DESIGO INSIGHT Shell
( INSIGHT exe )
.
Session Process
(... Session.exe )
Plant Viewer
( CITECT32.EXE)
Display Client
Log Viewer
Trend Viewer
Cicode
G , etc.
Shell Server
Object Viewer
,
Alarm Viewer Popup
Viewer
Engineering Tools
Graphics Server
Citect Handler
System Configurator
DBImport
Windows Session 0 : Service Principal (LOCALHOST\DESIGO_SERVICE)
Server Process (NT Service)
(...Service. exe )
Supervisor
Server
Resource
Server
Alarm
Server
Notification
Server
Plant Viewer
(CITECT32.EXE )
I/ O Server
Trend
Server
Router Server
Cicode
G , etc.
Citect Handler
Popup Server
Archive
Server
License Service
( LicSrvce.exe )
PDX &
Telephony Server
ACS
License Server
( LicSvrM.exe )
The setup for operation as a service is mandatory for the DESIGO INSIGHT Terminal
Server application, and strongly recommended for DESIGO WEB.
Web client users expect to be able to operate and monitor their plant at any time,
regardless of whether or not someone is logged into the desktop management station
on site! To this end, the operator station on which DESIGO INSIGHT is installed to run
as a service must also be in operation at all times.
18 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Principles of DESIGO WEB
CM110510en_01
30.01.2007
2.1.3
DI server with remote Web applications
For DESIGO WEB, the Web server components may either be on the same operator
station as the DESIGO INSIGHT service, or on a remote server as illustrated below.
Windows Session 0 : Web Principal (WebServer\IUSR_WEBSERVER)
ASP .NET Process (NT Service )
Web Plant
Viewer
Web Object
Viewer
Web Log
Viewer
Web Alarm
Viewer
Web Trend
Viewer
Web Time
Scheduler
WebServer
Windows Session 0 : Service Principal (DIServer\DESIGO_SERVICE)
Server Process (NT Service )
(... Service .exe )
Supervisor
Server
Alarm Server
Trend Server
Plant Viewer
(CITECT 32 .EXE )
I/O Server
(Optional )
License Service
(LicSrvce .exe )
Resource
Server
Cicode
G, etc .
DIServer
Notification
Server
Router Server
Popup Server
Archive
Server
License Server
(LicSvrM .exe )
Citect Handler
PDX &
Telephony
Server
ACS
In the variant illustrate above, neither desktop applications nor Web applications run on
the DESIGO INSIGHT operator station.
The Web applications do not require session processes either on the Web server or on
the DI server.
The DESIGO INSIGHT service can be configured to start Citect automatically at the
same time. In the case of UNIGYR integration or third-party integration via Citect, this is
a requirement for the Web Plant Viewer.
19 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Principles of DESIGO WEB
CM110510en_01
30.01.2007
2.1.4
Distributed architecture
The diagram below provides an overview of the distributed architecture of
DESIGO INSIGHT. Components on colored background may be installed on the same
or different operator stations. The applications are described in detail further below.
20 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Principles of DESIGO WEB
CM110510en_01
30.01.2007
2.2
2.2.1
Simplified architecture
Project topologies
Distribution of the software components
The architecture described in the previous section coupled with the freedom to
distribute the components to different operator stations, gives rise in practice to a wide
range of alternative topologies. The following is a simplified illustration of the new
DESIGO INSIGHT architecture described above:
DESIGO WEB Clients
DI Desktop
Client
Web Server (IIS)
DI Management Station
(DI Server / License)
Database
Server
Process
devices
This illustration will help you to determine which topologies are technically right for your
site. In large projects with distributed components, a Web server and a number of
management stations, it is also important to consider customer preferences, projectspecific IT aspects, hardware/software costs etc. Taken together, these considerations
will help you design not only the technically correct topology, but also the optimum
topology for your business case.
Design constraints
Your topology must take account of the following constraints:
• In each DESIGO INSIGHT project, there is one operator station on which the project
directory resides (defined in Project Utility)
• For each DESIGO INSIGHT project, there is one MSDE or SQL database server
(defined in Project Utility, locally or on a separate server).
• Each DESIGO WEB project has one Web server (local or separate Web server).
• The DESIGO WEB project always resides on the Web server.
Reference topologies
Reference topologies have been compiled at HQ for the most common business cases.
You should generally be able to find a suitable, supported variant on which to base your
project.
In the next sections, sample topologies for small, medium-scale and large sites are
illustrated and discussed.
21 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Principles of DESIGO WEB
CM110510en_01
30.01.2007
2.2.2
Reference topology for small DESIGO WEB sites
All the main components (DI server, DI project, Web server, MSDE/SQL server and
Internet Explorer) are installed on one operator station.
DESIGO INSIGHT
Management station
DESIGO WEB
Client
DESIGO WEB
Client
BACnet / IP
LAN
(Ethernet)
DESIGO Installation
Examples of application:
In small sites, to upgrade an existing DESIGO INSIGHT operator station to a DESIGO
WEB server on the intranet.
Best setup for small sites, for training purposes, commissioning tests in SBT project
engineering offices.
Note:
If DESIGO INSIGHT is shut down, DESIGO WEB ceases to be available on the Web
client.
2.2.3
Reference topology for medium-scale
DESIGO WEB sites
DESIGO INSIGHT is set up for operation as a service on an industrial PC or server.
The server is in a separate control panel, and can be protected from local power
interruptions by an uninterruptible power supply.
DESIGO
WEB
Client
DESIGO
WEB
Client
DESIGO WEB Clients
DESIGO
INSIGHT
Desktop
Client
Internet
Internet
- IS (Web Server)
- DI as Service inst.
- MSDE
- Industrial PC/Server
- USV
Firewall
Switchboard
BACnet
VISONIK
UNIGYR INTEGRAL SIMATIC
OPC
DCS
PRU
NCRS
S7
DESIGO
PX
22 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Principles of DESIGO WEB
CM110510en_01
30.01.2007
Examples of application:
The most common case: Average-sized plant (1000 to 2500 DPs) with one or two
DESIGO INSIGHT desktop management stations for engineering and maintenance
work; simultaneous access from several DESIGO WEB clients for operation and
monitoring.
Main characteristics:
DESIGO INSIGHT runs continuously as a background service, regardless of whether or
not a user is logged in at the management station. Operation and monitoring via
DESIGO WEB is possible at any time of day or night. Remote operation via the Internet
is supported.
2.2.4
Sample topology for large DESIGO WEB sites
Large sites are generally designed for multiple management station operation. Due to
more stringent requirements in terms of the performance and security of the
management stations, the Web server and, frequently, the database server (SQL) are
set up on separate operator stations. Furthermore, in many cases, the building
automation network is often integrated into the customer's corporate IT network.
DESIGO WEB Clients
(remote)
Web
DESIGO WEB Clients
(local)
Web Server (IIS)
Firewall
DI Server
DB Server
(SQL)
SQL NET
Firewall
.NET
Remoting
LAN (Ethernet)
Intranet
BACnet
Main features:
DESIGO INSIGHT
Desktop mgt stations
VISONIK
UNIGYR
INTEGRAL
SIMATIC
DESIGO
DESIGO INSIGHT runs continuously as a background service, regardless of whether or
not a user is logged in at the management station. Operation and monitoring via
DESIGO WEB is possible at any time of day or night. Remote operation via the Internet
is supported. The Web server and database server are integrated into the customer's IT
network.
23 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Principles of DESIGO WEB
CM110510en_01
30.01.2007
2.3
Network security
2.3.1
Protective measures
Every new technology also involves new risks. Every user who connects to the Internet,
and, in particular, every company which uses technology to integrate its own companyinternal network (intranet) into the Internet, is taking risks. The two main risks are:
• Introduction of computer viruses which can cause anything from minor annoyance to
total disruption.
• Access by unauthorized Internet users or programs to local private intranet domains
or private PCs (programs and data). These can lead to the loss of data protection,
and hence, to similarly catastrophic damage.
As the result of catastrophes of this nature, and the increasing flood of virus-laden
e-mails in recent years, software companies have developed protective measures
which are available to the customer free of charge, or in exchange for a license fee.
Virus protection programs and firewalls – in a reflection of the main risks – are now
standard precautions.
Virus protection
programs
Every computer connected to the Internet/intranet must have a virus protection
program. With DESIGO WEB this applies to all Web clients, Web servers, database
servers and the desktop management stations. The most common way of spreading
computer viruses is through e-mail attachments. Even starting " unsafe " applications in
the Internet carries this risk. To maintain their effectiveness, the virus protection
programs must be updated regularly.
Firewalls
In the IT world, the term " firewall " refers collectively to the precautions necessary to
increase network safety users of the Internet. The firewall is designed to prevent
unauthorized Internet users from invading private networks (internal company intranets)
or PCs connected to the Internet, and causing damage through unauthorized access.
The firewall blocks any attempts (invisible to, and not requested by the user) to
establish a connection with the computer.
Normally, the " firewall " is an installed program with a user-specific configuration. The
firewall software may be part of the PC operating system (e.g. Windows XP, Service
Pack 2) or it may be purchased from a standard dealer and installed by the computer
user.
Default settings
The user-specific configuration is not normally necessary for private Office users, as the
manufacturer's default values are adequate in normal circumstances.
User-specific settings
The user-specific configuration of a firewall is only possible if the user has at least a
rudimentary understanding of how the firewall works, and also knows the workings of
the programs to be protected.
For DESIGO WEB in large project installations, it is absolutely essential to configure the
various firewalls with user-specific settings, as without these, commissioning will fail.
This section discusses the principles and gives details of the settings required.
24 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Principles of DESIGO WEB
CM110510en_01
30.01.2007
How a firewall works
Firewalls prevent access by unauthorized Internet users and programs to private
networks (intranets) and PCs connected to the Internet.
A firewall checks all the services and messages (communication packets or datagrams)
to or from the Internet and blocks any which do not fulfill the specified security criteria.
Firewalls do not block required ports and software services.
Ports
The various programs need standard and program-specific services, which
communicate, in turn, via service-specific ports. By connecting a firewall between them,
it is possible to block certain ports. This stops unwanted programs from running and
causing damage.
At the same time, ports blocked by stringent default values set by the manufacturer can
also prevent important services (as in the case of our DESIGO WEB) from working. The
entire software will then be unable to operate.
The ports can be numbered from 0… 65535, whereby ports 0… 1023 are reserved for
standard services. Port numbers 1024…49151 are for registered applications. The rest
can be used for dynamic or private ports.
2.3.2
General port settings for DESIGO INSIGHT
Operation of DESIGO WEB requires .Net Remoting services (Port 11111) between the
Web server and DESIGO INSIGHT, and SQL Net services (Port 1433) between the
Web server and the database server. The HTTP protocol and, communicating via
HTTP, the standard Web protocol SOAP (Simple Object Access Protocol) operate
between the Web server and the Web client, for which reason, Port 80 must not be
blocked.
This is illustrated simply below:
DI WEB
Client
DI
Server
WEB
Server
IIS
IE V6.0
Firewall
Firewall
Database
Server
DI
MgtSt
SQL
TCP / IP
Internet
Port 80 : HTTP
SOAP
2.3.3
Intranet
DMZ
Port 11111 : .Net Remoting
Port 1433 : SQL Net
Port settings for Web Project Creator
The Web server utility, " Web Project Creator " is used when setting up a Web project on
the Web server. In order for this to work properly, Port 135 and Port 1027 must not be
blocked. For each new Web project, a virtual project directory is opened in IIS (Internet
Information Services) for this purpose. This requires Port 42424 to be open. The ports
referred to in this section are required only while the Web project is being set up. Web
Project Creator can then be uninstalled, and the ports can be blocked again.
25 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Principles of DESIGO WEB
CM110510en_01
30.01.2007
2.3.4
Subsystem-specific port settings
Although these settings have nothing to do with DESIGO WEB, it could be useful to
know the key information in the event of an upgrade-project.
PX, BACnet over IP
Please refer to the documentation for the PX subsystem and DESIGO TOOLSET.
UNIGYR integration
UNIGYR is integrated not via TCP/IP but via Profibus (separate Profibus adapters in
the management station). No port settings are necessary in this case.
Integral
When integrating NCRS controllers via Ethernet, UDP ports
8712, 8713 and 8714 must be open in the firewall.
Visonik
Visonik DCS is integrated into DESIGO INSIGHT via Ethernet and sockets. Ports 6000
to 6018 may be needed.
The default port number is 6011. Up to eight separate connections can be established
via this one port.
In this context, here is an example of a port configuration for socket communication
with DCS:
// PORT CONFIGURATION
$TYtype[2] = COMX
$TYcomxname[2] = COM2
$TYtype[6] = SOCKETX
$TYsocketxname[6] = ss [6006]
$TYtype[3] = COMX
$TYtype[7] = SOCKETX
$TYcomxname[3] = COM1
$TYsocketxname[7] = ss [6007]
$TYtype[4] = PIPEX
$TYtype[8] = SOCKETX
$TYpipexname[4] = \PIPE\4
$TYsocketxname[8] = ss [6008]
$TYtype[5] = PIPEX
$TYtype[9] = SOCKETX
$TYpipexname[5] = \PIPE\5
$TYsocketxname[9] = ss [6009]
// Terminal 10 is local used
$TYtype[11] = SOCKETX
$TYsocketxname[11] = ss
$TYtype[12] = SOCKETX
$TYsocketxname[12] = ss
$TYtype[13] = SOCKETX
$TYsocketxname[13] = ss
$TYtype[14] = SOCKETX
$TYsocketxname[14] = ss
$TYtype[15] = SOCKETX
$TYsocketxname[15] = ss
$TYtype[16] = SOCKETX
$TYsocketxname[16] = ss
$TYtype[17] = SOCKETX
$TYsocketxname[17] = ss
$TYtype[18] = SOCKETX
$TYsocketxname[18] = ss
[6011]
[6011]
[6011]
[6011]
[6011]
[6011]
[6011]
[6011]
26 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Principles of DESIGO WEB
CM110510en_01
30.01.2007
2.3.5
Editing ports in Windows XP, SP2 firewall
To protect your PC and to enable DESIGO WEB to run by opening the relevant ports,
you can use a standard commercially available firewall, or the one received with your
Windows XP, SP2 (assuming this is the operating system you are using).
Adding ports in
Windows XP, SP2
firewall
Proceed as follows:
1.
Open the firewall under Start & gt; Settings & gt; Control Panel & gt; Windows Firewall
2.
3.
Enable the firewall.
Under Exceptions & gt; Add Port..., open the Add a Port dialog box.
4.
5.
Open the ports required for the operation of DESIGO WEB.
Click OK, OK.
27 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Principles of DESIGO WEB
CM110510en_01
30.01.2007
2.4
Access protection
2.4.1
Principle of operation
For the users of DESIGO INSIGHT V3.0 desktop management stations, nothing has
changed compared with the earlier version. Access protection is still based on the user
name and an associated password. All users must be known in the system, and each
user belongs to a user group for which a profile must have been set up in System
Configurator by the system administrator. This profile defines the user functions that
can be started by each user and the access rights of that user when working with the
system. [+ WEB]
Each defined user can also be defined as a DESIGO WEB user. See 8.1, Setting up
DESIGO INSIGHT user profiles.
User authentication
After evaluation of the many and various standard Internet authentication methods, a
suitable and reliable option had to be selected for the DESIGO WEB clients with access
DESIGO INSIGHT via both the intranet and the Internet.
Digest authentication
A decision was made in favor of the " Digest Authentication " method, as this has two
important advantages:
• Passwords are sent over the Internet only in encrypted form.
• The integrity of the URL data is checked (for Web experts: this means, for example,
that the integrity of form information sent using the GET method is certified).
Note
The definition of a password is mandatory for all DESIGO WEB users, as otherwise,
user authentication over the Web is not possible. (A blank password is not valid!)
Take care with the use of upper and lower case letters in the user name and password.
Digest Authentication method requires considering of upper and lower case letters.
28 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Principles of DESIGO WEB
CM110510en_01
30.01.2007
2.5
DESIGO WEB licensing
2.5.1
Licensing model
The DESIGO INSIGHT licensing model is modular in structure, and scalable. The
design must take account of the following licensing models:
Basic License
Basic license
Options
Data points
Multi User
The customer must indicate how many users (1…n) will be working at desktop
management stations concurrently. The number of basic licenses ( " Start feature set " ) is
set on the basis of this information. If n is greater than 1, then, logically, a multi-user
license must be configured.
A " Start feature set " authorizes the following functions:
•
•
•
•
•
•
•
DESIGO INSIGHT application toolbar (shell)
Log in
Object Viewer
Alarm Viewer
Alarm Router
Time Scheduler / Calendar
System Configurator
For a DESIGO WEB project, at least one basic license must be enabled for the
operation of DESIGO INSIGHT on a desktop management station for maintenance,
configuration and engineering activities. In this case, all other users have access via
DESIGO WEB clients (i.e. not via desktop management stations).
Options
" Options " refers to the ability to tailor licenses for the numerous user functions to
customer requirements. For DESIGO WEB users, the following points must be taken
into account:
I.
The customer must indicate how many users (1…n) will concurrently require
access to DESIGO INSIGHT via DESIGO WEB.
The number of " DESIGO WEB Operation CALs " is set as an option based on this
information. Packages of 2, 5 and 20 are available. (CAL is the abbreviation for Client
Access License " ).
Obtaining licenses
Every logged-in DESIGO WEB user (per login/per session) obtains a DESIGO WEB
Operation CAL. If the same user is logged in several times, one CAL is obtained for
each log-in procedure. However, with the same log-in (only one instance of the Internet
browser) a user may have several " viewers " open at the same time on a client. The
Web licenses are re-enabled approximately 30…60 seconds after DESIGO WEB is
closed, irrespective of the Web (ASP.NET) session time, which times out after 20
minutes.
29 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Principles of DESIGO WEB
CM110510en_01
30.01.2007
II.
While the functions
• Plant Viewer
• Trend Viewer
• Log Viewer
• Reaction Processor (not available for DESIGO WEB)
• Report Viewer
must be licensed as options for DESIGO INSIGHT desktop users, the DESIGO
WEB Operation CALs always contain licenses for all DESIGO WEB applications
(the shell, Plant Viewer, Alarm Viewer, Log Viewer, Time Scheduler, Object
Viewer, Trend Viewer and Report Viewer).
Note
However, if Citect is required to run on the desktop management station, then for
projects involving UNIGYR or Citect third-party integration, Citect report- or other Citect
functions (see the CtApi section), at least one desktop Plant Viewer license must be
enabled as an option.
Data points
In this module, licenses are set for the maximum number of data points per type
• L & S data points
• Citect data points
• BACnet VIS data points
The licensing of the data points is independent of the DESIGO WEB application.
Multi User
" Multi-user " licensing applies to the number of desktop management stations used
simultaneously, and is independent of the DESIGO WEB application.
Provided there is only one desktop management station, many DESIGO WEB users
can work at the same time without the need for a multi-user license.
30 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Principles of DESIGO WEB
CM110510en_01
30.01.2007
2.5.2
Examples of the licensing of DESIGO WEB projects
It might be best to illustrate the licensing procedure in relation to the reference
topologies described earlier.
Example 1:
–
–
–
–
–
Topology for a medium-scale DESIGO WEB site (see " Project topologies " )
A desktop management station for engineering, configuration and maintenance work.
Maximum 4 simultaneously logged-in DESIGO WEB clients
1800 L & S data points, UNIGYR integration with 700 Citect DPs.
2 house engineers and their manager must be able to work with the desktop
management station or with DESIGO WEB
– Access must be provided to seven other building users, for sporadic monitoring and
operation of their area of the building via DESIGO WEB.
Licensing for Example 1 must be configured as follows:
Module
Licensing
Basic
Start Feature Set
Options
Data points
Multi User
Plant Viewer
Trend Viewer
Log Viewer
Graphics Builder
Pager
DESIGO WEB Operation CALs
L & S
Citect
BACnet VIS
Single User
Multi User 1st
Multi User 2nd
Multi User 3rd – 5th
Multi User 6th
Example 1
Example 2
1x
1x
1x
1x
1x
2x
2x2 CALs
& lt; 5k
& lt; 5k
X
-
Comment:
Three user groups must be set up in System Configurator (manager, house engineers,
others) with a total of 10 users. All users have authorized access to DESIGO WEB, but
only a maximum of 4 may be logged in at the same time.
31 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Principles of DESIGO WEB
CM110510en_01
30.01.2007
Example 2:
Sample topology for a large- scale DESIGO WEB site (see " Project topologies " ).
– Two desktop management stations for engineering, configuration and maintenance
work.
– Maximum 15 simultaneously logged-in DESIGO WEB clients
– 3500 L & S data points, Citect third-party integration with 6000 Citect data points
– 4 house engineers and their manager must to be able to work with the desktop
management station or with DESIGO WEB
– Access must be provided to seventeen other building users, for intermittent
monitoring and operation of their area of the building via DESIGO WEB.
Licensing for Example 2 must be configured as follows:
Modules
Licensing
Basic
Start Feature Set
Options
Data points
Multi User
Plant Viewer
Trend Viewer
Log Viewer
Graphics Builder
Pager
BACnet Server VIS
WEB Operation CALs
L & S
Citect
BACnet VIS
Single User
Multi User 1st
Multi User 2nd
Multi User 3rd – 5th
Multi User 6th
Example 1
Example 2
2x
2x
2x
2x
2x
4x
1X
3x5 CALs
& lt; 5k
& gt; 5k
X
-
Comment:
At least three user groups must be set up in System Configurator (manager, house
engineers, others) with a total of 22 users. All users have authorized access to DESIGO
WEB, but only a maximum of 15 may be logged in at the same time.
Multi-user access is required, not because of the 15 simultaneously DESIGO WEB
users, but because of the second desktop management station. The same is true of the
second Start Feature Set and the doubling of licenses for the user functions.
32 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Principles of DESIGO WEB
CM110510en_01
30.01.2007
3
Project engineering procedure
3.1
Overview
Owing to the tools shipped with DESIGO INSIGHT (Web Project Creator, Web DIGG)
and the default Web project, only minimal manual engineering is required. Careful
planning of the installing of the project ensures that installation times can be kept brief,
and that commissioning on the customer's site is quick and straightforward. The
DESIGO WEB plant graphics can be imported into Web format and pre-checked in
advance in the engineering office.
This section describes the detailed procedure for creating a DESIGO WEB customer
project, based on the recommended workflows.
The three main project phases are:
Planning the DESIGO WEB project
Installing the hardware/software
Restoring and commissioning the
DESIGO INSIGHT project
Creating and commissioning the
DESIGO WEB project
All the main steps of the workflow diagrams shown below are described in detail in
subsequent sections of this manual.
Expert knowledge
Some activities in the DESIGO WEB environment require expert knowledge. This
applies specifically to the integration of a DESIGO WEB project into an existing
customer IT environment, and the preparation of country-specific standard super genie
pages and Cicode script applications for conversion with Web DIGG (cross compiler).
As not all SBT site engineers have the required specialist knowledge, DESIGO WEB
projects must be integrated into the IT network in cooperation with the customer's IT
specialists, and the country-specific super genies and Cicode scripts must be
generated in advance by the library experts in the country headquarters.
Prerequisites
It is assumed in this document that a DESIGO INSIGHT project including Citect plant
graphics pages is already in existence (the DI project backup, which only needs to be
restored on the customer site and commissioned).
For information on how to engineer a DESIGO INSIGHT project, please refer to the
engineering manuals. 1.2 Reference documents.
33 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Project engineering procedure
CM110510en_01
30.01.2007
3.1.1
Planning the DESIGO WEB project
Establish project data,
timescales, customer
requirements and operating
strategy.
Determine the distribution of the
main components
Clarify integration into the
customer's existing IT structure
Planning the DESIGO WEB
project
Select the optimum project
topology
Determine the required
hardware/software components
Clarify licensing issues.
3.1.2
Installing the hardware/software
Install Web server:
IIS components and
Web Project Creator.
Install DESIGO INSIGHT
management station(s)
Installing HW/SW
Restoring and commissioning
the DESIGO INSIGHT project
Install basic Web components on
operator station with
DI project folder
Restore and commission the
DESIGO INSIGHT project
34 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Project engineering procedure
CM110510en_01
30.01.2007
3.1.3
Creating and commissioning the DESIGO WEB project
Use Web Project Creator to
create the DESIGO WEB project
on the Web server.
Using Web DIGG, convert plant
graphics pages for DESIGO WEB
Create and commission the
DESIGO WEB project
Set up DESIGO WEB users in
System Configurator
Check DESIGO WEB client
(MS Internet Explorer V6.0 SVG
plug-in) and commission
DESIGO WEB client
Carry out any custom settings.
Perform function test.
35 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Project engineering procedure
CM110510en_01
30.01.2007
36 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Project engineering procedure
CM110510en_01
30.01.2007
4
Planning a DESIGO WEB site
4.1
What to establish at the start of the project
Every DESIGO INSIGHT project starts with the customer's needs: customers want to
be able to use a building automation and control system to monitor and operate their
building services, and to optimize and maintain the plant while in operation. In doing so,
they want to exploit the benefits of the Web via intranet (LAN) or Internet (WAN), and
be able to access their own building services from anywhere, using a PC operator
station running standard, commercially available software.
Initially, there are numerous questions to be clarified by the SBT project engineers.
They need to know the exact intentions of the customer, the existing and planned plant,
the existing IT environment if any, the operating strategy (operation, alarms,
organization of personnel, house services, DESIGO WEB user groups etc.). This often
means working together with architects, consulting engineers, HVAC engineers and the
customer's IT specialists.
Bearing in mind that any DESIGO WEB project presupposes the existence of a
DESIGO INSIGHT project, the emphasis is on the planning, implementation, and
commissioning of the latter, including the graphics.
Note
Every DESIGO WEB project is based on an existing fully functional DESIGO INSIGHT
project. DESIGO WEB offers additional functions, which cannot be supported without
an existing DESIGO INSIGHT installation.
Since it is presupposed that readers already know about the design and implementation
of a DESIGO INSIGHT project, this manual deals only with the planning and
implementation specific to DESIGO WEB.
37 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Planning a DESIGO WEB site
CM110510en_01
30.01.2007
4.2
4.2.1
Type of installation
Influence of DESIGO WEB on
project planning
Installation
As already stated, DESIGO INSIGHT can be set up in two different ways, either as a
desktop management station, or for operation as a service.
A DESIGO WEB user (Web client) expects the plant data to be available at all times via
the Web. The following conditions must be fulfilled for this purpose:
• DESIGO INSIGHT must be in operation all the time (software running and available)
• The operator station on which DESIGO INSIGHT is installed must run continuously.
• The Web server must be available at all times
This is why, for DESIGO WEB, we recommend that DESIGO INSIGHT be set up for
operation as a service, and that it should be installed on an operator station designed to
run continuously.
4.2.2
Distribution of the main components
The main components,
• DESIGO INSIGHT desktop management station with DI project installation
• Database server (MSDE or SQL)
• Web server with DESIGO WEB project installation
• DESIGO WEB clients
of a DESIGO WEB project can all be installed on the same – or different – operator
stations (or servers). The distribution of the main components is determined by the
demands of the project in terms of performance (number of simultaneous DI desktop
and DESIGO WEB users, number of data points, anticipated data traffic) and in relation
to data security (precautions against data loss, distributed software/hardware).
Single user solution
With this " all-in-one " solution, the performance requirements are more demanding,
because all the software components use the same CPU and hardware (RAM). For this
reason, we recommend that this solution be set up on server operator stations with a
server operating system.
This " all-in-one " mode of operation is possible on a standard PC, but is recommended
only for small customer projects, project engineering and test operator stations.
4.2.3
IT environment
Ethernet TCP/IP
Whereas most earlier building automation and control systems were operated over
in-house networks (LANs) with the manufacturer's proprietary protocols,
DESIGO INSIGHT allows integration into an existing IT environment on the customer's
site. For commercial reasons, this is normally not only possible, but required.
This means that the SBT project manager no longer has sole control of the planning of
the building automation and control system, but must work in close cooperation with the
customer's IT specialists.
Integrating the building
automation and control
system
When planning the integration of a DESIGO WEB project into the customer's IT
environment, the following points must be clarified:
• Type and structure of the customer network: is it permissible and practicable for SBT
to use this network for the DESIGO WEB project too?
38 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Planning a DESIGO WEB site
CM110510en_01
30.01.2007
• If the customer already has a Web server in the network, and is it permissible and
practicable for SBT to use this for the DESIGO WEB project too?
• If the customer already has SQL database servers in the network, can and should
SBT use these for the DESIGO INSIGHT project databases?
• Access rights (arrangements in the domain controller)
• Access protection (firewall settings)
• Apply for IP addresses for new (DI) operator stations in the IT network (Domain
Name Server)
• Customer IT operation and security guidelines
• Suppliers and versions of the operating-system software and Web browsers on the
network client operator stations.
If a DESIGO WEB customer does not have an existing IT network structure, SBT must
design its own network with domain controller, DNS etc. Expert knowledge is required
for this purpose. In the absence of the necessary expertise, it is recommended that the
assistance of IT specialists from the regional company headquarters or of external
consultants should be obtained.
4.2.4
Prerequisites
Selecting the optimum topology
To select the optimum project topology, ensure that the following points have been
carefully planned and clarified with the customer in advance:
• Customer requirements (operating strategy)
• Type of installation
• Distribution of the main components
• Shared use of existing IT environment (network, Web, database server)
See Section 2.2, Project topologies.
39 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Planning a DESIGO WEB site
CM110510en_01
30.01.2007
4.3
Selecting the hardware/software
components
4.3.1
Hardware/software requirements
Observe the
system limits!
Once all the planning information, requirements and topology have been clarified, the
hardware and software components can be determined. Do not exceed the system
limits. Alongside the project requirements, these often decide which components have
to be used.
For this purpose, refer to the sales support documentation in the " Product market
introduction folder " or consult the " System limits " section of the DESIGO Technical
principles manual.
Number of update
channels per subsystem
As an example, the following illustrates how the subsystem influences the maximum
number of update channels. This limit cannot be circumvented, and the effect of
exceeding it is noticeable, when several DESIGO WEB or Terminal Server users
access the same plant (e.g. NCRS controller) or open the Web Object Viewer in the
system view in DESIGO WEB.
If the maximum number of available (COV-based) update channels is exceeded, the
values will no longer be updated on the client PCs.
Maximum number of update channels per subsystem:
• NCRS: 512 per connection
• NITEL: Serial connection: Must not exceed 100 values
• UNIGYR Profibus connection, 10 values/second
• Visonik: Now 1400 per DCS
• PX: 400 or 1600
As a further example, the following is a limit which must be observed as a criterion
when deciding on the choice of operating system:
Internet Information
Services (IIS)
Windows XP Pro/SP2 (IIS Version 5.1) supports a maximum of 5 simultaneous
DESIGO WEB client connections.
If more than 5 simultaneous connections are planned, you will need to set up the Web
server on server hardware running Windows 2000 / 2003 server.
Overview: Hardware/software requirements
DESIGO WEB
Dedicated
client
Web server
Windows 2000 / XP
W2K / 2003 Server
IIS
PC Hardware
Monitor resolution
.NET Framework
MSDE / SQL
Acrobat Reader
Adobe SVG Viewer
MS Internet Explorer
V6.0
X
Pentium 2.8 GHz,
512MB RAM
Optimum for
1280x1024 pixels
X
X
X
X
X
Server HW
& gt; = 2GB RAM
Standard
X
-
DESIGO INSIGHT
management station
X
(x)
(x)
Pentium 4, 3.2GHz,
& gt; = 1GB RAM
Optimum for & gt; =
1024 x 786 pixels
X
X
X
(x)
(x)
40 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Planning a DESIGO WEB site
CM110510en_01
30.01.2007
4.4
BACnet/IP network load
Communication requirements
With the " BACnet clients " , DESIGO INSIGHT and PXM20, the network load caused by
BACNet/IP depends on the amount of user interaction (e.g. trend data logging can load
the network significantly).
In general, the normal 100 Mbps standard Ethernet networks are sufficient, and the
DESIGO system does not place any special demands on the IT infrastructure.
However, in BACnet internetworks dispersed over a large area (e.g. a town), the IT
structure requires closer analysis, as there is a high risk of intermittent downtime.
Recommended minimum
communications speed:
The effective communications speed (upstream and downstream) for data transfer
(upstream and downstream) between the Web server and a DESIGO WEB client must
be: & gt; = 500 kbps.
In this context, refer to the diagram below for connections via the Internet:
Internet Explorer V6.0
upstream
downstream
Internet
upstream
LAN (100Mbit/sec)
downstream
Windows server
with IIS and
DESIGO INSIGHT
Connections via the
Internet
Although the transfer rate over the local network (LAN) is fast enough, problems can
arise with transmission over the Internet if the transmission route is too slow (less than
500 kbps = slow operation!).
State-of-the-art connection technologies today include the following:
•
•
•
•
•
•
•
•
Analog modem connections
ISDN connections (possibly two bundled channels, see table below)
DSL
(Digital Subscriber Line)
ADSL (Asymmetric Digital Subscriber Line)
SDSL (Symmetric Digital Subscriber Line)
xDSL
HDSL (High Data Rate DSL)
VDSL (Very High Data Rate DSL)
Data is transmitted via telephone lines, TV cable (Cablecom) or even over fast, wireless
connections (up to 54Mbps).
41 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Planning a DESIGO WEB site
CM110510en_01
30.01.2007
Case study: ADSL
The transfer rates of a standard ADSL modem are, for example:
600 kbps downstream and 100 kbps upstream. Question: Can you use this to establish
a viable connection from your home PC (DESIGO WEB client) to your DESIGO
INSIGHT site in the company?
Answer: Yes, but communication is (too) inefficient!
The resulting transfer rate (upstream/downstream) is less than 600 kbps, with a
theoretical maximum of 100 kbps (see the diagram below).
IE V6.0
up 100 kbps
down 600 kbps
ADSL Modem
Effective transmission speed:
up- and down stream: 100 kbps
Internet
Provider
Recommended: 500 - 600kbps
ADSL Modem
down 600 kbps
up 100 kbps
Windows Server
with IIS and
DESIGO INSIGHT
The table below shows the transfer modes that perform sufficiently well over the
Internet for DESIGO WEB:
Speed*
Bytes/s
kBytes/s
MB/h
DESIGO WEB
28 800
3 600
3.5
12.4
Not supported
56K modem
56 000
7 000
6.8
24
Not supported
ISDN
64 000
8 000
7.8
27.5
Possible
ISDN 2-channel
128 000
16 000
15.6
55
T-DSL-348
384 000
48 000
46.9
164.8
DSL 1000
1 024 000
128 000
125.0
439.5
Recommended
DSL 2000
2 048 000
256 000
250.0
878.9
Recommended
DSL 3000
TV cable communication
bit/s
28.8K modem
3 072 000
384 000
375.0
1318.4
Recommended
Product example: Cablecom
Highspeed 100 (with digital
telephones only)
Highspeed 600
Highspeed 1000
Highspeed 2000
Highspeed 3000
Download
(kbps)
Upload
(kbps)
DESIGO WEB
100
64
Possible
600
1000
2000
3000
100
200
400
800
Possible
Possible
Possible
Recommended
42 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Planning a DESIGO WEB site
CM110510en_01
30.01.2007
4.4.1
IIS compression
Upstream
& lt; 500 kbps
If the upstream transfer rate of the Web server is less than 500 kbps, it is
recommended to use the IIS-supported " On-demand " compression of static and/or
dynamic data.
(The batch files need to activate these functions on the Web server can be found on the
DESIGO INSIGHT installation CD, in the AdsUtil folder).
Static compression
Use this function when the client browser cache memory is very low, or when the Web
server (IIS) bandwidth is too small ( & lt; 500 kbps). Provided the appropriate option is
enabled, IIS checks whether the compression directory of the Web server contains the
compressed versions of static files (e.g. *.css, *.js). If these files are in the directory,
they are transmitted to the Web client. If they do not exist, or if the compressed data is
older than the original files, they are sent to the client in de-compressed form, while IIS
compresses the original file in a background process and saves it in the compression
directory.
Dynamic compression
Use this function if the bandwidth of the Web server (IIS) is low ( & lt; 500 kbps) but there
are sufficient hardware resources (CPU, memory).
Do not use this function if too many simultaneously active Web clients could occur
If this option is enabled, all dynamic data (html, aspx etc.) is compressed before being
transmitted to the Web client.
The compressed data is not saved in the compression directory in this process.
Notes:
• If IIS compression is enabled, it works not only for the DESIGO WEB project, but for
all Web projects on the server.
• All these compression functions are fully supported by both Windows and Internet
Explorer.
• By default, the file gzip.dll is used for compression of static and dynamic data. (If an
Internet browser does not support gzip compression, all data is transmitted without
compression, i.e. the transfer of data is not affected.)
43 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Planning a DESIGO WEB site
CM110510en_01
30.01.2007
44 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Planning a DESIGO WEB site
CM110510en_01
30.01.2007
5
Installing DESIGO WEB
The installation of DESIGO WEB comprises the following steps:
1.
Install the .NET Framework
2.
Install Web server (IIS)
3.
Install DESIGO INSIGHT
4.
Install DI basic Web components
5.
Install Web client
6.
Install Web Project Creator (WPC)
Important
The installation sequence is important, and must be adhered to.
Note: Versions of the operating system
The installation instructions below deal only with the installation of DESIGO WEB on
computers with Windows XP Professional or Windows 2003 Server.
Installation on computers with Windows 2000 or Windows 2000 Server is also
supported. In principle, the installation procedure is the same.
5.1
Planning complete
Prerequisites
Before the installation of DESIGO WEB, the planning steps described in Section 4 must
be implemented and complete. The following components are determined in this
process:
• The appropriate computer hardware and software
• The distribution of the components
• The type of Web server (IIS on PC or on server hardware with server operating
system)
• The type of DESIGO INSIGHT installation(s)
5.2
.NET Framework
All operator stations running one or several of the following program components
• DESIGO INSIGHT
• Web server (IIS)
• Web Project Creator
require the Microsoft .NET Framework, because the interaction between the Web
server and DESIGO INSIGHT (DESIGO WEB) is based on .NET Remoting.
For a DESIGO INSIGHT installation, the setup program ensures that the .NET
Framework components are installed first, if they are not already installed on the
operator station concerned (DESIGO INSIGHT button " grayed out " ). DESIGO INSIGHT
cannot be installed until this stage is complete.
When installing the IIS components, and with Web Project Creator on a Web server
(without a DI installation), it is also important to ensure that the .NET Framework
components are installed first.
The version of .NET Framework V1.1 which is compatible with DESIGO INSIGHT is
included on the DESIGO INSIGHT Setup CD.
45 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Installing DESIGO WEB
CM110510en_01
30.01.2007
Important
Other programs on a customers workstation (server) may ask for - or install and assign
- the current .NET Framework version (V2.0. or higher). It is no problem to have several
.NET Framework versions installed on a PC at the same time, but in such cases it
might be mandatory, that you have to switch the ASP.NET version of the Website in the
IIS.
Look up workflow in section: “Switching the ASP.Net version of the Web site”.
5.2.1
1.
2.
Installing the .NET Framework
Start the wizard for DESIGO Product Installation on the DESIGO INSIGHT
Setup CD.
Click .Net Framework.
This installs the .Net Framework V1.1.
46 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Installing DESIGO WEB
CM110510en_01
30.01.2007
5.3
5.3.1
The term " Web server "
Installing Web server (IIS)
Web server for DESIGO WEB
The term Web server has two meanings:
• Web server is the term used to refer to the computer which performs the Web server
function in a network.
The Web server may be set up on a dedicated server (with hardware and operating
system designed for a computer whose primary use is as a server), or it may be
installed on a high-performance operator station (with hardware and operating
system designed for a computer whose primary use is as an operator station PC).
• Web Server (IIS) is the designation for the Web Server program (software),
consisting of the installed and configured IIS components of the operating system
concerned.
Setting up Web Server
The server or operator station can be expanded into a Web Server by the later
installation of operating system components, the Internet Information Services (IIS)
components, designed specifically for this purpose. Although the operator systems do
contain these components, they are not pre-installed and ready to run by default. (For
most PC or server users, it is not essential that their device should be set up as a Web
Server.)
Internet Information
Services (IIS)
The IIS operating system components can be used to set up Web projects on the
relevant workstation (or server), to manage them and to publish customer-specific
content in the form of Web pages via an intranet or the Internet (WordWideWeb).
Depending on the operating system and configuration, numerous services (e.g. Web
project management, access and security settings, field transfer, e-mail, user
authentication etc.) can be enabled.
For administrators, an IIS operator console (MS Management Console, MMC) is
available for setting up, managing and setting the properties of the Web projects. The
IIS operator console includes an extensive Microsoft Help option, which can be used to
look up further details of the individual applications.
Since the functional scope of IIS and its limits vary according to the operating system,
the setup procedure is described separately for XP Professional and Windows 2003
Server in the next two sections.
IIS Versions
The IIS Version depends on the installed MS operating system version.
MS operating system
MS Windows 2000 Professional / Server
MS Windows XP Professional
MS Windows 2003 Server
IIS V5.0
IIS V5.1
IIS V6.0
X
X
X
47 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Installing DESIGO WEB
CM110510en_01
30.01.2007
5.3.2
Installing IIS components on a workstation
Prerequisite
The .NET Framework V1.1 must be installed.
Windows XP
Professional
operating system
Install a Web Server (IIS V5.1 components) on a workstation running the Windows XP
Professional operating system.
1.
2.
3.
4.
5.
Select Start & gt; Settings & gt; Control Panel & gt; Add or Remove Programs
Click Add/Remove Windows Components.
The Windows Components Wizard starts.
Select the Internet Information Services check box.
The check box will be displayed in gray, indicating that not all the available
components will be installed.
The Microsoft default settings can be used for DESIGO INSIGHT.
Click Next & gt; .
The IIS components are installed and configured. This may take some time.
Click Close.
The wizard shuts down.
If the following message is displayed, this indicates that certain individual IIS
components are still missing. This is possible if IIS was uninstalled on this
computer at some stage.
You can go back and install the missing IIS components from the CD-ROM for the
operating system concerned.
48 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Installing DESIGO WEB
CM110510en_01
30.01.2007
6.
When the IIS components have been installed, you can start the management
console for the Web Server (IIS).
Select Start & gt; Programs & gt; Administrative Tools & gt; Internet Information
Services.
For further information on the IIS management console, click Help
, or refer to the
product information available on the Web Server after installation of the IIS components
(http://localhost/iisHelp/).
Tip:
Create a desktop shortcut for starting the IIS.
49 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Installing DESIGO WEB
CM110510en_01
30.01.2007
5.3.3
Installing IIS components on a server
Prerequisite
The .NET Framework V1.1 must be installed.
Windows 2003 Server
operating system
Install the Web Server components on a server running either MS Windows 2000
Server (IIS V5.0) or MS Windows 2003 Server (IIS V6.0).
The Web server installation on a server contains more components (options) than the
Web Server installation on a workstation.
1.
2.
3.
Select Start & gt; Settings & gt; Control Panel & gt; Add or Remove Programs
Click Add/Remove Windows Components.
The Windows Components Wizard starts.
Select the Application Server checkbox.
The check box is shown in gray. This means that not all available components are
installed.
4.
Click Details.
The Application Server dialog box opens.
5.
Select Internet Information Services (IIS).
50 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Installing DESIGO WEB
CM110510en_01
30.01.2007
6.
Click Details...
The Internet Information Services (IIS) dialog box opens.
7.
Select the following IIS components:
– Common Files
– Internet Information Services Manager
– World Wide Web Service
Click OK to close the Application Server and Internet Information Services
(IIS) dialog boxes.
Click Next & gt; .
The Application Server components are installed and configured. This may take a
few minutes.
Click Close.
The wizard shuts down.
8.
9.
10.
11.
When the IIS components have been installed, you can start the management
console for the Web Server (IIS).
Select Start & gt; Programs & gt; Administrative Tools & gt; Internet Information
Services.
For further information on the IIS management console, click Help
, or refer to the
product information available on the Web Server after installation of the IIS components
(http://localhost/iisHelp/).
Tip:
Create a desktop shortcut for starting the IIS.
51 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Installing DESIGO WEB
CM110510en_01
30.01.2007
5.4
Installing DESIGO INSIGHT
A prerequisite for DESIGO WEB is the installation of DESIGO INSIGHT with the
following option selected in the Setup:
• When DESIGO INSIGHT is installed on the workstation, the Basic Web
components must be installed at the same time as the DESIGO INSIGHT project.
See 5.5, Basic Web components.
5.4.1
Planning complete
Prerequisites
The following elements were defined when planning the DESIGO WEB system.
• The computer on which DESIGO INSIGHT is installed has been defined. This may
be the same computer on which the Web Server (IIS) is set up.
• The type of DESIGO INSIGHT installation has been determined (installation for
operation as a service or as a desktop management station). For DESIGO WEB, we
recommend installing DESIGO INSIGHT for operation as a service is recommended.
See 2.1.2, Interactive mode and DESIGO INSIGHT as a service.
Important
The installation sequence is important, and must be adhered to.
5.4.2
Uninstall earlier version of DESIGO INSIGHT
Before you install a new version of DESIGO INSIGHT, you must uninstall any previous
versions of DESIGO INSIGHT.
1.
2.
3.
Create backup copies of the existing DI project and the graphics projects.
Delete the DI project, the associated databases and the project catalog with
Project Utility.
Uninstall the old DESIGO INSIGHT version.
5.4.3
Installing DESIGO INSIGHT
Install DESIGO INSIGHT as described in the engineering manual, CM110591
(Installation and configuration).
1.
2.
3.
Install the required components (MSDE/SQL/.NET Framework/DI/License Server
etc.)
Install DESIGO INSIGHT for operation as a service (or as a desktop management
station).
Install the additional components required:
– DESIGO Connect
These components are required for the exchange of project data points from
different types of automation systems via the DI management station (e.g.
peer-to-peer communication between Visonik PRV and DESIGO PX
automation stations). (See engineering manual CM110595, DESIGO Connect).
– DESIGO INSIGHT Integration Interface
These components are required as an interface to the Info Center (ADP) where
ADP is used in conjunction with DESIGO INSIGHT.
52 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Installing DESIGO WEB
CM110510en_01
30.01.2007
5.5
DESIGO INSIGHT Basic
Web Components
Basic Web components
The basic Web components provide the range of functions required between
DESIGO INSIGHT and the Web Server or DESIGO WEB clients. These include
functions such as user authentication, alarm handling, licensing, interfaces to user
functions, data servers etc.
For engineering workstations:
The " Web DIGG " option only becomes available in DIGG after the basic Web
components have been installed.
Where to install the
basic Web components
In a project configuration with more than one DESIGO INSIGHT management station,
the basic Web components are installed on the computer on which the DESIGO
INSIGHT project is set up (refer to the project path with the project name in Project
Utility).
There is no need to install the basic Web components on the other management
stations.
5.5.1
Stopping
the DESIGO service
Installing basic Web components
If DESIGO INSIGHT was installed as a service, the DESIGO service must be stopped
before the basic Web components can be installed. If the DESIGO service is still
running in the background, the subsequent installation of the basic Web components
will fail (error message),
With a DESIGO INSIGHT installation for operation as a management station, this step
is omitted (because there is no DESIGO service).
1.
Setup CD
Right-click the Service Monitor icon
. Select Stop Service.
Install the basic Web components on the computer with the DESIGO INSIGHT project.
1.
2.
3.
Start the wizard for DESIGO Product Installation on the DESIGO INSIGHT
Setup CD.
Click DESIGO INSIGHT.
This starts the InstallShield wizard for DESIGO INSIGHT.
Click Next, Modify, Next.
If DESIGO INSIGHT was installed to run as a service, the Service Arguments
dialog box is displayed, with fields for password entry.
53 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Installing DESIGO WEB
CM110510en_01
30.01.2007
Enter the password for the DESIGO service user. This is the password that was
defined when installing DESIGO INSIGHT.
If DESIGO INSIGHT was installed as a desktop management station, this step is
omitted (as there is no DESIGO service user).
4.
Click Next & gt; .
The Custom Setup dialog box is displayed.
5.
Select Web Base.
The basic Web components are selected for installation (1725kB).
Click Next & gt; , Next & gt; , Install.
This starts the installation routine.
Click Finish.
This completes the installation routine.
Reboot the computer to activate the configuration changes.
6.
7.
8.
54 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Installing DESIGO WEB
CM110510en_01
30.01.2007
5.6
Web Project Creator
5.6.1
Web Project Creator
Description
The Web Project Creator is a tool which facilitates the creation of DESIGO WEB
projects for the project engineer, and carries out the necessary settings in the Web
Server largely automatically. A default Web project, created at HQ and supplied as
WebInsight.zip in the setup program, is decompressed.
WebInsight.zip
In addition to the default Web project, the file WebInsight.zip contains the super genie
pages for Web Plant Viewer already generated from all the libraries in the HQ Graphics
Standard. Countries with their own graphics standard can create a country-specific
WebInsight.zip file which contains both the HQ super genies, and the country-specific
super-genie pages generated in advance. (These must be created by Library experts in
the regional companies.)
Prerequisites for
installation
The Web Project Creator is a .NET application which needs components of the .NET
Framework in order to run. (Otherwise this utility is independent of other components,
and no registry entries are required.) When a new Web project is created, Web Project
Creator starts IIS, checks its version number and sets up the Web environment for the
project.
This is why Web Project Creator is always installed on the Web Server
(workstation/server) on which IIS was set up, and on which the .NET Framework must
also be installed (refer to the section headed " Selecting the hardware/software
components " .)
5.6.2
Setup CD
Installing Web Project Creator
Install the Web Project Creator program on the computer on which the Web Server
(IIS) is installed.
1.
2.
Start the wizard for DESIGO Product Installation on the DESIGO INSIGHT
Setup CD.
Click DESIGO INSIGHT Web Project Creator.
This starts the InstallShield wizard for DESIGO INSIGHT Web Project Creator.
55 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Installing DESIGO WEB
CM110510en_01
30.01.2007
3.
4.
5.
6.
7.
Tips:
Click Next & gt; .
The License Agreement dialog box opens.
Select I accept the terms in the license agreement.
Click Next & gt; .
The Customer Information dialog box opens.
Select the required user access.
Click Next & gt; .
The Destination Folder dialog box opens.
The suggested directory path for installation is as follows:
C:\Program Files\Siemens\DESIGO\Insight 3.0\
Click Change... to change the directory.
Click Next & gt; .
Click Install.
This installs the program.
– The program files are copied into the ...\Bin directory.
– The default WebInsight.zip project is copied to the …\Temp directory.
This InstallShield wizard shuts down.
Create a desktop shortcut to Web Project Creator (C:\Program Files\
Siemens\DESIGO\Insight 3.0\Bin\Siemens.DesigoInsight.WebProjectCreator.exe).
DESIGO INSIGHT
WebProjectCreator
5.6.3
Uninstall procedure
The Web Project Creator is only needed to create and set up the DESIGO WEB
projects. Once this work is done, the utility can be uninstalled from the Web Server.
1.
2.
Problems with
installation?
Miscellaneous
Select Start & gt; Settings & gt; Control Panel & gt; Add or Remove Programs
Click Remove.
Web Project Creator will be uninstalled.
– The program files in the ...\Bin directory are deleted.
– The default project in the ...\Temp folder is deleted.
– All folders created in the installation process are deleted.
If the installation of Web Project Creator is not allowed, it is possible to create and
configure DESIGO WEB projects manually. This may be necessary, for example, if the
Web server is integrated into an intranet with increased security, and is therefore not
directly accessible to our project engineers (not managed by SBT, but by IT specialists
employed by the customer, with responsibility for the company network).
The procedure for manual creation of Web projects is described in detail in the section
entitled " Creating and backing up a Web project " .
56 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Installing DESIGO WEB
CM110510en_01
30.01.2007
6
6.1
Basic Web components
Prerequisites
6.1.1
Complete installation of
DESIGO WEB
Creating and backing up a Web
project
DESIGO INSIGHT project ready to run
Before a DESIGO WEB project can be created successfully, ensure that the following
prerequisite criteria are fulfilled:
• All components are installed in the right order, as described in the previous section,
" Installing DESIGO WEB " .
• A Web Server has been set up (with .NET Framework, IIS and Web Project Creator
installed)
• A correctly functioning DESIGO INSIGHT project has been set up. (Projects created
with older versions must be upgraded to actual version in advance, with the Upgrade
tool in Project Utility. The upgrade process is described in engineering manual
CM110591, " Installation and configuration " .)
• The DESIGO INSIGHT plant graphics pages have been generated either with DI
Graphics Generator (DIGG) or manually with Citect Graphics Builder, compiled and
ready to run.
• The DESIGO INSIGHT project path and project name are known (see Project Utility).
• The basic Web components are installed on the workstation on which the DESIGO
INSIGHT project resides.
There is no need to install basic Web components on any other (client) management
stations in the same project.
57 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Creating and backing up a Web project
CM110510en_01
30.01.2007
6.2
6.2.1
Flow chart
Workflow
Overview
The flow chart below illustrates the steps involved in the creation of a DESIGO WEB
project.
The automatic conversion of DESIGO INSIGHT plant graphics into Web plant graphics
by use of DIGG is described in detail in the section headed " Adopting the DESIGO
INSIGHT plant graphics " .
Check prerequisites
Web Server installation:
– .NET Framework
– IIS
– Web Project Creator
DESIGO INSIGHT installation:
– .NET Framework
– MSDE / SQL
– Install DESIGO INSIGHT
– Basic Web components
– Generate/restore DESIGO INSIGHT project
NO
Fully functional
DESIGO INSIGHT
project exists?
YES
Create WEB project:
– Start Web Project Creator
– Enter DESIGO WEB project path
– Enter name for virtual directory (IIS)
– Specify computer with DESIGO INSIGHT project
– Enter name of DESIGO INSIGHT project
– Enter path to default Web project zip file
– Click Create to start the process
Adopt plant graphics with DIGG:
– Start DIGG
– Click the Web tab
– Under Tools & gt; Options & gt; Web: Enter the path to
the Web project directory
– In the main dialog box select the pages to be
generated and start the process.
58 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Creating and backing up a Web project
CM110510en_01
30.01.2007
6.3
6.3.1
Purpose of the
application
Working with Web Project Creator
Introduction
Essentially, Web Project Creator (abbreviated below as WPC) is a utility which makes it
easy for a project engineer to create a DESIGO WEB project on a Web server.
In this process, the following steps are carried out automatically in the background.
• Verification of .NET Framework Version
• IIS installation check
• IIS configuration (creation of a virtual directory on the Web server, mapping of path
to physical project directory, configuration of ASP.NET application and access rights)
• ASPNET user setup if required
The user is initially required to make a small number of entries via the user interface.
These are described in detail in this section.
Main dialog box
While the project is being created, the text window (at the bottom) contains messages
to confirm the individual steps of the process. This provides users with a progress
report, so that they can see if the process was successful or if some problem caused it
to terminate (error messages giving information on the cause of the problem are shown
in red).
59 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Creating and backing up a Web project
CM110510en_01
30.01.2007
Conditions and
constraints
We would draw your attention here to certain conditions and constraints:
• The WPC must be installed on the Web server (computer with IIS enabled). This
means that Web projects cannot be set up on a remote Web server by remote
operation of a local WPC. (*)
• Once created, the Web project itself is installed on the Web server, as WPC does not
support the entry of UNC paths and connected network drives.
• In order to set up and configure both IIS and ASPNet users, the user must be logged
into the Web server as an Administrator.
• WPC is not a data backup tool (unlike Project Utility, for example).
• WPC does not support the comparison or automatic updating of Web projects.
(*) If it is not possible, or not permitted, to install tools such as Web Project Creator, the
Web project must be created manually (see " Creating a Web project manually " ).
6.3.2
The user interface
Start
WPC can be started via Start & gt; Programs & gt; DESIGO INSIGHT 3.0 & gt; Web Project
Creator. (An icon is available for a shortcut to the screen.)
The main dialog box (already illustrated further above) appears.
Fill in all the fields carefully, or check the default settings and change them where
necessary. If the settings are incomplete (blank fields) an error message will appear (in
red) in the text field, with the associated input fields displayed in yellow.
ScreenTips
In WPC, the mouse can be moved over the text fields in the dialog box to display
screen tips with information about the inputs required.
Status bar
If the mouse is moved over a button, the status bar shows a description of the action
that can be implemented by clicking the button.
The status bar also indicates the status of the WPC application (ready, error etc.).
Let us now start with the inputs from the top, beginning with the first input field: “Web
Project Path“.
Web Project Path
to physical directory
WPC, and the Web projects created with WPC, reside on the Web server. The Select
button opens the browse dialog box, in which you can select the path to the local,
physical directory for the Web project to be created. If the directory does not yet exist,
you can create one by clicking Create new directory (the name is freely definable).
Virtual Directory
A virtual directory is set up on the Web server (IIS) for each Web project. Enter the
name (also freely definable) of this directory in the " Virtual Directory " field. Note that the
virtual directory of the Web project cannot be located with Windows Explorer. However,
after the Web project has been created successfully, the " IIS Management Console "
can be opened, and the new project will appear here in the " Default Web Site " directory.
In the properties (right-click on your new Web project) you will find the path to the
" physical directory " where the files for the Web project are actually located. This
physical project directory can be located and viewed with Windows Explorer.
60 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Creating and backing up a Web project
CM110510en_01
30.01.2007
6.3.3
Computer Settings
Computer Settings
You now need to indicate whether DESIGO INSIGHT and the Web project are located
on the same computer, or on different computers.
(It is a prerequisite for working with WPC that the Web project should be on the Web
server. However, the DESIGO INSIGHT project may be installed either on the Web
server, or on another workstation.)
If DESIGO INSIGHT is also on the Web server, the unavailable (grayed) text " localhost "
appears in the field Computer Name of DESIGO INSIGHT.“.
Computer name of
DESIGO INSIGHT
If the DESIGO INSIGHT project is not on the Web server, then you must enter the
name of the DESIGO INSIGHT workstation here. Note that this computer name must
be a known name within the domain.
(The PC name or IP address are allowed as inputs).
6.3.4
Project Settings
DESIGO INSIGHT
project name
In the DESIGO INSIGHT Project field, enter the DESIGO INSIGHT project name
defined in Project Utility.
Comment:
There is no directory browse option here, because the path to the project is not
required. Although the project directory name and the project name are often identical,
this is not always the case!
This is why the project name must be entered manually.
WebInsight.zip
As has already been noted, when creating a new Web project, WPC looks for a valid
default Web project to decompress. With the WPC installation HQ supplies a zip file
containing all the necessary files (including the Web super genie pages of the HQ
graphics standard). When you create a Web project for the first time, it is best to use
this default WebInsight.zip file (the path for the default zip file (grayed out) is displayed
in the Select Web Project Zip " field.
What if you have your
own Web project?
You also have the option of selecting your own zip file (e.g. for a country-specific or
regional standard, or in order to decompress a Web project created in the engineering
office).
In this case, select the check box " Web Project is available " and specify the source
path to your own zip file in the directory browse dialog box. WPC runs a simple test to
determine whether the specified *.zip file is " valid " for creating a Web project.
Web language
HQ delivers EN and DE versions of WebInsight.zip files. Localization experts of
Regional Companies will deliver other languages with local WebInsight.zip files. A
default language is given after the installation of WPC and the language of the
decompressed WebInsight.zip file will influence the setting in the Web.config file during
Web project creation.
(Look up section: Web.config, 9.2.1 Setting the language conventions ( " culture " ))
61 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Creating and backing up a Web project
CM110510en_01
30.01.2007
6.3.5
Creating the Web project
When all the computer and project settings are complete, click Create to start the
automatic creation, decompression, saving and setting up of the new project. Progress
messages are displayed in the text field. The format of the text reflects the type of
information:
Progress messages
Name of action
Result(s) of action
Confirmation
Error message
Error information
Bold, black
Normal, black
Bold, green
Bold, red
Italic, black
For a successfully created project, the progress messages, displayed in succession in
the text field, are roughly as follows:
Setup Web Environment
User account APSNET created
.Net Framework for ASPNET valid
IIS available
User Account ASPNET checked
Web Environment OK
Selected archive and target path
Extracting {...\...\WebInsight.zip} to {...\...\WebProject}
Start extracting files
Valid Web project folder created
Valid zip file found
Web project configuration files updated
Folder added: Export
Extract procedure successful.
Setup IIS
IIS service started
IIS and virtual directory created successfully.
Directory access setup
Write access to Export set
Write access to project\pv set
Setup Web project successfully completed.
If there is a problem, a red error message appears in the text field, and the project
creation process is terminated.
62 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Creating and backing up a Web project
CM110510en_01
30.01.2007
Error messages
The possible error messages in the WPC progress indicator are shown below, with their
meanings and the corrective action to be taken.
Error message
Description
Action
Error: Settings incomplete
Not all mandatory fields have been
filled in
Enter the missing project information
(text fields with yellow background)
An old version of .Net Framework is
installed.
Install .Net Framework Version
1.1.4322.0 (or later).
a) IIS is not installed, or it is corrupt
b) DI computer name not recognized
c) Access rights not sufficient
d) Not logged in as Administrator
a) Install IIS now
b) Use " Localhost " as the computer
name
c,d) Log in as Administrator
IIS not recognized or
valid IIS version not recognized
Uninstall and re-install IIS (this is the
most frequent error)
No archive zip file found, or zip file is
corrupt
Copy default WebInsight.zip file or
other zip file (e.g. archive) to the
following directory:
& lt; Insight folder & gt; /template
User terminated the process with
Cancel
Start creation of the Web project
directory again.
IIS and ASP.net are not correctly
configured. This can be caused by
retrospective installation of the IIS
components
Enter the following command in the
console window:
" \ & lt; Windowsfolder & gt;
\Microsoft.NET
\Framework\ & lt; Version Number & gt;
\aspnet_regiis.exe " –i
lease enter a value in the colored text
boxes
Setup Web Environment
The installed .Net Framework is the
wrong version.
Setup IIS
IIS Setup failed.
Please check IIS configuration
Check that DESIGO INSIGHT MgtStn
Computername is valid
Setup Web Environment
IIS is not installed correctly
Please re-install IIS Version 5.0 min. via
" Add/Remove Windows Components "
function.
Start extracting files
Valid Web project folder created
No zip file found in directory
Zip-File C:\Data \WebInsight.zip not
found
Start extracting files
Valid Web project folder created
Valid zip file found
Extraction procedure interrupted by
" Cancel "
Setup Web Environment
ASP.Net is not installed correctly
Please check IIS mappings for ASP.NET
Web project path folder is not allowed
It is not allowed to store a Web project to
The user does not have authorized
access to the selected directory
C:\Inetpub\wwwroot. Please select
another directory.
Error in zip file IO: Is the zip path
correct? Are old files locked?
The process cannot access the file
C:\temp\NewFolder\autherror.htm
Some files have been opened by an
existing Web project (e.g. someone
has already logged in to the existing
project).
because it is being used by another
process.
Then:
regsvr32 " & lt; Windowsfolder & gt;
\Microsoft.NET\Framework\ & lt; Versi
on Number & gt; \aspnet_isapi.dll "
Example: It is not permissible to set
up a Web project in the directory
\Inetpub\wwwroot. Select a different
path/directory.
Terminate the connection to the IIS
project by ending the process
concerned in the Window Task
Manager. " aspnet_wp.exe "
(A new process will start
immediately.)
63 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Creating and backing up a Web project
CM110510en_01
30.01.2007
6.4
IT restrictions
It may be that due to restrictions in the IT guidelines, you will not be permitted to install
a utility such as the Web Project Creator on a Web server in the customer network.
( " No installation of third-party applications with Administrator rights in the protected
customer network " .) That is why this section contains a detailed description of how to
set up a DESIGO WEB project manually (without WPC).
6.4.1
Example
Creating a Web project manually
Starting point
Whether the DESIGO WEB project is created manually, or whether it is created
automatically with WPC, the prerequisites are exactly the same. However, we shall
assume that the Web server with the Web project is a computer maintained by the
customer (IT), and that the DESIGO INSIGHT project is on a workstation supplied and
maintained by SBT and integrated into the customer network (the IP address/PC name
is known and set up on the network domain). It must be possible for the DESIGO
INSIGHT management station to be used as a Web client, too.
In this case, then, there are at least two workstations, namely: the Web server
maintained by the customer, and the DESIGO INSIGHT management station installed
and maintained by SBT. An example of this type of arrangement is illustrated below:
The settings required for DESIGO WEB on the Web server and on the workstation
running the DESIGO INSIGHT project can be treated separately below.
For information about the required firewall settings, refer to Section 2.3, Network
security.
64 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Creating and backing up a Web project
CM110510en_01
30.01.2007
6.4.2
Setting up the Web project manually on the Web server
Before setting up the Web project on the server, you need to check a few points:
IIS Version
Check the IIS version on the Web server. It should be V5.0 or later.
(Select Start & gt; Settings & gt; Control Panel & gt; Administrative Tools & gt; Internet
Information Services (ISS) Manager & gt; Help & gt; About...).
Valid .NET Framework
version
Is the installed version of the .NET Framework valid?
To find out, open a console window via Start & gt; Run & gt; cmd.
Enter the following command:
C:\ & lt; Windows & gt; \Microsoft.NET\Framework\v1.1.4322\aspnet_regiis.exe –lv
where & lt; Windows & gt; stands for the directory of the server on which Windows is installed.
The valid .NET Framework Version must be at least 1.1.4322.0 or later.
Note
If " aspnet_regiis.exe " is not found, it is possible that the .NET Framework or ASPnet
may not be installed properly. In this case, please install the .NET Framework with the
help of the DESIGO INSIGHT installation CD.
Enter the following command in the console window:
C:\ & lt; Windows & gt; \Microsoft.NET\Framework\v1.1.4322\aspnet_regiis.exe –i
At least the following information must appear:
" Start installing ASP.NET (1.1.4322.0) "
This is followed, after short delay (~30 s), by an acknowledgement:
" Finished installing ASP.NET (1.1.4322.0) "
Registration
Enter the following command in the console window:
regsvr32 C:\ & lt; Windows & gt; \Microsoft.NET\Framework\v1.1.4322\aspnet_isapi.dll
After a short delay (~30 s) the following message appears:
IIS and ASPnet are now working together without error.
65 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Creating and backing up a Web project
CM110510en_01
30.01.2007
ASPNET user in
Windows XP
Professional (IIS V5.1)
Now check if a valid ASPNET user has been set up:
Start & gt; Settings & gt; Control Panel & gt; User Accounts
An ASPNET user must be created for the group " Users " for the domain
& lt; YourServerName & gt; .
NETWORK SERVICE
User for IIS V6.0
On a Windows 2003 Server with IIS V6.0, the " ASP.NET Worker Process " runs by
default under the user NETWORK SERVICE.
Copying WebInsight.zip
Create a directory on the Web server, to which you can copy WebInsight.zip, e.g.
C:\DESIGO WebProjectCreator\Template. The WebInsight.zip file can be found on the
DESIGO INSIGHT installation CD, Disk 1:
\\DESIGO WebProjectCreator\program files\Siemens\Insight 3.0\
Template\WebInsight.zip
Creating a physical
project directory
The files in WebInsight.zip can be extracted directly into another directory, the physical
project directory & lt; Web Insight Project Dir & gt; on the server, (directory example:
C:\WebInsight ). No other directory structures are required.
66 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Creating and backing up a Web project
CM110510en_01
30.01.2007
6.4.3
Creating a virtual
project directory
Settings in the IIS Management Console
The next step is to create a virtual directory on the Web server (IIS) for the Web Insight
project. (directory name example: City Bank)
Select Start & gt; Programs & gt; Administrative Tools & gt; Internet Information Services.
The IIS Management Console is displayed.
Navigate to " Default Web Site " and start the Web server, if it is not already running.
(Right-click Default Web Site and click Start in the context menu.)
Right-click in IIS on the node Default Web Site, open the context menu and click New
& gt; Virtual Directory.... The Virtual Directory Creation Wizard opens.
Click Next & gt; to proceed.
Enter a name for the virtual project directory. Next & gt; .
Enter the path to the physical project directory, described further above. This is the
directory that contains the content which is to be published on the Web page (extracted
WebInsight project). Next & gt; .
Leave the default settings in the Virtual Directory Access permissions dialog box
(the check boxes Read and Run scripts should be selected). Click Next & gt; Finish.
67 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Creating and backing up a Web project
CM110510en_01
30.01.2007
In IIS: Right-click on the newly created virtual directory (e.g. City Bank), open the
context menu, and click Properties. The screenshot above shows the settings used in
our example.
68 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Creating and backing up a Web project
CM110510en_01
30.01.2007
6.4.4
Configuring the WebInsight project in IIS
In the Properties dialog box, select the Documents tab. Remove all the default
documents listed and then add the default document, " Default.aspx. Click Apply.
In the Properties dialog box, select the Directory Security tab & gt; Edit.
Set the check boxes to define the authentication methods as shown below.
Click OK & gt; OK and shut down Internet Information Services.
69 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Creating and backing up a Web project
CM110510en_01
30.01.2007
6.4.5
Enabling user access to the WebInsight project
Once the default project WebInsight.zip has been extracted in the physical project
directory & lt; WebInsight Project Dir & gt; , you will see the following directory structure in the
Windows Explorer:
Note:
On servers with the Windows 2003 Server operating system, which support IIS V6.0,
the settings described below must be carried out not for the ASPNET user, but for the
NETWORK SERVICE user (see also " Setting up the Web project manually on the Web
server " ).
To enable ASP.NET to run without error, the computer-internal ASPNET user must have
write-access to the following two directories in the WebInsight project:
& lt; WebInsight Project Dir & gt; \ project\ pv and & lt; WebInsight Project Dir & gt; \ export.
The " Export " directory must be created manually. It is not part of the default project, and
is needed to save offline trend data (*.csv files) on the Web server. Every time a user
uses the Trend Data Export function to export offline trend data, one of these *.csv
files is created and saved on the server in the directory & lt; WebInsight Project Dir & gt; \
export.
Write access to these two directories for the ASPNET user can be set up as follows:
Right-click the directory & lt; WebInsight Project Dir & gt; \ project\ pv“ and in the context
menu, select Sharing and Security....
Select the Security tab and Add. In the input field, enter & lt; computer name & gt; \ASPNET“
and click OK.
( " computer name " here is the name of the Web server on which you are setting up the
Web project.)
70 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Creating and backing up a Web project
CM110510en_01
30.01.2007
Our example:
The new ASP.NET Machine Account is now set up for the ASP.NET user. Select it and,
in the lower pane, allocate the " Modify " and " Write " privileges by selecting the relevant
check boxes.
Click OK again.
Now carry out the same steps for the newly created directory. & lt; WebInsight Project
Dir & gt; \export “.
71 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Creating and backing up a Web project
CM110510en_01
30.01.2007
6.4.6
Modifying the configuration files
With the manual installation of a Web project, it is always necessary to modify manually
some of the settings in the configuration files Web.config and Project.config.
Web.config
The configuration file Web.config is located directly in the main directory of the Web
project that has been set up: & lt; WebInsight Project Dir & gt; \Web.config.
Open the file with a text editor (e.g. WordPad or NotePad). Two settings need to be
checked and perhaps modified:
1. Host Computer Name (the name of the workstation on which the DESIGO INSIGHT
project resides)
& lt; siemens.desigo.insight.activation & gt;
& lt; urlBase channel= " tcp " host= " ch1w44174 " port= " 11111 " / & gt;
& lt; /siemens.desigo.insight.activation & gt;
2. For the key: " projectName " the value to be entered is the DESIGO INSIGHT project
name (e.g. value= " CityBank " ).
& lt; appSettings & gt;
& lt; !-- PROJECT NAME -- & gt;
& lt; add key= " projectName " value= " CityBank " / & gt;
Save the inputs and close the file.
Note
When entering the computer name and the DESIGO INSIGHT project name, make sure
that you do not change any punctuation, and take care to distinguish between upper
and lower case letters.
Project.config
The configuration file Project.config is located in the Web project directory:
& lt; WebInsight Project Dir & gt; \project\Project.config.
Open the file with a text editor (e.g. WordPad or NotePad).
To make sure that the Web application is linked to the correct DESIGO INSIGHT
project, the Project Name setting must be checked and, if necessary, modified.
& lt; ?xml version= " 1.0 " encoding= " utf-8 " ? & gt;
& lt; Project Name= " CityBank " & gt;
& lt; Product Name= " DESIGO INSIGHT " Version= " V3 " / & gt;
Save the inputs and close the file.
Note
When entering the DESIGO INSIGHT project name, make sure that you do not change
any punctuation, and take care to distinguish between upper and lower case letters.
72 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Creating and backing up a Web project
CM110510en_01
30.01.2007
6.5
Switching the ASP.NET version of the Web
site
If there are several versions oft the .NET Framework installed, you have to make sure
that the Version 1.1 is available too and the appropriate ASP.NET version is active for
your web sites. Therefore you have to:
1.
Select Start & gt; Programs & gt; Administrative Tools & gt; Internet Information
Services.
2.
3.
4.
5.
Select the Web site and open “Properties”
Open ASP.NET tab
Click list box and choose ASP.NET version: 1.1.4322
Click Apply & gt; OK
73 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Creating and backing up a Web project
CM110510en_01
30.01.2007
6.6
Backing up/restoring the Web project
As the Web Project Creator is only designed for creating and setting up new DESIGO
WEB projects, there are no other functions available with this utility, such as functions
to save, restore or delete the project, (only available in Project Utility for the DESIGO
INSIGHT projects) For this reason it is necessary in any case to create and restore
backup copies of a DESIGO WEB manually.
You can also use the backup copy to transfer a Web project to another Web server, e.g.
from the engineering office to the customer's Web server.
Apart from the project-specific Plant Viewer plant pages, standard default pages are
used in DESIGO WEB for all user functions. In other words, a backup copy only needs
to contain the directory with the project-specific pages.
Directory:
...\project\ pv
This means that if you want to back up an existing Web project, you only need to add
the contents of the directory & lt; WebInsight Project Dir & gt; \ project\ pv to a backup zip
file.
This directory contains all the project-specific files which were created with Web DIGG,
and which are needed to display the Web graphics pages. (*.XML, *.js, *.png)
When Web plant pages and super genie pages are opened at runtime, files with the
extension *.svg“ and *.svg.gz“are created in the directory ...\project\ pv. With these
" auxiliary files, there is no need to repeat the compile process the next time a page is
opened. In other words, pages that have been opened once can subsequently be
displayed more quickly.
Note
Before zipping the ...\project\ pv directory into a backup zip file, first delete all pvdefault-page.* files and all files with the extension *.svg or *.svg.gz.
These files must be deleted, because when they are later extracted on another Web
server, these files are not assigned the access rights of the local ASPNet user. The
Web Plant Viewer will not be able to create a new version of these files if they already
exist.
The ASPX process copies the pv-default-page.* files to the pv directory if necessary.
6.6.1
Workflow
Creating a backup copy
Let us assume that you want to create a backup copy of a DESIGO WEB project that
has been prepared in the engineering office, so that you can restore it quickly and
without having to install Web DIGG on the customer server.
Backing up the Web project in the engineering office.
1.
2.
3.
4.
5.
Create the Web project with Web Project Creator.
Extract WebInsight.zip.
Generate Web graphics with Web DIGG.
Delete the files pv-default-page.* and all *.svg and *.svg.gz files from the directory
...\project\pv.
Create the file pv.zip with the contents of directory ..\project\ pv.
74 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Creating and backing up a Web project
CM110510en_01
30.01.2007
6.6.2
Restoring a backup copy
Let us assume that you have created a DESIGO WEB project with Web Project Creator
(or manually) on the customer's Web server, and that you have extracted the file
WebInsight.zip in this project.
Restore the Web project on the Web server:
1.
Delete the contents of the directory ...\project\ pv
2.
Now extract the pv.zip file created in the engineering office into the empty
directory folder.
3.
Commission the DESIGO WEB project See Section 3.1.3, Creating and
commissioning the DESIGO WEB project.
75 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Creating and backing up a Web project
CM110510en_01
30.01.2007
76 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Creating and backing up a Web project
CM110510en_01
30.01.2007
7
Importing the DESIGO INSIGHT plant
graphics
7.1
Principles
The DESIGO WEB graphics pages are created with DESIGO INSIGHT Graphics
Generator (DIGG). This includes not only the project-specific plant pages, but also the
HQ standard and the country-specific or project-specific super genie pages. In DESIGO
WEB these are largely the same in appearance as the graphics on a DESIGO INSIGHT
desktop management station.
In Versions V2.2/V2.3 DIGG is used exclusively to generate plant graphics for the
DESIGO PX subsystem. For this purpose, fully functional PX applications are required,
created with DESIGO Toolset (DTS) and programmed with standard components (a
compiled export file for each automation station).
Since DESIGO INSIGHT V2.35 it is possible to use Web DIGG to convert existing
graphics pages, created with Citect Graphics Builder, from all subsystems, so that
they can be displayed over the Web by Internet Explorer. To achieve this, it was
necessary to enhance the functional scope of DIGG.
Important
Web DIGG cannot create new Web pages! It can only convert existing Citect graphics
(plant and super genie pages) into Web pages.
Existing graphics pages
For the generation of DESIGO WEB graphics, we recommend the use of fully
programmed Citect graphics projects, ready to run, and compiled without error. These
must contain the plant and super genie pages to be converted. Errors in Citect projects
can generate resulting errors in Web DIGG, which can lead to unnecessarily timeconsuming searches.
Basic Web components
The basic Web components must be installed on the engineering PC.
See Section 5.5.1, Installing basic Web components.
7.1.1
Principle of Web-page creation
Graphics engineering involves placing individual graphic elements such as HVAC
symbols, pipes, genies, text and buttons on a Citect page template. All these elements
can be regarded as objects with the relevant properties and X and Y coordinates on the
page. Cicode functions are either implemented directly in the individual objects, or
retrieved from Cicode modules.
Web DIGG can break up the existing Citect graphics pages into their individual objects.
The individual elements are converted into " Web-compatible " formats (png, *.txt, *.js,
*.xml). A cross compiler converts supported Cicode functions into JavaScript. All pages
with their objects and the associated coordinates are mapped in a structured format to
XML files (*.xml in text format). All these files generated by Web DIGG are saved in the
DESIGO WEB project directory on the Web server.
When a graphics page is invoked in DESIGO WEB, the ASPX page on the Web server
can assemble an HTML page from these now Web-compatible files, and send it with
the *.svg files (Scalable Vector Graphics) to the DESIGO WEB clients.
77 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
The following is a simple illustration of the principles:
Engineering PC with Citect installed
*.ctl
*.dbf
*.ctm
*.ctg
*.ini
*.ci
Citect Graphics Builder
Web DIGG
Cross Compiler
Web Server (IIS)
*.xml
*.png
*.txt
*.js
Web Server
plant-viewer.aspx
*.svg
HTML
DESIGO WEB client
Web Plant Viewer with HTML plant page
78 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
7.2
Plant pages and super
genie pages
In existing customer projects, the DESIGO INSIGHT graphics are normally projectspecific plant pages and overview pages. The operation of the plant involves the use
not only of the HQ standard super genies, but often also of country-specific or
customized super genies.
Although super genies are smaller than plant graphics, both are created and saved in
the Citect graphics projects as pages.
All the plant pages and super genie pages must be created as Web pages with Web
DIGG, so that operation and display via DESIGO WEB works in the same way, and
looks the same as in the desktop Plant Viewer.
7.2.1
Requirement:
DESIGO WEB graphics pages
Plant pages and overview graphics
All experienced graphics engineers working on customer projects must be able to use
Web DIGG to generate the required plant graphics for DESIGO WEB. They must also
be able to interpret any Web DIGG error messages and either carry out the necessary
corrective measures themselves, or call upon expert support.
7.2.2
Super genie pages in the HQ graphics standard
The point of standard super genie pages is that they can be re-used without the need
for engineering. This is an advantage which we would like to maintain in DESIGO WEB.
In order, therefore, to avoid the need for every project engineer to re-create the HQ
standard super genie pages in their own project for DESIGO WEB, these pages are
pre-generated at HQ and supplied via the Web project installation (in the
" WebInsight.zip " file.
7.2.3
Country-specific super genie pages
In all the larger Siemens regional companies, the library experts responsible for
DESIGO WEB in the head office of the country concerned generate local standard
super genie pages in advance and incorporate them into a country-specific
" RC_WebInsight.zip " . Expert knowledge is required for this process (creation of Citect
graphics libraries, use of Cicode, use of JavaScript, fault analysis, debugging with Web
DIGG Debugger utility etc.)
Smaller regional companies which do not have their own library experts use the HQ
standard libraries, work together with a larger RC or with the support of HQ.
79 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
7.3
Working with Web DIGG
7.3.1
Workflow for creating Web pages
The flow chart below shows the procedure for converting the Citect graphics pages into
DESIGO WEB pages:
Start Citect Explorer
Compile the Main project
and select it
Close DIGG and install the
basic Web components
Start DIGG
Ist the Web
tab visible?
NO
YES
Click the Web tab in
the shortcut bar
Enter the Web project path
via the Web tab under
& gt; Tools & gt; Options
In the tree view, select the
pages to be generated
Start generating the
Web pages
Make sure there are no
error messages in the
report window.
Check info about number
of pages generated
The next sections provide details of the individual steps involved in generating Web
graphics pages, and describe the associated Web DIGG options.
80 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
7.3.2
Preparing Web DIGG
The user interface of Web DIGG is like the existing DIGG user interface which will be
familiar to graphics engineers involved in generating the PX plant graphics.
The basic Web components must be installed on the engineering PC. Without them, the
Web tab will not be available in DIGG.
Tip
Check that the option /WEB is set in the DIGG.ini file. The DIGG.ini file can be found in
the directory …\Insight\Digg\.
To start DIGG from the desktop, create a shortcut to the file. …\Insight\Bin\Digg.exe.
Web DIGG user interface
The user interface of DIGG for the generation of DESIGO WEB graphics is the same as
that used to generate the PX graphics pages.
Select the Web tab in the shortcut bar (by default on the left side of the DIGG user
interface). In the browser dialog box you will see your main graphics project. By
expanding the tree structure (identical to the link structure engineered in the Citect
graphics projects), you can navigate through the graphics projects and display the
graphics pages.
Update tree structure
Click & lt; F5 & gt; to update the tree structure in case another graphics project has been
selected in the Citect Explorer in the meantime.
81 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
7.3.3
Setting the Web options
Before creating any Web pages, you must set the Web options for DIGG. To do this,
open the dialog box for setting the options, by selecting
Tools & gt; Options & gt; Web.
Path to the Web project
The most important setting is the path to the Web project installation, which ensures
that the Web files generated by Web DIGG are saved in the right location.
The Web project always resides on the Web server.
The Web server, however, may have been set up on your local workstation, or remotely
on another PC or server (IIS components!). In the latter case, a UNC path must be
entered.
By default, the Web files created (*.png, *.xml, *.js) are always exported to the target
directory ..\WebInsight\project\pv\... (see the display in the grayed-out field).
(Here " WebInsight " stands for the directory name that you defined when you created
the Web project in Web Project Creator.)
Offline engineering
If the Web server is not accessible via UNC path, e.g. if you want to generate Web
graphics pages on a notebook not connected to the network, the Web files can be
generated locally in the default directory, and transferred later directly to the target
directory …\project\pv\... in the IIS with an FTP utility.
82 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
Cicode function
mapping table
The default path to the file containing the Cicode function mapping table is shown under
Cicode Mapping Function. Click Edit to open the text file CicodeMappingTable.txt and
add to it if necessary. This is where you can define how Web DIGG responds to Cicode
functions not supported by the cross compiler. This is described in more detail further
below.
Web settings
The default path to the Web.ini file is shown under Web settings. Click Edit to open
the Web.ini file and add to it if necessary.
The content and functions of the settings in Web.ini files are described further below.
Web options
The check box Only Create Web files, if Corresponding Citect pages are newer lets
you select an " Update " mode that only creates pages if they have changed in the Citect
projects since the last page creation procedure.
This is described in more detail further below.
Max number of
compile errors
You can enter a value here to define the maximum number of compiler errors. If this is
exceeded, DIGG terminates the graphic page conversion process.
The default limit is a maximum of 30 errors.
Warning
If the compiler process is interrupted after reaching the preset maximum number of
errors, any Web graphics already created are unlikely to work, because other files are
incomplete (e.g. *.js).
Corrective action: Either correct the errors or set the Max. Compiler Errors to 9999.
7.3.4
Selecting pages to be converted
Either complete projects or individually selected pages can be adopted. The pages to
be converted are defined by selecting the relevant check boxes in the tree view of the
projects.
The pages selected for conversion are listed on the right in the DIGG status window.
This window also acts as a progress indicator while the Web files are being generated.
An accumulative display of status and error messages for each page provides
information on the anticipated outcome of the conversion process.
Pages already selected and listed can be removed from the list by right-clicking the
relevant page entry and selecting Remove page (Uncheck).
83 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
7.3.5
Start
Generating Web plant pages
The conversion process can be started either by clicking the Start button on the menu
bar or by pressing & lt; F9 & gt; .
The selected pages are now exported in accordance with the settings, ready for
conversion.
– If the Only Create Web files if... check box is selected, pages that have not
changed will not be exported
(saves time with selective changes)
– Pages are not exported if they have been excluded with " exclude " in the Web.ini file.
– Pages are not exported if they contain the key word & lt; WebExclude & gt; in the
Description field of the Citect page properties.
If no pages are selected, then all pages are regenerated/updated.
The status of the export process is indicated continually in the report window.
7.3.6
Updating modified graphics pages
Selecting the check box Only Create Web files, if Corresponding Citect pages are
newer allows you to update only those pages that have changed, instead of always
having to generate all the pages again. Web DIGG automatically recognizes where any
changes have occurred.
However, if you are generating the project pages for the first time, or in the case of one
of the changes described below, you will be prompted to export all the plant graphics
including the super genie pages.
Note that it usually takes a long time to update all the pages, especially if all the super
genie pages also need to be updated ( & gt; 1 h).
All pages must be updated if changes have been made to the following:
- Citect databases (e.g. english.dbf),
- Labels
- Fonts
- The " Include " structure of the project, or
- The system database (e.g. after DB Import)
If none of the above changes has been made, then, as required, only pages containing
modifications are updated. Generally, this takes no more than a few minutes or
seconds.
Changing the
page description:
Customers with the desktop version of Plant Viewer can create a text file with a
description for every plant page. If one of these page descriptions is newly created or
modified, the text file for the page concerned is updated/exported to the Web project
the next time Web DIGG is run. The button in Web Plant Viewer is then no longer
unavailable ( " grayed out " ) and the description can be read. Web Plant Viewer does not
support the creation or modification of a page description by the user
Recommendation:
– Start Web DIGG initially without the update setting.
84 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
– Use the update setting on the customer PC when the project is more or less finished
and/or when you are sure that there will be no further changes to labels, fonts,
Include structure, language etc.
– By setting the option " /update " as a command line parameter, you can run the
update process in Web DIGG automatically at regular intervals controlled by a time
schedule. In this process, any changes carried out in the Citect project are
automatically updated on the Web pages of your Web projects.
Use the Scheduled Tasks Wizard for this purpose: Start & gt; Programs & gt; Accessories
& gt; System Tools & gt; Scheduled Tasks.
7.3.7
Generating Web super genie pages
HQ standard
super genie pages
As already stated, all HW standard super genies for the PX, Visonik, NCRS, NITEL and
Unigyr graphics libraries are created in advance at HQ and delivered as part of the file
..\template\WebInsight.zip, used by Web Project Creator. The super genies do not need
to be converted again.
Country-specific
super genie pages
Some countries also generate their own country-specific standard plant pages and
super genie pages in advance, and supply project engineers with an RC-specific
version of the WebInsight.zip file.
The procedure is as follows:
1.
2.
3.
Note
Create an empty Web project with the Web Project Creator.
Convert the local standard plant pages and super genie pages.
Copy the newly generated files from the folder ..\project\pv\.. to the file
WebInsight.zip, making sure that you save this file under a different name from
the name given to the HQ standard WebInsight.zip file (RC_WebInsight.zip).
The paths of all files in the zip file must be set correctly.
Later, when working with Web Project Creator, the project engineer can extract
the country-specific RC_WebInsight.zip file instead of the WebInsight.zip file from
HQ.
When integrating new (local) plant or super genie pages into an existing (standard)
WebInsight.zip file, remember that you must not adopt all the files in the local directory
..\project\ pv“.
Before zipping the ...\project\ pv directory into a backup zip file, first delete all
pv-default-page.* files and all files with the extension *.svg or *.svg.gz“.
See Section 6.6, Backing up/restoring the Web project.
Displaying super genie
pages in Web DIGG
Since site engineers normally only need to import the pages of their own project for the
Web, by default the Web DIGG browser pane does not show the super genie pages in
the tree view. This makes for a clearer overall view, and prevents the unnecessary
creation of Web super genie pages that exist already, having been generated in
advance.
In order to convert local super genies, they must be displayed for selection in the tree
view in Web DIGG.
1.
In the DIGG menu, select: & gt; Tools & gt; Options & gt; General and under Super Genie
Pages select the check box to display super genies in the tree view.
85 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
2.
3.
Close the Options dialog box.
Press & lt; F5 & gt; to refresh the browser view. The super genies are now displayed in
the tree view.
The procedure for converting super genie pages is exactly the same as for plant
graphics pages.
Start
1.
2.
Select the required super genie page(s) in the tree view.
Start conversion by clicking the Start button on the menu bar, or pressing & lt; F9 & gt; .
7.3.8
Web DIGG reporting
While the Web pages are being created, the report pane (in the lower part of the Web
DIGG user interface) provides continuous information on the conversion process.
The report messages provide information on the following:
•
•
•
•
•
Context menu
The converted Cicode modules
The selected Web.ini files
The selected CitectMappingTable.txt files
A list of the pages generated
Error, warning and information messages generated during the conversion process.
For a quick analysis of the messages in the report pane, you can display a context
menu by right-clicking on a selected message.
86 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
" View " function for
error messages
If an error message is selected, you can use the " View " option to jump straight to the
error in Graphics Builder or in the Cicode Editor. The graphics page or Cicode module
on the selected line are opened automatically in the tool. On a graphics page, the item
which is the cause of the error is highlighted.
The tabs at the bottom of the report window allow you to filter the messages according
to the categories shown.
(Default setting for status and error messages: Overview tab)
Log file
With a large number of messages, not all of them can be displayed in the report pane.
However, all the messages are saved to a log file (in text form) and this provides the
engineer with a clearer overview (or print-out, if required). The log file can also be
opened in the context menu referred to above.
87 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
7.4
Diagnostics and troubleshooting
7.4.1
Web Plant Viewer diagnostic tool
Debugging
The Web Plant Viewer incorporates diagnostic tools with limit functionality to trace and
analyze software errors on the graphics pages or in the associated JavaScript
programs.
A " trace " window or " debugger " is used to display errors messages and messages
about the conversion process, and to locate and analyze errors in elements on the
graphics pages.
Notes on
Debug mode
Debug mode (diagnostics)
• Debug mode is recommended only for qualified library and system experts.
• The open Trace window uses more of the system resources, and this can have
negative effect on the performance speed of your workstation.
Trace window
To activate the Plant Viewer " Debug " mode, edit the relevant line in the Project.config
file (in the ..\WebInsight\Project.. folder) as follows:
& lt; PlantViewer & gt;
& lt; Startup DebugMode=“true” / & gt;
& lt; /PlantViewer & gt;
If the option StartupDebugMode= " true " is set in this file, then the
WebTraceWIndow.html will be displayed when Web Plant Viewer is started.
The " Trace " window can be closed and opened again later by clicking the icon
the Plant Viewer menu bar, or with the keyboard combination & lt; Shift+t & gt; .
on
Error and program messages are displayed chronologically in the trace window.
Additional information appears when specific queries are entered in the Debugger tool.
The Debug window (DebugWindow.htm) must be open for this purpose.
Debug window
The scope of the Debugger is always limited to one graphics page (plant graphic or
super genie page) at a time. Whenever you click the debug button
, the focus is
always on the plant page currently displayed. In order to investigate an open super
genie page, the debugger must be focused on the relevant window. The title of the
Debug window contains information about the original window.
88 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
Starting the debugger
Proceed as follows:
1.
Focus on the required (super genie) window by clicking the mouse.
2.
Press & lt; Shift + d & gt; .
This opens the Debug window.
Site engineers can access the main functions via the Properties and TagInfo buttons.
Clicking these buttons opens the Trace window and starts the display of information
about the item under investigation.
Cicode expressions or commands can be entered in the input field. The result of the
function can be displayed in the adjacent results field by use of the associated keys
(key combinations).
89 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
7.5
Preparing local standard graphics libraries
for Web conversion
7.5.1
General
This section deals with the mechanisms involved in the conversion of Citect graphics
and Cicode modules into xml, png und JavaScript files.
There are many functions in Cicode which the cross compiler cannot convert into
JavaScript, and which are therefore not supported for DESIGO WEB.
The Web DIGG report messages provide information on the Cicode modules, Cicode
functions or graphics pages (genie/super genie pages) which include non-supported
functions.
There are various methods by which library experts can prepare their standard libraries
so that the Web conversion in Web DIGG runs without errors.
The three main approaches are as follows:
– Exclusion of the conversion of a non-supported function. The cross compiler skips
the excluded function.
– Replacement of non-supported Cicode functions by supported Cicode functions.
With this " workaround " solution it is often possible to achieve the same functions in
DESIGO WEB as on the Citect graphics page.
– Reprogramming (replacement) of a non-supported Cicode function directly in
JavaScript.
Expert knowledge
We assume that the engineers who are responsible for the standard libraries in the
Regional Companies and who are required to prepare these libraries for Web
conversion are well-versed in the programming of script languages (e.g. Cicode and
JavaScript).
7.5.2
Key words
Definition of WebExclude / WebInclude
To include or exclude functions in the conversion process, the cross compiler uses the
key words WebExclude and WebInclude. These key words can be used not only in
the Web.ini and CicodeMappingTable.txt files but also in Cicode functions.
The application is described below.
7.5.3
The Web.ini file
Web.ini is a text file which can be used in the Citect graphics projects (every project has
its own Web.ini in the project directory). Web.ini defines which elements of the graphics
projects must always be excluded (skipped) or included by the cross compiler.
Elements of the graphics projects are:
– Graphics pages (note that super genies are also graphics pages)
– Genies
– Symbols
– Cicode modules
The hierarchy of the project Include structure determines the priority of the
" Include/Exclude " definitions. The G project has the lowest priority and the main
(Compile) project the highest priority. Therefore, if a symbol in the G project was
excluded, but is included again in a project integrated at a higher level in the structure,
it will be converted for the Web application.
90 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
The file is divided into the following sections:
[WebExclude]
In the [WebExclude] section, the key words " Page " , “Module”, “Genie” or “Symbol” can
be used to specify elements of the project that should always be skipped by the cross
compiler (these elements are excluded from DESIGO WEB).
Example:
A genie with non-supported up/down navigation keys is excluded as follows:
Genie=G.g1_yw000.wk000_0_mx01
[WebInclude]
In the [WebInclude] section, the elements of a project that must always be included by
the cross compiler can be specified. WebInclude has a higher priority than WebExclude
statements made in the Web.ini file, or in the page properties, graphics elements or
Cicode modules.
Citect basic graphic elements (drawing primitives) such as lines, pipe, circles etc.
cannot be influenced in the [WebInclude /WebExclude] sections of the Web.ini file, as
they are not library elements.
Input format
Wildcards " * " and " ? " are supported. The input format always consists of the library
name, followed by a dot and the excluded or included item.
Examples:
Page=PX.!pxHeatCur
Modul=PX.p_slider.ci
etc.
91 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
See also the following illustration:
[WebExclude]
;===========
;Page=*
;Genie=*
;Symbol=*
;Module=*
Page=G.*
Module=G.*
[WebInclude]
;===========
Module=G.Tag.ci
Module=G.Citect.ci
Module=G.Alarm.ci
Module=G.Citectx.ci
Module=G.CitHnd.ci
Module=G.Misc.ci
Module=G.Globals.ci
Module=G.Windows.ci
Module=G.Sites.ci
Module=G.Spin.ci
Module=G.G_popups.ci
[Globals]
;========
EditorExtension=.txt
In the example above, first all Cicode modules are excluded from conversion by Web
DIGG.
In the [WebInclude] section (which has a higher priority than WebExclude), individual
modules are re-included.
In the [Globals] section, the text editor extension " .txt " is defined. This entry relates to
the text editor extension set in the Globals.ci file for the string " gsEditorExt " .
92 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
7.5.4
The CicodeMappingTable.txt file
The G and Include projects contain CicodeMappingTable.txt files which list the
functions that are not supported by the cross compiler. For non-supported functions,
the table gives default values which can be used as substitution values to replace the
function in the JavaScripts.
• The CicodeMappingTable.txt file of the Citect Include project contains nonsupported Citect Standard Cicode functions.
• The CicodeMappingTable.txt file of the G project contains non-supported HQ
Cicode functions.
The default values defined for the G projects can be overwritten by use of a
CicodeMappingTable.txt file contained in a project which is integrated at a higher level
than the G project within the project link structure. The priority is determined by the
hierarchy of the project Include structure.
Hence, when you prepare local standard graphics libraries for Web conversion, you
should define your own Web.ini and CicodeMappingTable.txt files in these libraries.
Since local projects are at a higher level in the project link structure than the HQ
standard libraries, your definitions will overwrite those from HQ.
Note
Do not make any changes to the Web.ini and CicodeMappingTable.txt files in the HQ
standard graphics libraries. To influence Web conversion, create new versions of these
files in (your) local projects.
Checking the
Cicode modules
If you want to check whether the local Cicode modules (and the functions they contain)
will operate as required in the Web application, you must make sure that:
– The relevant functions/modules are not " excluded " in the Web.ini file.
– None of the functions used is specified in the CicodeMappingTable.txt as " not
supported " .
If a function is listed in the CitectMappingTable.txt file, this indicates that it is not
supported in the Web. In many cases, existing Cicode that contains non-supported
functions can be adapted by inserting substitute functions that are supported in the
Web.
93 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
Extract from the CitectMappingTable.txt file of the G project.
(Comments in the text file are preceded by " ; " or " ! " .)
;CicodeMappingTable.txt
;======================
;Syntax for one line:
;1. Leading and trailing white spaces (space and tab) are ignored
;2. Empty lines are ignored
;3. Lines starting with ';' or '!' are comments
;
;A mapping line has 3 parts, separated by tabs:
;1) Cicode function name without signature
;2) JavaScript replacement, where the replacement can be a function
name without
;signature or a literal (int, float, or string).
;3) ExcludeElement ('yes' or 'no'), 'no' is default, i.e. doesn't
have to be specified
; Alarm.ci functions
;=====================================
; Module included
GetSeeToolTipAlarm
0
IsUnigyrAlarm
0
IsUnigyrAlarmRec
0
; CitectX.ci functions
;=====================================
; Module included
CxGetWindowTitle " "
CxSetWindowTitle (-1)
The function CxGetWIndowTitle() will return an empty string as the returned value in
Web Plant Viewer. In other words, it will not function as in Desktop Plant Viewer.
Note
If you want to return negative numbers, always put them in brackets to avoid errors
(see last line in the example above)
94 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
7.6
Adapting files: Some practical examples
The cross compiler does not support all Cicode functions when converting to
JavaScript. The following options can be used to resolve the problem of non-supported
functions:
– Modify the existing Cicode so that it does contain any non-supported functions.
– Default values can be defined in the CicodeMappingTable.txt file for non-supported
functions, to be output instead of the result (e.g. " –1 " ).
– Exclude the non-supported Cicode functions with " WebExclude " and replace them
with JavaScript or supported Cicode functions.
7.6.1
WebExclude
This section describes working with " WebExclude " in more detail on the basis of some
examples.
7.6.1.1
Example: Cicode replacement for non-supported Cicode
To replace a non-supported Cicode function with new Cicode, place commentcharacters on either side of the piece of Cicode ( /*comment*/).
/*{{WebExclude*/ cicode /*}}WebExclude & lt; new code & gt; */
The cross compiler in DIGG ignores all Cicode statements marked as comments. If the
& lt; new code & gt; is created, it is inserted here in text form. & lt; new code & gt; must be a valid
piece of Cicode. If no & lt; new code & gt; component is added, the default 0 or (= empty
string) is used for the Cicode expressions.
Example: The Cicode function CalculateOffset() is not supported on a DESIGO WEB
client, and is therefore to be replaced with the constant value 13.7. Desktop Plant
Viewer continues to use CalculateOffset().
...
Site_AS66_NamRI + /*{{WebExclude*/ CalculatedOffset() /*}}WebExclude
13.7*/
...
95 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
7.6.1.2
Example: JavaScript implementation
In this example, Web DIGG does not convert the Cicode to JavaScript.
However, the cross compiler expects to find a JavaScript file (*.js) in the project folder
integrated into the Include structure. This file contains a manually created JavaScript
substitute function named " Fred " .
FUNCTION Fred(STRING sSite)
/*{{WebExclude*/
Cicode here
/*}}WebExclude*/
END
pv.Cicode.Fred = function(sSite)
{
JavaScript here
}
When creating the JavaScript function, the engineer must make sure that it works as in
the original Cicode (the same number of parameters and output value types if any). The
& lt; new code & gt; component is not required here and is therefore left blank.
7.6.1.3
Example: Exclusion of a complete function
In this example, the cross compiler skips the complete function in the conversion
process.
/*{{WebExclude*/
FUNCTION Fred(STRING sSite)
Cicode here
END
/*}}WebExclude*/
The function is completely excluded in Web Plant Viewer. If it is called via another
Cicode function, in a page, a genie or a super genie, DIGG will transmit an error
message.
7.6.1.4
Example: WebExclude in Page Properties
The WebExclude statement in the Page Properties can be used to exclude whole
graphics pages from the Web conversion process (exclusion with the highest priority).
To use this option, enter the key word & lt; WebExclude & gt; in the Description field of the
page properties. Web DIGG then skips this page, even if it was specified in the
[WebInclude] section of the (lower priority) Web.ini file as a page to include.
96 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
7.6.1.5
Example: Basic graphics elements (drawing primitives)
Basic graphics elements cannot be excluded in the Web.ini file. However, the
Description fields of the Access properties can be used for this purpose.
To use this option, enter the key word & lt; WebExclude & gt; in the Description field of the
Access properties. Web DIGG will then skip the element concerned (and any nested
sub-elements).
Note
There is no description field for genies in the properties. They can only be excluded via
the Web.ini file.
97 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
7.6.2
Cicode modifications
Cicode is a language capable of multitasking even though it only needs one operating
system thread for this purpose. The Web browser (with JavaScript or VBScript) does
not support this feature. The Script Engine of a Web browser is " single-threaded " , i.e. it
does not allow script threads to run in parallel. Because of this distinction, some Cicode
functions, in particular blocking functions (Sleep, FormRead etc.) cannot be mapped to
a JavaScript equivalent without the use of Active components or Java applets.
Cicode modules containing functions of this kind can be prepared for Web conversion
by (minor) modifications to be carried out by the library experts.
As a general rule, the following functions require a Cicode modification:
– Sleep / SleepMS
– FormRead
– While
– CXShowMenu
– Alarm property “Time”
The examples below show how to adapt any country-specific or project-specific Cicode
containing these functions, and how to prepare it for Web conversion to JavaScript.
7.6.2.1
Normal situation
Sleep / SleepMS
Normally, the function Sleep/SleepMS is used between two pieces of Cicode (A and B).
Cicode A;
sleepMs(4000);
Cicode B;
END
Preparation for conversion:
– Sleep() and/or SleepMS() have no effect on a Web page.
– To remedy this, move the code after the Sleep statement (Cicode B) to a new
function and use TaskNewDelayed() with the new function name and optional
arguments.
Cicode B -- & gt;
INT NewFunction(....)
B;
END
This produces the following routine, which behaves in the same way after Web
conversion as in the original Cicode.
Cicode A;
TaskNewDelayed( “NewFunction”,
END
Example 1:
“”, 4000);
Use of Sleep or SleepMS between pieces of Cicode.
Original Cicode
FUNCTION MyFunc()
CxTraceMsg( " Part 1 " );
SleepMs(2000);
CxTraceMsg( " Part 2 " );
SleepMs(1500);
CxTraceMsg( " Part 3 " );
98 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
END
Re-engineered Cicode
FUNCTION MyFunc()
CxTraceMsg( " Part 1 " );
TaskNewDelayed( " MyFuncContinue1 " , " " , 2000);
END
FUNCTION MyFuncContinue1()
CxTraceMsg( " Part 2 " );
TaskNewDelayed( " MyFuncContinue2 " , " " , 1500);
END
FUNCTION MyFuncContinue2()
CxTraceMsg( " Part 3 " );
END
Exception
Sometimes the delay time depends on procedures on the server, or on current
processes (e.g. with SiteConnect() or TagWrite). In such cases, to simplify the situation,
proceed as follows:
1.
Example 2:
Replace Sleep() and/or SleepMS() with SleepMSEx() with the following restriction:
SleepMSEx() stops JavaScript from running on the Web client for the period of
time specified in the parameter (in ms). This solution will therefore only work if,
during the delay period, jobs are running exclusively on the server (wait for server
feedback message).
Use of Sleep or SleepMS to wait for server feedback.
Original Cicode
FUNCTION MyFunc()
INT nState;
ChSiteConnect( " Site1 " );
nState=ChSiteGetConnectionState( " Site1 " ));
// nState is now most probably = 0
Sleep(2); // same as SleepMs(2000)
SleepMs(3000);
nState=ChSiteGetConnectionState( " Site1 " ));
// nState should be 3
END
Re-engineered Cicode
FUNCTION MyFunc()
INT nState;
ChSiteConnect( " Site1 " );
nState=ChSiteGetConnectionState( " Site1 " ));
// nState is now most probably = 0
SleepMsEx(2000);
SleepMsEx(3000);
nState=ChSiteGetConnectionState( " Site1 " ));
99 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
// nState should be 3
END
7.6.2.2
FormRead(0)
When Cicode statements follow a FormRead(0), the following applies:
1.
FormRead(0) must be replaced by FormReadEx.
2.
The code after the FormRead(0) must be moved to a new function
a) The first argument is the result (INT).
b) Additional arguments are optional
c) This function and the additional arguments must be delivered in FormReadEx.
3.
Local form variables (e.g. in FormInput) must be redefined as global or module
variables, in case they still need to be read after the form has been closed.
The following is an example of the most common use of the FormRead(0) function and
shows how the Cicode component has to be re-engineered so that forms can be used
on a Web client.
Example:
Original Cicode
FUNCTION MyForm()
INT nResult;
STRING sValue=0;
FormNew( " MyForm " , 30, 5, 0);
FormInput(1, 2, " Value " , sValue, 20);
FormButton(1, 4, "
OK
" , 0, 1);
FormButton(15, 4, " Cancel " , 0, 2);
nResult = FormRead(0); // wait for user
IF nResult = 0 THEN
TagWrite( " Tag1 " , sValue);
END
END
Re-engineered Cicode
STRING msValue=0;
FUNCTION MyForm()
FormNew( " MyForm " , 30, 5, 0);
FormInput(1, 2, " Value " , msValue, 20);
FormButton(1, 4, "
OK
" , 0, 1);
FormButton(15, 4, " Cancel " , 0, 2);
FormReadEx( " MyFormContinue " , " Tag1 " );
END
FUNCTION MyFormContinue(INT nResult, STRING sTag)
IF nResult = 0 THEN
TagWrite(sTag, msValue);
END
END
100 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
7.6.2.3
Example 1:
FormRead(1)
Using FormRead(1) without any code after FormRead
Original Cicode
FUNCTION TestForm0()
INT hForm, hField, hButton;
STRING sValue = " 62 " ;
hForm = FormNew( " MyForm " , 38, 3, 0);
hField = FormInput(1,1, " Number " , sValue, 16);
hButton = FormButton(0,2, " Increment " , Inc, 0);
FormSetInst(hForm, hButton, hField, " " );
FormButton(28, 2, " Close " , 0, 2);
FormRead(1);
END
INT FUNCTION Inc()
INT hForm, hField, hButton, nNumber;
STRING sUnused;
FormCurr(hForm, hButton);
FormGetInst(hForm, hButton, hField, sUnused);
nNumber = FormGetText(hForm, hField);
FormSetText(hForm, hField, nNumber + 1);
RETURN 0;
END
Re-engineered Cicode
No re-engineering required as there is no code after the FormRead(1)
statement!
Example 2:
Using FormRead(1) with a WHILE loop after FormRead
Original Cicode
STRING msTime;
FUNCTION MyForm()
INT hForm, hField;
hForm = FormNew( " MyForm " , 30, 5, 0);
msTime = Time();
hField = FormInput(1, 1, " Time " , msTime, 20);
FormRead(1);
WHILE FormActive(hForm) DO
// update the time in the form
FormSetText(hForm, hField, Time());
SleepMs(1000);
END
CxTraceMsg( " Done " );
END
Re-engineered Cicode
STRING msTime;
FUNCTION MyForm()
101 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
INT hForm, hField;
hForm = FormNew( " MyForm " , 30, 5, 0);
msTime = Time();
hField = FormInput(1, 1, " Time " , msTime, 20);
FormRead(1);
WhileLoop(0, " MyFormActive " , hForm1:#, " MyFormStatements " ,
hForm1:# + " , " + hFieldTime1:#, 1000, " MyFormContinue " , " " );
END
FUNCTION MyFormActive(INT hForm)
gbWhileCondition = FormActive(hForm);
END
FUNCTION MyFormStatements(INT hForm, INT hField)
// update the time in the form
FormSetText(hForm, hField, Time());
END
FUNCTION MyFormContinue()
CxTraceMsg( " Done " );
END
102 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
7.6.2.4
WHILE
The following applies to the conversion process:
1.
Separate the WHILE loop into two parts, and write the new functions:
a) The " Expression“ component
The function must define the global variable gbWhileCondition.
b) The “Statement” component
2.
Move the code after the loop to a new function.
3.
Replace the WHILE statement with the function call WhileLoop and transfer all
function names with optional arguments.
4.
The loop interval is the sixth argument.
5.
If a Sleep or SleepMS statement occurs before the loop, the first argument in the
WhileLoop function can be used.
Example:
Run Citect report, wait until this is complete and then display the file with the results.
Original Cicode
Report( " Report1 " );
SleepMS(500);
WHILE RepGetControl( " Report1 " , 0) & lt; & gt; 0 DO
CxTraceMsg( " WhileStatements " , sReport);
SleepMS(200);
END
DisplayFile( " [run]:Report1.001 " );
...
Re-engineered Cicode
Report( " Report1 " );
WhileLoop(500, " WhileExpression " , " ^ " Report1^ " " ,
" WhileStatements " , " ^ " Report1^ " " , 200,
" WhileContinue " , " ^ " Report1^ " ,1 " );
FUNCTION WhileExpression(STRING sReport)
gbWhileCondition = RepGetControl(sReport, 0) & lt; & gt; 0;
END
FUNCTION WhileStatements(STRING sReport)
CxTraceMsg( " WhileStatements " , sReport);
END
FUNCTION WhileContinue(STRING sReport, INT nIndex)
DisplayFile( " [run]: " +sReport+ " .00 " +nIndex:#);
...
END
103 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
7.6.2.5
CxShowMenu
The following applies to the conversion process:
1.
Generate a new Cicode function for everything following CxShowMenu.
a) The first parameter of this new function is the index of the selected menu item
(as an INT)
b) Other optional parameters can be used.
2.
Add to CxShowMenu() two parameters containing the new function name and
optional parameters. Local variables can be delivered with the operational
parameters, as demonstrated with sValue and nValue in the example below.
3.
The value returned by CxShowMenu must be ignored.
Example:
Display context menu, wait until an item is selected and then continue with the index of
the selected menu item.
Original Cicode
FUNCTION Menu1()
INT
hMenu, nSelected;
STRING sValue;
INT
nValue;
hMenu = CxCreateMenu();
CxAppendMenuItem(hMenu, MF_STRING, 1, " Item 1 " );
CxAppendMenuItem(hMenu, MF_STRING+MF_CHECKED, 2, " Item 2 " );
sValue = " Hello world " ;
nValue = 123;
nSelected = CxShowMenu(hMenu, 10, 10, DM_ALL);
CxTraceMsg( " Menu1 " , " sValue=' " + sValue + " ' " );
CxTraceMsg( " Menu1 " , " nValue= " + nValue:#);
CxTraceMsg( " Menu1 " , nSelected:# + " selected " );
END
Re-engineered Cicode
FUNCTION Menu1()
INT
hMenu;
STRING sValue;
INT
nValue;
hMenu = CxCreateMenu();
CxAppendMenuItem(hMenu, MF_STRING, 1, " Item 1 " );
CxAppendMenuItem(hMenu, MF_STRING+MF_CHECKED, 2, " Item 2 " );
sValue = " Hello world " ;
nValue = 123;
CxShowMenu(hMenu, 10, 10, DM_ALL, " Menu1Continue " ,
" ^ " " +sValue+ " ^ " , " +nValue:#);
END
FUNCTION Menu1Continue(INT nSelected, STRING sValue, INT nValue)
CxTraceMsg( " Menu1 " , " sValue=' " + sValue + " ' " );
CxTraceMsg( " Menu1 " , " nValue= " + nValue:#);
CxTraceMsg( " Menu1 " , nSelected:# + " selected " );
END
104 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
7.6.2.6
Alarm Property “Time”
Because the data type of the Time property is an integer in Citect and a string in
DESIGO INSIGHT, different functions are required to display it in the Web and in
Desktop Plant Viewer respectively.
For a desktop plant graphics page, the function TimeToStr() must be used. On a Web
plant page, by contrast, no function is required.
Example:
Original Cicode
TimeToStr(DigAlm.Time, 1)
Re-engineered Cicode
/*{{WebExclude*/
TimeToStr(DigAlm.Time, 1)
/*}}WebExclude
DigAlm.Time
*/
7.6.3
New argument in ChangeValue function
The ChangeValue function has an additional argument, so that a callback function can
be executed when a user changes a value.
STRING FUNCTION ChangeValue(STRING sTag, STRING sValue,
INT bWriteTag=TRUE, STRING sCallbackFn= " " )
sCallbackFn: This is the name of the callback function which is invoked when
ChangeValue has closed, and only if the value has changed. Only tags with the data
types Boolean, Enum, Integer, Unsigned, Real, String or Nameref are supported.
The function must be passed in the following form:
" FUNCTION Function name(STRING sTag, STRING sNewValue) "
Refer also to the extended function description in the header (comment lines) of the
ChangeValue function, which you can find in the G project in the Cicode module
Misc.ci.
105 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
7.7
New Cicode function: OpenURL
The new Cicode function, OpenURL, (G project, Misc.ci) opens an HTML page for the
URL concerned in the same or a new Internet Explorer window.
OpenURL is used, for example, to open report pages.
Refer to Section 7.9, Starting Web Plant Viewer via URL and Section Fehler!
Verweisquelle konnte nicht gefunden werden., Fehler! Verweisquelle konnte nicht
gefunden werden..
Example:
The Cicode function OpenURL supported in DESIGO WEB can be used in a button to
take the customer to a specific Web page.
The second parameter indicates whether the page is to be displayed in a new Internet
Explorer window (false) or in the same window (true).
Further examples
Opening a specific file (in the same Explorer window; third parameter left blank)
OpenURL( " http://localhost/WebInsight/project/reports/HTMLPag
e1.htm " )
OpenURL( " localhost/WebInsight/project/pv/a & b.svg " )
OpenURL( " localhost/WebInsight/xyz.htm " )
Opening the latest file (first parameter contains wildcards * and ?, third parameter is the
Web project directory).
OpenURL( " localhost/WebInsight/project/reports/HTMLPage?.h
tm " , 0, " localhost /WebInsight " )
OpenURL( " localhost/WebInsight/project/reports/HTML*.htm " ,
0, " localhost/WebInsight " )
OpenURL( " localhost/WebInsight/xyz*.htm " , 0,
" localhost/WebInsight " )
106 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
7.8
CtApi
Cicode functions not supported in Web Plant Viewer (JavaScript) can be executed on a
running Citect PC.
Caution: All functions of this type are always called synchronously, which means that
JavaScript is blocked until the answer is received from the Citect PC.
The following conditions must be fulfilled:
1. Project.config
& lt; CtApi Enabled= " true " CitectNode= " " / & gt; & lt; !-- " CH1W40936 " ,
" 139.16.76.38 " -- & gt;
If the destination Citect PC is not the same as the DI server PC, CitectNode must be
set either to the PC name or to the IP address.
2. Citect.ini on the destination Citect PC
[LICENCE]CtApi must be set to at least 1 (before start-up) in accordance with the
available licenses.
If the destination Citect PC is not the same as the DI server PC, [CTAPI]Remote=1
must also be set.
3. Citect must be running on the destination PC.
4. A free CtApi license must be available on the DI server
Example of an arrangement with several Citect PCs ( " nodes " ):
IE V6.0
Example: Project.config:
....CitectNode=”12.32.12.07”
...
WEB
DI Server
Server
IIS
IP: 12.32.12.07
Citect PC
(node)
Citect
DESIGO WEB
Clients
IE V6.0
[LICENCE]CtApi=1
[CTAPI]Remote=1
107 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
7.8.1
Cicode functions via CtApi
The following Cicode functions can be executed via the CtApi interface.
–
–
–
–
–
–
–
–
–
–
–
Example:
AlarmAck
AlarmDisable
AlarmEnable
AlarmAckByTag
AlarmEnableByTag
CxCicode
IODeviceInfo
IODeviceControl
Report
RepGetControl
RepSetControl
The Cicode function Report() executes a Citect report. Note that the result is always
the same, whether the report is executed on the report server as an event, locally by a
user, or remotely via the CtApi interface.
If Citect is not running on the destination PC, or if no CtApi license is available, the
functions are not executed.
108 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
7.9
Starting Web Plant Viewer via URL
The Web Plant Viewer is started via the page " plant-viewer.aspx " .
Examples:
http://localhost/WebInsight/plant-viewer.aspx
or, more simply:
http://localhost/WebInsight/plant-viewer
Parameters can be specified to invoke plant pages directly, with or without browser and
toolbar displays, or even to invoke super genie pages directly. The parameters are
passed after a " ? " . If several parameters are passed, they are separated by an
ampersand " & " . (Refer to the following examples in the table below).
Application example
An end user wants to be able to open and operate the plant page for their own room via
a desktop shortcut . This user does not need any other plant graphics or user functions,
and therefore does not need to see either the DESIGO WEB toolbar or the browser.
URL parameters
The following URL parameters can be used:
Parameter
Description
page={PageName}
PageName is the name of the page (not the name of a
file!) Automatically opens the specified page directly. If
the page does not exist, the following error message is
displayed: " Cannot open plant page xx " . File " yy " not
found.
page={PageName.xml}
page={PageName.svg}
If no extension is specified, the SVG file is only
generated/renewed if the XML file is more recent than
the SVG file (default response).
If the extension .xml is specified, this enforces the
regeneration of the SVG file whatever the date of the
file.
If the extension .svg is specified, the SVG file is not
regenerated, and the specified SVG is displayed.
If no page is specified, the " Top " page is opened. If
there is no " Top " page (because no pages have been
exported by DIGG), a default page is displayed.
Example:
http://localhost/WebInsight/plantviewer.aspx?page=page1
title={title}
Only used internally, to pass a new title. This parameter
replaces the engineered title of a page.
109 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
hideFrame=true
If hideFrame is set to anything (!) (e.g. true), the
Explorer does not display either the key visual graphic,
or the DESIGO WEB toolbar or the browser. Only the
contents of the plant page are displayed.
Example:
http://localhost/WebInsight/plantviewer.aspx?page=top & hideFrame=irgendoepis
sgFunc={function}
Passes a function with arguments, in order to open a
super genie page directly. If the page parameter is not
set, the " Top " side is opened first.
Example 1: No page parameter specified
http://localhost/WebInsight/plantviewer.aspx?sgFunc=sgWnd( " !Sg1 " , " Tag1 " )
Example 2:
http://localhost/WebInsight/plantviewer.aspx?page=!Sg1 & sgFunc=sgWnd( " !Sg1 " ,
" Tag1 " )
Note that sgFunc only supports super genie functions,
i.e. WinShowPage() must be called somewhere else.
In a URL, certain special characters must be replaced
with other characters, e.g. " & " is replaced with " %26 " .
You can find out the substitute character strings for
special characters via the Debug window.
Example:
Enter the command window.escape( " & " ).
openUrl={host/service/path
/filename}
OpenUrl must start with host/service, followed by the
optional path and file name. The file name may contain
the wildcard characters * and ? The Aspx page then
forwards the reply to the most recent file.
Example: Open and display report pages.
http://localhost/insight/plantviewer.aspx?openUrl=localhost/insight/project/
reports/Report_AHU15_*.htm
110 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
7.10
Language localization of plant graphics
English / German
HQ supplies an installation in English and an installation in German for DESIGO
INSIGHT. The Citect text files for the graphics projects are supplemented by the RC
library experts who add their own text, including a translation. This means that project
engineers do not normally need to translate any text items.
Web DIGG
When converting the graphics, Web DIGG adopts the language selected in Citect (e.g.
via the Language=English parameter in Citect.ini) and generates an XML file in the
..\WebInsight\project\pv directory (_language.xml), containing the translated text for
the graphics.
Changing the
language setting
If necessary, you can change the language in the Web Plant Viewer graphics. However,
this can only be done during offline engineering. The file _language.xml must then be
updated by running the generate process in Web DIGG.
Workflow
To do this:
1.
In the Citect main graphics project translate the text of Language.dbf contained in
the " native " column, entering the translation in the " local " column.
2.
Compile the Citect main project (the Incremental compile setting is adequate).
3.
Start Web DIGG.
4.
Select the check box Only Create Web files, if Corresponding Citect pages are
newer.
5.
Select at least one page and start " Create Web pages " . (If no pages are selected,
all the graphics pages will be updated, which is unnecessary here.)
Resetting language
conventions ( " culture " )
for Web applications
Refer to Section 9.2.1, Setting the language conventions ( " culture " ) for a description of
how to reset the language " culture " or conventions (text, numerical formats, names of
months and days etc.) for the user interfaces of the Web application.
111 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
112 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Importing the DESIGO INSIGHT plant graphics
CM110510en_01
30.01.2007
8
Commissioning DESIGO WEB
The installation of DESIGO WEB, the creation of a Web project and the generation of
the Web graphics pages have all been described in detail above. When you have
completed all these steps, you will need to create user profiles for the DESIGO WEB
users before you can start commissioning. You can set these up on the desktop
management station on which the DESIGO INSIGHT project is installed.
8.1
Setting up DESIGO INSIGHT user profiles
8.1.1
Setting up DESIGO WEB users
Operation via DESIGO WEB (Web access) can be enabled for all DESIGO INSIGHT
users defined in System Configurator. In DESIGO WEB, these users are assigned the
same access rights as in DESIGO INSIGHT, except that the full range of functions is
not available in DESIGO WEB (no engineering or configuration via the Web).
To enable Web access for a user already set up in DESIGO INSIGHT, the procedure is
as follows:
1.
Open System Configurator:
2.
Select the user in the relevant user group. Double-click to open the Properties
dialog box for that user.
3.
Select the check box Enable web access and click OK.
113 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Commissioning DESIGO WEB
CM110510en_01
30.01.2007
Note: Password required
Although users of DESIGO INSIGHT desktop management stations do not necessarily
have a password/may have a blank password, this is not permissible for DESIGO WEB
users.
All DESIGO WEB users are prompted for a password for authentication purposes.
Without it, they cannot log in via the Web. Take care with the use of upper and lower
case letters in user names and passwords. Digest Authentication method requires
considering of upper and lower case letters.
8.1.2
Setting up DESIGO WEB user groups
In DESIGO INSIGHT you must define the access rights of a user in the properties fields
of the associated user groups. You will often find it desirable to impose more restrictions
on DESIGO WEB users in terms of operation than you would on users of the DESIGO
INSIGHT desktop application. In particular, you will want to prevent Web users from
logging into a DESIGO INSIGHT desktop management station with their account and
so obtaining undesirable access to configuration functions, DB Import etc.
To prevent this, it is a good idea to set up separate user groups with the appropriate
profile settings for users who are to have access exclusively via Web clients.
As described in the previous section, a password must be defined and the Web access
check box must be enabled for all users in this Web user group (or groups).
114 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Commissioning DESIGO WEB
CM110510en_01
30.01.2007
Profile settings
In the screenshot above, you will see under the user group Privileges, all the profile
options that are also available in DESIGO WEB are marked [+WEB] on the line
concerned.
The following is an example to illustrate the principles of the profile settings.
The following applies to these settings:
Desktop users
Users for whom the option Enable Web access was not selected can only perform the
functions Acknowledge alarms and Reset alarms on a DESIGO INSIGHT desktop
management station.
DESIGO WEB users
Users of a Web user group, for whom the option Enable Web access was enabled,
can perform the functions Acknowledge alarms and Reset alarms both on a DESIGO
INSIGHT desktop management station and on a DESIGO WEB client.
If you were to select the check box Shut down DESIGO INSIGHT in the Web user
group, this would not make any difference for DESIGO WEB users on a Web client, as
this function is not supported over the Web.
However, it would be possible for any DESIGO WEB user to use their account to log in
directly on a desktop DESIGO INSIGHT, where they would then be able to shut down
DESIGO INSIGHT. Other DESIGO WEB users might not be too pleased about this!
Note:
Create a separate user group for users who will work exclusively with DESIGO WEB
and do not have DESIGO INSIGHT training. Within the user group, only select profile
options which are marked [+WEB].
Work through all the tabs in the Web User Group Properties, and set the required
access options and privileges.
The DESIGO INSIGHT engineers know the meaning of all the other settings in the User
Group Properties, and they are therefore not described in detail here.
(See engineering manual CM110591en, DESIGO INSIGHT Installation and
configuration.)
115 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Commissioning DESIGO WEB
CM110510en_01
30.01.2007
8.2
DESIGO WEB Client
8.2.1
Definition of DESIGO WEB client
Definition of DESIGO
WEB client
A typical Web user is someone who does not have access to a DESIGO INSIGHT
management station, but who nevertheless needs to view the building automation and
control system now and again, and requires access to the main user functions. As an
operator only, this kind of user does not need access to engineering or project
configuration options.
The " tool " which enables this user to perform the necessary tasks is the DESIGO WEB
client.
The DESIGO WEB client enables user functions to be carried out via the
intranet/Internet.
Prerequisite
The DESIGO WEB client is a standard, commercially available PC with intranet/Internet
access and running Microsoft Internet Explorer (IE 6.x).
The minimum hardware and software requirements are listed in Section 4.3.1,
Hardware/software requirements
Notes
Microsoft Internet Explorer (IE 6.x) is the only browser supported.
DO NOT install DESIGO INSIGHT or any other SBT software on a DESIGO WEB
client PC!
8.2.2
Setting up a DESIGO WEB client
End user can
perform setup
Because no SBT-specific software may be installed on a DESIGO WEB client,
customers can set up DESIGO WEB clients themselves if required.
CM110511en
DESIGO WEB
Getting started
DESIGO WEB client users are provided with a small booklet for information and to help
them get started. The " Getting started " booklet contains important information about the
DESIGO WEB user interface and the available user functions.
This documentation is also available online (in PDF format) to logged-in users and can
be opened and read, or printed via a link included in the DESIGO WEB online help.
Adobe Acrobat Reader
Adobe Acrobat Reader is required to display documents in PDF format and read them.
Adobe Acrobat Reader V6.0 is supplied on the DESIGO INSIGHT Installation CD and
can be installed as part of the DESIGO INSIGHT setup or downloaded free of charge
directly from the supplier over the Internet (www.Adobe.com).
116 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Commissioning DESIGO WEB
CM110510en_01
30.01.2007
8.2.3
DESIGO WEB client commissioning workflow
Checking hardware and
software requirements
Start by checking the following requirements:
Prerequisites for
operation
The following criteria must be fulfilled for operation of a DESIGO WEB client:
Internet Explorer
settings
Before starting the DESIGO WEB client for the first time, check the following Internet
Explorer settings;
– Supplier and version of the operating system used on the PC
– Compliance with hardware requirements (RAM, monitor, resolution)
– Quality of network connection (Ethernet adapter, intranet/Internet
connection available)
– Supplier and version of the installed Internet browser
– Installation of Adobe Acrobat Reader
– An existing DESIGO INSIGHT project, already prepared as a DESIGO WEB project,
must be available
– The DESIGO WEB project must already be set up and running on the Web server
– The Web server must be on the network (integrated into the IT environment) The
URL (address) and project name must be known.
– The customer must already belong to a user group on the DESIGO INSIGHT
management station, and be set up, with a password, as a DESIGO WEB user.
A password is mandatory!
– The Web option must be enabled in the DESIGO INSIGHT license, and there must
be enough DESIGO WEB CALs for the required user functions.
1.
2.
3.
4.
Start the Internet Explorer.
Select Tools & gt; Internet Options... & gt; Security.
Select the Web contents zone (e.g. click Local intranet)
Click Custom Level…
5.
Enable Web Service Calls and the SVG plug-in
For Run ActiveX controls marked safe for scripting:
Select Enable.
For Run ActiveX controls and plug-ins:
Select Enable.
Enable the automatic download of the SVG plug-in:
For Download signed ActiveX controls:
Select Enable.
Click OK & gt; OK.
6.
7.
117 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Commissioning DESIGO WEB
CM110510en_01
30.01.2007
8.
9.
To ensure that the login procedure operates correctly, select Tools & gt; Internet
Options & gt; General & gt; Temporary Interne Files & gt; Settings…
For Check for newer versions of stored pages:
Select Automatically.
Click OK & gt; OK.
When all the above criteria are fulfilled, the customer can log in for the first time.
The DESIGO INSIGHT project engineer must provide the customer with the following
information:
– The URL (network address) of the DESIGO WEB project
– The UserName
– The password assigned to that user
1.
2.
Open the Internet Explorer.
Enter the address (URL) of your DESIGO WEB project.
3.
Starting DESIGO WEB
Client
(under the graphic).
Click
The Enter Network Password dialog box opens.
Enter the User Name and Password.
Take care with the user of upper and lower case letters in the user name and
password. (Check that the Caps Lock key is not accidentally on!)
4.
118 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Commissioning DESIGO WEB
CM110510en_01
30.01.2007
5.
Click OK.
The Viewer configured as the default will appear (e.g. Alarm Viewer).
The functions are enabled in accordance with the assigned user rights.
A license for the Web client is allocated.
DESIGO WEB
online help
The DESIGO WEB toolbar is displayed under the Explorer Address field, and by
Adobe SVG Viewer
To display the DESIGO INSIGHT plant graphics in the Web Plant Viewer you also need
the Adobe SVG Viewer plug-in. This ActiveX component allows the display of scalable
vector graphics in Internet Explorer. Without this plug-in Web Plant Viewer only displays
an inactive default page (pv-default-page).
Installing SVG Viewer
automatically
The installation of SVG Viewer plug-in is triggered automatically subject to the
following:
– Web Plant Viewer is opened for the first time.
– The SVG Viewer Plug-in is not already installed.
– The download of signed ActiveX controls is enabled under Internet Options.
clicking
the first-time user can start the DESIGO WEB online help and select the
introductory document, DESIGO WEB, Getting started.
In addition to the information already mentioned, this document contains guidance on
installing the SVG Viewer plug-in, and troubleshooting information if for some reason,
this does not work immediately.
1.
2.
3.
4.
5.
6.
7.
8.
Click the Web Plant Viewer button
.
The Plant Viewer default page appears, with the message " Adobe SVG Viewer is
not installed " .
Select the link " Click here to install " .
The File Download Security Warning dialog box opens
with the message ”Do you want to run or save this file?”
Click Run.
“Do you want to install this software?
Click Run.
This installs the program.
Press & lt; F5 & gt; to refresh the Web Plant Viewer page.
The software license agreement opens.
Click Accept.
The browser containing Web Plant Viewer opens.
119 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Commissioning DESIGO WEB
CM110510en_01
30.01.2007
Installing SVG Viewer
manually
Install the SVG Viewer manually when, for example, the Web project is not yet
complete or the user has not yet been configured.
1.
2.
Copy the file svgview.exe from the Web project directory
../ & lt; WebInsight Project Dir & gt; /plugins/
or download it directly from the supplier, Adobe, to your Web client PC over the
Internet (www.adobe.com).
Double-click the file svgview.exe.
The setup runs directly.
Now, when you open Web Plant Viewer for the first time, you will be prompted to
accept the software license agreement (click Accept).
In the event of a problem, the following alternative method of installation may help:
1.
Save the file svgview.exe on the DESIGO WEB Client PC.
2.
Right-click svgview.exe. Select Properties.
3.
Click Compatibility.
4.
Select Run this program in compatibility mode for:
5.
Select Windows 95.
6.
Click OK.
7.
Double-click the file svgview.exe.
Status check
First-time users are recommended to work through the " Getting started " document in
the online help feature. (It can be printed.) To check that everything is working, it is a
good idea to connect to the plant via the
button, and to start each available user
function once. As already described, the SVG Viewer plug-in is installed when the Web
Plant Viewer function is started for the first time.
Note
Web Trend Viewer can only be used if trend views have already been set up. While the
customer will become familiar with the other user functions quickly and intuitively, Web
Trend Viewer requires a little more basic know-how. The customer can either acquire
this from the " Getting started " document, or where appropriate, the DESIGO INSIGHT
commissioning engineers may provide an introductory session.
8.2.4
Simultaneous access to several DESIGO WEB projects
Simultaneous access is possible from a DESIGO WEB client PC to several DESIGO
WEB projects on different Web servers. For this purpose, users can create one or more
desktop shortcuts to DESIGO WEB (e.g. via IE & gt; File & gt; Send & gt; Shortcut to Desktop),
pointing to different DESIGO WEB projects (e.g. IIPAdrWebServer01/insight and
IPAdrWebServer02/insight).
Caution
Even if several Internet Explorer windows are opened via these shortcuts, there is still
only one instance of Internet Explorer running. (Look at Task Manager & gt; Processes:
iexplore is listed once only).
In this case, simultaneous access to two different Web projects via DESIGO WEB will
not work properly. The problem is that one instance of a browser can only have one
connection to a DESIGO WEB project. The same problem occurs if a second Internet
Explorer window is opened via File & gt; New & gt; Window.
Corrective action
Opening Internet Explorer twice via the Quick Launch toolbar launches two
independent instances of the program (visible in Task Manager) and it is then possible
to connect to two DESIGO WEB projects.
Note
Access to several viewers within the same DESIGO WEB project is not a problem (e.g.
Alarm Viewer, Log Viewer, Plant Viewer can be open simultaneously).
120 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Commissioning DESIGO WEB
CM110510en_01
30.01.2007
9
9.1
Default settings
Project-specific settings
Configuration files
When a Web project is created automatically with the Web Project Creator, the default
values in the configuration files are adapted accordingly. There is therefore no need, in
most cases, to edit these text files in XML format.
The configuration files are divided into sections, with the associated lines of code
containing specific parameters that are important when running the program.
Example from Web.config:
& lt; !--
DESIGO WEB ACTIVATION
The following channel, host and port must be configured when the default
settings aren't feasible:
channel:
formatter for .NET Remoting
host:
name of the host (computer), where the DESIGO INSIGHT is running
port:
port for the .NET Remoting
The channel and port must match the remoting configuration on the
DESIGO INSIGHT side.
-- & gt;
& lt; siemens.desigo.insight.activation & gt;
& lt; urlBase channel= " tcp " host= " ch1w44174 " port= " 11111 " / & gt;
& lt; /siemens.desigo.insight.activation & gt;
Each section is preceded by comments describing the functions of the parameters in
more detail. Comments in XML documents are placed between a start tag, & lt; !--, and the
associated end tag: -- & gt; . The lines of code are also placed between start & lt; ....xyz & gt; and
end tags & lt; /...xyz & gt; .
In the example above, the & lt; !-- section comment -- & gt; gives information about the
parameter values " channel " , " host " and " port " . In the code lines which follow, values are
assigned to these parameters (e.g. " channel=tcp " etc.)
Note
If necessary, plant engineers can modify parameter values in the configuration files. No
other changes are permissible.
(Example: Change the " host " parameter value from host=ch1w44174 to
host=chzugw0745.)
The main possibilities for modifying the values in the Web.config and Project.config files
are discussed in detail below.
121 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Project-specific settings
CM110510en_01
30.01.2007
9.2
Web.config
The configuration file Web.config is located directly in the main directory of the Web
project that has been set up: & lt; WebInsight Project Dir & gt; \Web.config.
If the Web project was generated automatically with Web Project Creator, then there is
normally no need to modify the file.
If the Web project was created manually, both the DESIGO INSIGHT project name and
workstation on which the project is located must be specified after extracting the files
from the WebInsight.zip file.
See also 6.4, Creating a Web project manually under Modifying the configuration files.
9.2.1
Setting the language conventions ( " culture " )
The Web.config file contains a Culture Info key, which is used to set the required
language conventions on the user interfaces of the Web applications.
& lt; !-- Culture info -- & gt;
& lt; add key=“cultureInfo“ value=“de-CH“/ & gt;
The value, (de-CH in the example above), affects not only the language of the text
items, but also the formatting of dates and values (e.g. the use of " . " or " , " in real
values), calendars, the names of the months and days etc.
Any Culture Info values are admissible if they are supported by .NET Framework.
Library experts in the Divisional Units can find the necessary information via
http://msdn.microsoft.com/library. In the msdn library, look for CultureInfo Class (.NET
Framework).
The valid Culture Names are listed in a table. For example, the following are values for
some of the English-speaking countries listed:
de-AT
de-DE
de-LI
de-LU
de-CH
0x0C07
0x0407
0x1407
0x1007
0x0807
German - Austria
German - Germany
German - Liechtenstein
German - Luxembourg
German - Switzerland
You should be aware of the following points in relation to the " Culture " setting:
1.
2.
3.
4.
If there is no entry found in Web.config, the operating-system culture settings
apply.
A neutral culture setting is not permitted. For example " en " throws an exception,
but en-US is supported.
If the selected culture information is not the same as that of the installed operating
system, the following may occur:
If the operating system and DESIGO WEB are set to German, but the culture
setting is it-IT, then the system looks for, but cannot find, the Italian language
(DLLs). The application then reverts to the default culture settings and the text
appears in English instead of Italian.
For the application described under point 3 above, several languages can be
installed simultaneously. To do this, copy the language-dependent resource DLLs
into the relevant directories (e.g. ...\webInsight\bin\de und ...\webInsight\bin\it).
You can then switch between one language (culture) and another via the
Web.config file.
122 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Project-specific settings
CM110510en_01
30.01.2007
5.
6.
Tip
Every change made in the Web.config file automatically causes the Web
application to restart, and the session information is lost. (Close and restart the
browser.)
Text from the subsystem or from the DESIGO INSIGHT server is not affected by a
change in the culture settings.
To help with translation, you can run two or more Web projects with different language
settings on the Web server at the same time.
123 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Project-specific settings
CM110510en_01
30.01.2007
9.3
Project.config
The configuration file Project.config is located in the Web project directory under
& lt; WebInsight Project Dir & gt; \project\Project.config.
If you need to change anything, open the XML text file with a text editor such as
WordPad or NotePad.
The XML text document is divided up as follows:
9.3.1
Project-specific and custom settings
The file starts with a general section, containing the project name, product name,
company logo and URL, and parameters defining the size of the browser pane and the
opening view.
& lt; ?xml version= " 1.0 " encoding= " utf-8 " ? & gt;
& lt; Project Name= " CityBank " / & gt;
& lt; Product Name= " DESIGO INSIGHT " Version= " V3 " / & gt;
& lt; Company LogoUrl=http://www.siemens.com
LinkText= " http://www.sbt.siemens.com "
LinkUrl= " http://www.sbt.siemens.com " / & gt;
& lt; BrowserPane Small= " 300 " Medium= " 400 " Large= " 500 " / & gt;
& lt; !-- in pixel -- & gt;
& lt; Default Viewer= " alarm-viewer.aspx " Designation= " Technical " / & gt;
& lt; !-- Use Technical, System or User -- & gt;
Default values are displayed as „fat“ characters, line comments in
& lt; ! -- comment text -- & gt; brackets.
& lt; Project Name ../ & gt;
& lt; Product Name ../ & gt;
You do not have any choice with the first two parameters: they must match the DESIGO
INSIGHT project name and installed product version defined in Project Utility (e.g.
" CityBank " , " DESIGO INSIGHT " , " V3.0 " )
& lt; Company LogoUrl ../ & gt;
In this line, the following default links in the DESIGO WEB toolbar can be adapted for a
given project.
Key visual
Company Logo (URL)
Link (URL)
Company LogoUrl=http://www.siemens.com
If you want to show the customer's company name here, you must replace the
company-logo.gif (200 x 54 pixels) in the & lt; WebInsight Project Dir & gt; \images\... folder with
the customer's own .gif file. After the company name, you can replace the URL (Internet
address) with that of the customer's Web page.
LinkText= " http://www.sbt.siemens.com "
LinkUrl= " http://www.sbt.siemens.com "
With these two parameter values you can modify both the text of the Web link (shown
on the right in the DESIGO WEB toolbar) and the stored link URL (the visible text and
the stored URL do not need to be the same!)
124 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Project-specific settings
CM110510en_01
30.01.2007
Key visual.jpg
If you also want to replace the small graphic at the extreme left of the toolbar, you must
replace the key-visual.gif (144 x 90 pixels) under WebInsight Project Dir & gt; \images\...
with one supplied by the customer.
Important
The size of any custom graphics is adapted automatically, but the aspect ratio (width to
height) must be the same as the original graphics they are replacing.
Browser width
The next line gives the default settings for the width of the displayed browser pane (can
be changed by the user via the toolbar)
& lt; BrowserPane Small= " 300 " Medium= " 400 " Large= " 500 " / & gt;
& lt; !-- in pixel -- & gt;
You can make the three width options wider or narrower (also in pixels).
& lt; Default Viewer ../ & gt;
By default, the Alarm Viewer is always displayed when the user logs in successfully.
This setting can be modified here.
Example:
Default Viewer= " log-viewer.aspx "
All user functions are embedded in their own *.aspx " Active Server Page " . Another
example:
Default Viewer= " plant-viewer.aspx "
& lt; Designation ../ & gt;
The default designation type can be defined here. For possible values for the technical,
system or user designations
see the & lt; !—line comment -- & gt; .
9.3.2
Configuring the user functions
In addition to the general project-specific and custom settings in project.config, the
following user functions:
– Web Report Viewer
– Web Plant Viewer
– Web Alarm Viewer
– Web Log Viewer
– Web Trend Viewer
– Web Object Viewer
each have their own section in the file for custom settings of the viewer properties
(layout, length of lists, column width, order of columns etc.). The sections are defined
with start and end tags.
The examples below show possible modifications of the user functions.
Object Viewer
& lt; ObjectViewer & gt;
& lt; Polling Rate= " 5 " / & gt;
& lt; /ObjectViewer & gt;
& lt; !-- Polling rate in seconds. The minimum rate is 5s -- & gt;
As the line comment indicates, the polling rate of Web Object Viewer can only be made
slower (intervals greater than 5 s).
125 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Project-specific settings
CM110510en_01
30.01.2007
Plant Viewer
& lt; PlantViewer & gt;
& lt; PvPolling Rate= " 4 " / & gt;
& lt; !-- Rate in seconds without units, e.g. " 4 " -- & gt;
& lt; CtApi Enabled= " true " CitectNode= " " / & gt;
& lt; !-- " CH1W40936 " , " 139.16.76.38 " -- & gt;
& lt; Zoom ShrinkToFit= " false " GrowToFit= " false " / & gt;
& lt; RenderingQuality SmoothText= " false " SmoothShapes= " false " SmoothImages= " true " / & gt;
& lt; DiskTagMapping PhysicalDiskTags= " false " / & gt;
& lt; Startup DebugMode= " true " / & gt;
& lt; /PlantViewer & gt;
As a general rule, the Plant Viewer parameters should only be adjusted by experts.
Note
If Disk Tags are used for third-party Citect integration, the parameter
& lt; DiskTagMapping PhysicalDiskTags= " true " / & gt; must be set. This is the only way to
synchronize the values of the tags on all clients.
Web Alarm Viewer
This example from Alarm Viewer shows how the columns can be rearranged to suit
customer requirements.
& lt; AlarmViewer SortColumn= " TO_ALARM_TIME " SortOrder= " Desc " & gt;
& lt; Polling Rate= " 30 " Unit= " sec " / & gt;
In this section you can choose to sort the alarms chronologically in descending or
ascending (=Asc) order and set the alarm polling rate.
& lt; PageSizeChoice DefaultSize= " 25 " & gt;
& lt; PageSizeEntry Value= " 10 " / & gt; & lt; !-- in entries -- & gt;
& lt; PageSizeEntry Value= " 25 " / & gt; & lt; !-- in entries -- & gt;
& lt; PageSizeEntry Value= " 50 " / & gt; & lt; !-- in entries -- & gt;
& lt; PageSizeEntry Value= " 100 " / & gt; & lt; !-- in entries -- & gt;
& lt; /PageSizeChoice & gt;
These values let you set the number of alarm entries per page, for selection from the
list box. & lt; PageSizeChoice DefaultSize= " 25 " & gt; defines the default when Alarm Viewer is
started. This value must correspond to one of the entries in the list box!
In the & lt; Columns & gt; section, you can modify the following settings:
– Display or hide columns
You can do this by strategically adding or removing & lt; !-- line comment -- & gt; characters
( " commenting-out " , see the example below).
– Change the order of columns
This is done by rearranging the column lines. The column in the first line is shown on
the extreme left, and the column in the last line on the extreme right.
– Change the column width
If you need to change the column width settings to accommodate or translate the
text in a column, you can do so by modifying the " Width= " parameter. (Setting in
pixels).
& lt; Columns & gt;
& lt; Column ColId= " STATUS " Width= " 120 " / & gt;
& lt; Column ColId= " TO_ALARM_TIME " Width= " 110 " / & gt; & lt; !-- in px -- & gt;
& lt; Column ColId= " PRIORITY " Width= " 50 " / & gt; & lt; !-- in px -- & gt;
& lt; Column ColId= " TECH_DESIG " Width= " 165 " / & gt; & lt; !-- in px -- & gt;
& lt; Column ColId= " TECH_DESCR " Width= " 160 " / & gt; & lt; !-- in px -- & gt;
& lt; !-- & lt; Column ColId= " SYS_DESCR " Width= " 0 " / & gt; -- & gt; & lt; !-- in px -- & gt;
& lt; !-- & lt; Column ColId= " USER_DESIG " Width= " 0 " / & gt; -- & gt; & lt; !-- in px -- & gt;
& lt; Column ColId= " MESSAGE " Width= " 150 " / & gt; & lt; !-- in px -- & gt;
& lt; !-- & lt; Column ColId= " ALARM_VALUE " Width= " 0 " / & gt; -- & gt; & lt; !-- in px -- & gt;
126 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Project-specific settings
CM110510en_01
30.01.2007
& lt; !-- & lt; Column ColId= " ALARM_LIMIT " Width= " 0 " / & gt; -- & gt; & lt; !-- in px -- & gt;
& lt; Column ColId= " USER_NAME " Width= " 60 " / & gt; & lt; !-- in px -- & gt;
& lt; Column ColId= " USER_VISA " Width= " 33 " / & gt; & lt; !-- in px -- & gt;
& lt; Column ColId= " VAL_LAST_EVT " Width= " 65 " / & gt; & lt; !-- in px -- & gt;
& lt; /Columns & gt;
... Viewer
The other user functions can be modified in the same way. In general, the default
values set by HQ should not need to be changed except in special cases (e.g. with
an unusual screen resolution).
127 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Project-specific settings
CM110510en_01
30.01.2007
128 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Project-specific settings
CM110510en_01
30.01.2007
10
FAQs (Frequently asked questions)
1.
Can DESIGO INSIGHT also run on a separate PC (i.e. not the Web server,
IIS)?
Yes, but the DESIGO WEB project must be installed on the Web server.
Refer to " Design constraints " in Section 2.2.1.
2.
For a DESIGO WEB project, is it better to install DESIGO INSIGHT to operate
as a service, or interactively as a stand-alone desktop management station?
The better solution is to install DESIGO INSIGHT as a service, as its availability
for DESIGO WEB should not depend on the actions of interactive users.
(The DESIGO INSIGHT server service can be configured to start automatically in
the event of a fault – or when the workstation is rebooted.)
Refer to Section 2.1.2, Interactive mode and DESIGO INSIGHT as a service.
3.
In what circumstances should I consider a separate workstation for the
DESIGO WEB application (e.g. a DESIGO INSIGHT workstation used
exclusively for DESIGO WEB)?
The determining factors are the required performance and the importance of the
availability of the Web server and plant data.
Refer to " Single-user solution " in Section 4.2.
4.
What is the maximum number of data points on a Web Plant Viewer page?
The recommended maximum is 80 data points per page. (The tested maximum is
200 data points per page.)
5.
Which Internet browsers can I use for DESIGO WEB?
MS Internet Explorer V6.0 (DESIGO WEB does NOT support other browsers).
6.
Can I use specific PDAs, tablet PCs or touch screen panels for
DESIGO WEB?
PDAs are not supported. The user interface strategy is not appropriate for PDAs
(SVG Viewer cannot run on a PDAs).
Tablet PCs/Touch screen panels: This depends on the IE version, the operating
system (Windows XP/2000
SVG Viewer) and the screen resolution of the
devices concerned.
7.
How does licensing work with DESIGO WEB?
The DESIGO WEB application is based on CALs (Client Access Licenses). Each
login procedure requires a CAL. If you log in several times with the same user
name, a CAL is obtained on each occasion. These " DESIGO WEB Operation
CALs " must not be confused with the Microsoft Terminal Services CALs.
Refer to Section 2.5.1, DESIGO WEB Licensing model.
8.
Is a Plant Viewer license required for DESIGO WEB?
No, this is not generally necessary for the runtime Web Plant Viewer.
However, a Plant Viewer license is needed in exceptional cases, namely with
UNIGYR integration or third-party Citect integration. In these cases the Citect
application needs to be started.
You may also require an engineering license if you (or the customer) need to do
engineering on the DESIGO INSIGHT workstation.
9.
Once a license has been obtained, is it released if the Web session
times out?
Refer to " Obtaining licenses " in Section 2.5.1.
129 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
FAQs (Frequently asked questions)
CM110510en_01
30.01.2007
10.
What happens if the Web server or DESIGO INSIGHT management station is
restarted while Web clients are in operation?
If the Web server (IIS, ASP.NET) is restarted: the user will notice some delay in
the display of the next page (this applies only to the first user, and until the
ASP.NET application has restarted). IE and IIS can handle these restarts without
difficulty.
If the Web server cannot be accessed, the Web clients display the following IE
message: " The page cannot be displayed " (in the case of a problem with the
network connection or if the Web server is not running).
If DESIGO INSIGHT is restarted: the message " Server not available " is displayed
(from the Web application). The user must log in again and restart the application
as soon as DESIGO INSIGHT is available again.
11.
With DESIGO WEB, does Plant Viewer have to run all the time?
No, only in certain cases.
Refer to Question 8.
12.
Is the subsystem communication connection shared, or does each Web
client require a separate connection?
There is a shared connection, but individual users can connect to and disconnect
from a site if they have the required privileges. Users share connections.
13.
What happens when the subscriptions run out in the NCRS?
No further values are displayed.
#COM is displayed temporarily.
14.
Do the communications have to be certified?
DESIGO WEB with HTTP does not require certification. If you want to use HTTPS
(S = " Secure " ), you do need a certificate.
Note: HTTPS is not normally necessary in an intranet.
15.
Which ports have to be open for operation of DESIGO WEB?
Refer to " Port settings " in Section 2.3.
16.
How can we convince customers that installing our Web application will not
affect the security of their Web server?
Instead of domain users, we set up our own DESIGO INSIGHT users. The ports
that have to be open for operation are documented, and can be made known to
the customer / customer's IT specialists.
We offer alternative solutions with Terminal Server or desktop applications.
Security can be enhanced by using other network installations (VLAN or a
separate LAN).
Consult your IT department for detailed information.
17.
What security settings are required on the Web server (and between
DESIGO INSIGHT and the Web server)?
The engineer must have Administrator rights on the Web server, in order to set up
and configure a DESIGO WEB project. DESIGO WEB users are verified and
approved using " Digest Authentication " , a standard Internet protocol
authentication method.
Refer to Section 2.4, Access protection, and to " Port settings " in Section 2.3.
18.
Does DESIGO WEB work with DCOM?
Not the actual Web part. The license server works with DCOM. The DESIGO
INSIGHT setup program carries out the required configuration settings.
130 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
FAQs (Frequently asked questions)
CM110510en_01
30.01.2007
19.
What security settings are required for the browser?
Refer to Section 8.2.3, Commissioning DESIGO WEB Client.
20.
How are RC-specific genies and Cicode files handled?
In the same way as HQ genies. Web DIGG converts them into an XML format for
Web Plant Viewer. Cicode is converted into JavaScript. If it cannot translate
something automatically, DIGG displays an error message.
Expert knowledge is required to correct these errors. Commissioning engineers
should generate only plant graphics pages. The standard super genie graphics
pages are generated in advance by the library experts in the regional companies,
and delivered as part of a country-specific default Web project (*.zip file).
See " What if you have your own Web project? " in Section 6.3.4
21.
How does DESIGO WEB have to be configured (to operate like QAX61)
for room management?
The Web Plant Viewer can be configured to open only a specific page (without a
toolbar) on start-up. Note, however, that users must be members of a DESIGO
INSIGHT user group, and must have access rights for DESIGO WEB and the
page concerned.
Refer to Section 7.9 , Starting Web Plant Viewer via URL.
22.
What is the maximum number of users that can be configured?
The limit is determined by DESIGO INSIGHT and the subsystems.
100 users in total.
23.
On what technologies is DESIGO WEB based?
.NET, ASP.NET, .NET Remoting: run together with Windows and IIS
Refer to the training literature.
24.
Can I use an Apache Web server under Linux for DESIGO WEB?
NO!
25.
Can DESIGO WEB still work if the DESIGO WEB site is maintained by a
third-party service provider (IP)? What additional information is needed?
The external providers must permit/support the use of Microsoft .NET technology
on their Web servers. The DESIGO WEB project running on an external server
must be able to establish a connection to DESIGO INSIGHT.
Refer to " Port settings " in Section 2.3.
Note: The main focus of DESIGO WEB is on intranet applications.
26.
What is the minimum bandwidth required for a DESIGO WEB Internet
application?
The effective communications speed (upstream and downstream) for data transfer
(upstream and downstream) between the Web server and a DESIGO WEB client
must be & gt; = 500 kbps.
Refer to Section 4.4, Communication requirements.
Note: The main focus of DESIGO WEB is on intranet applications.
131 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
FAQs (Frequently asked questions)
CM110510en_01
30.01.2007
27.
Is there any point in using a multiprocessor PC? What is the recommended
hardware configuration for a " good " server?
The Siemens Profibus driver is (currently) not compatible with multiprocessor
PCs. (This means that projects involving UNIGYR integration cannot be
supported.) So far, we have not found (quantifiable) evidence of any significant
advantages in terms of performance with multiprocessor PCs.
For hardware recommendations, refer to Section 4.3.
28.
Which edition of Windows 2003 Server should I use? Are there limitations
associated with Windows Small Business Server?
We recommend Windows 2003 Standard Edition.
More details available at
http://www.microsoft.com/windowsserver2003/evaluation/features/compareedition
s.mspx
Small Business Server:
http://www.microsoft.com/windowsserver2003/sbs/default.mspx
29.
Can the Windows 2003 server with DESIGO INSIGHT installed be set up as a
domain controller?
A Windows 2003 server can be configured as a domain controller.
A Change Request has been opened in relation to the question of installing
DESIGO INSIGHT on a domain controller (solution and description in progress).
30.
How much of a delay can be expected when refreshing data points or
performing write operations?
Typical for refresh times: By default, there is an additional delay of 0…5 s in
Web Object Viewer and Web Plant Viewer.
Typical for write operations: By default, there is an additional delay of 0…7 s in
Web Object Viewer and Web Plant Viewer.
The default refresh time in Web Alarm Viewer is 30 seconds.
31.
What color-depth setting is required for the engineering of Web graphics?
No change from DESIGO INSIGHT V2.3! The Web graphics are not engineered.
They are generated with DIGG from the existing Citect graphics pages. Web
graphics do support True Color, but Version 5.X Citect graphics have a depth of
only 256 colors.
32.
What is the optimum screen resolution on a Web client?
1280x1024 pixels
33.
Where can I obtain documentation or help with IIS configuration and
troubleshooting?
Refer to Section 5.3, Installing Web server (IIS). For IIS help, consult the IIS
manual or Microsoft home page.
34.
What is the method used to authenticate a Web user? How does it work?
The " Digest Authentication " method is used between IE (the Web client) and IIS
(the Web server). On the Web server, the information is forwarded to the Web
application. The Web application then uses the existing DESIGO INSIGHT access
protection mechanisms.
Refer to also Question 17.
132 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
FAQs (Frequently asked questions)
CM110510en_01
30.01.2007
35.
Can the Web pages be saved in any directory? Even via a UNC path?
Web pages can be saved in any directory, but UNC paths are not supported.
Note: If the Web pages are not stored locally (on the Web server), this can limit
performance as it then depends on the network bandwidth.
36.
Does DESIGO WEB support NITEL and UNIGYR time schedules?
No!
37.
Can I add Web pages to my Favorites?
Yes.
38.
Can Web clients be logged in automatically?
No, this is not supported, but you can choose to save and " remember " the user
name and associated password in the log-in dialog box.
39.
Is it possible to replace/modify the logo and hyperlink at the top of the
Web page?
Yes.
Refer to Section 9.3.1, under Project-specific and custom settings.
40.
Is Windows XP on a Web server powerful enough to handle 3 or 4 Web
clients with a large amount of data traffic?
Performance depends on a number of factors, e.g. whether or not DESIGO
INSIGHT is also running on the Web server. With a single-user solution,
MSDE/SQL Server and IE would also be running at the same time. Other
potentially limiting factors are the hardware resources of the PC (RAM) and the
CPU clock frequency.
Refer to Section 4.2.2, Single-user solution, and Sections 4.3 and 4.4.
Refer also to Section 4.5 of the DESIGO WEB user manual (CM110511en),
System load and online trends.
41.
What is the maximum number of Web clients allowable with the Web server
running on dedicated server hardware installed with Windows 2003 Server?
50 DESIGO WEB clients are verified and enabled. On a Server operating system,
IIS supports an unlimited number of connections – the specified limit is
determined by DESIGO INSIGHT.
42.
What is the cause of performance " bottlenecks " ? – DESIGO INSIGHT or the
Web application?
Impossible to separate. The network bandwidth could also be a " bottleneck " .
43.
What version of the .NET Framework is supported?
V1.1.4322
44.
If the .NET configuration is modified by another application (via the Control
Panel), will this affect DESIGO WEB? What do I need to check?
It depends on the actual modification. In any case, no changes are made to the
Microsoft default settings for DESIGO INSIGHT.
45.
Should Hyper-Threading be enabled or not?
The general recommendation is to switch it off.
There are known problems with the current Siemens Profibus driver.
(UNIGYR integration! Refer to also Question 27)
Not tested, so there may be other problems.
133 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
FAQs (Frequently asked questions)
CM110510en_01
30.01.2007
46.
Does DESIGO WEB create an additional load on the SQL server? Is MSDE
powerful enough, or do I need SQL Server Edition?
Yes, it does create an additional load on the database server. The effects will be
clarified in due course. The main MSDE/SQL criteria are the same as for DESIGO
INSIGHT V2.3 (max. number of users, frequency of events, load caused by user
functions such as trend logging etc.).
47.
Can an alarm event – or an e-mail – be forwarded if the Web application
stops working?
No. The Web application does not support this mechanism. In the event of a
" crash " , IIS automatically restarts the Web application.
48.
How can I set up a redundant Web server?
This is not currently recommended.
49.
What is the typical running time (operation) of a Web Viewer (how long are
the Viewer applications required to provide stable operation / what about
memory used by IE)?
Typical running times are between 4 and 8 hours.
134 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
FAQs (Frequently asked questions)
CM110510en_01
30.01.2007
Index
Interactive mode........................................................17
.
.NET Framework versions ........................................ 46
.NET Remoting ......................................................... 25
A
Access protection...................................................... 28
Adding ports .............................................................. 27
Architecture......................................................... 15, 21
ASP.NET version....................................................... 73
B
Basic license ............................................................. 29
Basic Web components ............................................ 53
C
CicodeMappingTable.txt............................................ 93
Creating or modifying a page description ................. 84
CtApi ....................................................................... 108
D
Debug Window.......................................................... 88
Default.aspx .............................................................. 69
DESIGO Connect...................................................... 52
DESIGO INSIGHT Integration Interface ................... 52
DESIGO WEB Operation CALs ................................ 29
Digest Authentication ................................................ 28
Directory structure..................................................... 70
Directory_Export_ ..................................................... 70
E
Engineering and operating documents ....................... 7
Engineering of user functions ..................................... 7
Expert knowledge ..................................................... 90
F
Firewall...................................................................... 24
G
Graphics engineering.................................................. 7
H
hideFrame............................................................... 110
HTTP......................................................................... 25
I
IIS.............................................................................. 47
IIS compression ........................................................ 43
IIS Operator Console ................................................ 47
IIS V5.1 ..................................................................... 48
IIS V6.0 ..................................................................... 50
Installation and configuration ...................................... 7
L
Licensing model ........................................................29
Limits .........................................................................40
localhost ....................................................................61
M
Main components ......................................................38
Multi-user license ......................................................30
N
NETWORK SERVICE ...............................................70
O
Obtaining licenses .....................................................29
OpenURL ................................................................106
P
Page Properties ........................................................96
Plant graphics ...........................................................79
plant-viewer.aspx ....................................................109
Ports ..........................................................................25
Project.config ............................................................72
R
Report messages ......................................................86
S
Script Engine .............................................................98
Service mode ............................................................18
Single user solution ...................................................38
SOAP ........................................................................25
SQL Net.....................................................................25
Super genie pages ....................................................79
System limits ...............................................................7
T
Trace Window ...........................................................88
Transfer rate..............................................................41
Trend Data Export .....................................................70
U
Update channels .......................................................40
URL Parameter .......................................................109
User's guide ................................................................7
V
Virus protection program ...........................................24
W
Web core technologies..............................................10
135 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Index
CM110510en_01
30.01.2007
Web DIGG .................................................................77
Web Project Creator..................................................55
Web Server ...............................................................47
Web.config ................................................................72
WebExclude ............................................................. 91
WebInclude............................................................... 91
WebInsight.zip .......................................................... 55
Wildcards.................................................................. 91
136/138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
Index
CM110510en_01
30.01.2007
137 / 138
Siemens
Building Technologies
Principles, setup and installation, V3.0
CM110510en_01
30.01.2007
Siemens Switzerland Ltd.
Building Technologies Group
International Headquarters
Gubelstrasse 22
CH-6301 Zug
Tel. +41 41-724 24 24
Fax +41 41-724 35 22
www.siemens.com/sbt
© 2005-2007 Siemens Switzerland Ltd.
Subject to change
138 / 138
Siemens
Building Technologies
DESIGO WEB, Principles, setup and installation, V3.0
CM110510en_01
30.01.2007