Это старая версия документа!

Содержание

Установка ejabberd

Установка ejabberd

У вас есть несколько вариантов установки ejabberd:

Быстрый старт с бинарными установщиками - рекомендации при запуске на localhost:
Установка из исходного кода - рекомендуется для опытных пользователей
Установка с определенными пакетами для операционной системы - рекомендуется для системных администраторов
Операции после установки - например, регистрация пользователей и создание учетных записей администратора

Быстрый старт

Бинарный установщик развернет и настроит полнофункциональный сервер ejabberd и не потребует каких-либо дополнительных зависимостей. Он включает в себя урезанную версию Erlang. Таким образом, при использовании установщика ejabberd вам не нужно устанавливать Erlang отдельно.

Эти мануалы предполагают установку на localhost для целей разработки. В этом документе при упоминании ejabberd-YY.MM мы предполагаем, что YY.MM - номер выпуска, например 19.02. Также обратите внимание, что сценарии установщика поддерживают множество параметров, полезных для производственной или автоматической установки по сценарию. Вы можете прочитать больше об опциях установщика при автоматической установке.

Установка в Windows

Перейдите на официальную страницу загрузки **ejabberd** на сайте **ProcessOne**.
Загрузите «64-битный установщик Windows».
Дважды кликните файл ejabberd-YY.MM-windows-installer.exe, чтобы запустить программу установки.
В диалоговом окне «Безопасность Windows» разрешите установку этого приложения.
Выберите язык установки, который вы предпочитаете, затем нажмите «Далее», чтобы выполнить необходимые шаги установки:
- принятие лицензионного соглашения,
- выбрав каталог установки,
- определение домена XMPP: по умолчанию для него задано имя вашего компьютера в локальной сети, если не уверены, введите localhost,
- установка имени пользователя администратора,
- установка пароля администратора,
- выберите, будет ли этот экземпляр ejabberd частью кластера: для простой локальной установки просто выберите «Нет»,
- начать установку,
- в ответ на запрос брандмауэра Windows вы можете оба раза нажать «Отмена»,

После успешной установки вы должны увидеть на рабочем столе два новых ярлыка: «Запустить ejabberd» и «Остановить ejabberd». Чтобы запустить или остановить ejabberd, щелкните правой кнопкой мыши на каждом ярлыке и выберите «Запуск от имени администратора», затем подтвердите диалоговое окно Windows, нажав «Да».

После запуска ejabberd в браузере по умолчанию должен открыться экран приветствия. Вы можете перейти на веб-панель мониторинга по адресу http://localhost:5280/admin и ввести имя пользователя admin и пароль для доступа. Следующий шаг - узнать, как настроить ejabberd.

Если во время установки что-то пойдет не так, и вы захотите начать с нуля, вы найдете файл ejabberd uninstall.exe в каталоге, где он был установлен. По умолчанию это C:\Program Files\ejabberd-YY.MM\uninstall.app. Деинсталлятор остановит ваш сервер ejabberd и удалит все его файлы. Файлы журналов могут остаться, поэтому, чтобы полностью удалить ejabberd, просто удалите его основную папку.

Установка в Linux

Перейдите на официальную страницу загрузки **ejabberd** на сайте **ProcessOne**.
Загрузите «Linux x86_64-bit Intel Installer».
Щелкните правой кнопкой мыши на загруженном файле и выберите «Свойства». Нажмите на вкладку «Разрешения» и установите флажок «Разрешить выполнение файла как программы».
Теперь вы можете дважды кликнуть файл, чтобы запустить программу установки. Вы также можете сделать установщик исполняемым файлом в терминале

chmod a+x ejabberd-YY.MM-linux-x86_64-installer.run

и запустить его с помощью командной строки:

./ejabberd-YY.MM-linux-x86_64-installer.run

Выберите язык установки, который вы предпочитаете, затем нажмите «Вперед», чтобы выполнить необходимые шаги установки:
- принятие лицензионного соглашения,
- выбор каталога для установки,
- определение домена XMPP: по умолчанию для него задано имя вашего компьютера в локальной сети. если не уверены, введите localhost,
- установка имени пользователя администратора,
- установка пароля администратора,
- выберите, будет ли этот экземпляр ejabberd частью кластера: для простой локальной установки просто выберите «Нет»,
- начать установку,

После успешной установки запустите ejabberd с помощью терминала. В командной строке перейдите в рабочую директорию ejabberd и выполните ./bin/ejabberdctl live. Это запустит ejabberd в интерактивном режиме с несколькими полезными сообщениями, напечатанными в терминале.

Теперь вы можете перейти на веб-панель мониторинга по адресу http://localhost:5280/admin и ввести имя пользователя admin и пароль для доступа. Следующий шаг - узнать, как настроить ejabberd.

Если во время установки что-то пойдет не так, и вы захотите начать с нуля, вы найдете скрипт деинсталляции ejabberd в каталоге, где он был установлен.

Установка в macOS

Использование бинарного установщика

Прежде чем начать установку ejabberd, убедитесь, что ваш Mac поддерживает приложения от определенных разработчиков. Для этого перейдите в «Настройки Mac», «Безопасность и конфиденциальность» и выберите «Разрешить загрузку приложений из: App Store и определенных разработчиков». Затем вы можете скачать ejabberd и продолжить установку:

Перейдите на официальную страницу загрузки **ejabberd** на сайте **ProcessOne**.
Загрузите «Установщик Mac OS X Intel». Если ваша система старше, чем указанные минимальные требования, найдите в ejabberd Download Archive подходящую версию.
Дважды кликните файл ejabberd-YY.MM-osx-installer.app.zip, чтобы распаковать архив.
Дважды кликните файл ejabberd-YY.MM-osx-installer.app, чтобы запустить программу установки.
Подтвердите диалог безопасности, нажав «Открыть».
Если вы видите диалоговое окно с заголовком «Приложение не оптимизировано для вашего Mac», вы можете безопасно его проигнорировать - оно относится только к установщику, а не к самому ejabberd.
Выберите язык установки, который вы предпочитаете, затем нажмите «Далее», чтобы выполнить необходимые шаги установки:
- принятие лицензионного соглашения,
- выбор каталога установки,
- определение домена XMPP: по умолчанию для него задано имя вашего компьютера в локальной сети. если не уверены, введите localhost здесь,
- установка имени пользователя администратора,
- установка пароля администратора,
- выберите, будет ли этот экземпляр ejabberd частью кластера: для простой локальной установки просто выберите «Нет»,
- начать установку,

По завершении сценария установки он пытается запустить ejabberd. Может появиться приглашение с просьбой разрешить входящие соединения для beam.smp. Если вы не разрешите, установка не сможет завершиться успешно.

Если во время установки что-то пойдет не так, и вы захотите начать с нуля, вы найдете файл ejabberd uninstall.app в каталоге, где он был установлен. По умолчанию это /Apllications/ejabberd-YY.MM/uninstall.app. Деинсталлятор остановит ваш сервер ejabberd и удалит все его файлы. Файлы журналов могут остаться, поэтому, чтобы полностью удалить ejabberd, просто удалите его основную папку.

Бинарные установщики ejabberd до версии 19.02 не имели подписи Apple Developer. Если macOS жалуется, когда вы пытаетесь установить ejabberd старше 19.02 с бинарным установщиком с сообщением «ejabberd-installer поврежден и его нельзя открыть» - тогда вам нужно временно отключить привратника, чтобы иметь возможность установить ejabberd:

sudo spctl --master-disable

Установить ejabberd и снова включить его

sudo spctl --master-enable

Использование Homebrew

Homebrew - менеджер пакетов для macOS, целью которого является портирование многих программ Unix и Linux, которые нелегко доступны или несовместимы. Установка Homebrew проста и инструкция доступна на его сайте.

После того, как вы установили Homebrew, откройте терминал. Запустите brew install ejabberd. Это должно установить самую последнюю или самую последнюю версию ejabberd.
Каталог установки должен быть указан в конце этого процесса, но обычно основной исполняемый файл хранится в /usr/local/sbin/ejabberdctl.

Запустите ваш ejabberd, запустив /usr/local/sbin/ejabberdctl live. Этот интерактивный режим печатает полезные сообщения в терминале. Домен по умолчанию, используемый ejabberd Homebrew - localhost.

Создайте учетную запись администратора, запустив /usr/local/sbin/ejabberdctl, зарегистрируйте пароль администратора localhost. Это создает учетную запись admin@localhost с указанным паролем.

Теперь вы можете перейти на веб-панель мониторинга по адресу http://localhost:5280/admin и ввести имя пользователя admin и пароль для доступа. Без конфигурации здесь не так много всего, поэтому следующий шаг - узнать, как настроить ejabberd.

Установка из исходного кода

Канонической формой распространения стабильных выпусков ejabberd является пакет исходного кода. Компилировать ejabberd из исходного кода довольно просто в *nix системах, если ваша система имеет все зависимости.

Технические требования

Чтобы скомпилировать ejabberd в «Unix-like» операционной системе, вам необходимо:

GNU Make
GCC
Libexpat 1.95 или выше
Libyaml 0.1.4 или выше
Erlang/OTP 19.1 или выше. Мы рекомендуем использовать Erlang OTP 21.2.
OpenSSL 1.0.0 или выше, для шифрования STARTTLS, SASL и SSL.
Zlib 1.2.3 или выше, для поддержки потокового сжатия (XEP-0138). Необязательный.
Библиотека PAM. Необязательно. Для сменных модулей аутентификации (PAM). Смотрите раздел PAM.
ImageMagick Convert. Необязательно. Для генерации капчи. Смотрите раздел CAPTCHA.

Загрузка

Вышедшие версии ejabberd доступны на официальной странице загрузки **ProcessOne**.

Кроме того, последний исходный код разработки может быть получен из репозитория Git с помощью команд:

git clone git://github.com/processone/ejabberd.git ejabberd
cd ejabberd
./autogen.sh

Компиляция

Для компиляции ejabberd выполните команды:

./configure --enable-user=ejabberd --enable-mysql

Это говорит конфигуратору, как подготовить сервер для установки с запуском от пользователя по имени ejabberd, поэтому, пожалуйста, создайте этого пользователя или попросите использовать другого локального пользователя. Не рекомендуется запускать ejabberd с привилегиями root.

Для компиляции ejabberd вам потребуется доступ в Интернет, поскольку зависимости будут загружаться в зависимости от выбранных параметров.

Сценарий конфигурации сборки допускает несколько вариантов. Чтобы получить полный список, выполните команду:

./configure --help

Опции

Некоторые доступные опции, которые могут вас заинтересовать в модификации:

-–Bindir = /: указать путь к исполняемым файлам пользователя (где доступны epmd и iex).
-–Prefix = /: Укажите префикс пути, куда будут копироваться файлы при запуске команды make install.
-–Enable-user [= USER]: разрешить этому обычному системному пользователю выполнять сценарий ejabberdctl (смотрите раздел ejabberdctl), читать файлы конфигурации, читать и записывать в каталог спула, читать и записывать в каталог журнала. Пользователь и группа учетной записи должны существовать на компьютере перед запуском make install. Эта учетная запись не нуждается в явном каталоге HOME, поэтому /var/lib/ejabberd/ будет использоваться по умолчанию.
-–Enable-pam: включить метод аутентификации PAM (смотрите раздел PAM).
-–Enable-tools: включить использование инструментов разработки.
-–Enable-mysql: включить поддержку MySQL (смотрите базы данных).
-–Enable-pgsql: включить поддержку PostgreSQL (смотрите базы данных).
-–Enable-sqlite: включить поддержку SQLite (смотрите базы данных).
–-Enable-riak: включить поддержку базы данных Riak (смотрите базы данных).
-–Enable-redis: включить поддержку Redis для использования во внешнем хранилище сеансов.
-–Enable-zlib: включить сжатие потока (XEP-0138) с помощью zlib.
-–Enable-lager: использовать стандартный инструмент регистрации Erlang вместо стандартного средства регистрации ошибок.
–-Enable-debug: компилировать с включенной + debug_info.
–-Enable-elixir: Сборка ejabberd с поддержкой расширения Elixir.
–-Enable-all: включить все предыдущие опции.
–enable-latest-deps: заставляет rebar использовать последние версии зависимостей, разработанные вместе с ejabberd, вместо версии, указанной в rebar.config. Следует использовать только при разработке ejabberd.

Вот другие доступные варианты, которые являются экспериментальными и не рекомендуются:

–-Enable-hipe: компилировать изначально с HiPE (не рекомендуется).