Информационные базы, кластер и платформа
Инструменты для работающей информационной базы: обновление и выгрузка конфигурации, агенты конфигуратора, расширения, сеансы кластера, обслуживание и установки платформы.
Эти инструменты обращаются к работающей информационной базе. Они используют четыре разных способа подключения, которые указаны в столбце Через.
- штатная синхронизация EDT – то, чем пользуется сама среда. EDT открывает собственное соединение с базой. Передать учетные данные вне интерфейса нельзя, поэтому синхронизация недоступна для базы с аутентификацией пользователей.
ibcmdидет прямо к базе данных, путем или координатами СУБД, поэтому кластерной базе доступ к кластеру не нужен. Режимextensionне принимает учетные данные 1С.- агент конфигуратора – это конфигуратор, запущенный с
/AgentMode. Он принимает команды по SSH и проходит аутентификацию как пользователь базы. Это позволяет обращаться к базам, недоступным двум другим способам. Мост использует один агент на каждую базу и сохраняет его между вызовами. racобращается к кластеру и управляет его сеансами. Ни агент, ниibcmdих не видят.
Инструментам, которые изменяют базу, требуется токен. По умолчанию они возвращают план.
Если задана EDT_BRIDGE_PII, edt_infobase_sessions, edt_infobase_maintenance и
edt_designer_agent заменяют пользователей и компьютеры сеансов и маскируют персональные данные в
остальном ответе; см. Персональные данные.
| Инструмент | Через | Что делает |
|---|---|---|
edt_infobases · edt_platform_installations |
EDT | С чем работает платформенная сторона. Зарегистрированные в EDT информационные базы с именем, uuid и строкой соединения, а к ним привязки открытых проектов. Дальше – установки 1С:Предприятие, из которых EDT выбирает при выгрузке .epf и .erf и при создании базы: каждая разрешена до конкретной установки с толстым клиентом, плюс полные установки, найденные на диске. |
edt_platform_build_readiness |
установка на диске | Запускает Конфигуратор на временной файловой базе для проверки пакетного режима и доступа к лицензии. Требует токен записи. |
edt_designer_agent |
агент | Жизненный цикл агентов конфигуратора, которыми управляет мост: список, запуск, остановка, уборка. Агент – это конфигуратор в режиме /AgentMode с открытым сеансом базы, проходящий аутентификацию как пользователь базы; так мост и добирается до базы, недоступной остальным транспортам. Агент запускается по требованию и продолжает работать между вызовами. Остановка освобождает сеанс на сервере. Простояв дольше EDT_BRIDGE_AGENT_IDLE_MINUTES, агент останавливается сам, потому что занимает клиентскую лицензию и сеанс конфигуратора; по умолчанию это 30 минут, а off отключает остановку по времени простоя. После аварийного завершения агента может остаться сеанс с блокировкой конфигурирования базы. Такой сеанс удаляется перед каждым запуском, при stop для базы, агент которой завершился с ошибкой, и по запросу action=sweep. Принадлежность определяется по записи агента, а не по хосту и пользователю сеанса. list также возвращает edtSessions – сеансы конфигуратора, которые EDT держит для своих баз: база, связанные проекты, pid и состояние (live, dead или external для агента, запущенного не EDT), – и otherConfigurators, процессы толстого клиента, не принадлежащие ни мосту, ни EDT. action=stop-edt закрывает сеанс EDT для одной зарегистрированной базы средствами EDT: агент, запущенный EDT, завершается, от чужого агента EDT только отключается. |
edt_infobase_config_state |
агент | Проверяет, применена ли конфигурация базы данных, которую исполняют сеансы, или ожидается обновление. Обновление запускается, но его подтверждение отклоняется, поэтому изменения не применяются. Для ожидающего обновления возвращается полный список изменений структуры. Вызов идет через агент конфигуратора, поэтому доступна серверная база с аутентификацией пользователей. |
edt_update_database_config |
агент | Применяет конфигурацию базы данных. Это шаг, после которого работающие сеансы начинают исполнять ту конфигурацию, которую хранит база. Загрузка проекта в базу этого не делает: до применения каждый сеанс исполняет прежний код, и так выглядит только что добавленный маршрут HTTP-сервиса, отвечающий 404. По умолчанию возвращает план. sessionTermination=force завершает удерживающие базу сеансы, когда нужна монопольная блокировка. |
edt_update_infobase |
EDT · агент | Обновляет конфигурацию базы из проекта EDT. По умолчанию используется синхронизация EDT: изменения структуры базы данных подтверждаются автоматически, конфликт прерывает обновление, а база с пользователями не поддерживается. При transport=agent проект выгружается в XML конфигуратора и загружается через агент конфигуратора. Этот способ поддерживает серверную базу с пользователями; конфигурация базы данных применяется, если не указано updateDatabaseConfig=false. Если сохраненная запись о загрузке соответствует состоянию базы, загружаются только измененные файлы. Условия и параметр fullLoad описаны в разделе Загрузка измененных файлов. |
edt_create_infobase · edt_register_platform |
EDT · установка с диска | Создает пустую файловую базу и регистрирует ее в списке EDT, а если под нужную версию EDT ничего не нашла, берет полную установку с диска. Второй инструмент регистрирует полную установку в EDT, чтобы ею мог пользоваться ее собственный движок. |
edt_register_infobase |
EDT | Регистрирует существующую серверную базу по name, connect="Srvr=server;Ref=base;", version и необязательному user. Использует EDT, обновляет ее список и считывает UUID без перезапуска среды. Отклоняет дубликаты имен/адресов и учетные данные в строке; серверную базу не создает и не изменяет. |
edt_extension_properties |
агент · ibcmd | Читает и задает то, как расширение зарегистрировано в базе: безопасный режим, защита от опасных действий, активность, область действия. Ни сборка .cfe, ни обновление из EDT этого не решают, а только что зарегистрированное расширение получает безопасный режим и защиту включенными. Расширение, которое меняет методы базовой конфигурации, под ними не работает. Передайте проект расширения, чтобы проверить, препятствуют ли эти настройки его работе. По имени из EDT вызов идет через агента, которому доступна серверная база с пользователями; по явным координатам СУБД – через ibcmd, которому она недоступна. |
edt_delete_extension |
агент | Снимает расширение с информационной базы. План содержит текущие свойства расширения; при неверном имени возвращается ошибка. Кроме apply нужен force: конфигурация расширения хранится в базе, и восстановить ее этим инструментом нельзя. |
edt_infobase_sessions |
rac | Сеансы кластера 1С через rac: перечислить по базе или по виду приложения и завершить. Агент и ibcmd не управляют сеансами, поскольку те находятся в менеджере кластера. Инструмент помогает освободить базу для конфигурирования. Принудительно завершенный сеанс конфигуратора может сохранять блокировку конфигурации и виден здесь как сеанс Designer. Завершение по умолчанию возвращает план и требует force. |
edt_infobase_maintenance |
rac | Управляет окном обслуживания при обновлении базы. begin устанавливает scheduled-jobs-deny и, по запросу, sessions-deny с кодом доступа. После завершения сеансов возвращается “clear to update”. end снимает оба флага, включая sessions-deny, установленный другим вызовом begin, и сообщает, если флаг остался установленным. status возвращает состояние. В работающей базе сеансы BackgroundJob пересоздаются каждую минуту, поэтому перед их завершением требуется запрет. Нужен администратор базы, по умолчанию возвращается план. |
edt_infobase_dump |
ibcmd | Выгружает информационную базу в .dt через ibcmd. Такую резервную копию можно создать перед применением конфигурации к базе данных. База адресуется путем или координатами СУБД, перезаписывать существующий файл инструмент отказывается, по умолчанию возвращает план. В самой базе ничего не меняется, но выгрузка читает все ее данные, поэтому нужен токен. |
Проверка готовности платформы к сборке
edt_platform_installations перечисляет полные установки, доступные в EDT и на диске. Чтобы
проверить запуск платформы, вызовите edt_platform_build_readiness с настроенным токеном
записи. Параметр platformVersion выбирает точную сборку по четырем компонентам версии или
новейшую полную установку указанной линии. Если параметр опущен, проверяется новейшая полная
установка. timeoutSeconds задает предел ожидания каждого процесса (1–120 секунд, по умолчанию
30).
Инструмент создает файловую базу во временном каталоге и выполняет для нее 1cv8 DESIGNER /DumpCfg.
Запуск использует установку платформы и доступ к лицензии в среде моста. Результат удаления
временных файлов указан в cleanup. Поле installation различает отсутствие полной установки
(platformNotFound) и отсутствие запрошенной версии (incompatibleVersion). Этапы
createInfobase и designer возвращают состояние, в том числе отказ лицензии
(licenseRefused), сбой запуска (launchFailed), превышение времени ожидания (timedOut) или
пропуск этапа (notChecked). Имя программы и код завершения указываются, если они доступны.
Успех подтверждает, что выбранный Конфигуратор смог выгрузить пустую конфигурацию в этой среде.
Ошибка команды платформы содержит имя программы, операцию и код, если процесс завершился. Аргументы команды в названии операции опускаются.
Загрузка измененных файлов
При вызове edt_update_infobase с transport=agent проект каждый раз выгружается целиком.
Файлы выгрузки сравниваются с записью о последней успешной загрузке в ту же базу.
Запись содержит хеши файлов, версию платформы и идентификатор поколения конфигурации базы.
Она хранится в метаданных рабочей области и доступна после перезапуска агента или EDT.
Только измененные файлы загружаются при выполнении всех условий:
- Запись доступна для чтения и относится к той же базе и версии платформы.
- Идентификатор поколения конфигурации доступен и совпадает с сохраненным.
- Из выгрузки не удален ни один файл.
Configuration.xmlи файл настроек поддержкиExt/ParentConfigurations.binне изменены.- Изменено не больше половины файлов выгрузки.
При невыполнении любого условия конфигурация загружается целиком. Если условия выполнены
и файлы не изменились, их загрузка пропускается. При ошибке частичной загрузки мост выполняет попытку полной
загрузки; потеря соединения обрабатывается повторным подключением агента. Расширения всегда
загружаются целиком. Для явного запроса полной загрузки конфигурации указать fullLoad=true.
В ответ входят loadMode (full, partial или skipped), причина выбора loadReason,
счетчики файлов и длительность выгрузки и загрузки. loadRecord указывает расположение записи,
а loadRecordState сообщает о ее чтении и сохранении. loadRepeated обозначает повторную
загрузку после потери соединения. После обработки файлов применяется конфигурация базы данных,
если не указано updateDatabaseConfig=false. Это относится и к случаю пропуска загрузки файлов.