Подключение дополнительных модулей к «Форсайт. Аналитическая платформа»

Для интеграции с Python на OC Linux предварительно необходимо произвести сборку исходных файлов Python.

Сборка Python из исходных файлов на OC Linux

Рассмотрим пример сборки исходных файлов Python версии 3.6.9 на OC Astra Linux CE.

Выполните действия:

1. Скачайте архив с исходными файлами Python версии 3.6.9:

wget https://www.python.org/ftp/python/3.6.9/Python-3.6.9.tgz

2. Распакуйте файл из архива:

tar xvf Python-3.6.9.tgz
cd Python-3.6.9

3. Добавьте в файл configure, поставляемый вместе с исходными файлами Python, параметры --enable-shared для генерации динамической библиотеки, которую использует платформа, и --prefix с указанием места установки Python:

./configure --enable-shared --prefix=/opt/python

4. Выполните компиляцию исходного кода Python, используя altinstall:

sudo make altinstall

Примечание. Команда make altinstall используется для предотвращения замены бинарного файла Python, который по умолчанию находится по пути S/usr/bin/python, где S - путь до папки установки Python.

Результат компиляции должен быть примерно следующим:

Collecting setuptools
Collecting pip
Installing collected packages: setuptools, pip
Successfully installed pip-18.1 setuptools-40.6.2

Интеграция с Python на OC Linux

Рассмотрим пример интеграции Python версии 3.6.9 на OC Astra Linux CE. Убедитесь, что предварительно была произведена сборка исходных файлов Python.

Для интеграции с Python на OC Astra Linux CE:

1. Проверьте, что сборка исходных файлов прошла успешно и была установлена новая версия Python.

Если версия в системе по умолчанию не была переписана, то проверьте текущую версию Python с помощью команды:

python3.6 --version

2. Выполните одно из действий, если команда не была найдена:

• добавьте путь к папке с установленным Python в системной переменной Path:

echo export PATH=$PATH:/opt/python/bin >> ~/.bashrc
source ~/.bashrc

• укажите путь до местоположения библиотеки Python libpython3.*m.so, которая была создана с помощью параметра --enable-shared в шаге 3:

echo export LD_LIBRARY_PATH="/opt/python/lib:$LD_LIBRARY_PATH" >> ~/.bashrc
source ~/.bashrc

При первом использовании Python платформа будет искать библиотеку из списка:

libpython3.9.so, libpython3.8.so, libpython3.7m.so, libpython3.6m.so, libpython3.5m.so

Платформа будет использовать первую найденную библиотеку до перезапуска. Перезапустите BI-сервер:

sudo systemctl restart apache2-fp10.x

Для интеграции с Python на OC Windows:

1. Загрузите дистрибутив Python.

2. Установите Python на тот же компьютер, на котором установлено настольное приложение «Форсайт. Аналитическая платформа». Если Python планируется использовать и в веб-приложении, то установите Python на компьютер, на котором расположен BI-сервер.

• При установке включите флажок «Add Python <Version> to PATH» для добавления пути к папке с установленным Python в системной переменной Path.

Если Python устанавливается с помощью какого-либо пакета, например Anaconda, то во время установки также необходимо включить флажок «Add...to PATH». Таким образом, будет выполнена интеграция продукта «Форсайт. Аналитическая платформа» с Python. Все выполняемые скрипты должны находиться в папке «Форсайт. Аналитическая платформа».

Для указания дополнительной папки со скриптами:

• создайте в реестре строковый параметр PythonPath и задайте в нём необходимый путь до дополнительной папки со скриптами. Параметр создается в ветке реестра [HKEY_CURRENT_USER\SOFTWARE\Foresight\Foresight Analytics Platform\10.0\DevEnv\Python];

• используйте метод IPythonUtils.AddFolderToPythonPath.

Установка Java в ОС Linux

Если язык Java уже установлен в среде Linux, то следующие пункты 1-8 можно пропустить. Для установки языка Java:

1. В терминале выполните команды:

sudo mkdir /usr/lib/jvm
cd /usr/lib/jvm

2. Скачайте .gz пакет по адресу https://www.oracle.com/java/technologies/downloads/#java8.

3. Выполните команду:

sudo tar -xvzf ~/Downloads/jdk-8u<Ver>-linux-x64.tar.gz

Примечание. Путь до .gz-файла может отличаться. Укажите тот путь, куда был сохранён пакет.

4. Откройте на редактирование файл с переменными:

sudo gedit /etc/environment

5. Добавьте в конец файла строки:

J2SDKDIR="/usr/lib/jvm/jdk1.8.0_<Ver>"

J2REDIR="/usr/lib/jvm/jdk1.8.0_<Ver>/jre"

JAVA_HOME="/usr/lib/jvm/jdk1.8.0_<Ver>"

DERBY_HOME="/usr/lib/jvm/jdk1.8.0_<Ver>/db"

6. Если в файле отсутствует переменная PATH, то добавьте следующее значение:

PATH="/usr/lib/jvm/jdk1.8.0_<Ver>/bin:/usr/lib/jvm/jdk1.8.0_<Ver>/db/bin:/usr/lib/jvm/jdk1.8.0_<Ver>/jre/bin:$PATH"

Если переменная имеется, то добавьте в список значение:

/usr/local/games:/usr/lib/jvm/jdk1.8.0_<Ver>/bin:/usr/lib/jvm/jdk1.8.0_<Ver>/db/bin:/usr/lib/jvm/jdk1.8.0_<Ver>/jre/bin

7. Выполните в терминале:

sudo update-alternatives --install "/usr/bin/java" "java" "/usr/lib/jvm/jdk1.8.0_<Ver>/bin/java" 0

sudo update-alternatives --install "/usr/bin/javac" "javac" "/usr/lib/jvm/jdk1.8.0_<Ver>/bin/javac" 0

sudo update-alternatives --set java /usr/lib/jvm/jdk1.8.0_<Ver>/bin/java

sudo update-alternatives --set javac /usr/lib/jvm/jdk1.8.0_<Ver>/bin/javac

8. Перезапустите терминал. Для проверки установленной версии выполните команду:

java -version

Интеграция с Java на OC Linux

1. Добавьте символьную ссылку:

sudo ln -s /usr/lib/jvm/jdk1.8.0_<Ver>/jre/lib/amd64/server/libjvm.so /opt/foresight/fp10.x-biserver/bin/libjvm.so

2. В ОС Windows в ветке реестра [HKEY_CURRENT_USER\SOFTWARE\Foresight\Foresight Analytics Platform\10.0\DevEnv\Java] создайте подраздел «Java», в котором добавьте строковый параметр Options. Данный параметр будет использоваться для указания дополнительных опций, используемых при создании и работе Java-машины. Значения в параметре Options указываются через запятую. Сохраните настройки в файл с расширением *.reg в папку /opt/foresight/fp10.x-biserver/bin/registry.

3. Откройте полученный *.reg файл на редактирование в среде Linux и задайте значение для параметра Options:

"Options"="-Djava.home=/usr/lib/jvm/jdk1.8.0_<Ver>/jre"

4. Если во время работы будет возникать ошибка «Проверьте значение CLASSPATH», то добавьте через запятую в параметр Options значение «-Dfile.encoding=UTF-8».

5. Дополнительно в Options могут быть указаны пути до файлов с пользовательскими классами (архивов с пользовательскими классами). Пути между собой разделяются двоеточием, например, «-Djava.class.path=/opt/foresight/fp10.x-biserver/:/usr/local».

Примечание. В указанных выше командах <Ver> - версия языка Java.

Для интеграции с языком Java установите на компьютере соответствующее программное обеспечение:

• Java SE Runtime Environment (JRE);

• Java SE Development Kit (JDK).

Примечание. Версии устанавливаемого программного обеспечения Java должны быть 8 или выше. Разрядность Java и «Форсайт. Аналитическая платформа» должна совпадать.

После установки выполните настройки:

1. В системную переменную Path добавьте путь до библиотеки jvm.dll в папке установки JRE (например, c:\Program Files\Java\jre1.8.0_<Ver>\bin\server\).

2. В ветке реестра [HKEY_CURRENT_USER\SOFTWARE\Foresight\Foresight Analytics Platform\10.0\DevEnv] создайте подраздел «Java», в котором добавьте строковый параметр Options. Данный параметр будет использоваться для указания дополнительных опций, используемых при создании и работе Java-машины. Значения в параметре Options указываются через запятую.

3. Задайте в Options путь до установленного JDK (указывается путь до подкаталога jre в папке установки JDK), например, «-Djava.home=c:/Program Files/Java/jdk1.8.0_<Ver>/jre/»;

4. Дополнительно в Options могут быть указаны пути до файлов с пользовательскими классами (архивов с пользовательскими классами). Пути между собой разделяются точкой с запятой, например, «-Djava.class.path=d:/Work/Java/;D:/Test/».

Для получения подробной информации о создании Java-модулей, в которых будут храниться коды модулей на языке Java, обратитесь к разделу «Создание Java-модулей».

Примечание. В указанных выше командах <Ver> - версия языка Java.

Для установки R на Astra Linux:

1. Настройте прокси-сервер для командной оболочки Bash.

2. Настройте прокси-сервер для программы Apt-Get, предназначенной для установки, обновления и удаления программных пакетов на Debian-подобных дистрибутивах ОС Linux.

3. Подключитесь к внешнему репозиторию Debian для скачивания файлов R. Для этого откройте на редактирование файл /etc/apt/sources.list и добавьте в него команду:

deb http://ftp.ru.debian.org/debian/ stretch main

4. Проверьте подписи пакетов из репозитория. Для этого скачайте ключ GPG для репозитория Debian и установите его с помощью команды:

sudo apt-key add <файл ключа>

5. Обновите списки пакетов в подключённом репозитории с помощью команды:

sudo apt-get update

6. Установите R с помощью команды:

sudo apt-get install r-base

Примечание. Для получения подробной информации об установке R обратитесь к документации к R.

7. Установите пакет Rserve для взаимодействия продукта «Форсайт. Аналитическая платформа» с R с помощью команды:

sudo apt-get install r-cran-rserve

Примечание. Для получения подробной информации об установке пакета Rserve обратитесь к документации к Rserve.

8. Запустите R.

9. Подключите пакет Rserve с помощью команды:

library(Rserve)

10. Запустите пакет Rserve с помощью команды:

Rserve()

11. Установите требуемые пакеты R с помощью команды:

install.packages("<наименование пакета>")

Список требуемых пакетов представлен в разделе «Какие методы в «Форсайт. Аналитическая платформа» можно рассчитать с помощью R?».

12. Зарегистрируйте пакет Rserve в качестве службы:

Примечание. Регистрация пакета Rserve в качестве службы необязательна, но рекомендуется для автоматического запуска R при запуске продукта «Форсайт. Аналитическая платформа».

После выполнения действий R будет установлен на Astra Linux.

Для установки R на ОС Windows:

1. Загрузите инсталлятор R.

2. Установите R.

Примечание. Для получения подробной информации об установке R обратитесь к документации к R.

3. Добавьте в системную переменную Path путь до папки «S\bin», где S - это папка установки R.

4. Запустите R и установите пакет RServe для взаимодействия продукта «Форсайт. Аналитическая платформа» с пакетом R с помощью команды:

install.packages("RServe");

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

Примечание. Для получения подробной информации об установке пакета RServe обратитесь к документации к RServe.

5. Скопируйте файлы Rserve.dll, Rserve.exe, Rserve_d.exe:

• для 32-разрядных систем: из «S\library\Rserve\libs\i386» в «S\bin\i386»;

• для 64-разрядных систем: из «S\library\Rserve\libs\x64» в «S\bin\x64»;

где S - это папка установки R.

6. Выполните команду в главном меню «Пакеты > Установить пакет(ы)» и установите требуемые пакеты R. Если пакеты уже загружены на компьютер, то для их установки выполните команду в главном меню «Пакеты > Установить пакет(ы) из локальных файлов». Подробная информация о пакетах, требуемых для расчёта методов R, приведена в разделе: «Какие методы в «Форсайт. Аналитическая платформа» можно рассчитать с помощью R?».

После выполнения действий R будет установлен на ОС Windows.

Для указания пути к библиотеке liblpsolve55.so cоздайте файл lpsolve55.reg в папке установки продукта «Форсайт. Аналитическая платформа» с содержимым:

Windows Registry Editor Version 5.00
[HKEY_CURRENT_USER\SOFTWARE\Foresight\Foresight Analytics Platform\10.0\StatCore]
"LPSolvePath"="/<путь до месторасположения файла>/liblpsolve55.so"

После выполнения действий будет указан путь к библиотеке liblpsolve55.so.

Для указания пути к библиотеке lpsolve55.dll:

1. Выполните команду «Сервис > Параметры» в главном меню:

• навигатора объектов в настольном приложении;

• инструмента «Анализ временных рядов» в настольном приложении.

2. Перейдите на вкладку «Подключаемые модули» и укажите путь к библиотеке. Например:

3. Нажмите кнопку «ОК».

После выполнения действий будет указан путь к библиотеке lpsolve55.dll.

Для расчёта контрольной суммы библиотеки liblpsolve55.so в ОС Linux можно использовать OpenSSL:

openssl dgst -engine gost -md_gost12_256 <полный путь до библиотеки>

При использовании OpenSSL убедитесь, что установлена библиотека для шифрования по алгоритму ГОСТ Р 34.11-2012.

Для расчёта контрольной суммы библиотеки lpsolve55.dll в ОС Windows можно использовать утилиту cpverify.exe от КриптоПро:

cpverify.exe -mk -alg GR3411_2012_256 <полный путь до библиотеки>