SMB/CIFS (мониторинг совместно используемого ресурса)

Драйвер устройства SMB/CIFS обеспечивает мониторинг файлов и папок, совместно используемых через технологию Server Message Block (SMB), которая также называется Common Internet File System (CIFS) или Microsoft Windows Network.

Информация о драйвере

ID плагина драйвера:

com.tibbo.linkserver.plugin.device.samba

Общие настройки

Не определены.

Настройки уровня пользователя

Не определены.

Свойства device

Учетная запись устройства SMB/CIFS настраивается при помощи следующих свойств:

Имя поля

Описание поля

Адрес

IP адрес или имя хоста сервера SMB.

Протокол

Выберите ваш протокол: SMB v1 или SMB v2/v3. 

Путь

Расположение (полный путь) контролируемого удаленного файла или папки.

Содержимое чтения

Включает/выключает чтение содержимого файла.

Рекурсивный

Включает/выключает рекурсивное чтение для папок.

Пошаговое чтение

Переключает с чтения всего файла на пошаговое чтение.

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

Максимальный размер чтения

Максимальное количество байт, которое читает сервер, если включено пошаговое чтение.

Размер чтения очереди сообщений

Количество дополнительных байт с предыдущего этапа пошагового чтения.

Разрешить редактирование

Разрешает или запрещает изменение содержимого файла.

Рассчитать контрольную сумму

Включает/выключает расчет контрольной суммы файла.

Активировать аутентификацию

Включает/выключает доступ к защищенным паролем ресурсам.

Домен

Домен, с котором существует имя пользователя.

Имя пользователя

Имя пользователя для аутентификации.

Пароль

Пароль для аутентификации.

Активы device

Драйвер не поддерживает активы.

Настройки

Device

Драйвер устройства SMB/CIFS создает следующие переменные настроек Device:

Имя переменной

Описание переменной

Комментарии

attributes

атрибуты файла

Эта переменная создается, только если Путь указывает на файл.

Содержит атрибуты файла:

  • Время последнего изменения (modificationTime)
  • Размер (size)
  • Контрольные суммы, рассчитанные с ипользованием алгоритма Adler-32 (checksum)

attributes

атрибуты папки

Эта переменная создается, только если Путь указывает на папку.

Содержит атрибуты папки:

  • Время последнего изменения (modificationTime)
  • Размер (size)
  • Количество файлов (fileCount)

contents

содержимое файла

Эта переменная создается, только если Путь указывает на файл.

Она имеет содержимое файла только для чтения (если включена опция Читать содержимое) или редактирования (если включена опция Разрешить редактирование).

contents

содержимое папки

Эта переменная создается, только если Путь указывает на файл.

Список элементов папки (файлы и подпапки) со следующими полями:

  • Тип (itemType)
  • Относительный путь (itemPath)
  • Размер (itemSize)

Операции Device

Закачать файл

Операция закачивает файл.

Вход:

  • Файл. Data Block. Содержимое файла.

Результат:

  • Результат. String. Статус операции закачивания файла.

Скачать файл

Операция скачивает файл.

Вход:

  • Файл. String. Имя файла.

Результат:

  • Результат. Data Block. Содержимое файла.

Переименовать файл

Операция переименовывает файл.

Вход:

  • Файл. String. Имя файла.
  • Новое имя файла. String. Новое имя файла.

Результат:

  • Результат. String. Статус операции переименования файла.

Удалить файл

Операция удаляет файл.

Вход:

  • Файл. String. Имя файла.

Результат:

  • Результат. String. Статус операции удаления файла.

События device

Драйвер не предоставляет событий.

Подключение

Устройство SMB/CIFS имеет статус онлайн, если успешно выполнены следующие шаги:

  • Установлено соединение с удаленным сервером
  • Аутентификация прошла успешно (если активирована)
  • Удаленный ресурс, указанный в настройках Пути, существует и доступен
  • Все операции ввода/вывода с ресурсом (т.е. чтение и запись содержимого файла/папки) были успешно завершены

Синхронизация

Во время синхронизации устройства SMB/CIFS с сервером выполняются следующие операции:

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