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
Here is two of the several start options:
- 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/
- 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
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
- 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.
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.
Scada-LTS documentation, will be included in this repo in the root directory.
In the process of making.
- ScadaLTS tag is finally available on Stack Overflow. Feel free to ask questions - http://stackoverflow.com/questions/tagged/scadalts.
Default project encoding is set to UTF-8.
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.
Code base on ScadaBR
Michał Rokitiański
Grzesiek Bylica
Arkadiusz Parafiniuk
Konrad Daniek
Jarosław Morzyniec
- https://github.com/Morzyniec Testing
Mateusz Kaproń
Diego Rodrigues Ferreira
Jerzy Piejko
Radosław Jajko
Marcin Gołda
Tomasz Skrobol
If you need support for deployment please contact us and find more information on our website
Code released under the GPL license.