Содержание


Communigate

Часть 2. Установка, базовая настройка, ввод в эксплуатацию

Comments

Серия контента:

Этот контент является частью # из серии # статей: Communigate

Следите за выходом новых статей этой серии.

Этот контент является частью серии:Communigate

Следите за выходом новых статей этой серии.

В первой части цикла о Communigate (CommuniGate Pro) мы изучали вопросы общей организации и назначения программного комплекса Communigate.

Рассмотрены основные компоненты, образующие логический состав сервера и составляющие его структуру.

Описаны нюансы, возникающие при выборе различных платформ для развертывания Communigate.

Во второй части цикла будут рассмотрены вопросы установки и базовой настройки Communigate, достаточные для ввода программы в эксплуатацию. Причем, в процессе описания будет предпринята попытка объединить эти рекомендации для версии 5.0.5 Communigate и более поздних.

План установки и ввода в эксплуатацию Communigate

Независимо версии UNIX/Linux, общий план развертывания системы Communigate на сервере имеет следующий вид:

  1. установить программу Communigate;
  2. отключить (деинсталлировать) имеющиеся в системе службы pop, imap;
  3. выполнить скрипт /etc/rc.d/init.d/CommuniGate start;
  4. уточнить пароль для учетной записи postmaster в каталоге: /var/CommuniGate/Accounts/postmaster.macnt/account.settings;
  5. изменить настройки системного firewall для открытия на нем необходимых портов. Пока нам будут жизненно необходимы протоколы http с портом 8010 и https с портом 9010;
  6. зайти на сервер под учетной записью postmaster, ввести полученный пароль и приступить к базовым настройкам системы по адресу: http://server_address:8010 или https://server_address:9010 (см. рис.1).
Рисунок 1
Рисунок 1
Рисунок 1

Теперь рассмотрим более подробно установку Communigate в системах Linux/UNIX.

Установка Communigate в Linux системе

  • Нужно зайти в систему как суперпользователь (root).
    • При использовании менеджера пакетов Red Hat (или подобных ему систем – с расширением файла .rpm) нужно исполнить команду:
        rpm -i CGatePro-Linux-version.rpm
    • при использовании других систем (файл .tgz):
        tar -xzf CGatePro-Linux-version.tgz
          cd CGateProSoftware
          sh install.sh

      CommuniGate Pro будет установлен в директории /opt.

  • программа-установщик создаст файл со сценарием автоматического запуска /etc/rc.d/init.d/CommuniGate. Для того, что бы Сервер CommuniGate Pro начинал и прекращал работу автоматически вместе с системой, установщик добавит ссылку на этот файл в /etc/rc.d/rcn.d (где n – номер уровня загрузки);
  • если в системе запущен отдельно SMTP сервер/MTA (такой, как sendmail или postfix), его нужно остановить (например, командой /sbin/chkconfig sendmail off) или деинсталлировать совсем;
  • если в системе запущены POP, IMAP, или другие службы, то их тоже желательно остановить и деинсталлировать, если они больше использоваться не будут. Если есть какие то сомнения по этому поводу, то удалять их не нужно. А в случае последующего удаления CommuniGate Pro, ранее используемая почтовая программа будет переименована обратно в /bin/mail;
  • программа-установщик создаст новое приложение /bin/mail – на замену для существующей программы mail;
  • программа-установщик так же создаст поддиректорию /var/CommuniGate, используемую сервером по умолчанию. Ее можно переместить в любое другое место. При этом, - откройте сценарий запуска /etc/init.d/CommuniGate и внесите в него соответствующие изменения;
  • перезапустите систему или запустите сценарий запуска вручную:
      /etc/rc.d/init.d/CommuniGate start
  • затем можно продолжить настройку базовой конфигурации Communigate (см. рис.2).
Рисунок 2
Рисунок 2
Рисунок 2

Нужно обратить внимание на то, что некоторые ранние(но ныне все еще широко используемые) версии Linux (такие как RedHat 9.0, SuSE 9.1) используют нестабильно работающую версию NPTL библиотеки.

Для того, чтобы решить проблему для этих версий Linux, сценарий запуска CommuniGate Pro использует команду LD_ASSUME_KERNEL=2.4.1. При этом компоновшик использует более стабильную версию этой библиотеки. Кроме этого, когда используется старая NTPL библиотека, системными утилитами ps и top каждая нить CommuniGate Pro отображается как отдельный процесс. В этом случае все эти "процессы" в действительности являются нитями сервера CommuniGate Pro, и они совместно используют все свои ресурсы - VRAM, дескрипторы файлов и тд. Не помешает помнить и тот факт, что ядра Linux до версии 2.6.13 имеют критическую уязвимость в реализации NFS клиента. При этом ядро нужно «пропатчить» или использовать сразу систему с более свежим ядром. Кроме этого, некоторые ядра Linux некорректно поддерживают параллельные вычисления на системах x86, поэтому лучше отключить функцию hyperthreading в BIOS сервера, имеющего x86 архитектуру.

Установка Communigate на базе FreeBSD

Имеется два пакета CommuniGate Pro для установки на систему FreeBSD: один под FreeBSD 4.x (поддерживающий версии FreeBSD 4.x), другой - поддерживающий FreeBSD 5.3 и более поздние версии. Независимо от используемой платформы, порядок действий будет практически одинаков.

Необходимо войти в систему как суперпользователь (root).

  • Установить соответствующий пакет CommuniGate Pro. FreeBSD 4.x:
      pkg_add CGatePro-FreeBSD4-version.tgz

    FreeBSD 5.x:

      pkg_add CGatePro-FreeBSD-version.tgz

    CommuniGate Pro будет установлен в директории /usr/local/sbin.

  • Если в системе запущен sendmail или любой другой SMTP сервер, его нужно остановить и изменить сценарий запуска операционной системы таким образом, что бы он не стартовал автоматически. Если не планируется обратный переход, то можно имеющийся SMTP службу деинсталлировать совсем.
  • Если в системе запущены POP, IMAP сервера, то нужно удалить их из тех конфигурационных файлов, которые обеспечивают их старт. Как правило, это /etc/inetd.conf файл;
  • программа-установщик создаст сценарий /usr/local/etc/rc.d/CommuniGate.sh. Таким образом, Communigate будет запускаться автоматически, одновременно со стартом системы FreeBSD.
  • программа-установщик создаст символьную ссылку /bin/cgmail на программу mail, работающую в режиме командной строки для взаимодействия с Communigate;
  • программа-установщик создаст поддиректорию /var/CommuniGate, используемую сервером по умолчанию. Можно переместить этот каталог в любое другое место. В этом случае нужно внести соответствующие изменения в сценарий запуска;
  • выполнить программу запуска сервера вручную:
      /usr/local/etc/rc.d/CommuniGate.sh start
  • теперь можно продолжить базовую настройку сервера в веб-интерфейсе администартора.

Установка Communigate на базе NetBSD

  • убедитесь, что вы используете NetBSD версии 2.0 или выше;
  • зарегистрируйтесь как суперпользователь (root);
  • установите пакет CommuniGate Pro:
      pkg_add CGatePro-NetBSD-version.tgz

    CommuniGate Pro будет установлен в директории /usr/pkg.

  • Если в системе запущен sendmail или любой другой SMTP сервер, остановите его и измените сценарий запуска операционной системы таким образом, что бы он не стартовал автоматически или деинсталлируйте его;
  • если на вашей системе запущены POP, IMAP или другой подобный сервер, то удалите его из фала, отвечающего за его старт. Как правило, это файл /etc/inetd.conf для BSD систем;
  • установщик при этом создаст сценарий запуска /etc/rc.d/CommuniGate и сервер будет запускаться автоматически, одновременно со стартом системы NetBSD;
  • программа-установщик создаст символьную ссылку /bin/cgmail на программу mail, работающую в режиме командной строки для взаимодействия с CommuniGate Pro;
  • программа-установщик создаст подкаталог /var/CommuniGate, используемый сервером по умолчанию. Его можно переместить в любое другое место. В этом случае нужно внести соответствующие изменения в сценарий запуска;
  • перезапустите систему или запустите сценарий запуска вручную:
      /etc/rc.d/CommuniGate start
  • продолжите настройку системы из веб-интерфейса администратора.

Установка Communigate на базе OpenBSD

  • Необходимо использовать версию OpenBSD 3.4 или выше;
  • Нужно войти в систему как суперпользователь (root);
  • Установите пакет CommuniGate Pro:
      pkg_add CGatePro-OpenBSD-version.tgz

    CommuniGate Pro будет установлен в директории /usr/local/sbin.

  • Если в системе запущен sendmail или любой другой SMTP сервер, остановите его и измените сценарий запуска операционной системы таким образом, что бы он не стартовал вместе с системой. Можно просто удалить его;
  • Если на вашей системе запущены POP, IMAP сервера, то удалите строки, в которых содержится описание этих серверов из файла /etc/inetd.conf;
  • Программа-установщик добавит ссылку на сценарий запуска CommuniGate Pro в файл /etc/rc.local, таким образом Сервер CommuniGate Pro будет запускаться автоматически, одновременно со стартом системы OpenBSD;
  • Программа-установщик создаст группу mail (если она отсутствовала);
  • Программа-установщик создаст символьную ссылку /bin/cgmail на программу mail, работающую в режиме командной строки для взаимодействия с CommuniGate Pro;
  • Программа-установщик создаст подкаталог /var/CommuniGate, используемый сервером по умолчанию. Его можно переместить в любое другое место. В этом случае нужно внести соответствующие изменения в сценарий запуска Communigate;
  • Перезапустите систему или запустите сценарий запуска вручную:
      /usr/local/sbin/CommuniGate/Startup start
  • Продолжите настройку системы из административного веб-интерфейса.

Начальные действия в системе

После того, как CommuniGate Pro установлен, нужно:

  • перезапустить операционную систему или перезапустить сервер CommuniGate Pro вручную;
  • затем, в течение 10 минут зайти на сервер через веб-интерфейс администратора, порт 8010, используя любой веб-браузер. Введите следующий URL в вашем браузере:
    	http://your.server.domain:8010

    где your.server.domain is доменное имя или IP адрес компьютера, на котором запущен Сервер CommuniGate Pro или используйте порт 9010, тогда адрес измениться на https://your.server.domain:9010;
  • прочитайте лицензионное соглашение, введите желаемый пароль для пользователя postmaster, затем щёлкните по кнопке «Accept»;
  • после этого произойдет перенаправление на страницу быстрого старта; используйте имя postmaster и введённый ранее пароль для открытия страницы;
  • продолжите настройку в административном веб-интерфейсе.

Если новый пароль для пользователя postmaster не будет введен в течение 10 минут, сервер отключиться. Причем это новшество касается версий выше, чем 5.0.5.

Переход на более новую версию Communigate

При установке новой версии сервера старые системные файлы замещаются новыми, но пользовательские данные при этом изменениям не подвергаются. Директория данных и файлы, находящиеся в ней, не меняются при переходе на новую версию CommuniGate Pro. Таким образом, все пользователи, папки, сообщения, настройки, файлы в хранилище файлов, лицензии, изменённые виды веб-интерфейса и файлы приложений реального времени остаются в неизменном виде, и будут работать под новой версией. Но в любом случае, необходимо сделать резервную копию и подстраховаться от внеплановых неожиданностей.

Для обновления имеющейся версии Communigate необходимо:

  • загрузите новую версию CommuniGate Pro;
  • остановите загруженный пакет;
  • удалите предыдущую версию Сервера, использую ту же самую утилиту, которая использовалась для установки (директория данных не будет удалена). Это нужно делать только в том случае, если установщик операционной системы не может переустанавливать новую версию "поверх" старой (как например в Solaris или FreeBSD, Linux).

    Стоит обратить внимание на то, что если используется менеджер пакетов Linux rpm, то его опцию "update" использовать не надо. Лучше деинсталлировать старую версию, а затем установите новую как в примере:

    rpm -e CGatePro-Linux
    rpm -i CGatePro-Linux-version.rpm
  • установите новую версию Communigate;
  • запустите, как описывалось раньше, Communigate.

Переход на новое оборудование

При необходимости перевода Communigate на другой компьютер - работающий под той же или другой операционной системой, все настройки модулей, настройки пользователей и доменов, папки, сообщения, лицензии и другие данные могут быть сохранены. CommuniGate Pro хранит их в папке для данных. Это единственная папка, требующая резервного копирования при переводе системы на новое оборудование. CommuniGate Pro использует одинаковый формат файлов на любой операционной системе и аппаратной платформе, так что обычно бывает достаточно упаковать всю директорию данных CommuniGate Pro в один архив (используя tar или gzip в системах Unix) с последующей распаковкой на другом сервере. Дополнительная обработка данных может потребоваться в случае, если сервер переносится с компьютера под управлением любой из операционных систем семейства MS Windows на компьютер под управлением Unix/Linux, или наоборот. Файлы CommuniGate Pro - это текстовые файлы, а текстовые файлы в MS Windows и в Unix используют различные EOL (окончание строки) символы: CR-LF (возврат каретки-перевод строки) в MS Windows и один LF символ (перевод строки) в системах Unix. Для корректного копирования файлов между ними можно использовать FTP протокол: когда FTP клиент передаёт файлы в режиме ASCII, он автоматически конвертирует EOL символы, а именно это нам и нужно.

Стоит обратить внимание на то, что папка с данными в CommuniGate Pro может содержать не текстовые (двоичные) файлы внутри директорий WebSkins и PBXApps, а также внутри директорий Accounts и Domains. Там могут храниться графические, аудио и видео - файлы, используемые для работы в приложениях реального времени и в настройках внешнего вида веб-интерфейса.

В хранилище файлов у пользователей тоже могут находиться двоичные файлы. Они хранятся в директориях account.web внутри директории Accounts.

Если перемещается директория данных Communigate между системами, в которых используются различные правила, касаемые EOL, то нужно убедиться, что они копируются в режиме BINARY (при этом не будет преобразований символа EOL). Если новый аппаратный сервер работает под управлением Unix, то лучше проверить его на предмет соответствия прав доступа у скопированной директории и всех ее файлов и подкаталогов правам доступа на той системе, где они находились ранее. После копирования папки с данными можно загрузить новую версию Communigate и установить ее на новом оборудовании. Не нужно копировать содержание папок с программами. Причем эта рекомендация касается случая работы обоих серверов под одинаковыми системами. Затем можно проверить, что заново установленная копия Communigate (и сценарий запуска, при его наличии) настроена на использование скопированной поддиректории данных. После этого можно запустить Communigate на новом оборудовании. Через административный веб-интерфейс нужно изменить на новом сервере все аппаратные настройки, связанные с правильным функционированием системы. При этом может понадобиться изменить таблицу IP адресов клиентов сервера или переназначить IP адреса доменов, которые обслуживает Communigate.

Выводы

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


Ресурсы для скачивания


Комментарии

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

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=40
Zone=Linux, Open source
ArticleID=556288
ArticleTitle=Communigate: Часть 2. Установка, базовая настройка, ввод в эксплуатацию
publish-date=10262010