09.03.10

АДИС. Руководство администратора

Настройка демона


Редактирование конфигурационного файла

При первоначальной настройке программы pilotd или изменении параметров передачи объектов (файлов) необходимо провести редактирование конфигурационного файла (Сonfig).

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

  1. Интерактивно - путем изменения параметров в окне конфигуратора.
  2. Неинтерактивно - путем редактирования конфигурационного файла вручную в окне текстового редактора.

Для запуска конфигуратора в меню "Настройка" выберите команду "Конфигуратор". Откроется окно конфигуратора.

Закладки "Переменные", "Пути поиска задания" и "Таблица маршрутов" используются для выбора формы ввода значений соответствующих параметров. Закладка "Имена удаленных станций" предназначена для выбора формы настройки отображения протоколов ТСP-передачи (см. главу "Управление и контроль работы демона").

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

Для редактирования конфигурационного файла в окне текстового редактора вручную в меню "Настройка" выберите команду "Изменение файла настроек вручную". Откроется окно редактирования конфигурационного файла локальной программы pilotd в текстовом режиме:

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

Если были внесены какие-либо изменения в конфигурационный файл, то, при закрытии окна текстового редактора, будет выведено сообщение, предлагающее:

Если конфигурационный файл был отредактирован тем или иным способом, выберите в меню "Фоновый процесс" команду "Реинициализация" для немедленного вступления внесенных изменений в силу.

Переменные конфигурационного файла

Первоначальная установка значений переменным, отвечающим за работу демона, производится при установке программного обеспечения.

Изменение значений переменных осуществляется в форме ввода конфигуратора, открываемой закладкой "Переменные", или непосредственно в текстовом редакторе.

В форме ввода конфигуратора имя переменной записывается в поле "Переменная", а соответствующее ей значение в поле "Значение".

Для редактирования значения переменной установите курсор мыши в поле "Значение", дважды нажмите левую кнопку и введите соответствующее значение.

Для создания новой переменной установите курсор мыши в поле "Переменная" последней строки списка переменных, дважды нажмите левую кнопку и введите имя переменной, а затем введите ее значение в поле "Значение".

Если необходимо удалить переменную, выберите ее в списке и нажмите правую кнопку мыши, откроется контекстное меню, содержащее команду "Удалить переменную".

При редактировании конфигурационного файла вручную (в текстовом редакторе) каждая переменная записывается выражением вида <имя_переменной=значение>. В той же строке может находиться комментарий.

Значением переменной может являться: произвольная строка (путь к каталогу), определенное текстовое значение или число в десятичной системе счисления.

Ниже приведено описание переменных, значения которых может редактировать непосредственно администратор.

Период проверки наличия задания

Установка требуемого периода проверки каталогов на наличие новых файлов, предназначенных для передачи, производится путем изменения значения переменной Interval. Период времени, через который будет производиться проверка и, если требуется, передача файлов, устанавливается в секундах.

Формат записи переменной в конфигурационном файле

Interval=период_проверки_(в_секундах).

Пример:


Interval=10   # Каждые 10 секунд происходит проверка каталогов на наличие новых файлов, предназначенных для передачи.

Каталоги локальной станции, предназначенные для хранения объектов во время их обработки

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

Формат записи переменных в конфигурационном файле

Spool*****=путь_к_каталогу_на_локальной_станции.

Пример:


SpoolQueue=/var/spool/pilot/queue    # Каталог "Очередь";

SpoolReady=/var/spool/pilot/ready    # Каталог "Исходящие";

SpoolBad=/var/spool/pilot/bad        # Каталог "Плохие";

SpoolLost=/var/spool/pilot/lost      # Каталог "Потерянные";

SpoolLocks=/var/spool/pilot/locks    # Служебный каталог для хранения "сигнальных файлов".


Настройка протокола выполнения программы

Уровень детализации протокола устанавливается значением переменной BugLevel.

Формат записи переменной в конфигурационном файле

BugLevel=уровень_детализации_протокола:

Пример:


BugLevel=1    # Протокол записывается с нормальным уровнем детализации.

Каталоги хранения передаваемых объектов

Описание каталогов списка "Входящие", из которых будут передаваться файлы, осуществляется в форме ввода конфигуратора, открываемой закладкой "Пути поиска задания", или непосредственно в текстовом редакторе.

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

Кроме того, при описании пути к каталогу из списка "Входящие", указывается маска файлов, предназначенных для передачи. В качестве маски файлов используется символ подстановки "*", заменяющий любую произвольную последовательность символов и, через точку, расширение имен файлов, предназначенных для передачи. Например, маска *.scf указывает на то, что предаваться будут все файлы с расширением .scf.

Если в одном каталоге хранятся файлы различного типа (с разными расширениями), то для передачи файлов каждого типа (файлов с определенным расширением) можно либо записать отдельные строки пути и указать конкретные маски, либо одну общую строку маской файлов, записанной в краткой форме. Например, маска *.[flt] говорит о том, что будут передаваться файлы с расширениями .f, .l и .t, маска *.[flt][fp]i - файлы с расширениями .ffi, .fpi, .lfi, .lpi, .tfi и .tpi.

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

После редактирования пути и маски файлов соответствующая запись добавляется в поле "Путь".

Справа от поля ввода пути расположена кнопка , при нажатии на которую открывается список команд преобразования файлов, предназначенных для передачи. После выбора требуемой команды ее имя будет отображено на кнопке и в поле "Обработка".

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

Если необходимо удалить запись, выберите ее в списке и нажмите правую кнопку мыши, откроется контекстное меню, содержащее команду "Удалить путь поиска".

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

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

Формат записи параметра в конфигурационном файле

SearchPaths={
   TransportParams;Process
}

При описании параметра SearchPaths, его поля разделяются только символом ";", пробелы игнорируются.

Пример:


SearchPaths={

/home/papillon1/export/*.[flt]
# Программа pilotd имеет доступ к файлам с расширениями .f, .l и .t, хранящимся в каталоге /home/papillon1/export/ локальной станции.
/home/papillon1/export/*.scf ; p_scf7_fs
# Программа pilotd имеет доступ к файлам с расширением .scf, хранящимся в каталоге /home/papillon1/export/ локальной станции, которые перед перемещением будут сжаты.
/var/spool/pilot/incoming/*
# Программа pilotd имеет доступ ко всем файлам, хранящимся в каталоге /var/spool/pilot/incoming/ локальной станции.
work://var/spool/pilot/incoming/*.scf
# Программа pilotd имеет доступ к файлам .scf, хранящимся в каталоге /var/spool/pilot/incoming/, находящимся на удаленной рабочей станции c именем "work".
}

Маршруты передачи объектов

Описание маршрутов, согласно которым будут передаваться файлы из каталогов списка "Входящие", осуществляется в форме ввода конфигуратора, открываемой закладкой "Таблица маршрутов", или непосредственно в текстовом редакторе.

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

Редактирование маршрута производится в полях, расположенных в нижней части формы ввода, следующим образом:

  1. В поле "Получатель DB#" записывается номер принимающей базы данных (в бирке объекта он записан в поле "Кому") в десятичной системе счисления.
  2. В поле "Тип объекта:" записывается тип передаваемого объекта (в бирке объекта он записан в поле "Тип данных") . Если ранее введен маршрут для объектов того же типа, то его можно выбрать из списка, нажав на кнопку, расположенную в правой части поля;
  3. Кнопка "Обработка:" используется для выбора команды преобразования передаваемых объектов. После выбора соответствующей команды ее имя будет отображено на кнопке.
  4. Кнопка "Модуль передачи:" используется для выбора способа передачи объектов (типа транспорта). После выбора требуемого типа транспорта его имя будет отображено на кнопке.
  5. В поле "Станция" записывается имя или IP адрес (несколько имен или IP адресов) удаленной станции, на которую будут передаваться объекты. Данное поле недоступно для заполнения, если установлен тип транспорта "Локально".
  6. В поле "Путь" записывается путь к каталогу, расположенному на локальной или удаленной станции, в который будут поступать объекты. Заполнения поля производится либо вручную, либо путем выбора в окне каталогов нужного каталога локальной станции. Стандартное окно каталогов отрывается после нажатия на кнопку .
  7. В поле "Имя пользователя" записывается имя пользователя, зарегистрированного на принимающей станции. Данное поле доступно для заполнения только, если выбран тип транспорта "FTP".
  8. В поле "Пароль" записывается пароль пользователя, зарегистрированного на принимающей станции. Данное поле доступно для заполнения только, если выбран тип транспорта "FTP".

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

Если необходимо удалить запись, выберите ее в списке и нажмите правую кнопку мыши, откроется контекстное меню, содержащее команду "Удалить маршрут".

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

Формат записи параметра в конфигурационном файле

RouteTable={
   Nbase;ObjectType;Process;TransportType;TransportParams
}

При описании параметра RouteTable его поля разделяются только символом ";", пробелы игнорируются. Если в поле ObjectType параметра RouteTable указан символ "*", передаются все объекты, но команды преобразования выполняться не будут. Для выполнения команды преобразования или передачи объекта конкретного типа, необходимо указать в поле ObjectType тип не сжатого объекта (из бирки) с добавлением символа "*".

Пример:


RouteTable={
009998; RawLatentMark*     ; p_fs_scf7 ; local ; /home/papillon1/u1l
# Все необработанные сжатые следы (RawLatentMarkPack), предназначенные для базы 009998, из описанных в параметре SearchPaths как локальных, так и удаленных каталогов будут передаваться в каталог /home/papillon1/u1l локальной станции. После передачи они будут преобразованы в исходные следы (7-й версии программы АДИС "Папилон").
009998; Ready*             ;           ; local ; /home/papillon1/import
# Все дактилокарты и следы (ReadyTenPrintCard и ReadyLatentMark), предназначенные для базы 009998, из описанных в параметре SearchPaths как локальных, так и удаленных каталогов будут передаваться в каталог /home/papillon1/import локальной станции.
000214; RawTenPrintCard*   ; p_scf7_fs ; tcp   ; work1, work2, work3  ;/var/spool/pilot/incoming/
# Все необработанные дактилокарты (RawTenPrintCard и RawTenPrintCardLive), предназначенные для базы 000214, из описанных в параметре SearchPaths как локальных, так и удаленных каталогов будут сжиматься и передаваться (при установленных каналах связи) в каталоги /var/spool/pilot/incoming/, расположенные на станциях с именами "work1", "work2", "work3". Передача будет производится в следующем порядке: первый объект будет перемещен на станцию с именем "work1", второй - "work2", третий - "work3", четвертый - "work1" и .т.д. (если со станций не будет установлен канал связи, то распределение объектов будет производиться по доступным станциям).
000216; IdentificationPhoto ;          ; ftp   ; 192.168.44.15 ; user ; passwor ; /var/spool/pilot/incoming/
# Все идентификации (IdentificationPhoto), предназначенные для базы 000216, из описанных в параметре SearchPaths как локальных, так и удаленных каталогов будут сжиматься и передаваться (при установленном канале связи) в каталог /var/spool/pilot/incoming/ станции с IP адресом 192.168.44.15 при условии, что пользователь "user", имеющий пароль "passwor", зарегистрирован на принимающей станции.
}


Примечание. Если в маршруте передачи не описан путь к каталогу для приема объектов, то по умолчанию объекты будут помещены в каталог /var/spool/pilot/incoming на принимающей станции.

Типы данных объекта

Тип данных объекта указан в поле "Тип данных" бирки. Программа "Пилот" работает со следующими типами объектов:

Команды преобразования

При передаче объектов, для уменьшения объема передаваемых данных, файлы необработанных дактилокарт и следов можно "сжать". Для "сжатия" и преобразования объектов в исходный вид используются специализированные модули, запускаемые следующими командами:

Программа pilotd поддерживает следующие типы транспорта с определенными параметрами: