Проект: Phones (Телефонный справочник)
Версия: 0.5.1
Дата: 19.10.2004
Адрес: [http://introvert.ru/projects.php?item=phones]
Автор: Интроверт [[email protected]]
ТЕЛЕФОННЫЙ СПРАВОЧНИК (phones) : ИНСТРУКЦИЯ ПО УСТАНОВКЕ
1. СИСТЕМНЫЕ ТРЕБОВАНИЯ
Для размещения серверной части приложения подходит любой хостинг с поддержкой технологий PHP и MySQL.
При разработке и тестировании данной версии приложения использовались:
-- Веб-сервер Apache 1.3.31
-- Модуль PHP 4.3.4
-- Сервер баз данных MySQL 4.0.20
Возможна нормальная работа приложения и на других версиях Apache/PHP/MySQL.
В качестве клиентской части приложения может быть использован любой веб-браузер, поддерживающий технологию CSS (например, Internet Explorer версии 4 и выше).
Как правило, установка приложения в локальной сети и его сопровождение производится одним человеком - системным (сетевым) администратором организации, обслуживающей эту сеть. Установка приложения не должна вызвать затруднений у специалиста, знакомого с современными веб-технологиями (имеются в виду Apache, MySQL, PHP, Perl и т.д.).
2. УСТАНОВКА СЕРВЕРНОЙ ЧАСТИ ПРИЛОЖЕНИЯ
2.1. Настройка сервера баз данных MySQL.
На сервере баз данных MySQL создать новую базу данных и пользователя для доступа к этой базе данных.
2.1.1 Выбрать значения параметров подключения к базе данных.
Для примера:
Хост MySQL -- localhost (если MySQL и Apache работают на одной машине)
База данных -- phones
Пользователь -- phones
Пароль -- q54dFX92
2.1.2 Создать новую базу данных с выбранным именем ("phones").
Команда SQL:
CREATE DATABASE phones;
2.1.3 Создать структуру таблиц базы данных.
Для этого необходимо выполнить SQL-скрипт (находится в архиве - [install/schema.sql]).
2.1.4 Создать пользователя базы данных, от имени которого приложение будет обращаться к базе данных, назначить ему пароль и необходимые привилегии.
Все это можно сделать одной SQL-командой
(или выполнить соответствующий SQL-скрипт, который находится в архиве - [install/grant.sql]):
GRANT SELECT,INSERT,UPDATE,DELETE ON phones.* TO phones@localhost IDENTIFIED BY 'q54dFX92';
2.2. Размещение и настройка скриптов.
2.2.1 В структуре каталогов веб-сервера выбрать подходящее место и создать отдельный каталог для размещения скриптов (например, [public_html/phones]). Если предполагается использовать отдельный виртуальный хост, зарегистрировать его в DNS (или прописать в файле [hosts]).
2.2.2 Распаковать все содержимое каталога [phones] из архива [phones051.zip] в выбранный каталог на веб-сервере.
2.2.3 Скорректировать файл [base.inc], указав в нем принятые ранее значения параметров (см. п. 2.1.1).
2.2.4 Скорректировать файл [header.inc], указав в его первой строке более подходящий подзаголовок, чем "г. Энск и Энский район", например:
<?php define('SUBTITLE', 'г. Коломна и Коломенский район'); ?>
2.3. Загрузка демонстрационной базы данных и настройка приложения.
2.3.1 Перейти к интерфейсу администратора, набрав в адресной строке браузера нужный адрес. Например, если приложение установлено как отдельный хост (см. п. 2.2.1) с именем "phones", следует набирать [http://phones/admin/].
Когда появится страница регистрации, указать:
Логин -- admin
Пароль -- admin
2.3.2 Загрузить демонстрационную версию базы данных и цитаты (ссылка "Загрузить файлы"). Примеры файлов [phones.csv] и [quotes.csv] можно найти в архиве в каталоге [install].
2.3.3 Изменить пароль для доступа к интерфейсу администратора (ссылка "Изменить пароль").
2.3.4 Выйти из интерфейса администратора и проверить работу приложения (набрать в браузере адрес хоста, например, [http://phones/]).
3. ЗАГРУЗКА РАБОЧЕЙ БАЗЫ ДАННЫХ
Заключительный этап внедрения приложения - подготовка и загрузка рабочей версии базы данных.
Прежде всего, необходимо собрать сведения об абонентах местной телефонной сети и представить их в электронном (табличном) виде.
Далее, при помощи табличного редактора следует преобразовать собранные сведения в файл формата CSV (Comma Separated Value = текст, разделенный запятыми). Это текстовый файл, где каждая запись таблицы располагается в отдельной строке, поля разделяются символом ";" (точка с запятой), количество и порядок следования полей для каждой записи приведены ниже (см. также образец файла [phones.csv] в архиве в каталоге [install]):
1) Номер телефона
2) Имя абонента (для офисных номеров - пустая строка)
3) Название организации (для частных номеров - пустая строка)
4) Название подразделения (для частных номеров - пустая строка)
5) Населенный пункт
6) Улица
7) Дом
8) Квартира (комната) (если не определено - пустая строка)
Осталось загрузить базу данных на сервере из полученного CSV-файла:
-- изменить имя файла на [phones.csv].
-- расположить указанный файл в каталоге [phones/admin] на веб-сервере.
-- в интерфейсе администратора перейти к странице "Загрузка файлов" и выполнить соответствующую команду.
После размещения и тестирования приложения на одном из серверов, можно известить пользователей о доступности справочника в локальной сети.
4. СОПРОВОЖДЕНИЕ ПРИЛОЖЕНИЯ
В приложении предусмотрена возможность обратной связи пользователей с администратором приложения, поэтому администратор приложения должен периодически просматривать поступившие сообщения и удалять уже не нужные.
Также администратору необходимо иногда обновлять сведения в базе данных, для чего можно привлечь пользователей приложения или специалистов узла связи.
5. ПРОБЛЕМЫ?
Если у вас возникли проблемы при установке приложения или вы заметили ошибки в его работе, пожалуйста, сообщите об этом автору приложения по адресу [[email protected]] (в поле "Тема" сделайте пометку - "phones 0.5.1").
Copyright (c) 2004, Интроверт.
__