Ðóññêàÿ âåðñèÿ?
Óêðà¿íñüêà âåðñ³ÿ

Manual for OpenSCADA building from sources

Introduction

This manual made for help on OpenSCADA building from sources. In process of accumulation of experience of building for different OS Linux distributions and others platforms generally, this document will be complement for tips and details of building for different environments.

The document also contain information about preset configuration of built system of OpenSCADA, for complete start with using of present, included to sources, demo DB (model "AGLKS").

System OpenSCADA direct building

Build system must be executed from normal system user name. Thus described variants of installing and execution how global and local, to user directory. Get what user login is - "user".

Before building enter as common user and change user login to your, get sources (from ftp/http-server or SVN-repository), select install method (global or local) and follow instruction:

Steps of preparation of the source tree to build:

1. Make directory for project building:
   $ mkdir ~/projects; cd ~/projects
   
2. Download sources package. It may be made from two ways:
   • download tar archive from ftp-server ftp://ftp.oscada.org/OpenSCADA/ and unpacked it, for example:
     $ wget ftp://ftp.oscada.org/OpenSCADA/0.7.1/openscada-0.7.1.tar.lzma
     $ wget ftp://ftp.oscada.org/OpenSCADA/0.7.1/openscada-res-0.7.1.tar.lzma
     $ tar --lzma -xvf openscada-0.7.1.tar.lzma
     $ cd openscada-0.7.1
     $ tar --lzma -xvf ../openscada-res-0.7.1.tar.lzma
     
   • get project's source tree from SVN-repository:
     $ svn co svn://oscada.org/trunk/OpenSCADA
     $ cd OpenSCADA
     
3. Resolve OpenSCADA dependents for build, on according demands. Exclude dependents in case of inability its by help of option --disable-{ModName} into comman "configure" below, for example --disable-SoundCard.
4. Generate of build system, when download from the SVN-repository:
   $ autoreconf -ivf

Steps of global building:

1. Configuring building system of OpenSCADA:
   $ ./configure
   
2. Make OpenSCADA project:
   $ make
   
3. Install OpenSCADA:
   $ su; make install
   
4. Copy start script and configuration file of demonstration:
   $ cp data/ModelsDB/AGLKS/openscada_demo /usr/bin
   $ cp data/ModelsDB/AGLKS/oscada_AGLKS.xml /etc
   
5. Make data directory and fill it:
   $ mkdir /var/spool/openscada
   $ mkdir /var/spool/openscada/{DATA,icons,LibsDB,AGLKS}
   $ cp data/LibsDB/*.db /var/spool/openscada/LibsDB
   $ cp data/ModelsDB/AGLKS/*.db /var/spool/openscada/AGLKS
   $ cp data/icons/* /var/spool/openscada/icons
   $ install -m 777 -d /var/spool/openscada/ARCHIVES/{MESS,VAL}
   
6. System ready to start:
   $ exit; openscada_demo

Steps of local building:

1. Configuring building system of OpenSCADA:
   $ mkdir ~/OScadaW; ./configure --prefix=/home/user/OScadaW
   
2. Make OpenSCADA project:
   $ make
   
3. Install OpenSCADA:
   $ make install
   
4. Copy start script and configuration file of demonstration:
   $ cp data/ModelsDB/AGLKS/openscada_demo_local ~/OScadaW/bin/openscada_demo
   $ mkdir ~/OScadaW/etc
   $ cp data/ModelsDB/AGLKS/oscada_demo_local.xml ~/OScadaW/etc/oscada_demo.xml
   
5. Make data directory and fill it:
   $ mkdir ~/OScadaW/share/openscada
   $ mkdir ~/OScadaW/share/openscada/{DATA,icons,LibsDB,AGLKS}
   $ cp data/LibsDB/*.db ~/OScadaW/share/openscada/LibsDB
   $ cp data/ModelsDB/AGLKS/*.db ~/OScadaW/share/openscada/AGLKS
   $ cp data/icons/* ~/OScadaW/share/openscada/icons
   $ install -m 777 -d ~/OScadaW/share/openscada/ARCHIVES/{MESS,VAL}
   
6. System ready to start:
   $ cd ~/OScadaW/bin; ./openscada_demo

Ñáîðêà ïàêåòîâ ñèñòåìû OpenSCADA äëÿ äèñòðèáóòèâà Linux

Redhat-based äèñòðèáóòèâû - ïàêåò RPM

Äëÿ ñáîðêè RPM-ïàêåòîâ OpenSCADA Âàì ïîíàäîáÿòñÿ àðõèâû èñõîäíûõ òåêñòîâ, ðåñóðñîâ è ôàéë ñïåöèôèêàöèè RPM ïàêåòà (openscada.spec, openscada_mod.spec) èëè æå SRPM-ïàêåò âñåõ ýòèõ èñõîäíûõ ìàòåðèàëîâ (openscada-0.7.1-2.src.rpm), êîòîðûå ìîæíî çàãðóçèòü ñ ftp èëè http-ñåðâåðà ïðîåêòà.

Ôàéë ñïåöèôèêàöèè RPM-ïàêåòîâ è SRPM-ïàêåò ìîãóò îòëè÷àòüñÿ äëÿ ðàçíûõ äèñòðèáóòèâîâ Linux, ó÷èòûâàÿ èõ îñîáåííîñòè, ïîýòîìó íóæíî ñòàðàòüñÿ çàãðóæàòü èõ â ñîîòâåòñòâèè ñ äèñòðèáóòèâîì. Åñëè ñïåöèàëüíûé SRPM ïàêåò îòñóòñòâóåò òî ìîæíî ïîïðîáîâàòü ñîáðàòü èç óíèôèöèðîâàííîãî ôàéëà ñïåöèôèêàöèè â îñíîâíîì SRPM ïàêåòå.

Ñáîðêà RPM-ïàêåòîâ ïðîèçâîäèòñÿ â äèðåêòîðèè ñî ñïåöèàëüíîé ñòðóêòóðîé, êîòîðàÿ îáû÷íî ñîçäà¸òñÿ ïðè óñòàíîâêå ñîîòâåòñòâóþùåãî ïàêåòà äèñòðèáóòèâà (íàïðèìåð: rpm-build). Ýòà äèðåêòîðèÿ, â çàâèñèìîñòè îò äèñòðèáóòèâà, ðàñïîëàãàåòñÿ â äîìàøíåé äèðåêòîðèè ïîëüçîâàòåëÿ èëè â äèðåêòîðèè /usr/src. Èçâåñòíûå ôàêòû ðàñïîëîæåíèÿ äèðåêòîðèè ñáîðêè RPM-ïàêåòîâ ðàçëè÷íûõ äèñòðèáóòèâîâ:

• /usr/src/packages : Open-SUSE
• ~/RPM : ALTLinux
• ~/rpmbuild : Mandriva, Fedora è îòâåòâëåíèÿ

Åñëè, ïîñëå óñòàíîâêè ñïåöèàëèçèðîâàííîãî ïàêåòà, äèðåêòîðèè ñîçäàíèÿ RPM ïàêåòîâ íåò òî å¸ íóæíî ñîçäàòü êîìàíäîé:

Ýòàïû ñáîðêè ïî ôàéëó ñïåöèôèêàöèè RPM:

1. Ðàçìåùåíèå àðõèâîâ OpenSCADA è ôàéëà ñïåöèôèêàöèè â äèðåêòîðèè ñáîðêè RPM (èñõîäíûå ôàéëû ïðåäâàðèòåëüíî ïîìåùåíû â òåêóùåé äèðåêòîðèè):
   $ cp openscada-0.7.1.tar.lzma openscada-res-0.7.1.tar.lzma Äèðåêòîðèÿ äèñòðèáóòèâà/SOURCES
   $ cp openscada.spec Äèðåêòîðèÿ äèñòðèáóòèâà/SPECS
   
2. Óäîâëåòâîðåíèå çàâèñèìîñòåé ïðîåêòà OpenSCADA äëÿ ñáîðêè â ñîîòâåòñòâèè ñ òðåáîâàíèÿìè. Èñêëþ÷åíèå çàâèñèìîñòåé, â ñëó÷àå íåâîçìîæíîñòè èõ óäîâëåòâîðåíèÿ, ïóò¸ì îòêëþ÷åíèÿ ñáîðêè íåíóæíûõ ìîäóëåé îïöèåé --disable-{ModName} ê êîìàíäå "configure" â ôàéëå "openscada.spec", íàïðèìåð: --disable-SoundCard.
3. Ñáîðêà ïàêåòîâ
   • ñáîðêà ñ íà÷àëà:
     $ rpmbuild -bb Äèðåêòîðèÿ äèñòðèáóòèâà/SPECS/openscada.spec
     
   • òîëüêî óñòàíîâêà è óïàêîâêà, èç ïàêåòà rpm-óòèëèò etersoft (óäîáíî ïðè íàñòðîéêå openscada.spec ôàéëà):
     $ rpmbb -i Äèðåêòîðèÿ äèñòðèáóòèâà/SPECS/openscada.spec
     
4. Ïàêåòû ãîòîâû è äîñòóïíû â äèðåêòîðèè Äèðåêòîðèÿ äèñòðèáóòèâà/RPMS , äëÿ ñîîòâåòñòâóþùåé àðõèòåêòóðû

Ýòàïû ñáîðêè èç SRPMS ïàêåòà:

1. Óäîâëåòâîðåíèå çàâèñèìîñòåé ïðîåêòà OpenSCADA äëÿ ñáîðêè â ñîîòâåòñòâèè ñ òðåáîâàíèÿìè.
2. Ñáîðêà ïàêåòîâ (èñõîäíûå ôàéëû ïðåäâàðèòåëüíî ïîìåùåíû â òåêóùåé äèðåêòîðèè):
   $ rpmbuild --rebuild openscada-0.7.1-2.src.rpm
   
3. Ïàêåòû ãîòîâû è äîñòóïíû â äèðåêòîðèè Äèðåêòîðèÿ äèñòðèáóòèâà/RPMS , äëÿ ñîîòâåòñòâóþùåé àðõèòåêòóðû

Debian-based äèñòðèáóòèâû - ïàêåò Deb

Äëÿ ñáîðêè Deb-ïàêåòîâ OpenSCADA Âàì ïîíàäîáÿòñÿ àðõèâû èñõîäíûõ òåêñòîâ è ðåñóðñîâ, êîòîðûå ìîæíî çàãðóçèòü ñ ftp èëè http-ñåðâåðà ïðîåêòà.

Ñáîðêà Deb-ïàêåòîâ ïðîèçâîäèòñÿ â äèðåêòîðèè "debian" ñî ñêðèïòàìè ñáîðêè, êîòîðàÿ ñîäåðæèòñÿ â àðõèâàõ èñõîäíûõ òåêñòîâ OpenSCADA.

Ýòàïû ñáîðêè:

1. Ñîçäàíèå äèðåêòîðèè äëÿ ñáîðêè ïðîåêòà:
   $ mkdir ~/build; cd ~/build
   
2. Çàãðóçêà ïàêåòà ñ èñõîäíûìè òåêñòàìè. Çàãðóçêà òàðáîëà èñõîäíûõ òåêñòîâ è ðåñóðñîâ ñ ftp-ñåðâåðà ïðîåêòà ftp://ftp.oscada.org/OpenSCADA/ è ðàñïàêîâêà, íàïðèìåð òàê:
   $ wget ftp://ftp.oscada.org/OpenSCADA/0.7.1/openscada-0.7.1.tar.lzma
   $ wget ftp://ftp.oscada.org/OpenSCADA/0.7.1/openscada-res-0.7.1.tar.lzma
   $ tar --lzma -xvf openscada-0.7.1.tar.lzma
   $ cd openscada-0.7.1
   $ tar --lzma -xvf ../openscada-res-0.7.1.tar.lzma
   
3. Óäîâëåòâîðåíèå çàâèñèìîñòåé ïðîåêòà OpenSCADA äëÿ ñáîðêè â ñîîòâåòñòâèè ñ òðåáîâàíèÿìè. Èñêëþ÷åíèå çàâèñèìîñòåé, â ñëó÷àå íåâîçìîæíîñòè èõ óäîâëåòâîðåíèÿ, ïóò¸ì îòêëþ÷åíèÿ ñáîðêè íåíóæíûõ ìîäóëåé îïöèåé --disable-{ModName} ê êîìàíäå "configure" â ôàéëå openscada-0.7.1/debian/rules, íàïðèìåð: --disable-SoundCard.
4. Ïåðåõîä â äèðåêòîðèþ OpenSCADA è çàïóñê ñáîðêè:
   $ cd openscada-0.7.1
   
   • ñáîðêà ñ íà÷àëà:
     $ dpkg-buildpackage -rfakeroot
     
   • ïðîïóñòèòü ñáîðêó è ïåðåóïàêîâàòü, óäîáíî ïðè îòëàäêå openscada-0.7.1/debian/rules:
     $ fakeroot debian/rules binary
     $ fakeroot debian/rules build
     
5. Ïàêåòû ãîòîâû è äîñòóïíû â äèðåêòîðèè óðîâíåì âûøå.

Gentoo - ìåòàäèñòðèáóòèâ

OpenSCADA íå âõîäèò â îôèöèàëüíîå äåðåâî portage Gentoo, ïîýòîìó ñáîðêà ïðîèçâîäèòñÿ èç îâåðëåÿ. Ïîäðîáíî ïðî ðàáîòó ñ îâåðëååì ìîæíî íàéòè íà ñàéòàõ äîêóìåíòàöèè Gentoo, íàïðèìåð: http://ru.gentoo-wiki.com/wiki/Portage_Overlay. Ïåðåä ñáîðêîé ñàìîãî ïàêåòà OpenSCADA, portage óäîâëåòâîðèò çàâèñèìîñòè, ò.å., ñîáåðåò íåäîñòàþùèå ïàêåòû (åñëè íåîáõîäèìî).

1. Ñîçäàíèå îâåðëåÿ portage ñâîäèòñÿ ê îïèñàíèþ ïóòè äëÿ îâåðëåéíîãî äåðåâà, ò.å., â /etc/make.conf íåîáõîäèìî ïðîïèñàòü ñòðîêó:
   PORTDIR_OVERLAY="/usr/local/portage"
   
2. Ñîçäàòü êàòàëîã /usr/local/portage/dev-util/openscada/, çàòåì ñêà÷àòü ôàéë àðõèâà ebuild c îôèöèàëüíîãî ñàéòà è ðàñïàêîâàòü åãî â ñîçäàííîì êàòàëîãå.
   $ cd /usr/local/portage/dev-util/openscada
   $ wget ftp://ftp.oscada.org/OpenSCADA/0.7.1/Gentoo/openscada-0.7.1.ebuild-010611.tar.gz
   $ tar -xzf openscada-0.7.1.ebuild-010611.tar.gz
   
3. Íåîáõîäèìî óêàçàòü portage, ÷òî OpenSCADA ðàçðåøåíà äëÿ ñáîðêè íà Âàøåé ïëàòôîðìå. Äëÿ ýòîãî íàäî âíåñòè ñëåäóþùóþ ñòðîêó â ôàéë /etc/portage/package.keywords:
   dev-util/openscada
   
4. Ïðîâåðêà:
   $ emerge -vp openscada
These are the packages that would be merged, in order:
Calculating dependencies... done!
[ebuild   R   ~] dev-util/openscada-0.7.1  USE="mysql ssl -bfn -blockcalc -daqgate -dbarch -dbase -dcon -demo -diamondboards -doc (-firebird) -flibcomplex1 -flibmath -flibsys -fsarch -http -icp_das -javalikecalc -logiclev -modbus -portaudio -qtcfg -qtstarter -selfsystem -serial -simens -snmp -sockets -sqlite -system -systemtest -vcaengine -vision -webcfg -webcfgd -webvision" 79,647 kB [1]

Total: 1 package (1 reinstall), Size of downloads: 79,647 kB
Portage tree and overlays:
 [0] /usr/portage
 [1] /usr/local/portage

   
   
5. Åñëè ó Âàc íåò ïîäêëþ÷åíèÿ ê èíòåðíåòó, òî íàäî çàãðóçèòü òàðáîë èñõîäíûõ òåêñòîâ è ðåñóðñîâ ñ ftp-ñåðâåðà ïðîåêòà è ðàñïîëîæèòü èõ çàðàíåå â êàòàëîãå èñõîäíèêîâ portage (/usr/portage/distfiles). Åñëè æå ó Âàñ åñòü ïîäêëþ÷åíèå ê èíòåðíåòó, òî âñå íåîáõîäèìîå äëÿ ñáîðêè áóäåò âçÿòî ñ ñåðâåðà ïðîåêòà àâòîìàòè÷åñêè.
6. Íåîáõîäèìî âûñòàâèòü íóæíûå Âàì USE-ôëàãè, ñ êîòîðûìè áóäåò ñîáðàíà OpenSCADA. Ýòî ìîæíî ñäåëàòü â ôàéëå /etc/portage/package.use, íàïðèìåð:
   dev-util/openscada dcon demo http javalikecalc mysql qtcfg qtstarter ssl vision webcfg webcfgd webvision blockcalc dbarch dbase doc flibcomplex1 flibmath flibsys fsarch logiclev modbus serial sockets sqlite vcaengine
   
7. Íåïîñðåäñòâåííî ñáîðêà:
   $ emerge -q openscada
   
8. Ôàéëû ÁÄ è ðåñóðñîâ OpenSCADA ãîòîâû è áóäóò ðàçìåùåíû â êàòàëîãå /var/spool/openscada/, èñïîëíÿåìûå ôàéëû - /usr/bin/, äîêóìåíòàöèÿ - /usr/share/doc/openscada-0.7.1/.

Links