Здравствуйте, коллеги!Сейчас на работе документирую сервера(работаеющие под FreeBSD и Linux) и задался вопросом как грамотнее это делать, какую информацию включить в документацию. Остановился вот на чем:
1)Задачи которые должен выполнять сервер.
2)Конфигурация аппаратной части сервера.
3)Особенности установки системы(использование программного RAID, выбор дополнительных пакетов, включение/выключение softupdates для партиций, добавление пользователей и т.д.).
4)Описание геометрии диска(размер партиций, точка монтирования, опции newfs, опции монтирования).
5)Вывод команды
# bsdlabel /dev/имя_слайса_с_freebsd
6)Настройки сетевого интерфейса(драйвер сетевого интерфейса, IP-адрес, маска подсети, адрес шлюза).
7)Содержимое файлов /etc/hosts, /etc/resolv.conf, /etc/hosts.allow, /etc/hosts.deny.
8)Установленные переменные окружения.
9)Файл /etc/make.conf (если присутствует).
10)Первичная настройка после установки(переменные sysctl, повышение безопасности, установка cvsup, portupgrade, установка патчей и т.д.).
11)Конфигурирования и сборка собственного ядра
12)Установка и настройка сервисов.
13)Процедуры сопровождение системы и сервисов(проверка целостности, снимки системы, синхронизация времени и т.д.).
14)Настройка пакетного фильтра на локальной машине(если требуется).
15)Подробная схема сети.В целом вроде все.
Интересно было бы узнать мнение об этом опытных администраторов и гуру.
во-первых должны быть "стандарты на операционную систему" или "стандарт автоматизированной системы" - и по тексту расписывать в том порядке как там описано. Но это сложно.во-вторых - возьми статью http://iasb.narod.ru/Unix-server_short.htm и напильником ее - до получения необходимого. Начиная с оглавления (написаного тобой). Идешь по оглавлению и дописываешь раздел за разделом. После определенного времени и усилий - получится нормальный документ.
+ нарисуй (себе, в документе, на стенке и т.д.) схему хранения CD или DVD back-up. Это как раздел документа.
+ нарисуй раздел "практическое выполнение" back-up и соответственно "восстановление из back-up"
Как минимум работа месяца на 2 если только этим заниматься.
Спасибо что ответили.>во-первых должны быть "стандарты на операционную систему" или "стандарт автоматизированной >системы" -
>и по тексту расписывать в том порядке как там описано. Но
>это сложно.
>
>во-вторых - возьми статью http://iasb.narod.ru/Unix-server_short.htm и напильником ее - до получения необходимого.
>Начиная с оглавления (написаного тобой). Идешь по оглавлению и дописываешь раздел
>за разделом. После определенного времени и усилий - получится нормальный документ.Мне кажется в документации не следует отражать то что есть в документации к системы или пакету. Кроме того выбор ПО и аппаратной части также должен выходить за рамки документации. Иначе получается каша. Хотя каждый это решает сам для себя
>+ нарисуй (себе, в документе, на стенке и т.д.) схему хранения CD
>или DVD back-up. Это как раздел документа.Согласен.
>+ нарисуй раздел "практическое выполнение" back-up и соответственно "восстановление из >back-up"
Это думаю стоит пометстить в отдельную доку для сервера резервного копирования.
>Как минимум работа месяца на 2 если только этим заниматься.
Зато сколько пользы...
>Интересно было бы узнать мнение об этом опытных администраторов и гуру.А для чего это нужно? для себя, для передачи дел, для начальства)?
>А для чего это нужно? для себя, для передачи дел, для начальства)?Для всего...
там у меня приписка - править напильником. Конфигурирование (по факту) пакетов - как на меня - обязательно - это документаця - ПОЛНОЕ И ДЕТАЛЬНОЕ описание. ДОЛЖНО БЫТЬ ОПИСАНО ВСЕ. Сисадмин уволился - конторе пора закрываться. Новый админ доолжен все сломать и поставить с нуля если нет подобноьго описалова.ДОЛЖНО БЫТЬ ОПИСАНО ВСЕ.
>там у меня приписка - править напильником. Конфигурирование (по факту) пакетов -
>как на меня - обязательно - это документаця - ПОЛНОЕ И
>ДЕТАЛЬНОЕ описание. ДОЛЖНО БЫТЬ ОПИСАНО ВСЕ. Сисадмин уволился - конторе пора
>закрываться. Новый админ доолжен все сломать и поставить с нуля если
>нет подобноьго описалова.
>
>ДОЛЖНО БЫТЬ ОПИСАНО ВСЕ.Разве кто-то спорит? =-)
На одном из ftp-серверов есть много пользовательских директорий, с весьма хитрым доступом к ним и распределением пользователей по группам. Как грамотнее, удобнее и понятнее задокументировать это?