Requirements and Installation

Requirements

  1. WinCC OA and the Add-on package SmartSCADA (SmartSCADA_3.20)
  2. A valid license for SmartSCADA. The following license options are available for SmartSCADA: smartscada_kpi >= 1, smartscada_analyt = Expiration date of the package (YYYYMMDD) e.g. 20171031. See chapter WinCC OA License Options
  3. Windows or Linux 64bit.
Note:
If a project that contains sub projects is updated, the suffix of the sub projects in the config file must be adapted or the current sub projects must be selected via the project administration. E.g. SmartSCADA_3.15 -> SmartSCADA_3.20.

R Software Version well as further R packages. For information on the supported R version, see chapter Software requirements.

Installation

In the following the installation of SmartSCADA is described. Some of the installation steps are only necessary under Windows and others only under Linux. These steps contain a reference to the respective platform. All other installation steps are valid for both platforms. To install Smart SCADA, proceed as follows:

R Installation

Note:
Note that R is not part of the WinCC OA installation but an external component. ETM is not liable for the accuracy of the information contained on the home page or for any loss, cost, claim, damage, demand or expense resulting from the use of R.
CAUTION:
Note that the R packages can have dependencies. Make sure that your Internet connection is working when you install the R packages.
CAUTION:
On 64bit operating systems, only install the 64bit R version!
Note:
The recommended installation directory for R under Windows is: C:\R\R- or D:\R\R-. Do not use the suggested path inside c:\program files. Thus, the additional necessary installation packages of R are easier to install.
  1. In order to use SmartSCADA, the installation of R is necessary: Install the R version 4.5.1.: https://cran.r-project.org/bin/windows/base/ (Windows) or https://cran.r-project.org/bin/linux/ (Linux) as an administrator.
    Figure 1. R Installation
    • Install the "Core files", the 64 bit files as well as Message translations:
    Figure 2. R Installation - Select components
  2. Furthermore, open the RGUI and install the R packages. Select the mirror "0-Cloud [https]". Execute the following commands in the R console: 
    install.packages("RInside")
install.packages("Rcpp")
install.packages("forecast")
install.packages("randomForest")
install.packages("skmeans")
install.packages("tseries")
install.packages("xts")
install.packages("binhf")
install.packages("TSA")
    >
    Figure 3. R program in the start menu
    Figure 4. R Console
  3. After installing R and the packages, set the system variables listed below (MyComputer > Properties > Advanced System Settings > Environment variables button ):

Environment variables Under Windows:

Figure 5. MyComputer -> Properties -> Advanced System Settings -> Environment variables

R_HOME ... to the R installation directory:

R_LIBS_USER ... to the R extension packages Rcpp and RInside:

Additionally set the Windows path to:

%R_HOME%\bin\x64
%R_LIBS_USER%\RInside\libs\x64

To reload the environment variables, stop the project and restart it.

Environment variables under Linux

Set an entry within the /etc/ld.so.conf to the RInside Lib package.
Note:
For how to add the path variable under Oracle 9, see chapter R Installation under Red Hat Enterprise Linux / Oracle Linux.

To reload the environment variables, stop the project and restart it.

Main Project integration into your project

  1. Install WinCC OA Version 3.20, for the installation see chapter Installation under Windows or Installation under Linux.

  2. Install the SmartSCADA package

    via R Shell:

    install.packages("wincc_oa_path/SmartSCADA_3.20/data/SmartSCADA/smartscada_1.2.tar.gz", repos = NULL, type="source", INSTALL_opts="--no-multiarch")

    e.g. install.packages("C:/Siemens/Automation/WinCC_OA/3.20/SmartSCADA_3.20/data/SmartSCADA/smartscada_1.2.tar.gz",repos = NULL, type="source", INSTALL_opts="--no-multiarch")

    Figure 6. R program in the start menu
    Figure 7. R console
  3. Include the sub project "SmartSCADA_3.20" into your main project. How to include a sub project, see chapter Change Project properties. Note that by including the SmartSCADA sub project into your customized project, you can also use SmartSCADA in customized projects.
    Figure 8. Include sub projects
  4. Add a CTRL manager with the script SmartSCADA.ctc and start mode "always" to the WinCC OA console: 
    SmartSCADA.ctc
    Figure 9. WinCC OA console and the CTRL manager with the script SmartSCADA.ctc
    Figure 10. WinCC OA console
  5. Add a CTRL manager with the script webclient_http.ctl and start mode "always" to the WinCC OA console: 
    webclient_http.ctl
    CAUTION:
    In case the parts used are not the default the ports can be changed by the config entries [[webClient] httpPort or [[webClient] httpsPort. Additionally the port for the web server has to be changed with [[ui]_httpServer for usage of loadSnippet.
    Figure 11. WinCC OA console and the CTRL manager with the script SmartSCADA.ctc
    Figure 12. WinCC OA console
  6. You can find the SmartSCADA wizards in the System Management ->on the SmartSCADA tab.
    Figure 13. System Management and the SmartSCADA tab
Note:
Additional load via statistical or KPI calculations is possible. You have to design WinCC OA according to the load either as a distributed system or also via other options such as remote UIs or remote CTRL managers. This applies to SmartSCADA similar to other projects with WinCC OA

General debug Flag for SmartSCADA

A general debug flag is available for SmartSCADA:

-dbg ssc_debug

Shows general debug information for SmartSCADA.