4. Получение и установка

4.1. Необходимые для установки условия

Для установки сервера статистики Вам необходимы:

• Компьютер с установленной на нем Unix-подобной OS из списка поддерживаемых (в настоящий момент это FreeBSD 2.*, BSD/OS 2.* и Linux OS по требованию).
• Программы sed, awk, perl, которые обычно входят в ``комплект поставки'' современных Unix'ов.
• Около 10 Mb свободного пространства (для тестовых целей достаточно ~3 Mb).
• Установленный SQL сервер (подробнее об этом смотрите в следующей главе).
• Базовые знания операционной системы на уровне ее конфигурационных файлов и пользовательских команд.
• Права на изменение системных конфигурационных файлов.

Желательно прочитать настоящее руководство по крайней мере до главы "Описания модулей" прежде, чем приступать к установке.

4.2. Получение дистрибутива

Для ознакомления с возможностями сервера Вы можете использовать свободно распространяемую некоммерческую версию сервера. Она полностью работоспособна и отличается от полной версии ограничением на общее количество пользователей, обслуживаемых сервером. В некоммерческой версии их может быть лишь 10, а в полной неограниченное количество.

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

Дистрибутив сервера статистики можно получить с FTP сервера:
ftp://ftp.f1.ru/pub/am/amstat/

В этом каталоге находятся архивы с исполняемыми модулями для различных операционных систем и конфигурационные файлы, которые универсальны. Файлы имеют вид amstat-<version>-<type>-<os>.tar.gz, где

version

текущая версия,

type

тип - bin для исполняемых модулей, conf для конфигурационных файлов и doc для документации.

os

операционная система.

Если у Вас нет возможности использовать FTP, Вы можете заказать файлы с помощью файлового сервера ms@f1.ru. С точки зрения файлового сервера сервер статистики находится в каталоге `/comp/unix/am/amstat'. Однако, заказывая файлы с помощью файлового сервера, помните, что это не бесплатный процесс! Не стесняйтесь также написать запрос автору - am@amsoft.ru с указанием желаемого метода кодирования и размера частей.

4.3. Как получить полную версию сервера? Регистрация.

Оплата.

В зависимости от принятого Вами решения о варианте покупки (в исходных текстах или исполняемых модулей) стоимость и процедура установки отличается. Напишите мне письмо по адресу <am@amsoft.ru> - мы обсудим детали и я вышлю Вам счет. При покупке исходных текстов заключение договора является обязательной предварительной процедурой.

Если Вы хотите произвести оплату в валюте, отличной от российских рублей - напишите письмо по указанному чуть выше адресу.

Результатом оплаты будет получение Вами либо ключа, снимающего ограничения демонстрационной версии, либо исходных текстов системы. Кроме того, Вы получите некоторые дополнительные привелегии и обязанности, оговоренные в Договоре.

Получение и установка ключа

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

После того, как Вы произвели оплату и получили таким образом право использовать сервер статистики, необходимо запустить модуль сервера registrate. В результате Вы получите три строки, обрамленные ограничителями - пошлите их автору по адресу <am@amsoft.ru>. Проще всего сделать это командой:

      registrate | mail -s "amstat registration" am@amsoft.ru

В результате (если все верно) Вы получите по почте уникальный ключ, по которому сервер будет "знать", что Вы его купили.

Рекомендуемое место размещения ключа - файл `.Key' в домашнем каталоге сервера. Разместив полученный ключ там (или в другом месте) дополните основной конфигурационный файл сервера `/etc/amstat.conf' следующей строкой (более подробно о параметрах конфигурации смотрите в главе настройка):

      key-file   полный_путь_к_имени_файла_ключа

Теперь можно проверить корректность установки запуском модуля ckconfig с ключом `-V' . При правильной установке ключа Вы должны получить сообщение ``Официально зарегистрированная версия''. Если такого сообщения нет, то запустите ckconfig с ключом `-n' и посмотрите есть-ли в выводе параметр key-file? Если есть - проверьте ключ присланный Вам автором - не нарушен-ли он? Не забыли-ли Вы его декодировать из формата uuencode если получали его по почте? Совпадает-ли его размер с указанным Вам автором?

Получение и установка исходных текстов

Для получения исходных текстов сервера статистики Вы должны выполнить следующие действия:

1. Получить с http://www.amsoft.ru/ru/amstat, из данной документации или запросить у автора текст договора.
2. Распечатать и подписать два экземпляра полученного договора (при необходимости вопросы и пожелания по тексту договора можно высказать автору).
3. Направить обычной бумажной почтой подписанные варианты договора по адресу:

    __пожалуйста, уточните адрес у автора с помощью e-mail__
   

4. Оплатить стоимость исходных текстов (при необходимости запросив у автора счет).
5. По получению договоров и оплаты Вам будут по электронной почте или на дискете (на Ваш выбор) отправлены исходные тексты сервера вместе с кратким описанием процедуры их установки, а также обычной почтой заказным письмом один вариант договора, подписанный автором, первый экземпляр счета и накладная.

4.4. Установка сервера

К этому моменту Вы должны иметь в своем распоряжении три архива: исполняемые файлы для своей системы - bin, конфигурацию - conf, и документацию - doc. Установка сервера должна производиться пользователем root.

Установка сервера в первый раз.

Выберите имя пользователя, которому будут принадлежать конфигурационный файлы, исполняемые модули и базы данных сервера. По умолчанию сервер расчитывает, что таким пользователем будет `root' - т.е. самый привелегированный пользователь в системе. Доводом ``за'' такой выбор может служить отсутствие необходимости в каких-либо серьезных переделках модулей и конфигурационных файлов сервера, упрощение разработки дальнейших расширений к серверу. В то же время, аргументом ``против'' может быть некоторый риск запуска сервера с полными правами на доступ ко всей системе. В случае, если Вы решили создать для сервера отдельного пользователя, Вам понадобится сделать следующие действия:

1. Придумать название группы (например `statserv') для сервера статистики и создать ее (во FreeBSD это можно сделать редактированием файла `/etc/group'). Кроме того, необходимо предоставить право перехода в эту группу из группы daemon (или иной, используемой Вашим почтовым агентом при запуске внешних программ, - подробнее о причинах смотрите ниже).
2. Добавить выбранное Вами имя пользователя (например `stat') в выбранной группе в систему (во FreeBSD это можно сделать командами `vipw' или `adduser').
3. Отредактировать модули конвертеров (см. daily-mail, daily-time и т.п.) с тем, чтобы они имели доступ к системной информации.
4. Установить параметры uid и gid конфигурации (смотрите следующую главу) в соответствии с идентификаторами выбранного Вами пользователя. Модули listener и htreport должны принадлежать root'у вне зависимости от того, какого пользователя Вы выбрали для установки сервера! При запуске они сами сменят права на указанные параметрами uid/gid.

Выберите каталог, в который Вы установите сервер (обычно это каталог `/usr/local/amstat' или `/var/local/stat'), и разверните в нем архивы с конфигурационными файлами, документацией и бинарными модулями сервера. Далее, этот каталог будем называть ``домашним каталогом сервера'' или `~stat'.

При этом конфигурационные файлы разместятся на те места, которые используются по умолчанию, за исключением `amstat.conf', поиск которого будет производиться в каталоге `/etc'.

Файл `amstat.conf' является основным конфигурационным файлом сервера, его читают все модули сервера! Вы обязательно должны изменить его в соответствии с настройкой Вашей системы. Подробнее о его формате и возможных значениях параметров смотрите в главе ``Настройка сервера''.

Кроме того, необходимо сделать модуль ckconfig доступным всем остальным небинарным модулям сервера (с его помощью они читают конфигурацию). Для этого можно либо исправить первые несколько строк этих модулей, либо сделать ссылку (символьная ссылка не позволит Вам забыть заменить копию на новую версию при обновлении) на ckconfig из каталога, входящего в PATH; например:

bash# ln -s ~stat/bin/ckconfig /usr/local/bin

Обновление версии.

Внимание! Для перехода от версий 0.* к версии 1.0 и выше действий, перечисленных в этом пункте, недостаточно! Смотрите приложение ``Обновление версии''.

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

http://www.amsoft.ru/amstat/

Теперь Вам необходимо развернуть архив с исполняемыми модулями. Если Вы вносили какие-либо изменения в исполняемые файлы предыдущей версии, то не забудьте их сохранить! Процедура автоматической безопасной инсталляции новых версий поверх старых будет реализована в одной из ближайших версий.

Будьте осторожны с конфигурационными файлами - разворачивание дистрибутива конфигурационных файлов новой версии может заместить Вашу конфигурацию!

Проверьте установки запуском ckconfig.