Документация SBSS
Документ содержит описание работы 3-х из 4-х реализованных в SBSS подсистем. По сравнению с описанием HelpDesk 2.0 добавлена информация о функционировании CRM системы, формированию базы знаний, работе с объектами CRM (присоединение файлов к карточке клиента и т.д.).
В течение июня 2008г. текущая документация будет дополнена информацией о работе системы активации копий. В частности раздел №5 будет содержать подробности генерации лицензий (ключей активации), процедур активации и проверки лицензий сторонним ПО через SBSS, а также инструкции по встройке необходимого для этого кода (описание библиотеки активации и проверки корректности лицензии) в приложение.
В течение июня также будет опубликована обновленная инструкция по установке и развертыванию SBSS 2.1 Beta, включая бинарные модули E-mail connector и Copy Activator.
В ближайшем будущем планируется обновление данного файла более подробным описанием процесса установки.
Первая сборка HD состоит только из PHP кода, который устанавливается под управлением Apache 1.3.x or 2.x. В Apache должен поддерживать php 5.x транслятор, установленный как загружаемый модуль или в качестве внешнего CGI приложения с библиотекой mysql.
LB HD использует СУБД MYSQL 5.x.x для хранения информации. Поэтому Вам необходимо установить MYSQL server и сконфигурировать его как описано в прилагающейся к нему инструкции.
Перед эксплуатацией ПО LB HD необходимо:
1) создать базу данных
2) создать и дать права доступа пользователю (mysql user) для полного контроля над созданной базой данных
3) создать структуру таблиц в базе данных (или структуру с примерами данных) при помощи .sql файлов, входящих в дистрибутив
4) извлечь php код в дерево web-сервера
5) настроить код
Все вышесказанное в деталях:
1) Первый шаг простейший. Если Ваш MySQLl сервер установлен и работает, выполните следующую команду под полномочиями администратора из консоли ОС:
#> mysqladmin create helpdesk
"helpdesk" - это название БД по-умолчанию. Вы можете указать любое имя базы данных, которое пожелаете
2) Тоже весьма простой шаг. Введите указанную ниже команду в консоль:
#> mysql
Далее создайте "пользователя" базы данных. Полномочия данного пользователя будут использоваться
HD при осуществлении доступа к базе данных.
use mysql;
GRANT ALL ON helpdesk.* TO 'rdbuser'@'rdbhost' IDENTIFIED BY 'rdbpass';
flush privileges;
"helpdesk" - это название базы данных. Используйте любое имя, но главное то же самое,
что и при первом шаге.
3) Дистрибутив HD содержит два файла, описывающие структуру базы данных.
Первый (sql/create.sql) содержит структуру базы, но без данных. Второй (sql/create_example.sql)
состоит из простых примеров использования возможностей HD: одно описание ПО, один клиент,
один запрос на техническую поддержку, и четыре образца статуса запроса, которые могут быть
использованы в качестве шаблонов, для любых целей, которые вы преследуете использованием HD.
Любая структура может быть загружена в базу данных, созданной на первом шаге установки,
при использовании следующих ниже команд в строке консоли.
#> cd sql #> mysql helpdesk < create.sql OR #> mysql helpdesk < create_example.sql
Используйте одну из инструкций по созданию базы данных, а не обе одновременно.
4) Если вы это читаете, значит вы уже извлекли LB HD код используя:
#> tar zxvf LBHelpdesk.tgz
в директорию, заранее созданную для этих целей.
Если нет, то введите tar zxvf LBHelpdesk.tgz сейчас
Скопируйте весь извлеченный код в дерево apache. Например, если папки с HD
расположены в /home/www-data/helpdesk/ выполните следующую команду в папке, в которую
был извлечен архив LB HD.
#> cp -R * /home/www-data/helpdesk/
После этого вам доступен web - интерфейс HD через web - браузер (при условии, что
DocumentRoot находится в /home/www-data) по следующим ссылкам
http://webserver/helpdesk/admin/index.php - Интерфейс администратора
(По умолчанию, без пароля login: admin)
http://webserver/helpdesk/client/index.php - Клиентский интерфейс
(Пароль для клиента в базе create_example.sql: login: user1 password: 1b38cd)
http://webserver/helpdesk/regform.class.php - Регистрация нового клиента / пользовательский интерфейс
http://webserver/helpdesk/forget_pass.php - Клиентский интерфейс для восстановления пароля
5) Каждая из директорий:
/home/www-data/helpdesk/admin/ (mysql.class.php)
/home/www-data/helpdesk/client/ (mysql.class.php)
/home/www-data/helpdesk/ (mysql.class.php)
содержит файлы mysql.class.php и если атрибуты доступа к базе данных у вас отличаются от
заданных по-умолчанию:
database: hddist
user: root
password
host: localhost
Вам необходимо изменить атрибуты доступа к mysql в каждом файле перечисленном выше.
Знаем, как это утомительно, но в ближайшем будущем разработчики внесут в дистрибутив
файл конфигурации для всех типов интерфейса.
Кроме того, необходимо внести изменения в /home/www-data/forget_pass.php
Enjoy.
p.s. В ближайшее время разработчики осуществят "чистку" кода, подготовят версию документации
на английском языке, а также разместят TODO - список грядущих изменений/дополнений.





