# Websmon Monitor - Installation notes
Websmon 1.01 -- Web-based system performance monitor for UNIX servers and PROGRESS databases
Keywords: websmon, system monitor, websmon monitor, performance monitor, unix, linux, system statistics, server statistics, progress, database statistics

|  | Websmon -- Web-based system performance monitor. Copyright © 2003-2005 Dmitry Lapenkov. All rights reserved. | [ Read in English ]

## Install. Инструкция по установке, настройке и запуску монитора Websmon.

Перед чтением этой инструкции полезно ознакомиться с общей информацией о мониторе Websmon, находящейся в файле Readme.

Более детальную информацию Вы найдёте в файле Websmon.

Вы также можете посетить Web-сайт, находящийся по адресу: http://www.websmon.com.
На сайте приведены многочисленные примеры Web-страниц системной статистики, создаваемых монитором.

1. Требования к операционной системе
2. Требования к дисковому пространству
3. Установка монитора Websmon
4. Настройка конфигурационного файла Apache httpd.conf
5. Создание account'ов для пользователя Websmon на удалённых серверах
6. Настройка конфигурационного файла websmon.ini
7. Настройка crontab
8. Лицензионная информация
9. Запуск монитора Websmon

### 1. Требования к операционной системе

В настоящее время Websmon может быть использован для мониторинга производительности серверов, работающих под управлением следующих операционных систем:

- Red Hat Linux 7, 8, 9
- Red Hat Enterprise Linux AS 3
- Sun Solaris 8
- Sun Solaris 9
- SCO UnixWare 7.x

и для определения производительности серверов баз данных PROGRESS V8.3 и PROGRESS V9, работающих под управлением любых операционных систем с поддержкой соединений по протоколу TCP, например, UNIX или MS Windows (для сбора статистики ресурсов БД PROGRESS требуется установленное на сервере статистики клиентское программное обеспечение PROGRESS V9 и включённая поддержка режима client-server на удалённых серверах БД PROGRESS).

Монитор Websmon 1.01 может быть установлен и запущен на сервере, работающем под управлением одной из следующих операционных систем:

- Red Hat Linux 9 (Intel)
- Red Hat Enterprise Linux AS 3.0 (Intel)
- Sun Solaris 8 (SPARC)
- Sun Solaris 9 (SPARC)
- SCO UnixWare 7.1 (Intel)

### 2. Требования к дисковому пространству

Для установки монитора Websmon 1.01 требуется наличие как минимум 125 MB свободного места в рабочем каталоге (по умолчанию /home/websmon).

Размер дискового пространства, необходимого для работы Websmon, Вы можете рассчитать по следующей формуле (верхняя оценка, в MB за год работы):

    	space = 20 * N_servers + 34 * N_dbservers

или, при включённой автоматической архивации старых файлов статистики:

    	space = 7 * N_servers + 12 * N_dbservers

где N_servers - число серверов UNIX, а N_dbservers - число серверов баз данных PROGRESS, для которых собирается статистика.

### 3. Установка монитора Websmon

### ПРЕДУПРЕЖДЕНИЕ:

#### Автор программного продукта, именуемого здесь и далее
"Монитор Websmon",
не может нести ответственности НИ В КАКОЙ ФОРМЕ
за любые возможные последствия инсталляции и/или
последующего использования данного программного продукта.

Для установки Websmon Вам необходимо зарегистрироваться в системе как root:

    	su root

Смонтируйте дистрибутивный CD-ROM (например, на /mnt) и запустите инсталляционный скрипт:

    	sh /mnt/install.sh

Вы также можете скопировать файлы, соответствующие операционной системе того сервера, на котором будет работать монитор, в какой-либо временный каталог (например, /tmp) и произвести установку Websmon из этого каталога:

    	cp /mnt/* /tmp        # файлы, общие для всех ОС
    	cp /mnt/rhl/* /tmp    # файлы для Red Hat Linux 9 / RHEL AS 3.0
    	sh /tmp/install.sh

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

Введите YES (или просто нажмите ENTER) для продолжения инсталляции, или введите NO для прекращения работы скрипта.

Инсталляционный скрипт начнёт установку монитора Websmon, создавая, если это требуется, группу websmon, пользователя websmon и домашний каталог /home/websmon и попросит установить новый пароль для пользователя websmon.

Если пользователь websmon или группа websmon уже существуют в системе, то соответствующие действия будут пропущены.

Затем скрипт изменит рабочий каталог в /home/websmon и установит файлы монитора в этот каталог, используя архивные (.tgz) файлы, соответствующие данной операционной системе.

После установки файлов инсталляционный скрипт изменит файл .profile пользователя websmon, добавив в него несколько определений переменных shell из файла /home/websmon/misc/profile, изменит владельца файлов и каталогов в /home/websmon:

    	chown -R websmon:websmon /home/websmon

и изменит права доступа в /home/websmon, запретив доступ всем, кроме самого пользователя websmon и пользователей из группы websmon:

    	chmod 770 /home/websmon

Затем скрипт создаст несколько symlink'ов в /usr/lib (для библиотек из /home/websmon/lib: libperl, libgd, libpng, libz, libjpeg); указанные symlink'и будут созданы, только если они необходимы для работы монитора Websmon в данной системе.

После этого скрипт спросит, требуется ли для работы монитора Websmon выделенный Web-сервер Apache (рекомендуется), или же систему графического представления статистики wmshow предполагается запускать под управлением уже установленного в системе сервера Apache (в последнем случае после установки Websmon необходимо будет изменить конфигурационный файл httpd.conf - подробнее см. п.4.)

В случае установки выделенного Web-сервера Apache необходимо указать номер порта, на котором будет работать сервер (рекомендуется порт 8080 - проверьте заранее, не используется ли уже этот порт каким-либо сервером в системе; можно использовать любой свободный порт, например, обычный для HTTP-сервера порт 80, но для портов с номерами, меньшими чем 1023, сервер должен быть запущен от имени super-user, т.е. root).

Инсталляционный скрипт затем запросит, нужно ли запускать Web-сервер автоматически во время загрузки ОС (как boot-скрипт в каталогах /etc/inid.d и /etc/rcN.d) и при положительном ответе (что рекомендуется) создаст symlink'и на управляющий скрипт Web-сервера Apache /home/websmon/bin/wmhttpd. После этого скрипт предложит запустить Web-сервер.

Затем инсталляционный скрипт вызовет программу настройки конфигурационных файлов монитора wmsetup (см. п.6), настроит crontab пользователя websmon (см. п.7), и сообщит о конце инсталляции.

По окончании инсталляции монитора Websmon Вы можете захотеть проверить, работает ли Web-сервер Apache - подробнее см. п.9.

### 4. Настройка конфигурационного файла Apache httpd.conf

Если Вы не хотите использовать Web-сервер Apache, поставляемый в составе Websmon, а предпочитаете уже существующий в системе сервер Apache (например, находящийся в каталоге /usr/local/apache), то Вам необходимо будет добавить в конфигурационный файл Вашего сервера /usr/local/apache/conf/httpd.conf содержимое файла /home/websmon/misc/apache.conf:

    	cat /home/websmon/misc/apache.conf >>/usr/local/apache/conf/httpd.conf

После этого Вам необходимо будет проверить новую конфигурацию Apache:

    	/usr/local/apache/bin/apachectl configtest

и перезапустить Web-сервер:

    	/usr/local/apache/bin/apachectl restart

### 5. Создание account'ов для пользователя websmon

Создайте account'ы для пользователя websmon (или того пользователя, имя которого Вы указали при инсталляции монитора) на всех удалённых серверах UNIX, с которых должна собираться статистика, например, используя команду

    	/usr/sbin/useradd -d /home/websmon websmon

Обеспечьте беспарольный доступ пользователя websmon к указанным удалённым UNIX-серверам по протоколу ssh (или rsh, если Вы предпочитаете использовать этот протокол).

### 6. Настройка конфигурационного файла websmon.ini

Файл websmon.ini, содержащий информацию о хостах и серверах БД, для которых должна собираться статистика и за активностью которых необходимо наблюдать, должен находиться в каталоге /home/websmon (или в каталоге, определяемом переменной среды WEBSMON, или же в каталоге /etc; будет использован первый найденный конфигурационный файл).

Файл состоит из секций, названия которых соответствуют именам хостов (например, секция [saturn] определяет хост с именем saturn) и серверов БД PROGRESS.

Пример: секция [saturn:bisquit] определяет сервер БД bisquit, работающий на хосте saturn; здесь bisquit является именем TCP сервиса, который определён в файле /etc/services, и, разумеется, определения сервисов на сервере статистики и на сервере saturn должны совпадать (вместо имён сервисов Вы можете использовать номера соответствующих портов TCP).

Каждое определение хоста и сервера БД должно располагаться в своей секции.

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

Одна из них - это секция [:default:], содержащая информацию о параметрах хостов и серверов БД по умолчанию, что позволяет опустить большинство параметров при добавлении новых секций.

Другая - секция [:license:], которая содержит лицензионную информацию системы Websmon.

Добавьте полученный Вами регистрационный код лицензии (параметр RegCode), и, возможно, серийный номер лицензии (параметр S/N) и параметры MaxUnixSrv (максимальное число UNIX серверов, позволенное для мониторинга) и MaxProgSrv (максимальное число серверов БД PROGRESS) в секцию [:license:].

Затем определите все те хосты и серверы БД, за активностью которых Вы хотите наблюдать и/или статистику использования ресурсов которых Вы хотите собирать.

Обязательными являются следующие параметры:

- Для хостов - имя хоста (т.е. название секции в форме [hostname]) и тип операционной системы (параметр ostype);
- Для серверов БД - имя хоста и сервиса БД (т.е. название секции в форме [hostname:service]).

Прочие параметры при их отсутствии будут взяты из секции [:default:].

Заметьте, что статистика использования ресурсов серверов UNIX будет собираться только для хостов с ostype=unixware, ostype=solaris, или ostype=linux и параметром active, установленным в значение yes или 1.

Для серверов БД PROGRESS статистика будет собираться, если параметр dbactive установлен в значение yes или 1.

Список всех допустимых параметров файла websmon.ini и их описание Вы можете найти в файле документации Websmon.

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

    	/home/websmon/bin/wmsetup

или

    	/home/websmon/bin/wmsetup config_file.ini

### 7. Настройка crontab

Для автоматического сбора статистической информации создаётся crontab для пользователя websmon, прототип которого находится в файле /home/websmon/misc/crontab.

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

    	su root -c "crontab -e -u websmon"

Сбор статистической информации осуществляется (по умолчанию каждые 5 минут) вызовом команды (скрипта)

    	/home/websmon/bin/websmon

Проверку активности хостов, TCP сервисов и серверов БД производит (по умолчанию ежеминутно) команда

    	/home/websmon/bin/wmwatch

Архивирование первичной статистической информации, хранимой в файлах данных в CSV формате, также как и файла протокола работы всех систем монитора Websmon websmon.log, производится ежемесячно вызовом команды (скрипта)

    	/home/websmon/bin/wmzip

### 8. Лицензионная информация

Временную лицензию (trial license) для использования монитора Websmon Вы можете получить бесплатно, отправив письмо по адресу:

    	Websmon demo license <websmon@websmon.com>

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

Уникальный идентификатор Вашей системы Вы можете узнать при помощи команды

    	/home/websmon/bin/wmsysid

Для изменения лицензии отредактируйте секцию [:license:] конфигурационного файла websmon.ini, либо воспользуйтесь программой

    	/home/websmon/bin/wmsetup -license

Примечание: постоянная лицензия Websmon зависит от особенностей аппаратной конфигурации Вашей системы; таким образом, при изменении hardware Вам, возможно, придётся обратиться за обновлённой лицензией, каковая лицензия будет Вам незамедлительно предоставлена, разумеется, без дополнительной оплаты.

### 9. Запуск монитора Websmon

Запуск системы сбора статистики будет произведён автоматически после настройки конфигурационного файла websmon.ini и crontab пользователя websmon (обратите внимание на порядок действий - настройка конфигурационного файла должна быть проведена в первую очередь).

Разумеется, пользователь websmon должен иметь право использовать cron - и, возможно, Вам нужно будет проверить системные конфигурационные файлы cron.allow и cron.deny.

Запуск системы графического представления статистики требует работающего Web-сервера Apache. Для запуска Web-сервера Apache, входящего в состав Websmon, Вы можете воспользоваться командой

    	/home/websmon/bin/wmhttpd start

Проверить работоспособность вышеуказанного Web-сервера можно, набрав в браузере адрес тестовой страницы сервера Apache:

    	http://HOSTNAME:PORT

Здесь HOSTNAME - это имя того сервера UNIX, на котором установлен монитор Websmon и работает Apache httpd, а PORT - номер порта (сервиса HTTP). Имя сервера можно узнать, вызвав команду

    	/bin/hostname

По умолчанию для монитора Websmon номер порта установлен в 8080. Номер порта может быть изменён, см. файл /home/websmon/apache/conf/httpd.conf, параметр Port.

Главная (стартовая) страница системы графического представления статистики, собранной монитором Websmon, доступна по следующему адресу:

    	http://HOSTNAME:PORT/websmon

Примечание: статистика использования того или иного системного ресурса будет отображаться в мониторе Websmon после двукратного сбора статистических данных (т.е. после 2 * 5 = 10 минут работы системы сбора статистики, при установках в websmon.ini по умолчанию).

PROGRESS © is a trademark of the Progress Software Corporation