Chapter 3. Installation and initial set up

Ревизия VCS: 8198

Дата сборки документа: 2017.07.27 15:17:55

Table of Contents

System installation
Установка системы ARTA SYNERGY при наличии подключения к сети Интернет
ARTA SYNERGY installation without access to network repositories
After installation
Настройка Jboss и MySQL
Обновление системы ARTA SYNERGY
Об особенностях процедуры обновления 3.5 и выше
Running and initial set up
Running
Initial setup
Creating backup
Automatic backup creation
Просмотр текущей версии системы
Licenses
Электронная цифровая подпись
Настройка ЭЦП
Service set up security rules

System installation

ARTA SYNERGY system is distributed in the form suitable for installation on original Debian and its derivates. You must keep in mind that the operating system which ARTA SYNERGY will be installed to must have installed all software packages required.

During installation of ARTA SYNERGY many features of Debian packaging system are employed. If you are not familiar with main principles of packaging system working and with notions of Debian package, repository, soft and hard dependencies and others, we kindly request you to read document 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 perlis 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.

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

aptitude update

or

apt-get update

Замечание:

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

Установка Java

Рекомендуется предварительно установить Java. Необходимо 7 версия Java. На 7-й работают JBoss и ARTA Synergy, а также Cassandra.

Установить из подключенных репозиториев

Версией 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 необходимо выполнить команду

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 installation without access to network repositories

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

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

Требования:

  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 perlis main contrib non-free
deb file:///путь/до/каталога/deb.arta.kz/tengri perlis-rc 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

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

  • Password for MySQL server.

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

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

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

After installation

После установки файлы системы будут находиться по адресу /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