Глава 2. Установка.
Пред. |  | След.

# Глава 2. Установка.

1. Этот шаг относится только к версии для `ArcaOS` (`OS/2`). Установите необходимые пакеты: `libc`, `libgcc1`, `libxml2`, `openssl`, `icu` и `sqlite` (последний, если планируется использовать проверку на спам или адресную книгу). Это можно выполнить одной командой:

       >yum install libc libgcc1 libxml2 openssl icu sqlite

2. Распакуйте архив сервера Manjary в любое удобное место на локальном диске, например `C:\` или `C:\Program Files`. В выбранном каталоге будет создана поддиректория `Manjary`.

3. Скопируйте начальную конфигурацию (все файлы .xml) из поддиректории `examples\full` в директорию установки, где находится исполняемый файл `manjary.exe`. При необходимости в конфигурацию могут быть внесены изменения, см. раздел Конфигурация.

4. Этот шаг относится только к версии для `ArcaOS` (`OS/2`). Если необходима миграция с сервера Weasel, выполните её.

5. Запустите исполняемый файл `manjary.exe` и переходите в интерфейс управления по адресу `http://localhost:81/management/` , где 81 - порт назначенный в конфигурации модуля HTTP.

По-умолчанию, имя пользователя с правами администратора - `postmaster`, пароль, если не использовалась миграция с Weasel - `ChangeMe`. Первым шагом необходимо изменить данный пароль в WEB-интерфейсе. Корректно завершить работу сервера можно выполнив `manjary.exe -k stop`. Если во время работы сервера в конфигурацию были внесены изменения, необходимо сообщить серверу о том что конфигурация должна быть перечитана: `manjary.exe -k reconfig`. В случае ошибок конфигурация не будет использована и в лог-файле появятся соответствующие замечания.

## Файл конфигурации.

Конфигурация читается из файла `manjary.xml` который находится в директории исполняемого файла. Это поведение можно изменить указав при запуске альтернативные путь и имя файла: `manjary.exe -c <полное имя файла>`. Архив уже содержит предварительно сформированные XML-файлы конфигурации в поддиректории `examples\full`. Для удобства конфигурации большинства модулей вынесены в отдельные файлы подключаемые к главному файлу с использованием стандартного механизма XInclude. Если сервер Manjary был только что установлен, скопируйте файлы *.xml из директории `examples\full` на уровень, где находится исполняемый файл `manjary.exe`. Либо, для быстрого знакомства можно использовать пример упрощённой конфигурации в одном файле `examples\simplest\manjary.xml`, скопируйте его в каталог где находится исполняемый файл `manjary.exe`

После внесения изменений в конфигурационный файл во время работы сервера конфигурация может быть обновлена без остановки и повторного запуска, для этого необходимо выполнить `manjary.exe -k reconfig`. В OS/2 также можно послать сигнал `HUP` процессу `manjary`.

### Быстрая конфигурация. Минимально необходимые настройки.

Далее в тексте в путях узлов конфигурации опущен корневой узел `server`. Рядом с названиями узлов в скобках указаны файлы в которых они находятся в примере из `examples\full`.

Узел `module-Mail`/`mail-root` (`manjary-mail.xml`). Указывает директорию где будут храниться данные доменов, пользователей, почтовых ящиков, сообщения в почтовых ящиках, очередь входящих и исходящих сообщений и другая информация. Это единственный узел который при изменении требует остановки и повторного запуска сервера. При первом запуске указанная директория должна быть пуста. По-умолчанию используется `mail` в каталоге где расположен выполняемый файл `manjary.exe`.

Узел `module-Mail`/`hostname` (`manjary-mail.xml`). Основное имя сервера в DNS.

Узел `module-Mail`/`default-domain` (`manjary-mail.xml`). Главный почтовый домен или домен по-умолчанию который будет обслуживаться данным сервером. Это имя будет использоваться в различных ситуациях, например, при аутентификации пользователя без указания в имени пользователя доменной части.

Опционально, узел `module-Mail`/`trusted` (`mail.xml`) задаёт IP ACL который будет использован для определения доверенных клиентов. Здесь следует указать локальные сети.

Пред. |  | След.
Глава 1. Описание. | Начало | Установка в качестве службы WIndows.