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

Содержание

Файл конфигурации.
Быстрая конфигурация. Минимально необходимые настройки.
Установка в качестве службы WIndows.
  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 который будет использован для определения доверенных клиентов. Здесь следует указать локальные сети.