Глава 3. Установка и первоначальная настройка

Ревизия VCS: 41c0f270e

Дата сборки документа: 2021.04.08 09:20:50

Содержание

Установка системы
Установка системы ARTA SYNERGY при наличии подключения к сети Интернет
Установка системы ARTA SYNERGY без наличия доступа к сетевым репозиториям
После установки
Настройка Jboss и MySQL
Настройка Jboss
Настройка MySQL
Обновление системы ARTA SYNERGY
Об особенностях процедуры обновления до версии 3.15
Об особенностях процедуры обновления 3.5 и выше
Запуск и первоначальная настройка
Запуск
Первоначальная настройка
Создание резервной копии
Автоматическое создание резервной копии
Настройка кластера Elasticsearch + Cassandra
MySQL
Elasticsearch
Cassandra
Перенос платформы Arta Synergy на другой сервер
Просмотр текущей версии системы
Лицензирование
Электронная цифровая подпись
Настройка ЭЦП
Правила настройки сервисов для обеспечения безопасности
Некоторые настройки производительности
Отключение пересчёта значений показателей
Настройка интервала коммита в индекс Lucene
Ограничение wildcard-поиска по индексу
Настройка максимальной длины текста для точного совпадения

Установка системы

Система «ARTA SYNERGY» распространяется в виде, пригодном для установки на оригинальный Debian, и на производные от Debian системы с той оговоркой, что необходимые для установки программные пакеты присутствовали в той операционной системе, куда требуется установить SYNERGY.

При установке ARTA SYNERGY задействуются многие возможности пакетной системы Debian. Если вы незнакомы с основными принципами работы пакетной системы, понятиями «пакет Debian», «репозиторий», «мягкие» и «жёсткие» зависимости и другими, настоятельно рекомендуем ознакомиться с документом Debian Reference.

Установка системы ARTA SYNERGY при наличии подключения к сети Интернет

Предварительные замечания

При выполнении установки предполагается наличие прав суперпользователя. Все описанные команды выполняются в терминале.

Для установки пакетов используется утилита apt-get или утилита aptitude с ключом install. Т.е. выполнение команды

apt-get install название_пакета

и команды

aptitude install название_пакета

эквивалентно.

Подключение репозиториев

Для корректной установки нужно подключить репозитории ARTA Synergy к репозиториям с Вашего IP-адреса. Для этого необходимо добавить в файл /etc/apt/sources.list следующую строку:

deb [allow-insecure=yes] http://deb.arta.kz/tengri minsky main contrib non-free

Кроме того, убедитесь, что репозитории вашей версии дистрибутива подключены. Например, для Debian 9 stretch:

deb http://httpredir.debian.org/debian stretch main contrib non-free
deb http://security.debian.org stretch/updates main contrib non-free
deb http://httpredir.debian.org/debian stretch-updates main contrib non-free
deb http://httpredir.debian.org/debian stretch-backports main contrib non-free

При установке версии ARTA Synergy 3.15 и выше необходимо дополнительно подключить репозитории СУБД Percona (для выполнения следующих шагов требуются пакеты lsb и dirmngr):

Вариант 1: официальные репозитории Percona: в терминале выполнить команды:

# wget https://repo.percona.com/apt/percona-release_0.1-4.$(lsb_release -sc)_all.deb
# dpkg -i percona-release_0.1-4.$(lsb_release -sc)_all.deb

Предварительно необходимо проверить, что установлен пакет lsb: # aptitude install lsb

Вариант 2: зеркало репозитория Percona: в файл /etc/apt/sources добавить строку:

deb http://deb.arta.kz/percona $debian_release main

Вместо $debian_release необходимо добавить используемую версию Debian. Узнать название используемой версии можно с помощью команды # lsb_release -sc.

Далее необходимо обновить ключ, который использует Percona для подписи репозиториев:

# apt-key adv --keyserver keys.gnupg.net --recv-keys 8507EFA5

Далее необходимо обновить список пакетов:

aptitude update

или

apt-get update

Замечание:

Рекомендуется отключить ссылки на CD-ROM в sources.list.

Установка Java

Рекомендуется предварительно установить Java. Необходима 8 версия Java. Для того, чтобы проверить, что Java по умолчанию 8-я, выполняем команду:

java -version

Вывод должен быть таким:

java version "1.8.0_131"
Java(TM) SE Runtime Environment (build 1.8.0_131-b11)
Java HotSpot(TM) 64-Bit Server VM (build 25.131-b11, mixed mode)

Если Java по умолчанию получила другую версию, выводим список установленных версий, выполнив команду:

update-java-alternatives --list

Список установленных версий будет выведен в следующем виде:

java-1.8.0-openjdk-amd64       1081       /usr/lib/jvm/java-1.8.0-openjdk-amd64
java-7-oracle                  1082       /usr/lib/jvm/java-7-oracle
java-8-oracle                  1081       /usr/lib/jvm/java-8-oracle

Переключим версию на нужную, выполнив команду:

update-java-alternatives --set java-8-oracle
Установить из скачанного ранее архива

В случае, если имеются необходимые архивы с сайта Oracle, можно превратить их в пакеты Debian с помощью утилиты java-package.

Переходим в терминале в каталог, в котором лежит архив и выполняем команду

make-jpkg `полное_название_архива`

вставив имя файла архива.

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

dpkg -i название_пакета.deb

При этом также необходимо удостовериться в том, что версией Java по умолчанию является 8-я.

В ходе установки Java необходимо принять несвободную лицензию.

Установка Synergy с поддержкой хранилища Jackrabbit

Замечание:

В случае установки Synergy версии 3.15 и выше рекомендуем ознакомиться с особенностями установки СУБД, приведенными в разделе Об особенностях процедуры обновления до версии 3.15.

Для установки системы Synergy необходимо выполнить команду

aptitude install arta-synergy-synergy

вместо описанной выше.

Замечание:

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

По ходу выполнения установки нужно задать параметры, которые запросит система. В их число входит:

  • Пароль MySQL Server

    По умолчанию предполагается, что Вы выберете пароль для пользователя root равным root для доступа к СУБД MySQL. Если Вы выберете другой пароль, то необходимо будет произвести редактирование некоторых конфигурационных файлов.

  • Запрос на конфигурирование параметров nginx

    Использование nginx крайне рекомендуется для production-инсталляций. Если у вас не имеется dns-имени для сервера, на который устанавливается ARTA Synergy, то можно указать в соответствующей опции ip-адрес сервера.

Установка Synergy с поддержкой хранилища Cassandra

Установка чистой системы

Для установки чистой системы с поддержкой хранилища в Cassandra необходимо установить одновременно пакеты arta-synergy-synergy и arta-synergy-jcr4c. Для этого выполним команду:

aptitude install arta-synergy-synergy arta-synergy-jcr4c

Замечание:

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

По ходу выполнения установки нужно задать параметры, которые запросит система. В их число входит:

  • Пароль MySQL Server

    По умолчанию предполагается, что Вы выберете пароль для пользователя root равным root для доступа к СУБД MySQL. Если Вы выберете другой записаны пароль, то необходимо будет произвести редактирование некоторых конфигурационных файлов.

  • Запрос на конфигурирование параметров nginx

    Использование nginx крайне рекомендуется для production-инсталляций. Если у вас не имеется dns-имени для сервера, на который устанавливается ARTA Synergy, то можно указать в соответствующей опции ip-адрес сервера.

Установка хранилища Cassandra вместо хранилища JCR

Установка системы ARTA SYNERGY без наличия доступа к сетевым репозиториям

Предварительные замечания

При выполнении установки предполагается наличие прав суперпользователя. Все описанные команды выполняются в терминале.

Требования:

  1. Наличие установочных дисков Debian с сайта debian.org: они должны быть добавлены в список установки ПО при помощи apt-cdrom

  2. Наличие архива Java 8-й версии с сайта Oracle (файл jdk-8u221-linux-x64.tar.gz, который можно загрузить по следующей ссылке

  3. Наличие зеркала репозитория deb.arta.kz с сохраненной структурой репозитория. Получить его можно при помощи программ - менеджеров закачек, например wget, HTTrack или других

Пример получения зеркала репозитория с помощью wget

wget -c -t 0 -m -np -k http://deb.arta.kz/tengri/

После выполнения этой команды в каталоге deb.arta.kz будет находится зеркало репозитория

Скачиваем архив Java и зеркало репозитория в удобные каталоги на машину без доступа к сети.

Настройка репозиториев

Необходимо добавить пути до скачанного зеркала репозитория, добавив в файл /etc/apt/sources.list следующие строки:

deb file:///путь/до/каталога/deb.arta.kz/tengri minsky main contrib non-free

где /путь/до/каталога/ необходимо заменить на фактический путь, по которому находится скачанное зеркало репозитория.

Далее для обновления списка пакетов выполняем команду:

aptitude update

Установка Java

Для установки Java воспользуемся утилитой java-package, предварительно установив ее командой:

apt-get install java-package

Далее выполняем в директории с архивом Java команду:

make-jpkg jdk-8u131-linux-x64.tar.gz

которая создаст deb-пакет. Устанавливаем созданный deb-пакет с помощью dpkg:

dpkg -i название_пакета.deb

Установка Synergy

Для установки Synergy необходимо выполнить команду:

aptitude install arta-synergy-synergy

По ходу выполнения установки нужно задать параметры, которые запросит система. В их число входит:

  • Пароль MySQL Server.

    По умолчанию предполагается, что Вы выберете пароль для пользователя root равным root для доступа к СУБД MySQL. Если Вы выберете другой пароль, то необходимо произвести редактирование некоторых конфигурационных файлов.

  • Запрос на конфигурирование параметров nginx.

    Следует отказаться от настройки.

После установки

После установки файлы системы будут находиться по адресу /opt/synergy. Внутренняя структура каталогов такова:

  • jboss/ — сервер приложений с установленной ARTA SYNERGY

  • db/ — файлы, содержащие «чистые» снимки необходимых БД, а также резервные копии БД, создаваемые при каждом обновлении системы

  • index/ — файлы поискового индекса

  • tmp/ — временные файлы, создаваемые в процессе работы системы

  • utils/ — различные утилиты для обслуживания ARTA SYNERGY

Для переименования схем БД synergy и/или jbpm необходимо:

  • в конфигурационном файле .../jboss/standalone/configuration/standalone-onesynergy.xml в секции datasource внутри URL’ов прописать новые имена (см. примеры ниже);

  • дополнительно только для схемы jbpm в конфигурационном файле .../jboss/standalone/configuration/arta/management/db.properties добавить новую строку:

    jbpmdb=ПЕРЕИМЕНОВАННОЕ_НАЗВАНИЕ

Пример 1. Переименование схемы synergy в arta1.

Исходное состояние секции datasource в standalone-onesynergy.xml

<datasource jta="false" jndi-name="java:/AMDS" pool-name="AMDS" enabled="true" use-java-context="true">
    <connection-url>jdbc:mysql://127.0.0.1:3306/synergy?useUnicode=true&amp;characterEncoding=utf8</connection-url>
    ...
</datasource>

...

<xa-datasource jndi-name="java:/SynergyDS" pool-name="synergy_ds" enabled="true" use-ccm="false">
    <xa-datasource-property name="URL">
    jdbc:mysql://127.0.0.1:3306/synergy?useUnicode=true&amp;characterEncoding=utf8
</xa-datasource-property>

необходимо изменить на:

<datasource jta="false" jndi-name="java:/AMDS" pool-name="AMDS" enabled="true" use-java-context="true">
    <connection-url>jdbc:mysql://127.0.0.1:3306/arta1?useUnicode=true&amp;characterEncoding=utf8</connection-url>
    ...
</datasource>

...

<xa-datasource jndi-name="java:/SynergyDS" pool-name="synergy_ds" enabled="true" use-ccm="false">
    <xa-datasource-property name="URL">
        jdbc:mysql://127.0.0.1:3306/arta1?useUnicode=true&amp;characterEncoding=utf8
    </xa-datasource-property>

А также в db.properties добавить новую строку и получить:

host=localhost
port=3306
user=root
pass=root
http_port=8080
#image_cache=true
#script_cache=true