Приложение А (рекомендуемое). Требования к документу "Руководство по организации сопровождения"

ПРИЛОЖЕНИЕ А
(рекомендуемое)

Требования к документу "Руководство по организации сопровождения"

1 Документ "Руководство по организации сопровождения" должен разрабатываться для каждой системы (задачи) или автоматизированного рабочего места на стадии "Рабочая документация" и входить в перечень эксплуатационной документации на систему. Он предназначен как для подразделений, осуществляющих сопровождение системы в организации-разработчике, так и на объектах внедрения.

2 Документ "Руководство по организации сопровождения" должен содержать информацию по организации процесса сопровождения программного и информационного обеспечения автоматизированной системы, включая сведения по установке системы, начальной загрузке компонент системы, по конфигурированию и тестированию результатов инсталляции. Кроме этого, в документе должны быть даны рекомендации по контролю за программными конфигурациями и проведенными модификациями, а также по технической поддержке инсталлированной системы или ее части.

3 "Руководство по организации сопровождения" должно включать следующие разделы:

1) Основные положения.

2) Технология сопровождения.

3) Организация работ по внесению изменений.

4) Организация работ по контролю за внесенными изменениями.

5) Организация тестирования внесенных изменений.

6) Список сокращений и обозначений.

4 Требования к содержание разделов документа "Руководство по организации сопровождения":

4.1 В разделе "Основные положения" приводятся сведения, идентифицирующие объект сопровождения.

Все библиотеки (директории) с программным обеспечением, объекты НСИ и объекты баз данных (БД) системы однозначно должны быть идентифицированы номером версии и номером модификации. В разделе должен быть описан контроль корректности и согласованности версий программного обеспечения и БД, осуществляемый в процессе инсталляции/модификации, а также при попытке соединения с базой данных. Формируются требования к описанию дистрибутива после внесения изменений, содержащего сведения об изменениях в функциях, задачах, технологиях с указанием на модифицированные при этом программные средства и объекты базы данных. Приводится необходимость включения в "Извещение об изменении" в качестве примечания сведений о проведении инсталляции/модификации/ревизии в виде рекомендаций.

В разделе описывается технология работы с ревизиями: опытными или исправительными модификациями, то есть необязательными для передачи на объекты внедрения. Определяется, где и как хранится хронологический список ревизий (в архиве системы или другим способом).

4.2 Раздел "Технология сопровождения проекта " включает следующие сведения:

1) Подразделения, осуществляющие сопровождение (тестового контроля, фонда алгоритмов и программ, внедрения и сопровождения, администратора баз данных, локальных сетей и пр.).

2) Планирование модификации программных комплексов и объектов базы данных (источники данных для модификации; определение комплексов системы, подлежащих модификации; согласование и увязка заданий разработчикам и группе сопровождения; координация работ, в том числе по подготовке планов тестирования).

3) Подготовка и реализация модификации (виды и имена файлов, содержащих информацию для инсталляции и модификации серверной части и дистрибутива для инсталляции и модификации клиентских частей).

4) Общая технологическая схема подготовки версии/модификации/ревизии.

5) Архитектура системы:

Приводится описание архитектуры системы для проведения процедур сопровождения:

- модифицируемые задачи (группа функций);

- модифицируемые функции;

- модифицируемые режимы;

- модифицируемые операции (входные и выходные формы и сообщения), причем модифицированные объекты БД указываются на диаграмме системных процессов, которая представляется в виде схем навигации экранов и иерархических схем вызовов функций в группах функций (библиотеках);

- диаграммы системных процессов модификации в виде схемы навигации экранов и иерархии вызовов функций.

6) Сопровождение БД и их синхронизация.

В подраздел включаются технологии использования выбранных инструментальных средств, в том числе CASE-средств, для сопровождения баз данных. Приводятся этапы и методы выполнения реинжениринга единой БД, синхронизации эталонной модели с единой БД разработчиков, оперативный контроль объектов базы данных, синхронизации эталонной модели, тестовой БД, стендовой БД и промышленной БД, а также документирование проекта БД в процессе сопровождения.

Кроме этого, этот подраздел может быть расширен описанием дополнительных возможностей по синхронизации баз данных.

7) Ведение НСИ и документирование модификации.

В подразделе указывается перечень нормативно-справочной информации и наименование соответствующих библиотек на машинных носителях.

Приводится список функций системы для ведения справочников или архивов НСИ, а также инструментальные средства с целью документирования модификаций информационного обеспечения системы.

8) Сборка модификации.

Процесс сборки модификации определяется ее содержанием.

Приводится иерархическая структура каталогов для формирования дистрибутива с указанием содержания каждой директории (библиотеки)

9) Порядок проведения модификации:

- Приводится порядок установки (инсталляции) системы. Описывается последовательность инсталляции СУБД, серверной части, клиентской части, настройки между клиентскими и серверными частями. Далее описывается инсталляция оболочки рабочих мест, клиентских частей и приложений, а также администрирование клиентских приложений.

- Описывается последовательность модификации системы:

- модифицирование серверной части системы (если содержится указание на это в примечаниях к модификации);

- инсталлируется оболочка рабочих мест, если содержится указание на это в примечаниях к модификации;

- инсталлируются клиентские части системы, если содержится указание на это в примечаниях к модификации;

- администрируются клиентские приложения, если содержится указание на это в примечаниях к модификации.

10) Тестирование модификации.

Приводятся наименования инструментальных средств, с помощью которых осуществляется тестирование модификаций системы, и виды тестирования, которые необходимо проводить:

- Функциональное тестирование.

- Конфигурационное тестирование.

- Конкурентное тестирование.

- Стрессовое тестирование.

- Тестирование загрузки.

- Тестирование эффективности.

- Регрессионное тестирование.

11) Стендовые испытания.

Приводятся виды тестирования при стендовых испытаниях, например:

- Тестирование загрузки;

- Тестирование эффективности;

- Регрессионное тестирование.

Стендовые испытания модификации системы, в отличие от тестового контроля, должны проводиться на данных, максимально приближенным к реальным.

12) Порядок отслеживания замечаний, ошибок и предложений:

- Приводятся порядок и способы доставки замечаний, обнаруженных ошибок и предложений (форма оформления, обязательность подписей должностных лиц, виды почты - СПФ, E-mail и др.).

- Приводится форма журнала регистрации замечаний и ошибок и технология их передача в базу данных технической поддержки для отслеживания и подготовки ответов на замечания.

13) Техническая поддержка проекта:

- Приводится схема, по которой осуществляется техническая поддержка информационной системы.

- Описывается ведение журнала регистрации вопросов и ответов и поиск возможного ответа на поступивший запрос среди ранее зарегистрированных.

- Даются рекомендации по использование журнала регистрации вопросов и ответов в качестве технологической карты, отслеживающей прохождение каждого вопроса в процессе подготовки ответа на него.

- Приводится технология подготовки и формирования окончательного ответа.

- Указывается порядок регистрации необходимых данных в журнале замечаний и предложений или в журнале планирования модификаций.

14) Структура дистрибутива.

Приводится перечень библиотек (директорий). Содержание отдельных библиотек (директорий) определяется тем, что представляет собой дистрибутив - инсталляцию/модификацию или ревизию.

15) Структура передаточного носителя.

В зависимости от способа передачи модификаций структура передаточного носителя может быть:

- многотомным архивом при передаче дистрибутива электронной почтой;

- блоками данных при передаче на магнитных лентах или картриджах. Для надежности блоки дублируются двух или трехкратно;

- структурой, совпадающей со структурой дистрибутива при передаче на магнитно-оптическом диске;

- структурой, совпадающей со структурой дистрибутива при передаче на записываемый CD.

Указываются способы разархивирования блоков данных и порядок размещения дистрибутива на рабочее место администратора системы или сервер системы.

16) Порядок формирования дистрибутива модификации:

- Определяются лица, ответственные за формирование дистрибутива модификации серверной части и порядок приемки исходных объектов клиентских частей и объектов БД.

- Перечисляется возможный состав дистрибутива (приводятся варианты).

- Приводится порядок формирования дистрибутивов.

4.3 Раздел "Организация проведения модификации" включает общую последовательность организационных мероприятий при проведении модификации:

- Описывается контроль следующих начальных параметров: соответствие номеров версии и модификации.

- Например, осуществляется проверка того, что номер версии СУБД не должен быть ниже, чем указан в извещении на инсталляцию/модификацию. Приводятся сведение о необходимых путях выхода из неверной ситуации.

- Контролируется версия клиентской части для обеспечения совместимоcти библиотек.

Далее в разделе описывается схема процесса проведения самой модификации на базе опытной БД с переходом на промышленную БД или какая-либо другая схема (например, использование другого сервера и пр.).

4.4 Раздел " Организация контроля модификации" включает подразделы:

1) Верификация базы данных ( приводится полная схема верификации).

2) Верификация клиентских частей - описывается схема верификации. Например, верификация установленных подсистем и задач выполняется инсталлятором при попытке инсталлирования новых клиентских компонент. При этом выводится список всех установленных подсистем. Инсталлированные ранее подсистемы отмечаются. Для них разрешается инсталлировать дополнительные функции или задачи.

В обоих разделах описываются действия администратора в случае обнаружения ошибок.

4.5 Раздел "Организация тестирования модификации" содержит информацию по следующим организационным мероприятиям:

1) Организации тестирования: (определяются подразделения, выполняющие тестирование модификации, распределяются функции между подразделениями).

2) Отслеживанию архитектуры модификации (на каком уровне системы, какие объекты и какие изменения вносятся).

3) Подготовке планов функционального, регрессионного и др. видов тестирования; разработке самих тестов.

4) Выполнению функционального тестирования клиентских частей и объектов серверной части.