Установка программы и создание сети RANet

Установка пакета RA

Запуск программы RA

Если данные (сеть RANet) и запускалка были созданы инсталятором, то этот параграф можно пропустить.

Программа RA хранит все необходимые для её работы настройки в той же сети, что и данные. При запуске ей необходимо указать объект, который она будет считать корнем сети. Адрес этого объекта задается опцией --root=RANetURL (или -r=RANetURL), где RANetURL ‐ адрес раздела сети, записываемый в формате специализированного URL (см. описание формата RANetURL). Примеры командной строки:

RA --root=/home/andrew/MySetup.RANet.sqlite
RA -r=/home/andrew/AnotherSetup.RANet.sqlite
RA -r="E:\Пупкин\Васины спектры\desk1.RANet.sqlite"
RA -r=sqlite:/home/andrew/MySetup.RANet.sqlite 
RA -r=sqlite:../_data/MySetup.RANet.sqlite 
RA -r=mysql://rauser:123@127.0.0.1:3306?ranet;andrew

Корень указанного раздела на время сессии работы с программой RA будет считаться корнем сети RANet. Этот объект должен иметь атрибуты, задающие все необходимые кофигурационные параметры (расположение данных, список и настройки приборов, индивидуальные опции экрана и т.п.):

Атрибуты рабочего стола (desk)
Имя атрибутаТип значенияЗачем
Desktopпапка
Dataпапка
Pluginsпапка
Devicesпапка
Font Familyтекст
Font Sizeцелое
Stylesпапка
Basic Line Color Setспециальный (sColorSetNode)
Custom Colorsспециальный (sColorSetNode)
Languageтекст
Unit Systemпапка
Record Numbering Dataпапка
Record Historyпапка
Records To Browseпапка
Samplesпапка
Topicsпапка
CSV Export Settingsпапка
CSV Import Settingsпапка
SOS Import Settingsпапка

Из вышесказанного следует, что программа RA, предназначенная для расширения и модификации сети RANet, нуждается в том, чтобы на момент её запуска эта сеть уже существовала, хотя бы в неком элементарном виде. Это может быть сделано инсталлятором во время установки программы или позднее. Кроме того, в пакет входит программа RAdmin, преднаначенная для низкоуровневых манипуляций с сетью (создания сложных, многопользовательских и распределённых архитектур, миграции, архивирования, лечения и т.п.)

В строке запуска RA (а также RAdmin) могут быть заданы дополнительные параметры:

Опции запуска, общие для RA и RAdmin
КлючСокра-
щённый
ключ
ЗначениеПримеры
--workdir -wd Рабочий каталог
--workdir=/home/vik/RAData
-wd="/home/vik/Data for RA"
-wd=D:/RAData
-wd="E:\Пупкин\Васины спектры"
--logfile -lf Имя лог-файла, т.е. файла для вывода трассировочной информации о работе программы. Можно с абсолютным путём или с путём, относительно рабочего каталога. Умолчательное значение "log.txt". Если трассировка не нужна, то следует задать -lf="" или просто -lf= (пробел или конец строки после знака равенства).
--console -c Вывод трассировки на консоль. По умолчанию, трассировка на консоль выводится, только если программа скомпилирована в режиме Debug.
--admin нет Запуск RA в режиме администратора

Создание сети RANet при помощи программы RAdmin

Для создания сети RANet в объёме, минимально необходимом для старта прораммы RA, используется программа RAdmin. Кстати, инсталлятор, если его попросить установить базу данных, делает это тоже через RAdmin, вызывая её со специальной опцией:

                          для Linux:
/path/to/installation/folder/bin/RAdmin -wd="/path/to/data/folder" -j="CN|first.RANet.sqlite|INSTALL"
                          для Windows:
\path\to\installation\folder\bin\RAdmin.exe -wd="/path/to/data/folder" -j="CN|first.RANet.sqlite|INSTALL"

Если Вы не попросили об этом при инсталляции, можно запустить такую команду из оболочки ОС. Она создаст файл first.RANet.sqlite, представляющий собой базу данных в формате SQLite, и разместит в ней объект, необходимый для запуска RA. Теперь можно запустить RA командой:

                          для Linux:
/path/to/installation/folder/bin/RA -wd="/path/to/data/folder" -r=first.RANet.sqlite
                          для Windows:
\path\to\installation\folder\bin\RA.exe -wd="/path/to/data/folder" -r=first.RANet.sqlite

или создать запускалку (Windows program-shortcut, Ubuntu .desktop-file) с соответствующими параметрами и запускать RA через меню ОС.

Другой вариант – запустить RAdmin без параметров (или только с параметром -wd) и сделать то же самое в диалоге через меню:
File → New
Install → Install everything here

В окне навигатора RAdmin появится структура созданной сети RANet. Её можно посмотреть, выйти из RAdmin и запустить RA, как описано выше.

Подробнее о работе с RAdmin см. в соответствующем разделе.

Установка плагинов

Вся полезная функциональность RA заключена в установленных плагинах. Во-первых, это драйверы различных устройств. Во-вторых, это консоли, позволяющие использовать ряд приборов в соответствии с определённой методикой и получать данные, например, спектры. И наконец, это различные вычислительные и вспомогательные инструменты.

Некий набор плагинов обычно включён в дистрибутив вместе с ядром RA и инсталлятор даёт возможность выбрать, какие из них инсталлировать. Часть плагинов распространяются в отдельных дистрибутивах, не включающих в себя ядро программы. Их имена начинаются с RA-PS- и их нужно запустить после установки основного дистрибутива, указав тот же каталог для инсталляции.

Программа RA при запуске обнаруживает все инсталлированные плагины и сразу использует всю привнесённую ими функциональность, однако некоторые плагины при первом старте спрашивают:

Дело в том, что автоматически плагином привносится лишь потенциальная возможность работы с устройством определённого типа – устанавливается драйвер (например, драйвер магнетометра LakeShore Model 475 DSP Gaussmeter), но это не сообщает программе о реальном наличии в Вашей установке такого прибора, подключённого к компьютеру через такой-то COM-порт (их может не быть или быть несколько).

То же касается и консолей. Поэтому, если на все вопросы вышеприведённого диалога ответить нет, то при первом старте программы готовых к использованию инструментов не будет. Их надо будет создать, настроить и связать друг с другом, как описано в разделе Приборы (Instruments).

Некоторые плагины, однако, прелагают сразу сформировать некий набор взаимосвязанных и настроенных устройств. Если это плагин, написанный специально для Вашей установки, имеет смысл согласится. Весьма вероятно, что всё сразу заработает, или потребуются лишь незначительные изменения настроек (номер порта, например, исправить).

Плагин DemoDevices предлагает установить ряд устройств, эмулирующих похожую на правду деятельность на компьютере, к которому ничего не подключено. Можно поиграть. Весьма рекомендуется для первого свидания. В последствии ненужные устройства можно легко удалить.

Установка обновлений