Изменения

VPNtest: Руководство администратора

10 байтов добавлено, 23:12, 28 августа 2009
Нет описания правки
== Термины, сокращения и предположения ==
; '''СТ''': Система Тестирования
; '''Рабочие таблицы БД''': Таблицы, используемые для хранения актуальных данных
; '''Архивные таблицы БД''': Таблицы, используемые для хранения архивных данных (результатов прошедших тестирований)
; '''Загрузка вопросов в БД''': Заполнение таблицы вопросов заранее подготовленным содержимым, [[#подготовка_текстового_файла_с_вопросами_тестаПодготовка текстового файла с вопросами теста|исходным форматом]] является текстовый файл
; '''Регистрация слушателя''': Заполнение анкеты, выбор логина и пароля, создание учётной записи слушателя в СТ
; '''Авторизация слушателя''': Процесс «опознания» зарегистрированного слушателя, включает проверку пароля
== Установка СТ ==
СТ устанавливается на специально выделенный компьютер — «сервер». В случае Windows-машины сервер проще всего организовать с помощью системы типа «Денвер» ([http://www.denwer.ru/ Д.Н.W.Р. — Джентльменский Набор Web-Разработчика]) или [http://www.apachefriends.org/en/xampp.html XAMPP].
=== Установка Денвера ===
# Вы (Администратор СТ) должны выбрать имя для виртуального «сайта» с тестами — по умолчанию ''vpntest.ru''
# На компьютере Администратора СТ, который будет выступать сервером для слушателей, установите базу: Apache + PHP + MySQL c помощью, например, Денвера (Джентльменский Набор Web-разработчика), бесплатный дистрибутив которого можно скачать здесь: [[http://www.denwer.ru/dis/Base_PHP5/Base_PHP5_2006-04-25_a1.3.31_p5.1.2_m4.1.16_pma2.6.1.exe]Base_PHP5].
#: '''Примечание:''' Если на компьютере Администратора СТ уже установлены Apache, PHP и MySQL, можете использовать их.
#: '''Примечание:''' Если на рабочем столе не появится ярлыков "«'''Start Servers'''"», "«'''Restart Servers'''"», "«'''Stop Servers'''"», создайте их вручную - вручную — ярлыки на ''C:\WebServers\etc\Run.exe''  — запуск серверов, ''C:\WebServers\etc\Restart.exe''  — перезапуск серверов и ''C:\WebServers\etc\Stop.exe'' -  — останов серверов. Здесь ''C:\WebServers\etc\''  — установочная директория Денвера.# Запустите Денвер, дважды кликнув по ярлыку "«'''Start Servers'''"».
# Задайте Пароль пользователя БД. Для этого:
#* Зайдите в браузере по адресу [[http://localhost/Tools/phpMyAdmin/]http://localhost/Tools/phpMyAdmin/],#* Выберите "«'''Привилегии'''"»,#* Кликните по иконке "«'''Редактирование привилегий'''" » справа от строки с Пользователем БД "«'''root'''"»,
#* Заполните поля '''Пароль''' и '''Подтверждение пароля''',
#* Выберите радиокнопку рядом со словом "«'''Пароль'''"»,#* Нажмите "«'''Пошёл'''"».# Остановите Денвер, дважды кликнув по ярлыку "«'''Stop Servers'''"».# Пусть Z:\ -  — виртуальный диск, созданный Денвером, тогда удалите всё, кроме папки ''localhost'', из папки ''Z:\home''. \\ #: Папку "localhost" «localhost» можно и удалить, но лучше переместите её куда-нибудь в недоступное по HTTP место, чтобы иметь возможность при необходимости воспользоваться phpMyAdmin-ом.# Добавьте в файл ''Z:\usr\local\apache\conf\httpd.conf'' строчку ''Listen *:80''  — это требуется для того, чтобы Apache слушал 80-й порт и принимал входящие соединения от всех IP-адресов, то есть, цель данного пункта – пункта — сделать возможным заходить в систему тестирования с компьютеров слушателей.
=== Установка СТ ===
# Создайте в Z:\home папку с именем vpntest.ru (с именем хоста – хоста — виртуального "сайта" – «сайта» — см. п.1) и распакуйте в эту папку архив с дистрибутивом системы тестирования.#* После установки подпапка ''WWW'' эквивалентна корню "сайта" «сайта» ''vpntest.ru''.#* В подпапке ''WWW'' расположены файлы, отвечающие за регистрацию и тестирование: #* В ''WWW/admin/'' расположена администраторская часть системы. #* В ''WWW/lib/'' расположены библиотеки функций, используемые системой при работе, а также ''config.php''  — конфигурационный файл.
# Сконфигурируйте систему тестирования. Для этого отредактируйте конфигурационный файл ''config.php'', который находится в папке ''Z:\home\vpntest.ru\WWW\lib\config.php'', следующим образом:
#* Откройте для редактирования файл ''config.php''
#* Проведите следующие настройки:
#* В строке ''$dbuser ='' введите имя Пользователя БД. \\ #: По умолчанию значение переменной ''$dbuser'' = "root"«root». \\ #: Если Пользователь БД имеет другой логин и обладает меньшими, чем у root, привилегиями, измените значение этой переменной. При этом вы можете поднять уровень безопасности.#* В строке ''$dbpwd ='' введите пароль Пользователя БД, который вы задали в пункте 4. \\ #: ''$dbpwd'' = "11111" «11111» (в данном случае). \\ #: Значение переменной ''$dbpwd'' требуется менять сразу после установки, а также при смене пароля на доступ к БД. \\ #: Пароль к БД хранится в конфигурационном файле ''config.php'' в открытом виде. Однако, даже если убрать ''.htaccess'', доступ к нему пользователи не получат, т.к ''config.php'' лишь проинтерпретируется PHP и ничего не выдаст на экран.#* В строке ''$TriesCount ='' установите количество попыток ответа на один вопрос \\ #: ''$TriesCount = 2'' (при четырех вариантах ответов этого будет достаточно).#* В строке ''$TimeLimit ='' установите время ответов на вопросы теста в секундах: \\ #: ''$TimeLimit = 60*100'' (в данном случае 100 минут). \\ #: Если значение переменной ''$TimeLimit'' меньше или равно 0, временной лимит отключён. \\ #: Если строка с этой переменной закомментирована, временной лимит отключён.#* В строке ''$DoNotShowResults ='' установите значение false, чтобы пользователи могли посмотреть количество правильных ответов в процентах по отношению к количеству всех вопросов. #* Сохраните изменения в файле конфигурации config.php. \\ #: '''Внимание!''' До тех пор, пока вы не отредактируете файл ''config.php'', вы не сможете зайти в Панель Управления СТ.
# Установите входные данные '''Администратора СТ'''.
#* Используется HTTP-аутентификация. Логин и пароль Администратора СТ хранятся в отдельном файле "passwords" «passwords» (в хэшированном виде), который вы создаёте при установке.
#* Установите Логин и Пароль Администратора СТ. Для этого:
#* '''Наберите в командной строке''' Windows: ''Z:\usr\local\apache\bin\htpasswd –с Z:\home\vpntest.ru\ passwords ЛОГИН_АДМИНА''
#* Далее дважды введите пароль, который станет Паролем администратора СТ.
#* После установки Логина и Пароля администратора СТ в двух файлах ''.htaccess'' поменяйте строчку ''Require user vmx'' на строчку ''Require user ЛОГИН_АДМИНА'', где ЛОГИН_АДМИНА – ЛОГИН_АДМИНА — указанный вами Логин Администратора СТ. Файлы .htaccess находятся в папках:
#** ''Z:\home\vpntest.ru\WWW\admin\.htaccess''
#** ''Z:\home\vpntest.ru\WWW\lib\.htaccess''
Произведите '''Инициализацию БД''':
* Запустите Денвер, дважды кликнув по ярлыку "«'''Start Servers'''"»* В браузере зайдите по адресу [[http://vpntest.ru/admin/]]* Введите ЛОГИН_АДМИНА - ЛОГИН_АДМИНА — '''Логин Администратора СТ''' и соответствующий пароль - пароль — '''Пароль Администратора СТ''' в высвечивающемся окне аутентификации* Нажмите на кнопку "«'''Инициализировать БД'''"»* Перейдите по ссылке "«'''К архиву'''" » под заголовком страницы* Перейдите по ссылке "...нажмите «…нажмите __'''сюда'''__, чтобы произвести инициализацию..."инициализацию…»
'''БД инициализирована.'''
Загрузка вопросов из текстового файла.
* В Панели Управления СТ нажмите кнопку "«'''Обзор'''" » ("Browse"«Browse»)
* Выберите подготовленный заранее текстовый файл с вопросами теста
* Задайте вариант для вопросов загружаемого файла (или оставьте его равным значению по умолчанию = 1)
* Нажмите кнопку "«'''Загрузить вопросы в БД'''"»
* После этого вопросы будут загружены в БД, а вам будет показан результат операции загрузки вопросов (были ошибки или нет). Также система покажет детальную информацию обо всех этих ошибках.
: '''Замечание:''' Если в БД уже загружены вопросы, которые требуется уничтожить перед добавлением новых – новых — установите флажок "«'''Перезаписать БД вопросов'''" » и нажмите кнопку "«'''Загрузить вопросы в БД'''"».
=== Конфигурирование клиентских компьютеров ===
Чтобы компьютеры слушателей могли найти хост ''vpntest.ru'', добавьте на компьютерах локальной сети, кроме компьютера Администратора СТ ([[http://www.denwer.ru/|Денвер]]  — сам разберётся) в файл hosts строчку вида ''192.168.0.10 vpntest.ru'', где 192.168.0.10 надо заменить на IP-адрес компьютера Администратора СТ, а vpntest.ru - ru — на установленное имя виртуального хоста.
Файл hosts расположен в:
* В Windows NT/2K/XP/Vista - Vista — C:\WINDOWS\SYSTEM32\DRIVERS\ETC\hosts* В Windows 9x/Me - Me — C:\WINDOWS\hosts.sam* В Linux и других UNIX-системах - системах — /etc/hosts
На всех компьютерах локальной сети в свойствах браузера отключите использование HTTP прокси-серверов.
== Панель управления СТ ==
Когда вы заходите в браузере по адресу [[http://www.vpntest.ru/admin/]], - появится окно с запросом авторизации:
[[Изображение:VPNtest - HTTP-аутентификация Администратора СТ.png]]
* Списка вопросов.
Название теста можно задать в строках, начинающихся с ''<code>###'' </code> (трёх решёток). Все эти строки склеиваются через ''<br />'' (для HTML это перевод строки) и сохраняются в БД как название теста.
Список вопросов:
В любом месте файла с вопросами могут присутствовать пустые строки и комментарии. Пустой строкой считается строка, содержащая не более, чем пробелы и символы табуляции. Кроме того, пробелы и табуляции в начале и конце всех строк обрезаются, то есть, отступы не играют вообще никакой роли. Комментариями в файле вопросов считаются строки, начинающиеся с '';;;'', то есть, с «трёх точек с запятой». При обработке файла комментарии игнорируются так же, как и пустые строки.
И вопросы, и ответы — не просто текст: допускается использование HTML кода. Например, чтобы вставить в текст вопроса или ответа перевод строки, вы должны написать ''<nowiki><br /></nowiki>''. Чтобы вставить в текст вопроса или ответа изображение — напишите ''<img src="путь_к_картинке">''. Путь к картинке задаётся относительно корня директории WWW. Рекомендуется писать пути в стиле ''<nowiki><img src="/dir1/dir2/.../img.png"></nowiki>'' — тогда вы будете абсолютно уверены в том, что картинки везде отобразятся корректно и возьмутся из ''/home/vpntest.ru/WWW/dir1/dir2/.../img.png''.
==== Пример файла с вопросами ====
==== Просмотр результатов тестирования ====
В крайней правой ячейке каждой строки со слушателями вы можете заметить ссылку «'''. . .'''» — нажав на эту ссылку, вы увидите анкету слушателя и все его результаты.
Также вы можете посмотреть полный список результатов '''всех''' выведенных пользователей — для этого перейдите по ссылке «'''Подробные результаты'''». Вы увидите ответы слушетелей на все вопросы теста — правильные и неправильные ответы, а также вопросы, на которые не были даны ответы.
==== Просмотр данных снимка ====
* Выведите на экран список снимков в соответствии с пунктом «[[#вывод_списка_снимков|Вывод списка снимков]]»
* Найдите в этом списке требуемый снимок.
* Выберите его, кликнув по названию.
* '''Теперь вы можете:'''
** Просмотреть список пользователей из снимка (аналогично пункту [[#возможные_операции_со_списком_слушателей|Возможные операции со списком слушателей]]), кликнув по ссылке «'''Список слушателей'''», или «'''. . .'''» рядом с ним — в этом случае будет показана форма поиска слушателей.
** Просмотреть список результатов, переходя по ссылкам из списка пользователей.
** Просмотреть список вопросов из снимка, кликнув по ссылке «'''Список вопросов'''».
Чтобы удалить снимок:
* Выведите на экран список снимков в соответствии с пунктом «[[#вывод_списка_снимков|Вывод списка снимков]]»
* Найдите в этом списке требуемый снимок.
* Выберите его, кликнув по названию.