Chapter 3. Орнату және алғашқы баптаулар

Ревизия VCS: 9b940fe27

Дата сборки документа: 2019.09.09 14:15:21

Table of Contents

Жүйені орнату
Установка системы ARTA SYNERGY при наличии подключения к сети Интернет
Установка системы ARTA SYNERGY без наличия доступа к сетевым репозиториям
Орнатудан кейін
Настройка Jboss и MySQL
Настройка Jboss
Настройка MySQL
Обновление системы ARTA SYNERGY
Об особенностях процедуры обновления до версии 3.15
Об особенностях процедуры обновления 3.5 и выше
Іске қосу және алғашқы баптаулар
Іске қосу
Алғашқы баптаулар
Создание резервной копии
Автоматическое создание резервной копии
Просмотр текущей версии системы
Лицензиялау
Электронная цифровая подпись
Настройка ЭЦП
Правила настройки сервисов для обеспечения безопасности
Некоторые настройки производительности
Отключение пересчёта значений показателей
Настройка интервала коммита в индекс 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 http://deb.arta.kz/tengri hamming main contrib non-free

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

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

Замечания:

  1. Обратите внимание, что помимо основных репозиториев Debian подключен также jessie-backports, что требуется для установки правильной версии nginx

  1. При установке ARTA Synergy на Debian 9 stretch необходимо дополнительно подключить репозитории от Debian 8 jessie.

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

Вариант 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. Необходима 7 версия Java. На 7-й работают JBoss и ARTA Synergy, а также Cassandra.

Установить из подключенных репозиториев
  1. Переходим на официальный сайт, принимаем лицензионное соглашение и скачиваем нужный файл Java (например, jdk-7u80-linux-x64.tar.gz). Для этого требуется наличие учётной записи на сайте Oracle.

  2. Создаём директорию

mkdir /var/cache/oracle-jdk7-installer

и перемещаем в неё скачанный файл.

  1. Так как перед установкой требуется принять лицензионное соглашение Oracle, при необходимости можно сделать его принятие автоматическим (необязательно):

echo oracle-java7-installer shared/accepted-oracle-license-v1-1 select true | sudo /usr/bin/debconf-set-selections
  1. Далее выполняем установку Java 7:

aptitude install oracle-java7-installer

Для того, чтобы проверить, что Java по умолчанию 7-я, выполняем команду:

java -version

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

java version "1.7.0_80"
Java(TM) SE Runtime Environment (build 1.7.0_80-b15)
Java HotSpot(TM) 64-Bit Server VM (build 24.80-b11, mixed mode)

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

update-java-alternatives --list

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

java-6-oracle 65 /usr/lib/jvm/java-6-oracle
java-7-oracle 64 /usr/lib/jvm/java-7-oracle

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

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

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

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

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

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

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

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

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

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

Установка nginx в Debian 8 jessie

Synergy для правильной работы необходим nginx версии 1.3.10 либо новее. Если вы используете Debian 8 jessie, вам необходимо подключить репозиторий backports (см. выше). Для установки nginx из репозитория backports необходимо выполнить команду:

aptitude -t jessie-backports install nginx

Установка 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 7-й версии с сайта Oracle (файл jdk-7u80-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 hamming main contrib non-free

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

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

aptitude update

Установка Java

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

apt-get install java-package

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

make-jpkg jdk-7u80-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>

Пример 2. Переименование схемы jbpm в arta2.

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

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

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

<xa-datasource jndi-name="java:/jbpm" pool-name="jbpm_ds" enabled="true" use-ccm="false">
    <xa-datasource-property name="URL">
        jdbc:mysql://127.0.0.1:3306/arta2?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
jbpmdb=arta2