SCADA-SST Files

			 ______________________

			  SCADA-SST USER GUIDE
			 ______________________


Table of Contents
_________________

1 Installation
.. 1.1 Installing OMNeT++
.. 1.2 Installing INET Framework
.. 1.3 Installing SCADA-SST
2 Creating and Configuring a Simulated SCADA Network
.. 2.1 Setting Network Topology
.. 2.2 Creating Simulated Nodes
.. 2.3 Configuring Interface Nodes
.. 2.4 Connecting SIMATIC S7 PLCs with SCADA-SST





1 Installation
==============

  This installation procedure has been tested on [Ubuntu 12.4]. It
  should be adapted when using other Ubuntu versions or other Linux
  distribution.

  Before installing SCADA-SST, one has to first install OMNeT++ and the
  corrsponding INET framework.


  [Ubuntu 12.4] http://releases.ubuntu.com/12.04/


1.1 Installing OMNeT++
~~~~~~~~~~~~~~~~~~~~~~

  Install prerequisite packages
  ,----
  | $ sudo apt-get install build-essential gcc g++ bison flex perl \
  |  tcl-dev tk-dev blt libxml2-dev zlib1g-dev openjdk-7-jre \
  |  doxygen graphviz openmpi-bin libopenmpi-dev libpcap-dev 
  `----
  Extract the downloaded OMNeT++ files
  ,----
  | $ tar zxvf omnetpp-4.2.1-src.tgz
  `----
  Setup the environment variables
  ,----
  | $ cd omnetpp-4.2.1
  | $ . setenv
  `----
  Run configure
  ,----
  | $ ./configure
  `----
  Compile the simulator
  ,----
  | $ make 
  `----

  Make sure that OMNeT++ has been installed successfully through running
  one of the sample simulations packaged with OMNeT++.

  ,----
  | $ cd samples/dyna
  | $ ./dyna
  `----


1.2 Installing INET Framework
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  Download the corresponding version of [INET], and extract the
    downloaded files
  ,----
  | tar xjf inet20111118-src.tar.gz
  `----
  Start the OMNeT++ IDE
  ,----
  | $ ide/omnetpp
  `----
  Import INET as an existing project
  ,----
  | File -> Import... -> General -> Existing Projects into Workspace
  `----
  Select the directory you previously extracted the INET archive to as
  root directory. Now INET should appear within the list of projects.
  ,----
  | Press Finish
  `----
  Start compiling
  ,----
  | Ctrl+B
  `----


  [INET] https://inet.omnetpp.org


1.3 Installing SCADA-SST
~~~~~~~~~~~~~~~~~~~~~~~~

  Extract SCADA-SST files
  ,----
  | tar xzf SCADA-SST-src.tar.gz
  `----
  Start the OMNeT++ IDE and import SCADA-SST as an existing project
  ,----
  | File -> Import... -> General -> Existing Projects into Workspace
  `----
  Select the directory you previously extracted the SCADA-SST archive to
  as root directory. Now SCADA-SST should appear within the list of
  projects.
  ,----
  | Press finish
  `----
  Start compiling
  ,----
  | Ctrl + B
  `----


2 Creating and Configuring a Simulated SCADA Network
====================================================

  SCADA-SST is designed to be a generic, easy- to-use and easy-to-setup
  SCADA simulation framework. This is achieved by making the process of
  setting the SCADA network topology and populating it with nodes as
  straightforward and intuitive as possible.


2.1 Setting Network Topology
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  Simulating a SCADA system network starts by creating a network
  topology.  The network topology is implemented in two files, namely, a
  network topology file (.ned) and a simulation configuration file
  (.ini). For each simulated network, the network topology file
  specifies the list of subnetworks (LANs and WANs).  For every
  subnetwork, the configuration specifies the list of nodes and the
  links (connections) between those nodes. The network topology
  configuration can be edited directly with text or it can be
  constructed using the graphical user interface. The simulation
  configuration file, on the other han, specifies runtime simulation
  parameters. This includes:
  - the network (or subnetwork) to be simulated.
  - the simulation duration as well as the scheduler
  - TCP protocol settings
  - IP protocol settings
  - ARP protocol configuration


2.2 Creating Simulated Nodes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  Adding a simulated node to the network can be done in two different
  ways.  First, adding an entry in the topology configuration file and
  setting all related links (connections). Second, using the graphical
  user interface (drag-and-drop).  In SCADA-SST, there is an extensive
  list of node types that can be used to create new nodes. Node types
  fall into two categories: INET nodes and SCADA related nodes. INET
  nodes category includes typical network hosts such as routers,
  wireless hosts, ICMP hosts, etc. SCADA related nodes category includes
  SCADA specific hosts such as PLC, RTU, historian, database server,
  etc.


2.3 Configuring Interface Nodes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  An interface node is a particular type of nodes that allows external
  hosts to be connected to SCADA-SST. For each external host, there is a
  need for (at least) one interface node. Each interface node can
  support one protocol. That is, if an external host can communicate
  with simulated nodes using two different protocols, there is a need
  for two interface nodes. Configuring an interface node consists in
  setting a set of parameters, such as the routing table, interface
  table, the external host IP address, etc.


2.4 Connecting SIMATIC S7 PLCs with SCADA-SST
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  To integrate physical Siemens SIMATIC PLC with simulated nodes (either
  master or slave nodes) inside SCADA-SST, please follow the
  instructions in [this document].


  [this document]
  http://www.controltechnology.com/Files/common-documents/application_notes/Communication-to-Simatic-S7-using-open-modbus