## Инсталляция SAMS

### 1. Разархивируйте этот архив:

tar zxf sams-xxxxxx.tar.gz

будет создан каталог, в котором будет размещено содержимое архива.

### 2. Переместитесь в него

сd sams-xxxxxx

### 3. Соберите SAMS:

Для настройки конфигурации воспользуйтесь командой
% ./confugure

По путь по-умолчанию SASM находится /usr/local.
Если вы захотите изменить путь:
- к расположению программ и путь к расположению библиотек и файлов заголовков MySQL
- к каталогу расположения root директории http сервера (если путь к нему отличается от /var/www/html или /var/www/htdocs
- к каталогу расположения php, воспользуйтесь ключами configure
для получения списка опций настройки наберите:
% ./confugure --help

Если на этапе конфигурирования выдаются ошибки, проверьте наличие необходимых SAMS пакетов.

### 4. По завершении работы команды configure откомпилируйте дистрибутив и инсталлируйте его.

Linux:
% make
% make install

FreeBSD:
% gmake
% gmake install

Если на этапе сборки выдаются ошибки, проверьте наличие необходимых SAMS пакетов.

### 5.Расположение файлов SAMS (по-умолчанию)

По окончании инсталляции файлы SAMS будут проинсталлированы:
/etc:
sams.conf - файл конфигурации SAMS

/usr/local/sams:
файлы:
sams - анализатор логов squid
samsf - демон, создающий fifo файл, в который squid записывает логи.
samsdaemon - демон, отвечающий за переконфигурацию squid и автоматический запуск sams и samsf

/usr/local/share/sams:
файлы WEB-интерфейса sams

Каталог SAMS http сервера:
В результате инсталляции должен быть создан симлинк из root каталога http сервера на каталог web-интерфейса SAMS. Если он не создан, создайте симлинк из каталога вашего web-сервера на каталог /usr/local/share/sams
ln -s /usr/local/share/sams /our/path/www/htdocd/sams.

### 6.Запуск WEB интерфейса SAMS и создание баз SAMS в MySQL

Запустите броузер и подключитесь к WEB-интерфейсу SAMS:
http://localhost/sams

Ваш httpd сервер должен поддерживать работу php скриптов.Для работы WEB интерфеса SAMS необходимо установить модули php.
И настроить работу php в safe_mode: Настройка httpd сервера apache

Если базы SAMS еще не созданы, вам будет предложен диалог создания баз и пользователя SAMS в MySQL.
Заполните поля:
MySQL Hostname: - адрес сервера, на котором установлен MySQL
MySQL login: - Имя пользователя MySQL, имеющего права на создание баз данных (обычно это root)
MySQL password: - Пароль пользователя root
Create SAMS MySQL user - установите галочку, если вы хотите создать пользователя, от имени которого будет работать SAMS
SAMS MySQL user: Введите имя пользователя, от имени которого будет работать SAMS (если MySQL расположен на этом же хосте, то это будет, например, sams@localhost)
SAMS MySQL user password: Пароль юзера sams

Занесите введенные значения в файл конфигурации SAMS /etc/sams.conf:
MYSQLHOSTNAME=localhost - имя хоста, где стоит MySQL
MYSQLUSER=sams - Имя пользователя MySQL, от имени которого будет работать SAMS (sams@localhost писать ненадо!)
MYSQLPASSWORD=yourpasswd - Пароль пользователя в MySQL

Нажмите на кнопку "Create database", и, если поля формы были заполнены правильно, базы и пользователь SAMS будут созданы.

Нажмите на кнопку "Starting SAMS web interface".

Если данные в файл конфигурации sams.conf были занесены верно, то будет выведен WEB-интерфейс SAMS.

### 7. Измените владельца каталога /usr/local/share/sams на пользователя, от имени которого работает ваш web сервер

например:
chown -R apache:apache /usr/local/share/sams

### 8. Смените права доступа на католог /usr/local/share/sams/data на 777

Это должен сделать скрипт инсталляции

### 9. Слеюующие шаги вы должны сделать в WEB интерфейсе SAMS

### 10. Настройка SAMS на использование NTLM авторизации

Если планируется использовать NTLM авторизацию в домене Windows NT 4.0, настройте winbind, а также squid на работу с winbind-авторизацией.
Если планируется использовать NTLM авторизацию в домене Windows 2000/2003, настройте winbind, а также squid на работу с winbind-авторизацией.
Если планируется использовать LDAP авторизацию в Active Directory, настройте squid на работу с авторизацией в AD.

### 11. Настройка чтения логов SQUID

Чтение логов SQUID и занесение данных в базу данных SAMS может производится путем периодического чтения файла логов squid access.log

11.1 - /usr/local/bin/sams - запускается периодически и считывает информацию из файла access.log. Необходимо осуществлять запуск этой программы с периодичностью 1 раз в минуту.

Запуск программы sams может быть произведено samdaemon автоматически (см. настройку samsdaemon) или из cron
Для запуска ис cron создайте демону cron задание:
*/1 * * * * /usr/local/bin/sams

11.2 - /usr/local/bin/samsf - после запуска остается в памяти демоном, устанавливает fifo файл access.log. Этот режим на данный момент работает нестабильно, и использовать его не рекомендуется

### 12. Очистка счетчиков трафика пользователей

SAMS ведет учет объема информации, полученной пользователями. По превышении объема информации, пользователь отключается от доступа к прокси-серверу.

Необходимо настроить очистку счетчиков трафика пользователей. Это может быть произведено samdaemon автоматически (см. настройку samsdaemon)

или создайте демону cron задание:
0 0 1 * * /usr/local/sams/bin/sams -c

### 13. Настройка запуска samsdaemon

Настройте систему на автоматический запуск демона
/usr/local/bin/samsdaemon, необходимого для работы SAMS.

### 14. Дополнительно:

Незабудьте раскомментировать в php.ini вызов библиотеки mysql.so