<?xml version='1.0' encoding='UTF-8' ?> <!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Transitional//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'> <html class="client-nojs" dir="ltr" lang="en"> <head> <meta charset="UTF-8" /> <title>Documents/How to/Install - OpenSCADAWiki</title> <meta content="MediaWiki 1.26.4" name="generator" /> <link href="https://www.gnu.org/copyleft/fdl.html" rel="copyright" /> <link href="files/doc.css" rel="stylesheet" /></head> <body><div class="floatright"><a href="index.html"><img alt="OpenSCADA" src="../en/files/index.png" /></a></div><div id="mw_header"> <div class="mw-indicators"> </div> <h1 id="firstHeading" lang="en">Documents/How to/Install</h1> </div><div class="mw-content-ltr" dir="ltr" id="mw-content-text" lang="en"><div class="mw-pt-languages" dir="ltr" lang="en"><div class="mw-pt-languages-list autonym"><span class="mw-pt-languages-ui mw-pt-languages-selected mw-pt-progress mw-pt-progress--complete">English</span> • ‎<a class="mw-pt-progress mw-pt-progress--complete" href="../ru/How_to_Install.html" title="Документы/Как/УÑтановить (100% translated)">mRussian</a> • ‎<a class="mw-pt-progress mw-pt-progress--complete" href="../uk/How_to_Install.html" title="Документи/Як/Ð’Ñтановити (100% translated)">УкраїнÑька</a></div></div> <div style="float:right; border:1px solid gray; width:300px; padding:2px; margin-left: 10pt; margin-bottom: 10pt;"> <ul><li> <b>Author:</b> <a class="external" href="http://oscada.org/wiki/User:RomanSavochenko" title="User:RomanSavochenko">Roman Savochenko</a></li></ul> </div> <p>Installing OpenSCADA in general can be done in two ways. The first and simplest way is to get ready-made packages for the Linux distribution that you are using. The second is to compile OpenSCADA from the source code. </p><p>The installation procedure is highly dependent on the Linux distribution you are using and it is not possible to describe that exhaustively in this manual. Therefore, you may need to get a deep knowledge of the mechanisms of installing the software of the selected Linux distribution in its documentation. In the event that the user does not have such knowledge, skills and preferences for a Linux distribution, it is advisable to choose it according to the availability of OpenSCADA packages and even a packages repository, which provides the simplest and most trouble free installation. </p><p>If the user has trouble with installing not only OpenSCADA, but also the Linux distribution, then on the first time, he can use the "live" Linux distribution with installed and ready to work and studying the demonstration and full-featured OpenSCADA. If this environment of rapid availability is suited for you then you can stop on it and install it. At this time, "live" builds based on the Debian and ALTLinux (deprecated) distributions are available as hybrid CD/DVD/USB stamps at the page: <a class="external free" href="http://oscada.org/en/main/download/" rel="nofollow noreferrer noopener" target="_blank">http://oscada.org/en/main/download/</a>. For more information see the "<a href="How_to_Live_disk.html" title="Special:MyLanguage/Documents/How to/Live disk">How to create Live disk</a>" document. </p> <div class="toc" id="toc"><div id="toctitle"><h2>Contents</h2></div> <ul> <li class="toclevel-1 tocsection-1"><a href="#Installing_OpenSCADA_from_ready-made_packages"><span class="tocnumber">1</span> <span class="toctext"><span>Installing OpenSCADA from ready-made packages</span></span></a> <ul> <li class="toclevel-2 tocsection-2"><a href="#Adding_a_package_repository_and_installing_OpenSCADA_from_that"><span class="tocnumber">1.1</span> <span class="toctext"><span>Adding a package repository and installing OpenSCADA from that</span></span></a></li> <li class="toclevel-2 tocsection-3"><a href="#Manual_installation_of_the_OpenSCADA_packages"><span class="tocnumber">1.2</span> <span class="toctext">Manual installation of the OpenSCADA packages</span></a></li> </ul> </li> <li class="toclevel-1 tocsection-4"><a href="#Installing-building_from_the_source_texts"><span class="tocnumber">2</span> <span class="toctext">Installing-building from the source texts</span></a></li> </ul> </div> <h3><span class="mw-headline" id="Installing_OpenSCADA_from_ready-made_packages"><span class="mw-headline-number">1</span> <span id="ReadyPacks" title="#ReadyPacks">Installing OpenSCADA from ready-made packages</span></span></h3> <p>Installing from the ready-made packages, in turn, can be done in two ways. The first one is simpler, when OpenSCADA packages are already present in their <a class="external text" href="http://oscada.org/en/main/download/" rel="nofollow noreferrer noopener" target="_blank">own OpenSCADA package repositories</a> or the official — additional repositories of the used Linux distribution. Installing these packages is a matter of running a typical distribution package management program with the subsequent selection of OpenSCADA packages. In addition to simple installation, the package repository generally allows you to simply keep the operating system updated, safe and up to date! The second method involves obtaining and installing OpenSCADA packages manually. </p><p>You can check the availability of OpenSCADA packages in the repositories of Linux distributions or OpenSCADA, as well as download OpenSCADA packages for manual installation, on the download page of the <a class="external text" href="http://oscada.org/en/main/download/" rel="nofollow noreferrer noopener" target="_blank">official OpenSCADA site</a>. Here you can also get the configuration for connecting the OpenSCADA package repositories to the package manager of your Linux distribution. </p><p><a class="image" href="http://oscada.org/wiki/File:At.png"><img alt="At.png" height="22" src="files/At.png" width="22" /></a> You must download packages and connect package repositories directly to the version of the distribution that you use, otherwise there may be unresolved dependency problems at the installation process. </p> <h4><span class="mw-headline" id="Adding_a_package_repository_and_installing_OpenSCADA_from_that"><span class="mw-headline-number">1.1</span> <span id="ReadyPacksRepo" title="#ReadyPacksRepo">Adding a package repository and installing OpenSCADA from that</span></span></h4> <p>Package repositories are provided by the OpenSCADA project itself, whose service information is usually located along with the packages themselves and is updated automatically at the building, that is, these repositories are most up-to-date and preferable. Although OpenSCADA packages can still be found in the repositories of such Linux distributions: <a class="external text" href="http://www.altlinux.ru" rel="nofollow noreferrer noopener" target="_blank">ALTLinux</a> and distributions based on the package base <a class="external text" href="http://fedoraproject.org" rel="nofollow noreferrer noopener" target="_blank">Fedora</a>, but they rather will be old ones since the packages building to the distribution repositories from the developers is not practiced right now! </p><p>Repository addresses and configurations for the repository manager can be found on the same OpenSCADA download page (<a class="external free" href="http://oscada.org/en/main/download/" rel="nofollow noreferrer noopener" target="_blank">http://oscada.org/en/main/download/</a>) or in the examples below. </p><p>When installing from the repository, we select only the package with the configuration of the OpenSCADA project or the model. Everything else will be selected and installed automatically according to the dependencies. The following packages of this kind are usually provided: </p> <ul><li> <b>openscada-model-aglks</b>, <b>openscada-model-boiler</b> — projects of dynamic simulators of technological processes, which together perform the function of demonstrating OpenSCADA;</li> <li> <b>openscada-vis-station</b> — template project of the SCADA station, usually run in a graphical interface and without a Web;</li> <li> <b>openscada-server</b> — template project of the SCADA server, running in the background — the daemon mode;</li> <li> <b>openscada-plc</b> — PLC template project, running in the background — the daemon mode;</li> <li> <b>openscada</b> — typical-complete installation of OpenSCADA.</li></ul> <p><a class="image" href="http://oscada.org/wiki/File:At.png"><img alt="At.png" height="22" src="files/At.png" width="22" /></a> In the case of the <a class="external" href="http://oscada.org/wiki/Special:MyLanguage/Sub-projects/Automation_Linux_distributive" title="Special:MyLanguage/Sub-projects/Automation Linux distributive">Automation Linux Distributive</a> and LTS packages, the suffix "-lts" is added to the main package name — "openscada-lts", since the repository is one and it contains packages of the both branches: Work and LTS. </p><p>Installation-update from the repository is simple but specific to the Linux distribution, window manager or separate program for working with repositories and packages, so we will send the reader to the appropriate documentation for the distribution or program that it uses. Here's a brief look at adding a repository and installing OpenSCADA with standard command line tools: </p><p><b><span id="ReadyPacksRepoDeb" title="#ReadyPacksRepoDeb">Package repositories based on the package manager APT (Debian, Ubuntu, ALTLinux)</span></b> — are added by the location of the downloaded file "openscada.list" to the /etc/apt/sources.list.d folder or by editing the /etc/apt/sources.list file by inserting one line:<br /> <i>Debian (LTS and Work, <a class="external" href="http://oscada.org/wiki/Special:MyLanguage/Sub-projects/Automation_Linux_distributive#Debian" title="Special:MyLanguage/Sub-projects/Automation Linux distributive">Automation Linux repository</a>):</i> "deb <a class="external free" href="http://ftp.oscada.org/Debian/12/openscada" rel="nofollow noreferrer noopener" target="_blank">http://ftp.oscada.org/Debian/12/openscada</a> ./"<br /> <i>Ubuntu (LTS):</i> "deb <a class="external free" href="http://ftp.oscada.org/OpenSCADA/LTS/Ubuntu/22.04" rel="nofollow noreferrer noopener" target="_blank">http://ftp.oscada.org/OpenSCADA/LTS/Ubuntu/22.04</a> ./"<br /> <i>Ubuntu (Work):</i> "deb <a class="external free" href="http://ftp.oscada.org/OpenSCADA/Work/Ubuntu/22.04" rel="nofollow noreferrer noopener" target="_blank">http://ftp.oscada.org/OpenSCADA/Work/Ubuntu/22.04</a> ./"<br /> Installing: </p> <div class="mw-highlight mw-content-ltr" dir="ltr"><pre>apt-get update apt-get install openscada-model-aglks </pre></div> <p><i>ALTLinux (LTS and Work, <a class="external" href="http://oscada.org/wiki/Special:MyLanguage/Sub-projects/Automation_Linux_distributive#ALTLinux" title="Special:MyLanguage/Sub-projects/Automation Linux distributive">Automation Linux repository</a>):</i> "rpm <a class="external free" href="http://ftp.oscada.org/ALTLinux/7" rel="nofollow noreferrer noopener" target="_blank">http://ftp.oscada.org/ALTLinux/7</a> openscada main"<br /> Installing: </p> <div class="mw-highlight mw-content-ltr" dir="ltr"><pre>apt-get update apt-get install openscada-Model.AGLKS </pre></div> <p>Adding the signature verification key (the authenticity) of the repository and packages in it (not necessarily and not in all repositories): </p> <div class="mw-highlight mw-content-ltr" dir="ltr"><pre>wget -P /etc/apt/trusted.gpg.d http://ftp.oscada.org/Misc/openscada-archive-keyring.asc <span class="c"># or on old Debian systems</span> wget -O - http://ftp.oscada.org/Misc/pkgSignKey <span class="p">|</span> sudo apt-key add - </pre></div> <p><b><span id="ReadyPacksRepoRH" title="#ReadyPacksRepoRH">Package repositories based on the package manager YUM (RedHat, Fedora, CentOs)</span></b> — are added by uploading or creating a file /etc/yum.repos.d/openscada.repo with the contents: </p> <div class="mw-highlight mw-content-ltr" dir="ltr"><pre><span class="k">[openscada]</span> <span class="na">name</span><span class="o">=</span><span class="s">OpenSCADA</span> <span class="c1">#CentoOs (LTS)</span> <span class="na">baseurl</span><span class="o">=</span><span class="s">http://ftp.oscada.org/OpenSCADA/LTS/CentOs/7</span> <span class="c1">#CentoOs (Work)</span> <span class="c1">#baseurl=http://ftp.oscada.org/OpenSCADA/Work/CentOs/6</span> <span class="c1">#Fedora (Work)</span> <span class="c1">#baseurl=http://ftp.oscada.org/OpenSCADA/Work/Fedora/12</span> <span class="na">enabled</span><span class="o">=</span><span class="s">1</span> <span class="na">gpgcheck</span><span class="o">=</span><span class="s">1</span> <span class="na">repo_gpgcheck</span><span class="o">=</span><span class="s">1</span> <span class="na">gpgkey</span><span class="o">=</span><span class="s">http://ftp.oscada.org/Misc/pkgSignKey</span> </pre></div> <p>Installing: </p> <div class="mw-highlight mw-content-ltr" dir="ltr"><pre>yum install openscada-Model.AGLKS </pre></div> <p><b>The package repositories SuSE YaST</b> — are added by the command: </p> <div class="mw-highlight mw-content-ltr" dir="ltr"><pre>zypper ar -f http://ftp.oscada.org/OpenSCADA/LTS/SuSE/15 OpenSCADA </pre></div> <p>Installing: </p> <div class="mw-highlight mw-content-ltr" dir="ltr"><pre>zypper in openscada-Model.AGLKS </pre></div> <h4><span class="mw-headline" id="Manual_installation_of_the_OpenSCADA_packages"><span class="mw-headline-number">1.2</span> Manual installation of the OpenSCADA packages</span></h4> <p>To manually install the OpenSCADA packages you need to download them from the official site or another source. You can usually download two sets of the packages. </p><p>The first set is represented by twelve packages: </p> <ul><li> <b>openscada</b> — package with all the files needed to launch OpenSCADA in full volume, including all modules;</li> <li> <b>openscada-server</b> — contains dependencies, script file and configuration the server project to run OpenSCADA in the daemon-service mode;</li> <li> <b>openscada-plc</b> — contains dependencies, script file and configuration the PLC project to run OpenSCADA in the daemon-service mode;</li> <li> <b>openscada-libdb-main</b> — main OpenSCADA libraries for data acquisition and other in the SQLite database;</li> <li> <b>openscada-libdb-vca</b> — visual component libraries in the SQLite database;</li> <li> <b>openscada-model-aglks</b> — DB and configuration of the dynamic real-time model "AGLKS" (Demo: EN,UK,RU);</li> <li> <b>openscada-model-boiler</b> — DB and configuration of the dynamic real-time model "Boiler" (EN,UK,RU);</li> <li> <b>openscada-doc-en</b> — offline documentation of OpenSCADA in English;</li> <li> <b>openscada-doc-uk</b> — offline documentation of OpenSCADA in Ukrainian;</li> <li> <b>openscada-doc-ru</b> — offline documentation of OpenSCADA in mRussian;</li> <li> <b>openscada-dev</b> — development package of creation separate OpenSCADA modules;</li> <li> <b>openscada-dbg</b> — debugging package of debug information to the binary files for <a href="How_to_Crash_report.html" title="Special:MyLanguage/Documents/How to/Crash report">report</a> and search for errors in the program.</li></ul> <p>The second set is represented by about fifty packages with separation of OpenSCADA modules by packages: </p> <ul><li> <b>openscada-core</b> — contains the OpenSCADA core, the basic configuration and the executable files;</li> <li> <b>openscada-db-*</b> — modules of the subsystem "DB";</li> <li> <b>openscada-daq-*</b> — modules of the subsystem "DAQ";</li> <li> <b>openscada-arh-*</b> — modules of the subsystem "Archives-History";</li> <li> <b>openscada-tr-* </b> — modules of the subsystem "Transports";</li> <li> <b>openscada-prot-* </b> — modules of the subsystem "Transport protocols";</li> <li> <b>openscada-ui-* </b> — modules of the subsystem "User interfaces";</li> <li> <b>openscada-spec-* </b> — modules of the subsystem "Specials";</li> <li> <b>openscada</b> — virtual package with dependencies for installing default configuration of OpenSCADA;</li> <li> <b>openscada-server</b> — contains dependencies, script file and configuration the server project to run OpenSCADA in the daemon-service mode;</li> <li> <b>openscada-plc</b> — contains dependencies, script file and configuration the PLC project to run OpenSCADA in the daemon-service mode;</li> <li> <b>openscada-vis-station</b> — virtual package with dependencies for installing typical configuration of OpenSCADA as visual SCADA-station;</li> <li> <b>openscada-libdb-main</b> — main OpenSCADA libraries for data acquisition and other in the SQLite database;</li> <li> <b>openscada-libdb-vca</b> — visual component libraries in the SQLite database;</li> <li> <b>openscada-model-aglks</b> — DB and configuration of the dynamic real-time model "AGLKS" (Demo: EN,UK,RU);</li> <li> <b>openscada-model-boiler</b> — DB and configuration of the dynamic real-time model "Boiler" (EN,UK,RU);</li> <li> <b>openscada-doc-en</b> — offline documentation of OpenSCADA in English;</li> <li> <b>openscada-doc-uk</b> — offline documentation of OpenSCADA in Ukrainian;</li> <li> <b>openscada-doc-ru</b> — offline documentation of OpenSCADA in mRussian;</li> <li> <b>openscada-dev</b> — development package of creation separate OpenSCADA modules;</li> <li> <b>openscada-dbg</b> — debugging package of debug information to the binary files for <a href="How_to_Crash_report.html" title="Special:MyLanguage/Documents/How to/Crash report">report</a> and search for errors in the program.</li></ul> <p>The first set of the packages is more intended for simple-manual installation since it contains only twelve packages. The second set is intended to be located in the Linux repository and then to be installed by the package manager that automatically resolves dependencies, and also allows you to install only the required OpenSCADA components, thereby optimising the work environment. </p><p>Manual setup of the first set of DEB packages can be done by command, having previously changed the working directory to the directory with the packages: </p> <div class="mw-highlight mw-content-ltr" dir="ltr"><pre>dpkg -i openscada-libdb.main_0.9.0-1_all.deb openscada-libdb.vca_0.9.0-1_all.deb openscada-model.aglks_0.9.0-1_all openscada_0.9.0-1_i386.deb </pre></div> <p>Manual setup of the first set of RPM packages can be done by command, having previously changed the working directory to the directory with the packages: </p> <div class="mw-highlight mw-content-ltr" dir="ltr"><pre>rpm -i openscada-LibDB.Main-0.9.0-alt1.noarch.rpm openscada-LibDB.VCA-0.9.0-alt1.noarch.rpm openscada-Model.AGLKS-0.9.0-alt1.i586.rpm openscada-0.9.0-alt1.i586.rpm </pre></div> <p><a class="image" href="http://oscada.org/wiki/File:At.png"><img alt="At.png" height="22" src="files/At.png" width="22" /></a> During the installation process there may be errors related to the unsatisfactory dependencies. When manually installing from packages, they will need to be handled manually just like installing the OpenSCADA packages or through the Linux distribution package manager. Cases of the dependency problems can exist even when installing through the packages manager if the OpenSCADA repository used that does not match the Linux distribution or its version, or the main package repositories of the distribution itself are not connected. In the APT package manager you can use the command to automatically resolve external dependencies that arose when manually installing OpenSCADA: </p> <div class="mw-highlight mw-content-ltr" dir="ltr"><pre>apt-get install -f </pre></div> <h3><span class="mw-headline" id="Installing-building_from_the_source_texts"><span class="mw-headline-number">2</span> Installing-building from the source texts</span></h3> <p>When there is no way to get ready-made OpenSCADA packages for the selected distribution, a variant of the OpenSCADA build from the source texts only remains. This process is described in detail by the document "<a href="How_to_Build_from_source.html" title="Special:MyLanguage/Documents/How to/Build from source">How to build from the source texts</a>". </p> </div><table style="border-top: dotted 2px #999999; margin-top: 20pt; color: gray;" width="100%"><tr><td style="text-align: left;" width="40%"><a href="http://oscada.org/wiki/Documents/How_to/Install/en">Documents/How_to/Install/en</a> - <a href="http://oscada.org/en/main/about-the-project/licenses/">GFDL</a></td><td style="text-align: center;">March 2025</td><td style="text-align: right;" width="40%">OpenSCADA 1+r3012</td></tr></table></body> </html>