Установка пакета 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. Этот объект должен иметь атрибуты, задающие все необходимые кофигурационные параметры (расположение данных, список и настройки приборов, индивидуальные опции экрана и т.п.):
Имя атрибута | Тип значения | Зачем |
---|---|---|
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) могут быть заданы дополнительные параметры:
Ключ | Сокра- щённый ключ | Значение | Примеры |
---|---|---|---|
--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 в объёме, минимально необходимом для старта прораммы 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 предлагает установить ряд устройств, эмулирующих похожую на правду деятельность на компьютере, к которому ничего не подключено. Можно поиграть. Весьма рекомендуется для первого свидания. В последствии ненужные устройства можно легко удалить.