SAMS2 Установка
Требования | Оглавление | Настройка

# 3 Установка

## 3.1 Загрузка дистрибутива

Для загрузки дистрибутива зайдите на http://sams.nixdev.net и выберите наиболее предпочтительный вариант. Если дистрибутив представлен в виде собранного пакета для вашей операционной системы, то установите его, используя соответствующий менеджер пакетов, и переходите к этапу настройки. Если же вы выбрали установку из исходных кодов, то пора переходить к этапу сборки.

## 3.2 Компиляция исходных текстов

1. У вас должен быть файл sams2-VERSION.tar.gz. Распакуйте его с помощью команды

       $ tar xzf sams2-VERSION.tar.gz

2. Перейдите в полученную директорию

       $ cd sams2-VERSION

3. На этом этапе вам необходимо создать скрипт автоматической конфигурации для компилирования. Используйте команду

       $ make -f Makefile.cvs

   (на некоторых операционных системах используется gmake)

4. Далее запустите скрипт автоматической конфигурации

       $ sh ./configure

   В этом случае скрипт попробует найти все необходимые зависимости самостоятельно и в дальнейшем будет произведена установка в /usr/local. Если вы хотите устанавливать SAMS в другую директорию, или необходимые пакеты находятся не в стандартном месте, или конфигурация по умолчанию вас не устраивает, то воспользуйтесь опциями configure, список которых можно получить, выполнив команду

       $ sh ./configure --help

   По окончанию конфигурирования обратите внимание на используемые библиотеки (API). Из трех возможных вариантов баз данных, должен быть сконфигурирован хотя-бы один, иначе SAMS работать не сможет. Соответственно, если библиотека подключения к какой-либо БД не сконфигурирована, то в дальнейшем вы не сможете использовать эту БД в качестве хранилища данных SAMS.

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

   По умолчанию, документация для исходных текстов не компилируется. Для компиляции и последующей установки этой документации необходимо иметь установленный пакет doxygen и добавить опцию --with-srcdocs.

       $ sh ./configure --with-srcdocs

   Запомните пути, которые выводятся в самом конце, они вам понадобятся в дальнейшем, на этапе системных настроек.

5. После успешного конфигурирования необходимо запустить процесс компиляции. Выполните команду

       $ make

   (Не забывайте что на некоторых операционных системах используется gmake)

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

## 3.3 Установка из исходных текстов

Для установки необходимо обладать привилегиями root, для этого, находясь в директории, где происходила компиляция, выполните команды

    $ su

Password: <тут самый секретный пароль>

    # make install

После этого все модули будут установлены и можно приступать к системным настройкам.

Надо написать как поставить отдельный модуль (web, daemons, doc)

## 3.4 Системная настройка

1. Измените владельца файлов web интерфейса на пользователя и группу http сервера. Их можно узнать в файле httpd.conf, параметры User и Group соответственно. Например,

       chown -R apache:apache /usr/local/share/sams2-2.0.0

2. Измените владельца конфигурационного файла sams2.conf на пользователя и группу http сервера. Например,

       chown apache:apache /usr/local/etc/sams2.conf

3. Скопируйте файл redhat/httpd_conf из директории дистрибутива в директорию конфигурационных файлов http сервера, переименовав его в sams2.conf. Например,

       cp redhat/httpd_conf /etc/httpd/conf.d/sams2.conf

4. Замените в файле, скопированном в предыдущем пункте, ключевое слово __WEBPREFIX на директорию, где находятся файлы web интерфейса. Воспользуйтесь предпочитаемым редактором или возьмите за основу следующую команду:

       sed -i -e 's|__WEBPREFIX|/usr/local/share/sams2-2.0.0|' /etc/httpd/conf.d/sams2.conf

5. Перезапустите http сервер для того чтобы изменения вступили в силу. Например,

       /etc/init.d/httpd restart

6. Установите скрипт запуска демона.

       cp redhat/init.d /etc/init.d/sams2

   Замените в файле ключевое слово __PREFIX на директорию, где находится исполняемый файл демона, а ключевое слово __CONFDIR на директорию, где находится конфигурационный файл SAMS. Воспользуйтесь предпочитаемым редактором или возьмите за основу следующую команду:

       sed -i -e 's|__CONFDIR|/usr/local/etc|' -e 's|__PREFIX|/usr/local/bin|' /etc/init.d/sams2

   Добавьте скрипт в базу данных chkconfig.

       /sbin/chkconfig --add sams2

   Включите его выполнение на уровнях по умолчанию.

       /sbin/chkconfig sams2 on

## 3.5 Создание базы данных SAMS

### Создание базы данных SAMS в СУБД MySQL

База данных SAMS для MySQL создается автоматически при первом запуске WEB интерфейса.

### Создание базы данных SAMS в СУБД PostgreSQL

1. Создание пользователя

Вы должны создать пользователя только для базы данных SAMS.
Следующая команда создает нового пользователя "username" и запрашивает пароль этого пользователя:

createuser --pwprompt --encrypted --no-adduser --no-createdb username

2. Создание базы данных SAMS

Вы должны создать базу данных только для использования с SAMS.
Следующая команда создает новую базу данных "databasename", принадлежащую пользователю "username":

createdb --owner=username databasename

Требования | Оглавление | Настройка