Механизмы администрирования РБД 1С

Распределённая информационная база 1С (РБД, в терминах платформы — РИБ) состоит из главного узла и периферийных узлов. Ниже собраны три операции администрирования: отвязка периферийного узла от главного, место хранения каталога файлового обмена и пакетная выгрузка и загрузка всех расширений конфигурации в XML.

Ключ отвязки ПУ от главного узла

ПУ — периферийный узел. Ключ запуска платформы /ResetMasterNode отменяет назначение главного узла у той информационной базы, которую открывают с этим ключом. После выполнения база больше не считается подчинённым узлом прежнего главного: штатный обмен РБД с ним останавливается. Уже загруженные данные, справочники и документы в базе сохраняются.

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

Полная строка запуска в том же виде, что и команды выгрузки расширений. Имя базы в параметре /S заменяют на имя периферийной базы. /N и /P — пользователь и пароль информационной базы:

chcp 65001
"C:\Program Files\1cv8\common\1cestart.exe" DESIGNER /S "localhost\имя_базы_ПУ" /N"Admin" /P"123" /ResetMasterNode

Команду выполняют в командной строке Windows (cmd.exe), из каталога, где путь к базе и пароль читаются в нужной кодировке. chcp 65001 переключает окно на UTF-8: без этого путь с кириллицей может быть передан конфигуратору искажённым.

Ключ отрабатывает один раз, повторный запуск не нужен. Состав плана обмена в конфигурации при этом не удаляется. На главном узле регистрация этого периферийного узла остаётся: если обмен больше не нужен, узел отключают или удаляют уже в главной базе, иначе главный узел продолжит готовить для него сообщения обмена.

Чтобы снова включить эту базу в РБД, узел создают заново и заново настраивают обмен. Прежняя цепочка сообщений после /ResetMasterNode не продолжается.

Место хранения настроек пути к обмену файлами для РБД

Каталог, через который узлы обмениваются файлами сообщений, хранится в регистре сведений «Настройки транспорта обмена данными». Одна запись регистра соответствует одному узлу плана обмена. Путь к каталогу лежит в поле «Каталог обмена информацией» (в метаданных — FILEКаталогОбменаИнформацией). Это поле используется, когда вид транспорта сообщений — сетевой каталог (FILE).

Открыть настройку из интерфейса: «НСИ и администрирование» — «Администрирование» — «Синхронизация данных» — «Настройки синхронизации данных» — нужная синхронизация — «Параметры подключения». Для прямой правки: «Функции для технического специалиста» — «Регистры сведений» — «Настройки транспорта обмена данными».

В том же регистре, в записи этого узла, лежат и остальные параметры транспорта: FTP (сервер, порт, каталог, пользователь), электронная почта, COM-соединение и веб-сервис. При виде транспорта FTP каталогом обмена является путь на FTP, а не поле сетевого каталога.

В каталоге появляются файлы сообщений вида Message_КодОтправителя_КодПолучателя.xml. Если в настройках включено сжатие, сообщение будет в архиве. Оба участника файлового обмена указывают каталог, который им доступен: часто это одна общая папка.

Для клиент-серверной базы путь читается на том компьютере, где выполняется сеанс обмена. Если обмен идёт регламентным заданием на сервере 1С, каталог должен существовать на сервере либо быть сетевым путём, доступным учётной записи сервера. Локальный путь рабочего стола пользователя в этом случае сервер не увидит.

Выгрузка из 1С всех расширений сразу в файлы XML

Пакетный режим конфигуратора выгружает все расширения информационной базы в файлы XML одной командой. Ключ -AllExtensions относится к /DumpConfigToFiles и выгружает каждое расширение в отдельный подкаталог. Основная конфигурация этой командой не выгружается: для неё ту же строку запускают без -AllExtensions. Одно расширение выгружают ключом -Extension ИмяРасширения вместо -AllExtensions.

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

chcp 65001
"C:\Program Files\1cv8\common\1cestart.exe" DESIGNER /S "localhost\erp_update2024_3" /N"Admin" /P"123" /DumpConfigToFiles "C:\Users\pride\Desktop\ТЗ ERP\Переход24\ExtExt" -AllExtensions

/S "localhost\erp_update2024_3" — клиент-серверная база: сервер кластера и имя базы. Для файловой базы вместо /S указывают /F "C:\путь\к\базе". /N и /P — пользователь с правом открытия конфигуратора и пароль. В примере пароль тестовый.

В каталоге ExtExt появится подкаталог на каждое расширение, внутри — Configuration.xml и каталоги объектов метаданных. Файлы остаются в UTF-8, как их записала платформа.

1cestart.exe сам выбирает установленный релиз платформы. Если на компьютере несколько версий 8.3, для выгрузки надёжнее запускать 1cv8.exe из каталога bin той версии, под которой работает база. Если конфигуратор останавливается на стартовом диалоге, в конец строки добавляют /DisableStartupDialogs. Протокол запуска пишут ключом /Out "C:\путь\выгрузка.txt".

Загрузка всех расширений из файлов XML в 1С

Загрузка читает дерево XML, полученное выгрузкой с ключом -AllExtensions, и загружает все найденные расширения в указанную базу. В каталоге загрузки должны лежать подкаталоги расширений, а не отдельный файл. Выгрузка в примере пишет в C:\Users\pride\Desktop\ТЗ ERP\Переход24\ExtExt, загрузка читает C:\FTP\rbd_test_26\ExtExt: перед загрузкой файлы копируют в тот каталог, который указан в команде, либо в команде указывают каталог фактической выгрузки.

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

chcp 65001
"C:\Program Files\1cv8\common\1cestart.exe" DESIGNER /S "localhost\iv24_update2024" /N"Admin" /P"123" /LoadConfigFromFiles "C:\FTP\rbd_test_26\ExtExt" -AllExtensions

После загрузки расширения есть в конфигурации, но ещё не применены к базе данных. Следующей командой обновляют конфигурацию базы данных по всем расширениям. На это время другие сеансы конфигуратора закрывают; если обновление потребует реструктуризации, пользователей выводят из базы. Перед загрузкой снимают копию базы.

"C:\Program Files\1cv8\common\1cestart.exe" DESIGNER /S "localhost\iv24_update2024" /N"Admin" /P"123" /UpdateDBCfg -AllExtensions

По окончании в конфигураторе проверяют список расширений: состав, активность и область действия. Файлы XML перед загрузкой не перекодируют в Windows-1251 и не правят редактором, который меняет кодировку или порядок байтов: конфигуратор ждёт ту кодировку, в которой файлы были выгружены.