subversion://[vpntest]/release/2.3/manual.txt Log in
ViewVC logotype

Annotate of /release/2.3/manual.txt

Parent Directory Parent Directory | Revision Log Revision Log

Revision 18 - (show annotations) (download) (as text)
Sun Feb 17 17:45:12 2008 MSK (12 years, 11 months ago) by vitalif
File MIME type: text/plain; charset=windows-1251
File size: 34138 byte(s)
Release 2.3

1 --------------------------------------------------------------
2 -- ИНСТРУКЦИЯ ПО ЭКСПЛУАТАЦИИ СИСТЕМЫ ТЕСТИРОВАНИЯ СЛУШАТЕЛЕЙ --
3 --------------------------------------------------------------
4 Copyright (c) 2006, Виталий Филиппов [VMX]
5
6 ***************************************************
7 *************** 1. Краткая информация ***************
8 ***************************************************
9
10 Назначение системы: тестирование слушателей и хранение архива их результатов
11 Текущая версия: 2.3
12 Список изменений: см. changelog.txt
13
14 Скачать новую версию системы и руководство по её использованию вы всегда можете с сайта http://vmx.yourcmc.ru.
15
16 ******************************************************
17 *************** 2. Структура руководства ***************
18 ******************************************************
19
20 1. Краткая информация
21
22 2. Структура руководства
23
24 3. Установка системы
25 3.1. Установка в локальной сети
26 3.2. Установка на реальный сервер
27 3.3. Обновление системы
28
29 4. Общая информация о системе
30 4.1. Процесс тестирования
31 4.2. Сама система
32 4.3. Файлы, относящиеся к системе
33 4.4. Способ вывода информации
34 4.5. Система хранения информации
35 4.6. Аутентификация и безопасность
36
37 5. Формат файла с вопросами
38
39 6. Конфигурирование системы
40 6.1. Конфигурационные переменные
41 6.2. Что вы ДОЛЖНЫ поменять после установки
42
43 7. Администрирование системы
44 7.1. Вывод информации о пользователях.
45 7.2. Просмотр списка вопросов в БД.
46 7.3. Загрузка вопросов из текстового файла.
47 7.4. Инициализация БД.
48
49 8. Работа с архивом результатов
50
51 9. Координаты автора
52
53 **************************************************
54 *************** 3. Установка системы ***************
55 **************************************************
56
57 Здесь приведены пошаговые инструкции для установки и обновления системы. Если вашей версии нет в списке инструкций к обновлению - воспользуйтесь ближайшими версиями.
58
59 *************************************************************
60 *************** 3.1. Установка в локальной сети ***************
61 *************************************************************
62
63 3.1.1. Выделить компьютер администратора, этот компьютер будет выступать сервером для остальных. Выбрать имя для виртуального "сайта" с тестами (по умолчанию "vpntest.ru" - в инструкции по установке везде прописано оно, если хотим другое, везде меняем)
64
65 3.1.2. Поставить на админский комп Денвер (Д.н.w.р) - Джентльменский Набор Web-разработчика.
66 Дистрибутив Денвера, с которым проводилась проверка системы, можно скачать здесь:
67 http://www.denwer.ru/dis/Base/Base_2005-10-07_a1.3.31_p4.4.0_m4.1.8_pma2.6.1.exe.
68 Если на админском компе уже установлены Apache, PHP, и MySQL, то используйте их, но если они у вас установлены не в составе чего-нибудь типа Денвера, то вы, скорее всего, продвинутый пользователь и настроите всё сами.
69 Если чего-то нету (например, установлен только Apache) - то проще всего удалить его и поставить Денвер.
70
71 Иногда бывает, что Денвер по каким-то причинам не в состоянии ни создать ярлыки, ни прописать в автозагрузке монтирование виртуального диска. Если ярлыки не появятся, тогда создать их вручную - на рабочем столе - ярлыки на <ПАПКА_С_ДЕНВЕРОМ>\etc\Run.exe (запуск серверов), <ПАПКА_С_ДЕНВЕРОМ>\etc\Restart.exe (перезапуск серверов) и <ПАПКА_С_ДЕНВЕРОМ>\etc\Stop.exe (остановка серверов). Виртуальный диск создаётся консольной утилитой subst командой вида "subst Z: <ПАПКА_С_ДЕНВЕРОМ>". Чтобы прописать в автозагрузку создание виртуального диска - создайте ярлык, ссылающийся на команду, указанную выше, в папке "Автозагрузка" меню "Пуск".
72
73 3.1.3. Запускаем Денвер. ("Start Servers")
74
75 3.1.4. Чтобы поменять пароль root'а на базу данных:
76 - зайти в броузере на http://localhost/Tools/phpMyAdmin/,
77 - выбрать "Привилегии",
78 - кликнуть по иконке "Редактирование привилегий" справа от строки с пользователем "root",
79 - там установить Пароль и Подтверждение пароля,
80 - выбрать радиокнопку рядом со словом "Пароль",
81 - нажать "Пошёл".
82
83 3.1.5. Останавливаем Денвер. ("Stop Servers")
84
85 3.1.6. Пусть Z:\ - виртуальный диск, созданный Денвером:
86 - из папки Z:\home удаляем всё, что там есть, КРОМЕ:
87 - папку "localhost" можно оставить, но лучше тоже убрать, однако не полностью - просто возьмите и переместите её куда-нибудь себе, иначе потом не сможете пользоваться phpMyAdmin (что, правда, при нормальной работе системы и не требуется)
88
89 3.1.7. Создать в Z:\home папку с именем хоста (vpntest.ru) и распаковать в неё архив с дистрибутивом системы.
90
91 3.1.8. Конфигурируем систему тестирования, изменяя Z:\home\vpntest.ru\WWW\lib\config.php. (см. секцию 6 "Конфигурирование системы")
92
93 3.1.9. Устанавливаем пароль администратора:
94 - набираем в командной строке "Z:\usr\local\apache\bin\htpasswd -с Z:\home\vpntest.ru\passwords ЛОГИН_АДМИНА"
95 - дважды вводим пароль, который станет паролем администратора
96
97 Потом, чтобы всё-таки можно было зайти в папку /admin/:
98 - в файлах "Z:\home\vpntest.ru\WWW\admin\.htaccess" и "Z:\home\vpntest.ru\WWW\lib\.htaccess"
99 меняем строчку "Require user vmx" на "Require user ЛОГИН_АДМИНА",
100 где ЛОГИН_АДМИНА - желаемый логин для администратора.
101 - если меняли vpntest.ru или имя диска, то в этих же файлах .htaccess надо в строчке
102 "AuthUserFile Z:\home\vpntest.ru\passwords" вместо Z:\home\vpntest.ru\passwords
103 прописать полный путь к файлу с паролями (по умолчанию - не надо)
104 - если поддаться соблазну и скопировать строчку из этого файла в командную строку через буфер обмена,
105 то htpasswd работать ОТКАЗЫВАЕТСЯ. Почему - непонятно. В общем, не поддавайтесь соблазну - вводите ручками :)
106
107 3.1.10. Вписать в Z:\usr\local\apache\conf\httpd.conf строчку "Listen *:80" - чтобы можно было заходить в систему тестирования с других компьютеров.
108
109 3.1.11. Если хотим, чтобы другие компы видели систему как домен, именем, то вписываем на всех компах локальной сети, кроме админского (тут Денвер сам разберётся) в файл C:\WINDOWS\SYSTEM32\DRIVERS\ETC\hosts (для Windows 9x C:\WINDOWS\hosts.sam) строчку вида "192.168.0.10 vpntest.ru", где 192.168.0.10 заменить на IP админского компа, а vpntest.ru - на установленное имя виртуального домена.
110
111 3.1.12. Запускаем Денвер. ("Start Servers")
112
113 3.1.13. В браузере зайдите на http://vpntest.ru/admin/:
114 - вводим ЛОГИН_АДМИНА и соответствующий пароль в высвечивающееся окошко аутентификации;
115 - жмём "Инициализировать БД".
116
117 3.1.14. В браузере же зайдите на кликните по ссылке под названием страницы: "к архиву" и произведите его инициализацию кликом по предлагаемой ссылке.
118
119 3.1.15. Загружаем вопросы, выбирая подготовленный заранее текстовый файл и нажимая "Загрузить". (см. секцию 5 "Формат файла с вопросами")
120
121 3.1.16. Если в броузере установлена работа через прокси-сервер, то виртуальный "домен" открываться не будет. Прокси надо везде отключить. На всех компьютерах.
122
123 3.1.17. Поздравляю! Система готова к работе.
124
125 ***************************************************************
126 *************** 3.2. Установка на реальный сервер ***************
127 ***************************************************************
128
129 Систему можно поставить на "реальный" веб-сервер, т.е отдельную машину, имеющую выделенный IP-адрес в интернете, с установленными на ней веб-сервером, сервером MySQL и модулем PHP; или на хостинг - любой, можно платный, можно бесплатный, главное это веб-сервер+PHP+MySQL.
130 Для установки на реальный веб-сервер:
131 3.2.1. Убедитесь, что на этом сервере (или хостинге) есть PHP и MySQL. Если сервер и нету, установите, но в данном случае Денвером, конечно, пользоваться не надо.
132 3.2.2. Вы должны получить в своё использование одну базу данных MySQL: "vpntest", а также имя пользователя MySQL и пароль. Скорее всего, Вам понадобится вручную создать БД, так как привилегий на программный запрос создания базы данных у Вас, скорее всего, не будет.
133 3.2.3. Также узнайте имя хоста, на котором запущен сервер MySQL. Для хостингов эту информацию Вам сообщит хостинг-провайдер, для сервера - администратор.
134 3.2.4. Далее вы должны установить систему в предоставленный вам HTTP каталог сервера. Это НЕ ЗНАЧИТ распаковать туда архив. HTTP каталог - это папка "WWW", в архиве она есть, и вы должны её содержимое залить в HTTP каталог сервера.
135 3.2.5. Теперь отконфигурируйте систему: в config.php вы должны прописать правильные значения переменных $dbhost, $dbuser, $dbpwd, $Domain (см. config.php и комментарии в нём, а также секцию 6 "Конфигурирование системы").
136 3.2.6. Установка пароля администратора происходит так же, как и обычно. Утилитой htpasswd создаётся файл паролей, который кладётся желательно в недоступный по HTTP каталог (т.е НЕ в папку WWW), в .htaccess прописывается полный путь к этому файлу.
137 3.2.7. Зайдите на сайт, который вы только что создали, на http://www.site.ru/admin/, введите имя и пароль администратора, "инициализируйте БД", потом зайдите в архив и инициализируйте его.
138
139 *****************************************************
140 *************** 3.3. Обновление системы ***************
141 *****************************************************
142
143 Если обновляем, например, с 1.0 на 2.0, то надо сначала сделать обновление с 1.0 на 1.1, потом с 1.1 на 2.0. То есть, обновления "накапливаются".
144
145 3.3.1. Обновление с 1.0 на 1.1:
146 3.3.1.1. копируем всё из архива vpntest_11.rar, заменяя всё, кроме .htaccess-ов и config.php
147 3.3.1.2. заходим на http://www.vpntest.ru/admin/update.php
148
149 3.3.2. Обновление с 1.1 на 2.x:
150 3.3.2.1. копируем всё из архива vpntest_21.rar, заменяя всё, кроме .htaccess-ов
151 3.3.2.2. config.php берём из архива и конфигурируем заново.
152 3.3.2.3. инициализируем архив: заходим в него - сначала на http://www.vpntest.ru/admin/, там ссылку "к архиву", там выбираем инициализацию.
153
154 3.3.3. Обновление с 2.1x на 2.2:
155 3.3.3.1. копируем всё из архива vpntest_22.rar, заменяя всё, кроме .htaccess-ов
156 3.3.3.2. config.php берём из архива и конфигурируем заново.
157
158 3.3.4. Обновление с 2.2 на 2.3: копируем всё из архива vpntest_23.rar, заменяя всё, кроме .htaccess-ов и config.php
159
160 ***********************************************************
161 *************** 4. Общая информация о системе ***************
162 ***********************************************************
163
164 *******************************************************
165 *************** 4.1. Процесс тестирования ***************
166 *******************************************************
167
168 Система предназначена для тестирования слушателей. Тестирование в данном случае означает, что есть набор или несколько наборов вопросов, на каждый из которых есть 4 ответа, из которых можно выбирать правильный. Правильный ответ ТОЛЬКО один. Если слушатель не отвечает на вопрос - это приравнивается к неправильному ответу. Каждый "набор" вопросов - это вариант теста. Вариант при тестировании выбирается СЛУЧАЙНО; вопросы внутри него СЛУЧАЙНЫМ образом перемешиваются. Результаты тестирования сохраняются ТОЛЬКО после того, как пользователь нажмёт кнопку "Закончить тестирование". Потом администратор, естественно, сможет посмотреть ответы слушателей в правильном порядке.
169 Существует возможность ограничить:
170 - время прохождения теста - за это отвечает конфигурационная переменная $TimeLimit
171 - ограничить количество раз, сколько ещё пользователь сможет НАЧАТЬ тестирование
172 - ограничить количество раз, сколько пользователь сможет менять свой ответ на один и тот же вопрос.
173 (см. секцию 6 "Конфигурирование")
174 Чтобы пройти тест, каждый слушатель сначала будет должен зарегистрироваться в системе, кликнув по ссылке "Зарегистрироваться" на главной странице системы тестирования. При этом он будет ДОЛЖЕН заполнить анкету. Далее администратор сможет просматривать информацию обо ВСЕХ слушателях, а каждый из них - ТОЛЬКО о себе и своих результатах. Также каждый пользователь может править свою анкету и менять пароль. Для этого ему надо выбрать "Править анкету..." на странице просмотра анкеты и результатов (на главной странице).
175 Пользователь НЕ СМОЖЕТ проходить тесты, если администратор не добавит ему одну или несколько возможных попыток, используя систему администрирования. (см. секцию 7 "Администрирование")
176 Пользователь также НЕ СМОЖЕТ проходить тесты, если база данных вопросов пуста. Информация о формате файла с вопросами - смотрите секцию "Формат файла с вопросами".
177
178 ***********************************************
179 *************** 4.2. Сама система ***************
180 ***********************************************
181
182 Сама система написана на веб-языке программирования PHP (требуется версия PHP не ниже 4.3.10), что делает её независимой от операционной системы - главное, что ей требуется - это подходящая программа-WWW-сервер (например, Apache), интерпретатор PHP >= 4.3.10, подключённый к WWW-серверу, и СУБД MySQL. Другие СУБД пока НЕ поддерживаются.
183 Для начала работы с системой наберите в адресной строке браузера http://www.vpntest.ru или другое заданное вами при установке доменное имя. Чтобы перейти в администраторский раздел, вы ДОЛЖНЫ знать логин и пароль админстратора, с которыми вы будете заходить на http://www.vpntest.ru/admin/.
184
185 ***************************************************************
186 *************** 4.3. Файлы, относящиеся к системе ***************
187 ***************************************************************
188
189 Директорией, в которую устанавливается система, является Z:\home\vpntest.ru, где Z - имя виртуального диска, создаваемого Денвером, а vpntest.ru - желаемое имя виртуального домена, на котором будет расположена система тестирования. Внимание! Когда сервера Денвера уже запущены, вы НЕ ДОЛЖНЫ менять имя этой папки.
190 Внутрь этой директории вы распаковываете архив с дистрибутивом системы. После установки подпапка WWW эквивалентна корню сайта vpntest.ru. В самой папке WWW расположены файлы, отвечающие за пользовательскую часть системы - часть, отвечающую за регистрацию и тестирование. В WWW/admin/ расположена администраторская часть системы. В WWW/lib/ расположены библиотеки функций, используемые системой при работе, а также config.php - конфигурационный файл. (см. секцию 6 "Конфигурирование")
191 Доступ ко всем директориям, кроме WWW/, должен быть закрыт для простых пользователей, для этого рекомендуется использовать HTTP-метод аутентификации (посредством .htaccess).
192
193 ***********************************************************
194 *************** 4.4. Способ вывода информации ***************
195 ***********************************************************
196
197 Вся информация, выводимая данной системой, представляется в формате HTML и выводится на экран через обычный WEB-браузер. Вы можете установить систему на своём компьютере и проверять себя; вы можете установить её на выделенный компьютер локальной сети, чтобы тестирование проходить могли пользователи со всех компьютеров локальной сети; вы можете установить её даже на веб-сайт и тогда пользователи со всего интернета смогут заходить к вам и проходить тестирование. Соответственно, при просмотре ЛЮБОЙ страницы вы можете воспользоваться командой браузера "Сохранить страницу", а дальше сможете, например, открывать её в текстовых процессорах, которые поддерживают работу с HTML.
198
199 **************************************************************
200 *************** 4.5. Система хранения информации ***************
201 **************************************************************
202
203 ВСЕ данные, которые система использует при работе, хранятся в базе данных. Для работы с базой данных система использует СУБД MySQL. Сервер MySQL устанавливается тогда, когда вы устанавливаете Денвер. Он, конечно, может быть установлен и отдельно. За хранение базы данных отвечает MySQL! Данная система об этом не задумывается. Обычно (если вы не меняли это название) база данных, относящаяся к системе тестирования слушателей, называется vpntest и хранится в Z:/usr/local/mysql4/data/vpntest. Файлы, которые находятся в этой директории, трогать НЕ НАДО. Если вы хотите сделать резервную копию базы данных - вы всегда можете воспользоваться phpMyAdmin; в следующих версиях планируется добавить возможность резервного копирования и восстановления базы данных целиком.
204 В данном руководстве используются термины "рабочая база данных" и "архивная база данных". На самом деле - БД одна, но состоит из двух частей: рабочих таблиц (по умолчанию users, results, questions) и архивных таблиц (по умолчанию snapshots, snapshots_users, snapshots_results, snapshots_questions). Идея в том, что архивные таблицы затрагиваются при работе ТОЛЬКО с архивом. Ни "Инициализация БД", ни другие команды администрирования, ни система прохождения тестов НЕ ЗАТРАГИВАЮТ архив. То есть, будьте спокойны: при выборе "Инициализации БД" архив останется жив :)
205
206 ****************************************************************
207 *************** 4.6. Аутентификация и безопасность ***************
208 ****************************************************************
209
210 Для аутентификации слушателей, а также для самого тестирования используются переменные уровня сессии. Сессия начинается тогда, когда слушатель войдёт в систему, а заканчивается, когда выйдет. Каждой сессии присваивается SID - уникальный идентификатор сессии. ДОСТАТОЧНО иметь этот идентификатор, чтобы зайти в сессию. То есть, если злоумышленник "подсмотрит" SID - то, пока пользователь не вышел, злоумышленник сможет зайти от его имени. Обычно SID сохраняется в "куках" (HTTP Cookies), и нигде не виден. Чтобы его получить из cookie, будет требоваться открыть и проанализировать файл, в котором она хранится.
211 Для аутентификации администратора используется метод HTTP-аутентификации - его логин и пароль хранятся в отдельном файле - в том самом файле "passwords", который вы создаёте при установке. Доступ к панели администрирования ограничивается ТОЛЬКО этим паролем - так что при установке на сайт делайте этот пароль сложным для взлома.
212 Переменные уровня сессии используются также и для сохранения результатов тестирования, пока слушатель не закончил тестирование. То есть, если сессия обрывается, результаты не сохраняются вовсе. Обрыв связи не является обрывом сессии. Однако, при закрытии броузера SID теряется и, таким образом, сессия прерывается.
213 То есть, если во время тестирования у вас оборвалась связь - не закрывайте броузер и постарайтесь её восстановить. Если она будет восстановлена, вы сможете продолжить тестирование. Однако, время тестирования при этом идёт, т.е временной лимит уменьшается.
214
215 *********************************************************
216 *************** 5. Формат файла с вопросами ***************
217 *********************************************************
218
219 Файл с вопросами - это файл формата PLAIN TEXT - "чистый текст" - *.txt.
220 В файле с вопросами записана последовательность вопросов. Каждый вопрос относится к некоторому варианту; вариант задаётся при загрузке файла в базу данных сразу для ВСЕХ вопросов из этого файла, по умолчанию - вариант 1.
221 Вопрос - это 5 строк: на первой записаны номер вопроса и его текст, на следующих четырёх - четыре варианта возможных ответов на этот вопрос. ВСЕ вопросы должны быть пронумерованы: первая строка ДОЛЖНА выглядеть как "ЧИСЛО. ТЕКСТ ВОПРОСА" - после числа (номера вопроса) ДОЛЖНА стоять точка и пробел.
222 Тот вариант ответа, перед которым в начале строки написан символ *, считается правильным. Правильный вариант ответа ТОЛЬКО один. Если звёздочкой отмечено несколько вариантов - последний из них будет выбран как правильный.
223 ВСЕ строки файла перед обработкой подвергаются trim'у, то есть удалению пробелов и табуляций из начала и конца строки. То есть, отступы у каждой строки вы МОЖЕТЕ делать произвольные - на загрузку вопросов это не влияет.
224 Комментарий - строка, после trim'а начинающаяся с трёх точек с запятой (";;;"). При загрузке файла учитываются ТОЛЬКО значащие строки - т.е непустые после trim'а строки, не являющиеся комментариями. То есть, вы можете вставлять комментарии и пустые строки в ЛЮБОЕ место файла.
225 И вопросы, И ответы - это не просто текст: позволяется HTML-код. Например, чтобы вставить в текст вопроса или ответа перевод строки, вы должны написать "<br>" (без кавычек). Чтобы вставить в текст вопроса или ответа картинку - вы должны написать <img src="путь_к_картинке">. Путь к картинке задаётся относительно корня директории WWW. РЕКОМЕНДУЕТСЯ писать пути в стиле <img src="/dir1/dir2/.../img.png"> - тогда вы будете абсолютно уверены в том, что картинки везде отобразятся корректно и возьмутся из /home/vpntest.ru/WWW/dir1/dir2/.../img.png (или, если вы меняли имя домена - вместо vpntest.ru будет оно).
226 В качестве корневого каталога "/" в этом файле везде, кроме ссылок и картинок, скорее всего имеется ввиду корень виртуального диска, создаваемого Денвером (по умолчанию это "Z:\").
227 Пример файла с вопросами вы можете посмотреть в файле testq.txt из архива.
228
229 *********************************************************
230 *************** 6. Конфигурирование системы ***************
231 **********************************************************
232
233 Система нуждается в конфигурировании - особенно сразу после установки. Конфигурирование осуществляется путём редактирования файла WWW/lib/config.php. В начале этого файла расположены конфигурационные переменные с комментариями к ним. В этой секции руководства приведены комментарии ко всем конфигурационным переменным, а также стандартная последовательность действий при начальном конфигурировании системы.
234
235 **************************************************************
236 *************** 6.1. Конфигурационные переменные ***************
237 **************************************************************
238
239 Значение каждой переменной задаётся как строка: "$переменная = значение;"
240
241 Переменная $dbhost: адрес (или IP) хоста, на котором запущен сервер СУБД MySQL.
242 Значение по умолчанию: "localhost"
243 Менять: обычно не требуется.
244
245 Переменная $dbuser: имя пользователя MySQL.
246 Значение по умолчанию: "root"
247 Менять: по умолчанию - не требуется; однако создав нового пользователя с меньшими, чем у root, привилегиями может немного поднять уровень безопасности.
248
249 Переменная $dbpwd: пароль пользователя MySQL.
250 Значение по умолчанию: "" (пустой пароль)
251 Менять: требуется сразу после установки и при смене пароля на доступ к БД.
252 Замечание: да, пароль к БД хранится в открытом виде в конфигурационном файле. Однако, даже если убрать .htaccess, доступ к нему пользователи не получат, т.к config.php лишь проинтерпретируется PHP и ничего не выдаст на экран.
253
254 Переменная $db: имя базы данных, используемой для хранения информации системой.
255 Значение по умолчанию: "vpntest"
256 Менять: обычно не требуется. Требуется только в том случае, если у вас уже есть БД "vpntest", не относящаяся к данной системе тестирования.
257
258 Переменная $UsersTable: имя таблицы, используемой для хранения рабочей информации о слушателях.
259 Значение по умолчанию: "users"
260 Менять: обычно не требуется.
261
262 Переменная $ResultsTable: имя таблицы, используемой для хранения рабочей информации о результатах тестирований слушателей.
263 Значение по умолчанию: "results"
264 Менять: обычно не требуется.
265
266 Переменная $QuestionsTable: имя таблицы, используемой для хранения рабочих вопросов.
267 Значение по умолчанию: "questions"
268 Менять: обычно не требуется.
269
270 Переменная $SnapshotsTable: имя таблицы, используемой для хранения списка снимков (см. секцию 8 "Работа с архивом результатов")
271 Значение по умолчанию: "snapshots"
272 Менять: обычно не требуется.
273
274 Переменная $VLoginSession: имя HTTP-сессии, используемой для обозначения аутентификации пользователя.
275 Значение по умолчанию: "vmxlsess"
276 Менять: обычно не требуется.
277
278 Переменная $Domain: имя домена (в нашем случае обычно виртуального), на котором установлена система.
279 Значение по умолчанию: "vpntest.ru"
280 Менять: требуется после установки, если вы выбрали другое имя виртуального домена.
281
282 Переменная $MatrixWidth: ширина матрицы с номерами вопросов, которую увидят пользователи при прохождении теста.
283 Значение по умолчанию: 10
284 Менять: можно.
285
286 Переменная $TriesCount: количество попыток ответа на один вопрос. Больше, чем это число раз, поменять выбранный ответ на другой слушатель не сможет (первая попытка ответа включается).
287 Значение по умолчанию: 3
288 Менять: можно.
289
290 Переменная $TimeLimit: временной лимит прохождения теста в секундах. Если значение меньше или равно 0, временной лимит отключён. Если строка с этой переменной закомментирована - временной лимит отключён.
291 Значение по умолчанию: 60*90 (то есть полтора часа)
292 Менять: можно.
293
294 Переменная $ElementsPerPage: количество записей на одной странице при постраничном просмотре больших объёмов данных.
295 Значение по умолчанию: 20
296 Менять: можно.
297
298 *************************************************************************
299 *************** 6.2. Что вы ДОЛЖНЫ поменять после установки ***************
300 *************************************************************************
301
302 После установки системы, если все настройки, кроме пароля на БД, вы оставили равными значениями по умолчанию - вы ДОЛЖНЫ установить лишь правильное значение переменной $dbpwd.
303
304 ***********************************************************
305 *************** 7. Администрирование системы ***************
306 ***********************************************************
307
308 Администрирование системы производится с помощью http://www.vpntest.ru/admin/. Первым, что вы увидите, когда введёте логин и пароль администратора, будет список возможных операций, состоящий из операций, перечисленных ниже. При клике "Версия для печати" на любой странице - система постарается выдать наиболее удобную для печати или сохранения в HTML-файл страницу. С версии для печати всегда можно вернуться кликом по ссылке "Назад" внизу страницы.
309
310 7.1. Вывод информации о пользователях. Вы задаёте подстроку, содержащуюся в логине требуемых пользователей либо дату, после или в которую они зарегистрировались, и нажимаете кнопку "Искать пользователей". После этого система выдаст вам табличку с информацией о найденных пользователях, соответствовавших заданному критерию поиска. Внимание! Если задана дата, позже которой регистрировались требуемые пользователи - поле "логин" игнорируется.
311 В таблице будут перечислены пользователи и информация о них. Если кликнете по логину - логин попадёт в поле "Логин" команды "Вывод информации о пользователях". Справа, в колонке "Результат", отображается ПОСЛЕДНИЙ результат прохождения теста пользователем и ссылка "...", при клике по которой вы попадёте на страницу с информацией о пользователе и кратко - всех его результатах.
312 Флажки рядом с логинами пользователей служат для выбора лишь некоторых пользователей из списка.
313 Кроме того, под таблицей будет отображён список действий, которые в данный момент возможно применить к выбранным пользователям. Это команды:
314 Следующие действия влияют ТОЛЬКО на отмеченных флажками пользователей.
315 - "+1 тест" - при нажатии на эту кнопку отмеченным флажками пользователям будет разрешено пройти ещё один тест.
316 - "-1 тест" - при нажатии на эту кнопку у тех отмеченных флажками пользователей, кто ещё может проходить тесты, отберётся одна возможность пройти тест.
317 - "Обнулить тесты" - после нажатия на эту кнопку отмеченные флажками пользователи не смогут проходить тесты до следующего разрешения.
318 - "Удалить слушателей" - после подтверждения ПОЛНОСТЬЮ удалить отмеченных флажками пользователей вместе с их результатами. Операцию отменить невозможно.
319 Следующие два действия отображаются как ссылки, а не кнопки, и действуют на ВСЕХ выведенных в таблице слушателей, а не только на отмеченных флажками.
320 - "Версия для печати" - отобразить наиболее дружелюбную для принтера версию текущей таблицы.
321 - "Тесты подробно" - отобразить подробную информацию о всех результатах прохождения тестов выбранными пользователями. Для корректного вывода информации загруженные в БД вопросы должны соответствовать тем, на которые тогда отвечали пользователи.
322
323 7.2. Просмотр списка вопросов в БД. Вы можете посмотреть постраничный список ВСЕХ вопросов, на данный момент загруженных в БД. Для этого перейдите по ссылке "нажмите СЮДА". На странице выводится $ElementsPerPage вопросов (см. секцию 6 "Конфигурирование системы"). При выводе версии списка вопросов, предназначенной для печати - выведутся ВСЕ вопросы на одной странице - для удобства. Вывод списка вопросов из рабочей БД и вывод списка вопросов из одного из снимков, находящихся в архиве, принципиально эквивалентны (см. секцию 8 "Работа с архивом результатов").
324
325 7.3. Загрузка вопросов из текстового файла. Вы выбираете любой файл со своего компьютера (см. секцию 5 "Формат файла с вопросами"); задаёте вариант вопросов загружаемого файла - или оставляете его равным 1 - значению по умолчанию; если хотите сначала стереть всё содержимое рабочей БД с вопросами - устанавливаете флажок "Перезаписать БД вопросов"; и нажимаете кнопку "Загрузить вопросы в БД". После этого вопросы будут загружены в БД, а вам будет показан результат операции загрузки вопросов (были ошибки или нет). Также система покажет детальную информацию обо всех этих ошибках.
326
327 7.4. Инициализация БД. Инициализация означает уничтожение и создание заново ВСЕЙ рабочей базы данных. Архивную базу данных эта команда не затрагивает. Инициализация архива производится отдельно, на странице работы с архивом. Таким образом, обычно работа с системой выглядит так: протестировать группу слушателей, отпустить их, архивировать результаты (см. секцию 8 "Работа с архивом результатов"), инициализировать рабочую БД заново, повторить всё заново :)
328
329 *************************************************************
330 *************** 8. Работа с архивом результатов ***************
331 *************************************************************
332
333 Чтобы попасть в архив, вы можете либо набрать http://www.vpntest.ru/admin/archive.php, либо нажать на ссылку "к архиву" вверху на странице администрирования системы. Точно так же из архива вы можете вернуться обратно к администрированию, нажав на ссылку "к администрированию" вверху на странице с архивом.
334 Архив устроен как множество снимков рабочей базы данных. Каждый снимок включает в себя и информацию о пользователях, и их результатах, и вопросах тестов, которые они проходили, то есть по сути является просто копией рабочей БД, с которой можно работать абсолютно так же, как и с рабочей, за тем исключением, что пользователи, "сданные в архив", уже не могут проходить тесты, хотя вся информация о них и остаётся. Соответственно, команд "Дать +1 тест", "Отнять 1 тест", "Убрать тесты" здесь нету.
335 Если архив ещё не был инициализирован - выведется только одна команда, отвечающая за его инициализацию. Естественно, для работы с архивом вы должны его инициализировать.
336 Вы можете просматривать список снимков: выведите его, используя кнопку "Показать список снимков" и поля ввода выше неё (ограничения на снимки задаются по абсолютно тем же правилам, что и ограничения для вывода списка пользователей на странице администрирования, только вместо логина здесь используется имя снимка); список снимков выводится постранично. Кликая по кнопкам "<<" (переход к первой странице), "<" (переход к предыдущей странице), ">" (переход к следующей странице), и ">>" (переход к последней странице), вы осуществляете навигацию по страницам списка. На одной странице выводится $ElementsPerPage снимков (см. секцию 6 "Конфигурирование системы").
337 Далее, выбирая снимок из списка, вы можете просматривать данные, сохранённые в этом снимке. Когда снимок уже выбран, над списком команд отобразится табличка с информацией о снимке (его именем и датой-временем снятия) в заголовке, командами для просмотра данных снимка в центре и командой удаления списка внизу. Удаление производится после подтверждения, выдаваемого при нажатии на ссылку "Удалить снимок".
338 Кликнув по пункту "Список пользователей", вы выведете список ВСЕХ пользователей, сохранённых в снимке, в виде таблички, аналогичной табличке вывода информации о пользователей из рабочей базы данных. При клике по ссылке "..." в скобках рядом с пунктом "Список пользователей" выведется форма задания ограничений на поиск пользователей, аналогичная таковой на странице администрирования. Вся разница только в том, что здесь вы работаете со снимком, находящимся в архиве.
339 После показа списка пользователей вы точно так же, как и при администрировании, можете вывести версию для печати, или подробную информацию о всех результатах выбранных пользователей. Команды разрешения/запрещения прохождения тестов, естественно, запрещены, так как пользователи уже "сданы в архив", как было уже сказано выше.
340 Кликнув по пункту "Список вопросов", вы выведете постраничный список всех вопросов, сохранённых в снимке, отсортированный по номеру варианта и номеру вопроса. На странице выводится $ElementsPerPage вопросов. Вопросы выводятся списком, под каждым вопросом выдаются его варианты ответа, правильный из которых отмечается более тёмным рыжим фоном. Постраничная навигация осуществляется так же, как и в списке снимков. При выборе "Версии для печати" списка вопросов - отобразятся сразу все вопросы на одной странице в удобном для печати / сохранения виде.
341 При клике по пункту "Скрыть списки" все выведенные списки будут скрыты.
342 Другими командами работы с инициализированным архивом будут: создание нового снимка и уничтожение архива.
343 Чтобы создать новый снимок, вы должны вписать имя для нового снимка в поле "Имя снимка" и нажать либо Enter, либо кнопку "Сделать снимок". После отработки программы у вас появится новый снимок базы данных, являющийся практически точной её копией. Практически - потому что ID'ы пользователей при создании снимка не сохраняются во избежание дублированных индексов в таблице.
344 Чтобы уничтожить архив, вам придётся сначала подтвердить свои действия в появляющемся на экране после клика на кнопке "Уничтожить архив" окне.
345
346 **************************************************
347 *************** 9. Координаты автора ***************
348 **************************************************
349
350 Автор: Виталий Филиппов [VMX]
351 ICQ # 278245320
352 vitalif@mail.ru
353 http://vmx.yourcmc.ru