Общество с ограниченной ответственностью
«Группа комплексных решений»
Утверждаю
|
Утверждаю
|
Заместитель директора
Департамента развития малого и среднего предпринимательства Министерства экономического развития Российской Федерации
___________________ М.В. Паршин.
«_____» __________________ 2009 г.
|
Генеральный директор
ООО «Группа комплексных решений»
___________________ В.Б. Безруков
«_____» __________________ 2009 г.
|
Автоматизированная информационная система «Региональный портал поддержки малого и среднего предпринимательства» (включает подсистему «Реестр субъектов МиСП – получателей поддержки)
пункт 1 календарного плана работ
к государственному контракту № 2102-05-09 от 25 августа 2009г
Инструкция по установке рабочей версии
на листах
Согласовано
|
Директор
Департамента развития малого и среднего предпринимательства Министерства экономического развития Российской Федерации
|
______________________ А.В. Шаров
|
г. Нижний Новгород
2009 г.
Аннотация
Данный документ содержит Инструкцию по установке рабочей версии Автоматизированной информационной системы «Региональный портал поддержки малого и среднего предпринимательства» (включает подсистему «Реестр субъектов МиСП – получателей поддержки) (далее – АИС «Региональный портал поддержки малого и среднего предпринимательства»).
Документ содержит сведения о структуре АИС «Региональный портал поддержки малого и среднего предпринимательства», настройке системы, проверке работоспособности.
Работы выполнялись в рамках ФЦП «Электронная Россия (2002-2010 годы)» в соответствии с Государственным контрактом № 2102-05-09 от 25 августа 2009г. между Министерством экономического развития Российской Федерации и Обществом с ограниченной ответственностью «Группа комплексных решений».
Содержание
1. Введение
Настоящий документ содержит инструкцию по установке рабочей версии АИС «Региональный портал поддержки малого и среднего предпринимательства».
Документ содержит сведения о структуре АИС «Региональный портал поддержки малого и среднего предпринимательства», действиях администратора по установке и настройке системы, проверке ее работоспособности.
2.УСТАНОВКА И УДАЛЕНИЕ системы
Перед установкой системы необходимо установить и настроить следующие продукты:
СУБД MySQL не ниже версии 5.0.20;
PHP не ниже версии 5.0 и сконфигурировать поддержку MySQL в PHP;
Apache не ниже версии 2.0 и сконфигурировать поддержку PHP.
Данные продукты устанавливаются и настраиваются администратором системы в соответствии с руководствами по установке продуктов (в состав дистрибутива системы не входят).
2.1.Дополнительные требования к настройке ПО
2.1.1.Конфигурация веб-сервера
Кодировка сайта: UTF-8. За это отвечает параметр AddDefaultCharset UTF-8 в файле httpd.conf. Несмотря на то, что в файле .htaccess сайта кодировка прописана дополнительно, мы рекомендуем Вам установить это значение.
Модуль mod_rewrite должен быть включен. За это отвечает строка:
LoadModule rewrite_module modules/mod_rewrite.so в файле httpd.conf.
Директива AllowOverride All в файле httpd.conf в секции:
Options FollowSymLinks
AllowOverride All
2.1.2.Директория сайта
Файлы разворачиваемого сайта будут находиться в каталоге /www/www
Сконфигурируйте Apache:
Если вы используете директиву DocumentRoot:
DocumentRoot "www/www"
Если вы используете виртуальные хосты:
DocumentRoot "www/www"
ServerName yoursite.name
2.1.3.Конфигурация PHP
Значение max_execution_time = 60
Значение memory_limit = 64
Значение file_uploads = On
Значение upload_max_filesize = 32M
Убедитесь, что в файле php.ini у вас отсутствует директива default_charset. Если она есть и имеет значение, отличное от utf-8, то установите значение в default_charset = "utf-8".
2.1.4.Конфигурация MySQL
В MySQL должен работать InnoDB.
В конфигурации MySQL (файл my.cnf) в секции [mysqld] добавьте значения:
max_allowed_packet=64M
и
default-character-set=utf8
2.1.5.Конфигурация пользователей MySQL
Система установки требует, чтобы перед началом установки в базе данных MySQL существовал пользователь с именем db_user и паролем s98zxzxQQ.
Вы можете использовать свои собственные пользователя и пароль в MySQL, но в этом случае Вы теряете возможность автоматической установки, импорт баз данных может пройти с ошибками, и вам придется переконфигурировать механизм поиска на сайте. Мы рекомендуем вам создать указанного пользователя, и сменить пароль после установки. Дополнительно см. раздел «После установки».
Для того, чтобы создать пользователя, запустите клиент MySQL и выполните следующие команды:
CREATE USER `db_user`@`localhost` IDENTIFIED BY 's98zxzxQQ';
GRANT ALL ON *.* TO 'db_user'@'localhost';
FLUSH PRIVILEGES;
2.2.Установка поискового механизма
На сайте используется внутренний поисковый механизм Sphinx. Для того, чтобы поисковый механизм начал функционировать вам необходимо установить компонент Sphinx перед тем как начать установку сайта. Для запуска процесса установки перейдите в каталог installer и запустите команду install_search_engine.sh
Примечание: в комплекте поставки поисковый механизм поставляется только для Linux, но вы можете найти версию и для других ОС, в том числе исходный код для Linux на сайте www.sphinxsearch.com.
Примечание: вам необходимы права пользователя root для выполнения установки.
Примечание: наличие работающего поиска необходимо для процесса автоматической установки сайта. Если по каким-либо причинам Sphinx не установился или не запускается, вы можете запустить автоматическую установку с ключом --no-search чтобы пропустить проверку наличия поиска в системе.
2.3.Установка системы
Существует два варианта установки системы – автоматическая и ручная.
2.3.1.Автоматическая установка
Автоматическая установка создана для быстрого и удобного разворачивания сайта. Обратите внимание, что установка работает только для ОС Linux и только от имени пользователя root. Для разворачивания системы под другие ОС перейдите в раздел «Ручная установка».
Для выполнения автоматической установки вы должны создать пользователя db_user в MySQL (см. раздел «Конфигурация пользователей MySQL»)
Для запуска установки запустите команду:
install.sh | tee log/install.log
Лог процесса установки может быть найден в файле log/install.log
В процессе автоматической установки выполняются следующие действия:
Проверка наличия необходимых компонентов, установленных в системе
(Checking for required software) – проверяет наличие всех требуемых компонент и их версии. Наличие всех компонентов нужных версий гарантирует успешную работу сайта. Исключение может составлять поиск (sphinx), и одна из двух проверок MySQL: mysql или MySQL-server-community.
Проверка запущенных сервисов (демонов)
(Checking for services're running) – сервисы, необходимые для работы сайта: httpd, mysqld, crond. За поиск отвечает сервис searchd.
Проверка возможности соединится с базой данных от имени пользователя db_user (MySQL connection) - см. «Конфигурация пользователей MySQL». В случае неудачной проверки установка прерывается.
Разворачивание файлов сайта (Processing directory structure) – распаковка файлов сайта в директорию /www, назначение разрешений за запись в требуемые каталоги сайта (см. «Права на запись»).
Проверка наличия баз данных в MySQL(Checking databases) – проверяет наличие баз данных с именами oops_classifier, oops_common, oops_registry. В случае, если хотя бы одна из баз существует, установка прерывается, кроме случая, когда указан ключ --force_db_create (см. «Ключи установки»)
Создание баз данных (Creating databases) – создает базы данных.
Установка баз данных (Installing databases) - устанавливает «Классификатор» и тестовый контент сайта.
Установка задач по расписанию (Installing cron tasks) – конфигурирует сервис cron на выполнение задач по расписанию (реиндексация поиска, и пр.). Задачи в cron устанавливаются для пользователя root, т.к. требуют перезапуск некоторых служб во время работы.
Запуск инсталлятора сайта(Running Oops installer) – запуск окончания установки из файла /www/Oops/Install.php.
После окончания установки необходимо перейти к процессу окончательного конфигурирования сайта. См. раздел «После установки».
2.3.2.Ключи установки
--no-search – не проверять наличие установленного поиска;
--force_db_create – создавать базы данных, если базы с такими именами уже существуют. При указании этого ключа для существующих баз будет сделано архивирование в директорию db_backup, и базы будут созданы заново. Этот ключ также может быть полезен для повторного запуска, если предыдущая установка прошла не до конца, но завершилась уже после создания баз.
2.3.3.Ручная установка
Если автоматический инсталлятор не может выполнить инсталляцию, вы можете использовать ручную инсталляцию.
-
Разверните содержимое из файла data/pmp_www_1.0.tar.gz в каталог /www (или другой по вашему выбору, при этом не забудьте сконфигурировать Apache на соответствующий каталог). После распаковки архива вы получите следующую структуру каталогов:
www – сайт;
Oops – библиотека, необходимая для работы сайта;
sql – файлы для создания баз данных;
bin – исполняемые файлы и скрипты, требуемые для работы сайта;
Сделайте назначение прав доступа на каталоги и файлы, которые могут изменяться веб-сервером (см. «Права на запись»);
Создайте базы данных oops_classifier, oops_common, oops_registry с кодировкой UTF8, например, командой:
CREATE DATABASE oops_classifier CHARSET=UTF8;
CREATE DATABASE oops_common CHARSET=UTF8;
CREATE DATABASE oops_registry CHARSET=UTF8;
Импортируйте файлы баз данных из директории sql в MySQL (файлы oops_classifier.sql, oops_common.sql, oops_registry.sql) командой:
mysql oops_classifier < oops_classifier.sql
mysql oops_common < oops_common.sql
mysql oops_registry < oops_registry.sql
Установите задачу по расписанию (если у вас установлен поиск) для cron командой:
crontab –e 23 00 * * * /www/bin/search_engine/reindex_full.sh
Перейдите в директорию www и выполните команду:
php -q install.php
2.3.4.Права на запись
Некоторые директории должны иметь права на запись от имени веб-сервера (обычно пользователь apache, группа apache) для следующих элементов:
www/www/.files (включая поддиректории)
www/www/.upload (включая поддиректории)
www/i/site
файл www/www/.settings
директория, в которую сохраняются файлы сессии (параметр session.save_path в php.ini)
директория, в которую временно сохраняются загружаемые файлы сессии (параметр upload_tmp_dir в php.ini)
2.4.После установки
Откройте установленный сайт и войдите в систему с помощью учетной записи «system» с паролем «default». Форма входа расположена в верхнем правом углу по ссылке «Вход».
Смените пароль встроенной записи «system», выбрав «Мой Профиль», а затем «Изменить свою регистрационную информацию». Рекомендуется выбрать сложный пароль.
Измените настройки сайта (логотип и название), выбрав в профиле «Изменить настройки портала/реестра» или набрав в строке адреса имя_сайта/admin.
Рекомендуется сменить пароль для пользователь db_user в базе данных MySQL. Если вы решите изменить пароль, измените также настройки в следующих файлах:
в файле конфигурации сайта /www/www/.boiler.php измените строку:
define("DATABASE_PASSWD","s98zxzxQQ");
на
define("DATABASE_PASSWD","новый_пароль");
в файле конфигурации поисковой системы (если установлена) изменить строку:
sql_pass = s98zxzxQQ
на
sql_pass = новый_пароль
Если поиск не был установлен, измените в файле /www/www/.boiler.php строку:
define("SEARCH_ENABLED", true);
на
define("SEARCH_ENABLED", false);
Если поиск был установлен, запустите реиндекс содержимого сайта, зайдя в систему под именем учетной записи «system», ввести любой запрос в строку поиска или введя в адресной строке имя_сайта/search. Над появившейся строкой поиска выберите ссылку «Do full index recreation», дождитесь окончания операции реиндексации, и после этого в командной строке выполните команду reindex_full.sh из каталога /www/bin/search_engine.
3.Настройка системы на параметры пользователя
Система поставляется с набором встроенных учетных записей пользователей. Каждому пользователю соответствует определенная роль и, соответственно, набор прав по отношению к системе. Добавление новых пользователей и назначение им прав в системе осуществляется через пункт меню «Администрирование» главного меню системы и разрешено для пользователя «root». (Пользователь «root» является администратором системы и имеет все права по отношению к ней. Этот пользователь создается автоматически при установке системы.) Иных настроек, кроме добавления пользователей и назначения их ролей в системе, для работы системы не требуется.
4.Проверка работоспособности
Проверка работоспособности системы производится путем запуска автоматизированной системы управления программами поддержки малого предпринимательства. Для этого необходимо в окне Internet Explorer ввести стартовый адрес системы в формате http:// ip-адрес портала/. Работоспособность подсистем проверяется путем последовательного обращения к пунктам меню.
Критерием нормального функционирования системы является отсутствие сообщений об ошибках, в том числе и в системных журналах регистрации ошибок. В ответ на действие пользователя система должна выполнять ожидаемое действие.
5.Лист регистрации изменений
№ п.п.
|
Дата
|
Описание изменения
|
Автор
|
Версия документа
|
1
|
09.11.2009
|
Первоначальная редакция
|
Гришагин А.В.
|
1
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
