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

Ревизия VCS: 8198

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

Содержание

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

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

Система «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 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

или

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 без наличия доступа к сетевым репозиториям

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

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

Требования:

  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

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

  • Пароль 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