HTTP Server Requirements and Installation

Requirements

WinCC OA base installation
A valid HTTP Server license (required for both components)
An HTTP browser (for example, Internet Explorer or Firefox).
Network with TCP/IP communication.
For the HTTPS (SSL) connection certificates are required. Create certificates via the Certificate authority (see Create a Certificate with a Certificate Authority) or create self-signed certificates (see Create a self-signed Certificate).

Note: The root certificate (CA) must be imported to a browser so that it is added to the trusted Certification Authorities and not blocked by the browser - see chapter Root Certificate & the Trusted Certification Authorities for Browsers.

CAUTION: The privkey.pem-file under Linux must only be readable by the user running the CTRL HTTP server.

The confg entries ip_allow and ip_deny must be used to set a list of allowed and restricted IP addresses for the Server access.

Note:

The behavior of the HTTP Server regarding connection management is different depending on the client HTTP/1.0 or HTTP/1.1.

A 1.0 client expects a connection being closed unless it stated otherwise, a 1.1 client expects a connection being kept open unless stated otherwise.

Note:

A slow response from the DNS server might cause delays and an unresponsive WebServer. If the DNS response is slow, a warning is shown indicating that the DNS response is unusually slow and that you should check the network settings.

Under Linux, you can reduce the maximum DNS translation wait time by setting the following parameters:

options timeout:1

options attempts:1

in /etc/resolv.conf file.

See the man page for the resolv.conf file for more information.

Installation of the HTTP Server

Configure the following settings before starting a project to ensure that the HTTP Server works correctly:

Install the WinCC OA base package.
Start a CTRL Manager with the rs_http.ctl script:

WCCOActrl rs_http.ctl

Copy the file config.http from the directory <wincc_oa_path>/config to<proj_path>/config.
In a browser, enter the name of the computer on which the HTTP Server is running (host name) or its TCP-IP address (for example, http://193.81.17.83). If the HTTP Server is installed on the local machine, enter http://localhost in the browser window.

Note that the Desktop UI and the HTTP Server package can not be run over the same port at the same time.

Next, the login prompt will automatically be displayed. There are three ways of logging in to the HTTP Server depending on the settings in the base configuration config.http:

Login as WinCC OA user. User name and password are the same as for WinCC OA login (User: root, PW: empty (no password) (see also HTTP base configuration, entry httpLogin).
Login by entering an access code (see also HTTP base configuration, entry httpLogin and httpAccessCode).
Access without login (see also HTTP base configuration, entry httpLogin).

Note:

Note that a stepwise delay ( steps: 1, 2, 4, 8, 16, 32 and 60 seconds) is implemented when an invalid login is attempted. See also httpSetSecondaryAuthSuccess() and httpConnect() for more information.

CAUTION:

To use the (default) port 80 (or 443 for HTTPS) under Linux, the CTRL Manager (HTTP Server)must be started as root (other users must not open a port <= 1024). Specify a port number > 1024 in the 'httpServerPort' entry of the 'config.http' file, if another port should be used.

The main HTTP Server directories are <proj_path>/data/http and <proj_path>/pictures/http. Save your HTML pages in the language directories under <proj_path>/data/http/<lang> and <proj_path>/data/http/<lang>/refs and your own images in <proj_path>/pictures/http. (see also Working with standard WinCC OA HTML pages).

The necessary directory structure will be created when you start the projects. The folders are created in the directory <proj_path>/data/http. By default, a multi-language project supports English 'en' and German 'de'. The standard pages are located in these directories and are available for immediate use.

For the use of Proxy/NoProxy settings see HTTP base configuration

As usual on the web, there is no difference between en_US and en_GB. One page is available for both English options. Also only one page exists for de_AT and de_DE in German.

Note:

The language of the standard WinCC OA HTML pages cannot be changed directly in the address bar of the browser. To change the language, use the language selection button at the bottom of an HTML page.

Other languages are available, but the pages must be translated.

The following 30 languages are available:


Abbreviation	Language
de	German
en	English
hu	Hungarian
jp	Japanese, ext. UNIX code
zh	Chinese
nl	Dutch
tr	Turkish
it	Italian
fr	French
es	Spanish
el	Greek
iw	Hebrew
da	Danish
fi	Finnish
no	Norwegian
pt	Portuguese
sv	Swedish
is	Icelandic
cs	Czech
pl	Polish
ro	Rumanian
hr	Croatian
sk	Slovenian
ru	Russian
bg	Bulgarian
ar	Arabic
ko	Korean
ja	Japanese, shift JIS encodg
th	Thai