Export translations

Settings

Group
Language
Format	Export for off-line translation Export in native format

{{DISPLAYTITLE:Документи/Як/Скласти з вихідних текстів}}<noinclude>
<languages/>
{{Info|* '''Автор:''' [[User:RomanSavochenko|Роман Савоченко]], [http://oscada.org/en/forum/user/IrmIngeneer/ Константин] }}
</noinclude>
Посібник покликано допомогти у збірці OpenSCADA з вихідних текстів. Протягом накопичення досвіду збірки OpenSCADA на різних дистрибутивах ОС Linux та на інших платформах взагалі, документ буде доповнюватися особливостями та деталями збірки у цих оточеннях.

Попереднього налаштування складеної програми на останніх версіях OpenSCADA не потребується у разі використання при складані пакету з ресурсами "openscada-res" або дерева вихідних текстів з репозиторію SVN, навіть після прямої збірки. Тому одразу після збірки і встановлення програма готова до використання!

[[File:at.png]] Для складання OpenSCADA із вихідних текстів необхідний досвід складання вільного ПЗ, а також базові знання ОС Linux та використаного дистрибутиву Linux. Що дозволить коректно задовольняти залежності та вирішувати можливі проблеми складання.

== Конфігурація OpenSCADA для складання ==
У якості складальної системи проєктом OpenSCADA використовується набір утиліт [http://en.wikipedia.org/wiki/GNU_build_system AutoTools]. Будь якому складанню проєкту під керуванням AutoTools передує стадія конфігурації під оточення ОС, а інколи і формування самої складальної системи. Стадія конфігурації, як і безпосередньо складання, здійснюється завжди та не залежить від того, чи відбувається це пряма збірка або збірка пакету.

Для формування складальної системи мають бути встановлені утиліти AutoTools: '''autoconf''', '''automake''' і '''libtool'''. Загальне формування можна здійснити командою {{InLineCode|autoreconf -if}}. Раніше сформована складальна система інколи може потребувати переформатування, наприклад, у випадку значної відмінності оточення ОС формування і поточного! Переформування складальної системи також здійснюється раніше визначеною командою формування.

Конфігурація складальної системи здійснюється викликом команди {{InLineCode|configure}}. За посередництвом визначення аргументів до цієї команди можна включити-виключити функцію або модуль OpenSCADA. Отримати весь перелік доступних параметрів конфігурації та модулів OpenSCADA можна вказавши аргумент {{InLineCode|configure --help}}.

Включення і виключення модулів OpenSCADA здійснюється передаванням аргументів {{InLineCode|configure --enable-{ModName} }} і {{InLineCode|configure --disable-{ModName} }}. Під час вибору модулів можна вказати політику "Включити всі модулі" — {{InLineCode|configure --enable-AllModuls}} або "Виключить всі модулі" — {{InLineCode|configure --disable-AllModuls}}, і надалі включати-виключати окремі модулі, залежно від того, що буде простіше. Більшість модулів OpenSCADA можна влінковувати (вбудовувати) безпосередньо у бібліотеку ядра OpenSCADA, а не збирати окремою бібліотекою, для чого потрібно вказати аргумент {{InLineCode|<nowiki>configure --enable-{ModName}=incl</nowiki>}}.

Загалом ви можете скласти OpenSCADA у трьох бінарних конфігураціях, оперуючи розташуванням бібліотеки ядра аргументом {{InLineCode|configure --enable-CoreLibStatic}}:
# Стандартно зі спільною бібліотекою ядра '''lib/liboscada.so.4.0.9''', спільними бібліотеками модулів '''lib/openscada/{modTp}_{modNm}.so''' і бінарним файлом запуску '''bin/openscada''' — ефективне на великих системах із запуском багатьох проєктів OpenSCADA і гнучким контролем завантаженням модулів.
# Без спільної бібліотеки ядра, зі спільними бібліотеками модулів '''lib/openscada/{modTp}_{modNm}.so''' і бінарним файлом запуску '''bin/openscada''' зі статично вбудованим кодом бібліотеки ядра — ефективно на системах зі швидким запуском одного або декількох проєктів OpenSCADA і гнучким контролем завантаженням модулів.
# Усе в одному бінарному файлі запуску '''bin/openscada''' шляхом статичного вбудування сюди коду бібліотеки ядра й усіх модулів — ефективно на дуже щільних вбудованих системах для вбудування усіх потрібних функцій до максимально малого одного бінарного файлу.

По успішному завершенню конфігурації буде сформовано зведений результат налаштувань, за допомогою якого можна перевірити основні моменти.

Перед складанням необхідно визначитися з джерелом вихідних текстів, [http://oscada.org/ua/golovna/zavantazhiti/ FTP/HTTP-сервер або SVN-репозиторій], та гілкою OpenSCADA, яку будете складати. Оскільки LTS гілка автоматично складається для багатьох дистрибутивів Linux, рідко оновлюється та її версія міняється з випуском нової LTS, то у цьому посібнику розглянемо збірку робочої гілки (Work) яка, своєю чергою, автоматично складається для обмеженого кола Linux дистрибутивів, часто змінюється та її адреса завжди однакова, якщо не вважати номер ревізії. Збірка LTS гілки як правило здійснюється так само і у інструкції треба "Work" замінити на версію LTS та змінити назву пакету вихідних текстів. Загалом, до назв пакетів та тек треба ставитися уважно, бо вони можуть відрізнятися версія від версії!

== Пряме складання OpenSCADA ==
Складання має здійснюватися від ім'я звичайного користувача, хоча для ізольованих оточень може і від суперкористувача. При цьому будуть розглянуті варіанти встановлення та виконання як глобально — у систему, так і локально — у теку користувача. Приймаємо логін (обліковий запис) користувача за "user".

Входимо у якості звичайного користувача та підмінюємо обліковий запис "user" на ваш, визначаймося зі способом встановлення (глобальний або локальний) та дотримуємося інструкції:

Етапи приготування дерева вихідних текстів до складання:
:1. Створити теку для складання проєкту:
<syntaxhighlight lang="bash" style="margin-left: 40px">
mkdir ~/projects
cd ~/projects
</syntaxhighlight>
:2. Завантажити пакет вихідних текстів. Може бути виконано у два способи:
:* [TAR] завантаження тарболу з FTP/HTTP-сервера проєкту http://ftp.oscada.org/OpenSCADA та розпакування, наприклад так:
<syntaxhighlight lang="bash" style="margin-left: 40px">
wget http://ftp.oscada.org/OpenSCADA/Work/openscada-1+r2920.tar.xz
wget http://ftp.oscada.org/OpenSCADA/Work/openscada-res-1+r2920.tar.xz
tar -xvf openscada-1+r2920.tar.xz
cd openscada-1+r2920
tar -xvf ../openscada-res-1+r2920.tar.xz
</syntaxhighlight>
:* [SVN] отримання дерева вихідних текстів із SVN-репозиторію проєкту:
<syntaxhighlight lang="bash" style="margin-left: 40px">
svn co http://oscada.org/svn/trunk/OpenSCADA/
cd OpenSCADA
</syntaxhighlight>
:3. Задовільнити залежності проєкту OpenSCADA для складання відповідно до [[Special:MyLanguage/Functions_and_demands#Building|вимог]].
:4. [SVN] Генерувати складальну систему при завантажені із SVN-репозиторію:
<syntaxhighlight lang="bash" style="margin-left: 40px">
autoreconf -ivf
</syntaxhighlight>

Етапи глобального складання:
:1. Сконфігурувати складальну систему OpenSCADA:
<syntaxhighlight lang="bash" style="margin-left: 20px">
./configure
</syntaxhighlight>
:2. Скласти OpenSCADA:
<syntaxhighlight lang="bash" style="margin-left: 20px">
make
</syntaxhighlight>
:3. Встановити OpenSCADA:
<syntaxhighlight lang="bash" style="margin-left: 20px">
su    # Вхід до суперкористувача
make install
</syntaxhighlight>
:4. Програма готова до запуску:
<syntaxhighlight lang="bash" style="margin-left: 20px">
exit
openscada
</syntaxhighlight>

Етапи локального складання:
:1. Сконфігурувати складальну систему OpenSCADA:
<syntaxhighlight lang="bash" style="margin-left: 20px">
mkdir ~/OScadaW
./configure --prefix=/home/user/OScadaW
</syntaxhighlight>
:2. Скласти OpenSCADA:
<syntaxhighlight lang="bash" style="margin-left: 20px">
make
</syntaxhighlight>
:3. Встановити OpenSCADA:
<syntaxhighlight lang="bash" style="margin-left: 20px">
make install
</syntaxhighlight>
:4. Програма готова до запуску:
<syntaxhighlight lang="bash" style="margin-left: 20px">
cd ~/OScadaW/bin
./openscada
</syntaxhighlight>

== Складання пакетів OpenSCADA для дистрибутиву Linux ==

=== Засновані на Debian дистрибутиви — пакети DEB ===
Для складання DEB-пакетів OpenSCADA вам знадобляться архіви вихідних текстів та ресурсів.

Складання DEB-пакетів відбувається у теці "debian" із скриптами складання, яка міститься у архівах вихідних текстів OpenSCADA.

Етапи складання:
:1. Створити теку для складання програми:
<syntaxhighlight lang="bash" style="margin-left: 40px">
mkdir ~/build
cd ~/build
</syntaxhighlight>
:2. Завантажити пакети вихідних текстів. Може бути виконано у два способи:
:* [TAR] завантаження тарболу з FTP/HTTP-сервера проєкту http://ftp.oscada.org/OpenSCADA та розпакування, наприклад так:
<syntaxhighlight lang="bash" style="margin-left: 40px">
wget http://ftp.oscada.org/OpenSCADA/Work/openscada-1+r2920.tar.xz
wget http://ftp.oscada.org/OpenSCADA/Work/openscada-res-1+r2920.tar.xz
tar -xvf openscada-1+r2920.tar.xz
cd openscada-1+r2920
tar -xvf ../openscada-res-1+r2920.tar.xz
</syntaxhighlight>
:* [SVN] отримання дерева вихідних текстів із SVN-репозиторію проєкту:
<syntaxhighlight lang="bash" style="margin-left: 40px">
svn co http://oscada.org/svn/trunk/OpenSCADA/
cd OpenSCADA
</syntaxhighlight>
:3. Обрати тип складання:
:* бінарні файли в одному пакеті:
<syntaxhighlight lang="bash" style="margin-left: 40px">
ln -s data/debian debian
</syntaxhighlight>
:* бінарні файли модулів в окремих пакетах:
<syntaxhighlight lang="bash" style="margin-left: 40px">
ln -s data/debian_mod debian
</syntaxhighlight>
:4. Задовільнити залежностей проєкту OpenSCADA для складання відповідно до [[Special:MyLanguage/Functions_and_demands#Building|вимог]]. Аргументи команди "configure" можна вказати у файлі "debian/rules".
:5. Скласти:
:* складання з початку:
<syntaxhighlight lang="bash" style="margin-left: 40px">
dpkg-buildpackage -rfakeroot
</syntaxhighlight>
:* пропустити складання і переупакувати, зручно під час налаштування "debian/rules":
<syntaxhighlight lang="bash" style="margin-left: 40px">
fakeroot debian/rules binary
fakeroot debian/rules build
</syntaxhighlight>
:6. Пакети готові та доступні у теці рівнем вище.

=== Засновані на RedHat дистрибутиви — пакети RPM ===
Для складання RPM-пакетів OpenSCADA вам знадобляться архіви вихідних текстів, ресурсів та файл специфікації RPM пакету ([http://oscada.org/svn/trunk/OpenSCADA/data/ openscada.spec, openscada_mod_ALT.spec, openscada_mod_RH.spec]) або ж SRPM-пакет всіх цих вихідних матеріалів.

Файл специфікації RPM-пакетів і SRPM-пакет можуть відрізнятися для різних дистрибутивів Linux, враховуючи їх особливості, тому необхідно намагатися завантажувати їх у відповідності до дистрибутиву. Якщо спеціальний SRPM пакет відсутній, тоді можна спробувати скласти з уніфікованого файлу специфікації (openscada.spec) у основному SRPM пакеті або пакеті ресурсів.

Складання RPM-пакетів відбувається у каталозі зі спеціальною структурою, який за звичай створюється під час встановлення відповідного пакету дистрибутиву (як "rpm-build"). Цей каталог, залежно від дистрибутиву, розташовується у домашній теці користувача або у теці "/usr/src". Відомі факти розташування каталогу складання RPM-пакетів ''RPMBuildDir'' різних дистрибутивів:
* "~/rpmbuild" — [https://www.redhat.com RedHat], [https://www.centos.org/ CentOS], Mandriva, [http://fedoraproject.org Fedora]
* "/usr/src/packages" — [https://www.opensuse.org/ SuSE]
* "~/RPM" — [http://altlinux.com ALTLinux]

Якщо після встановлення спеціалізованого пакету відсутній каталог RPM пакетів, тоді його необхідно створити командою:
<syntaxhighlight lang="bash">
install -m 755 -d ~/rpmbuild/{SPECS,SOURCES}         # RedHat, CentOS, Mandriva, Fedora
install -m 755 -d /usr/src/packages/{SPECS,SOURCES}  # SuSE
install -m 755 -d ~/RPM/{SPECS,SOURCES}              # ALTLinux
</syntaxhighlight>

Етапи складання за файлом специфікації RPM:
:1. Розташувати архіви OpenSCADA та файл специфікації у каталозі складання RPM (вихідні файли попередньо розташовано у поточній теці):
<syntaxhighlight lang="bash" style="margin-left: 40px">
cp openscada-1+r2920.tar.xz openscada-res-1+r2920.tar.xz {RPMBuildDir}/SOURCES
cp openscada.spec {RPMBuildDir}/SPECS
</syntaxhighlight>
:2. Задовільнити залежності проєкту OpenSCADA для складання відповідно до [[Special:MyLanguage/Functions_and_demands#Building|вимог]]. Аргументи команди "configure" можна вказати у файлі "openscada.spec".
:3. Скласти пакети
:* складання з початку:
<syntaxhighlight lang="bash" style="margin-left: 40px">
rpmbuild -bb {RPMBuildDir}/SPECS/openscada.spec
</syntaxhighlight>
:* лише встановлення і пакування, із пакету rpm-utilities від etersoft (зручно на час налагодження openscada.spec файлу):
<syntaxhighlight lang="bash" style="margin-left: 40px">
rpmbb -i {RPMBuildDir}/SPECS/openscada.spec
</syntaxhighlight>
:4. Пакети готові та доступні у каталозі "{RPMBuildDir}/RPMS" для відповідної архітектури.

Етапи складання із SRPMS пакету:
:1. Задовільнити залежності проєкту OpenSCADA для складання відповідно до [[Special:MyLanguage/Functions_and_demands#Building|вимог]].
:2. Скласти пакети (вихідні файли попередньо розташовано у поточній теці):
<syntaxhighlight lang="bash" style="margin-left: 40px">
rpmbuild --rebuild openscada-1+r2920.src.rpm
</syntaxhighlight>
:3. Пакети готові та доступні у каталозі "{RPMBuildDir}/RPMS" для відповідної архітектури.

=== Gentoo — метадистрибутив ===
OpenSCADA не входить до офіційного дерева "portage Gentoo", тому збірка відбувається з оверлею. Перед збіркою самого пакета OpenSCADA portage задовольнить залежності, тобто, збере потрібні пакети (якщо необхідно).

:1. Створити оверлей "portage" описом шляху для оверлейного дерева, тобто, у "/etc/make.conf" потрібно прописати рядок:
<pre style="margin-left: 40px">
PORTDIR_OVERLAY="/usr/local/portage"
</pre>
:2. Створити каталог "/usr/local/portage/dev-util/openscada/", потім завантажити файл архіву ebuild з офіційного сайту та розпакувати його у створеному каталозі.
<syntaxhighlight lang="bash" style="margin-left: 40px">
cd /usr/local/portage/dev-util/openscada
wget http://ftp.oscada.org/OpenSCADA/LTS/Gentoo/openscada-0.9.4.ebuild.tar.bz2
tar -xvf openscada-0.9.4.ebuild.tar.bz2
</syntaxhighlight>
:3. Необхідно вказати portage, що OpenSCADA дозволена для збірки на Вашій платформі. Для цього необхідно внести наступний рядок до файлу "/etc/portage/package.keywords":
<pre style="margin-left: 40px">
dev-util/openscada
</pre>
:4. Перевірити:
<syntaxhighlight lang="bash" style="margin-left: 40px">
emerge -vp openscada
</syntaxhighlight>
<pre style="margin-left: 50px">
These are the packages that would be merged, in order:
Calculating dependencies... done!
[ebuild   R   ~] dev-util/openscada-0.9  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
</pre>
:5. Якщо у вас відсутнє підключення до Інтернету, тоді необхідно завантажити тарболи вихідних текстів і ресурсів з FTP/HTTP-серверу проєкту та розташувати їх заздалегідь у каталозі вихідних текстів portage "/usr/portage/distfiles". Якщо-ж маєте підключення до Інтернету, то все потрібне для складання буде отримане із сервера проєкту автоматично.
:6. Необхідно виставити потрібні Вам USE-прапорці, з якими буде зібрано OpenSCADA. Це можна здійснити у файлі "/etc/portage/package.use", наприклад:
<pre style="margin-left: 40px; white-space: normal">
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
</pre>
:7. Складання:
<syntaxhighlight lang="bash" style="margin-left: 40px">
emerge -q openscada
</syntaxhighlight>
:8. Файли БД та ресурсів OpenSCADA готові та будуть розташовані у теці "/var/spool/openscada/", виконувані файли — "/usr/bin/", документація — "/usr/share/doc/openscada-0.9/".

=== Легка система керування пакетів — IPKG пакети ===
Областю застосування менеджеру пакетів та пакетів IPKG переважно є вбудовані оточення Linux з обмеженим об'ємом пам'яті на кшталт роутерів бездротових мереж. Відповідно і складання пакетів IPKG є частиною складальних систем таких оточень та опис цієї процедури не можна розглядати окремо від самої складальної системи, тому щодо створенням IPKG пакетів OpenSCADA читайте у розділі "[[Special:MyLanguage/Sub-projects/Embedding_and_PLC#OpenWrt|Дистрибутив OpenWRT]]" підпроєкту "[[Special:MyLanguage/Sub-projects/Embedding_and_PLC|Загальне вбудовування OpenSCADA і програмовані логічні контролери (ПЛК)]]".

=== Складання для Android — APK пакети ===
Операційна система [https://en.wikipedia.org/wiki/Android_(operating_system) Android] є програмним оточенням на основі ядра Linux, яке переважно призначене та використовується на мобільних телефонах, смартфонах, планшетах та іншому обладнані з сенсорним екраном. Стороннє програмне забезпечення для Android розповсюджується у вигляді APK-пакетів, складання якого неможливо розглянути у відриві від складального оточення Android SDK, NDK та складання усіх залежностей OpenSCADA, тому на предмет збірки OpenSCADA та створення її APK-пакетів читайте у підпроєкті "[[Special:MyLanguage/Sub-projects/Adaption_to_Android|Адаптація OpenSCADA до платформи Android]]".

Export translations

Views

Navigation menu

OpenSCADA

OpenSCADA Wiki

Search

Tools

MediaWiki

Personal tools