Пошаговая установка MailTUX 2

Материал из SelyukSupport База Знаний


Чтобы установить приложение на хостинг нужно выполнить несколько пунктов:

  • Создайте отдельный поддомен вида mailtux.вашдомен.ru - это обязательное условие. Приложение не сможет работать во вложенной папке без правки файла .htaccess
  • Создайте отдельную базу данных. Изначальная кодировка не важна - приложение при установке изменит ее на UTF-8.
  • Создайте отдельный почтовый ящик для bounce-сообщений, которые будут приходить от серверов в случае ошибок доставки. Этим ящиком будет управлять приложение.
  • Закачайте приложение на хостинг

Содержание

Создание поддомена

В панели управления хостингом перейдите в раздел "Управление поддоменами" или аналогичный. Создайте поддомен с нужным вам именем, например, mailtux.

Создание базы данных

В панели управления хостингом перейдите в раздел "Управление базами данных", "Управление MySQL", или аналогичный. Укажите имя базы данных, например, tux2 Если пользователь базы данных не был создан автоматически при создании базы данных, то создайте его (желательно чтобы он ассоциировался с БД), запишите пароль. Затем прикрепите пользователя к базе данных.

Создание почтового ящика

В панели управления хостингом перейдите в раздел "Управление почтовыми аккаунтами", или аналогичный. Создайте ящик, например mailer@вашдомен.ru Запишите пароль на него. Также запомните адрес сервера и порт для доступа к ящику.

Закачка приложение на хостинг

Проверьте, чтобы файла .htaccess не было в папке публикации для поддомена. Если он есть, удалите его (проконсультируйтесь с хостером в случае ошибок)

Здесь есть несколько вариантов. Первый самый простой. Если у вас уже есть последняя версия архива с приложением на вашем компьютере, то извлеките оттуда файл install/autodownload.php и загрузите его по FTP в папку публикации для поддомена (например, www или public_html). Закачивать нужно обязательно в БИНАРНОМ РЕЖИМЕ, так как файл не текстовый.

Затем перейдите по адресу http://поддомен.вашдомен.ru/autodownload.php и если не возникнет ошибок (ошибки могут возникнуть если нет необходимых модулей, например, отсутствует встроенная в PHP поддержка ZIP-архивов или ошибка при выполнении команды unzip, или запрет команды shell_exec), то программа автоматически скачает последнюю версию архива с нашего сервера, распакует его и пригласит вас начать установку.

Вариант второй. Закачайте архив с приложением по FTP в папку публикации домена. Через панель управления хостингом распакуйте скрипт, затем перейдите браузером на адрес, куда будет устанавливаться скрипт, http://поддомен.вашдомен.ru/. Приложение пригласит вас к установке.

Вариант третий. Если у вас есть доступ к SSH. Авторизируйтесь через SSH и перейдите в каталог публикации для поддомена. Выполните команды:

  • wget http://mailtux.selyuktech.com/download/mailtux2.zip
  • unzip -o mailtux2.zip

После этого у вас должен быть распакованный архив в папке публикации поддомена. Чтобы начать установку перейдите на http://поддомен.вашдомен.ru/

Установка

Предполагается что вы находитесь в модуле автоматической установки (пятиминутный инсталлятор). Укажите параметры подключения к базе данных. Если вы устанавливаете несколько копий приложения в одну базу данных, то имеет смысл указывать различные префиксы для таблиц.

После того как приложение импортирует начальные данные в базу данных вам будет предложено ввести желаемые логин и пароль для доступа к приложению. Все указанные данные сохраняются в файле конфигурации /config/config.ini и вы их там можете исправить при необходимости, после завершения установки.

После установки вам будет предложено авторизироваться в приложении. Do it. Дальше вам нужно будет настроить расширенную конфигурацию приложения.

Настройка планировщика заданий

Приложение использует модули запускаемые через cron (или аналогичный) для отправки и приема почты.

В панели управления хостингом перейдите в модуль "Планировщик заданий", "Cron-менеджер" или аналогичный. Вам нужно будет добавить два задания. Модули обязательно должны запускаться через веб-сервер, путем вызова определенных адресов.

Примеры команд для отправки почты (требуется использовать только одну из них):

  • curl -s http://поддомен.вашдомен.ru/cronsend.php > /dev/null
  • curl -s http://поддомен.вашдомен.ru/cronsend.php 2>&1
  • wget http://поддомен.вашдомен.ru/cronsend.php > /dev/null

Примеры команд для приема почты (требуется использовать только одну из них):

  • curl -s http://поддомен.вашдомен.ru/cronfetch.php?sleep=3 > /dev/null
  • curl -s http://поддомен.вашдомен.ru/cronfetch.php?sleep=3 2>&1
  • wget http://поддомен.вашдомен.ru/cronfetch.php?sleep=3 > /dev/null

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

  • Минуты: */5
  • Часы: *
  • Дни: *
  • Месяцы: *
  • Годы: *

Обратите внимание, что в конфигурации скрипта указано время работы в 300 секунд по умолчанию, с расчетом на запуск каждые 5 минут. Если вы хотите запускать задания каждую минуту, то исправьте в конфигурации время работы программы на 60 секунд, чтобы не было нескольких одновременных запусков.

Дополнительные параметры для настройки производительности

В заданиях вы можете указать дополнительные параметры, которые будут влиять на производительность приложения и соответственно на нагрузку сервера. Параметры передаются методом GET, то есть путем указания их после ? (знака вопроса).

Возможные параметры:

  • sleep=x - позволяет включить паузу на x секунд после отправки или приема каждого письма (в зависимости от модуля)
  • usleep=x - позволяет включить паузу на x микросекунд (микросекунда = одна миллионная секунды) после отправки или приема каждого письма (в зависимости от модуля)
  • seclimit=x - позволяет ограничить число писем за одну секунду, где x=число писем.

Параметры можно смешивать между собой, но только если вы понимаете что получите в результате.

Конфигурация приложения

В разделе Сервис|Конфигурация вам нужно настроить параметры для работы программы. Минимально нужно настроить регистрационные данные, доступ к ящику входящей почты, и метод отправки почты. Все это зависит от конкретных параметров хостера и сервера.

Подробнее о настройке конфигурации: Пошаговая настройка конфигурации MailTUX