Scada-LTS

Scada-LTS is an Open Source, web-based, multi-platform solution for building your own SCADA (Supervisory Control and Data Acquisiton) system.

Quick start
Bugs and feature requests
Documentation
Contributing
Community
Versioning
Creators
Copyright and license

Quick start

Here is two of the several start options:

To Run ScadaLTS on Docker:

Download and install Docker from: https://www.docker.com/
Download Docker Toolbox from: https://kitematic.com/
Run Docker and Docker Toolbox.
When the download is completed in the Docker Toolbox run Docker CLI (bottom-left corner).
In the Docker CLI type in: docker pull scadalts/scadalts to download repository.
Type in: docker images to check if repository is created. It should show "scadalts/scadalts" on the list.
To run Scada on Docker type in: docker run -it -e DOCKER_HOST_IP=`docker-machine ip` -p 81:8080 scadalts/scadalts /root/start.sh.
Type in: Get-NetIPAddress and find IPAdrress for "DockerNAT" InterfaceAlias (You need a new CLI window to do it).
Type in docker IP adrress in the browser with port 81 and /ScadaLTS/ sufix. Example: http://10.0.75.2:81/ScadaLTS/

Second option:

Download the latest release.
Install tomcat7: apt-get install tomcat7.
Install mysql: apt-get install mysql-server.
Login to mysql: mysql -u [user] -p.
Create db:create database scadalts;.
Copy ScadaBR.war to dir tomacat webapps: cp ScadaBR.war /var/lib/tomcat7/webapps/. Optionally you can build ScadaBR.war. For this you have instruction how do it in section "Building from sources",which is below.
Restart tomcat7 to generate ScadaLTS folder: /etc/init.d/tomcat7 restart
Change config file env.properties set connection to db: vim /var/lib/tomcat7/webapps/ScadaBR/WEB-INF/classes/env.properties.
Restart tomcat7: /etc/init.d/tomcat7 restart

Building from sources

1.Please checkout sources from git from master branch by command git clone https://github.com/SCADA-LTS/Scada-LTS.git

After that You can open the project on Intellij Community Edition

2.Build project by Ant

Please set up environment variable CATALINA_HOME in your system. Example for linux system: CATALINA_HOME='home/yourusername/path_to_tomcat_directory'

We have build.xml which is used to build scadalts.war file.

Below are ant tasks which we run step by step

ant clean,
ant build,
ant war

3.Deploy

For deploy war file to tomcat we use ant clean_and_tomcat_deploy task on Windows and Linux.

4.Running and debugging application

After deploying you can run tomcat by supplying either ant run-debug on windows or ant run-debug-linux on Linux

Selenium Tests - GUI Automation tests

Needed libraries.

After checkout sources, as mentioned in 'Building from sources' section above using point 1, we have selenium directory. Here we have one file:

selenium-java-3.141.59.zip <- inside we have jar files which we have add to our project. We have additional geckodriver file ,responsible for open web browser.

Needed imports.

Here we can have situation when we don't have needed jar files or libraries. Please unzip selenium-java-3.141.59.zip in the same one directory. We need, to working this test, only 'client-combined-3.141.59.jar' file, from unziped file. Please add mentioned jar file 'client...' as additional library to the project. Right now we should have all of imported classes.

Simple example.

Under package 'selenium', we have 'AntSeleniumTest_LogIn_And_LogInWithFailUser.java'. This java class had two cases of test.

First use case - user exist in database: a) open webbrowser and in webbrowser put url address to open ScadaBR login side, b) put data like username and password into responsible fields, c) run login action, d) after succesfully point c) we should see our default side of ScadaLTS application. e) the end step is close webbrowser.

Second use case - user not exist in database: a) open webbrowser and in webbrowser put url address to open ScadaBR login side, b) put data like username and password into responsible fields, c) run login action, d) after unsuccesfully point c) we have information that this username not exist in database, e) the end step is close webbrowser.

Additional Ant Task to run test.

In build.xml, we have task named 'AntSelenium_UserLogIn'. Before run , we need run some other ant tasks :

ant clean,
ant build,
ant war,
'ant clean_and_tomcat_deploy'.

Without ant we can run our apache-tomcat server. Right now we can run mentioned task 'ant AntSelenium_UserLogIn' from terminal.

5.Problems and issues

First of all , I had problem on Ubuntu when I tried run 'ant AntSelenium_UserLogIn' task. I saw messages in console which told me, that I don't have GTK+ package on my machine, so I solved this one by install GTK+ package.

I didn't have any issues more, but If you have someone else, please contact with us.

Bugs and feature requests

Have a bug or a feature request? Please first read the issue guidelines and search for existing and closed issues. If your problem or idea is not addressed yet, please open a new issue.

Documentation

Scada-LTS documentation, will be included in this repo in the root directory.

Contributing

In the process of making.

Community

ScadaLTS tag is finally available on Stack Overflow. Feel free to ask questions - http://stackoverflow.com/questions/tagged/scadalts.

Tests

scada-lts.testquality.com

Project Encoding

Default project encoding is set to UTF-8.

Versioning

For transparency into our release cycle and in striving to maintain backward compatibility, Scada-LTS is maintained under the Semantic Versioning guidelines. Sometimes we screw up, but we'll adhere to those rules whenever possible.

See the Releases section of our GitHub project for changelogs for each release version of Scada-LTS.