Как установить утилиту ring в 1С: пошаговая инструкция

Ring — это консольная утилита, входящая в состав технологической платформы «1С:Предприятие» начиная с версии 8.3. Она предназначена для управления серверными компонентами: установки агентов кластера, служб хранилища конфигураций, веб-серверов и других модулей в виде обычных приложений или системных служб. Администраторы используют ring, когда нужно развернуть сервер 1С без графического интерфейса — например, на Linux-сервере или при автоматизации развёртывания через скрипты.

Отдельно скачивать ring не требуется: исполняемый файл поставляется вместе с платформой и находится в каталоге её установки. Задача сводится к тому, чтобы убедиться в наличии утилиты, при необходимости добавить путь к ней в переменные окружения и научиться вызывать базовые команды. Ниже разобраны оба сценария — для Windows и Linux — с проверкой результата и разбором типичных ошибок.

Что такое ring и когда она нужна

Утилита ring заменяет традиционный подход с регистрацией служб вручную. Раньше агент сервера 1С регистрировали как службу Windows через ragent.exe с параметрами командной строки, а на Linux — через системные юниты systemd. Ring унифицирует этот процесс: одна и та же команда устанавливает, удаляет, запускает и останавливает модули на обеих операционных системах.

Практические сценарии, где ring незаменима: развёртывание сервера 1С на Linux без графической оболочки, автоматическая установка через скрипты, управление службами хранилища конфигураций, установка нескольких экземпляров агента на один сервер. Если вы работаете только с файловыми базами на локальном компьютере, утилита вам не понадобится.

Где находится ring после установки платформы

В Windows утилита ring.cmd располагается в каталоге установленной версии платформы, обычно по пути вида C:\Program Files\1cv8\<номер версии>\bin\ring.cmd. Если платформа установлена в стандартный каталог, найти файл можно через поиск внутри папки 1cv8.

В Linux после установки пакетов платформы утилита находится в каталоге /opt/1cv8/x86_64/<номер версии>/ring. Точный путь зависит от архитектуры и номера версии. Быстрый способ найти файл — выполнить поиск по файловой системе.

find /opt/1cv8 -name ring -type f 2>/dev/null

Если поиск не дал результатов, значит, на машине не установлена платформа 1С либо установлена усечённая версия без серверных компонентов. В этом случае сначала установите платформу с дистрибутива, отметив при установке серверные компоненты.

Установка и настройка ring в Windows

На Windows дополнительной установки не требуется — достаточно, чтобы была установлена платформа. Однако вызывать утилиту по полному пути неудобно, поэтому каталог с ней добавляют в системную переменную PATH. Это делается через «Система → Дополнительные параметры системы → Переменные среды».

Порядок действий: откройте переменные среды, найдите переменную Path в системных переменных, добавьте путь к каталогу bin нужной версии платформы. После сохранения закройте и заново откройте командную строку, чтобы изменения применились. Важно запускать командную строку от имени администратора, если планируется установка служб — без повышенных прав ring не сможет зарегистрировать службу.

1. 1
   Убедитесь, что платформа 1С установлена, и найдите ring.cmd в каталоге bin нужной версии
2. 2
   Добавьте путь к каталогу bin в системную переменную Path
3. 3
   Перезапустите командную строку от имени администратора
4. 4
   Выполните ring help и убедитесь, что выводится справка по командам
5. 5
   Проверьте список доступных модулей: ring help module

Установка и настройка ring в Linux

В Linux платформа устанавливается пакетами, и ring появляется автоматически. Для удобства создайте символическую ссылку в каталог, который уже входит в PATH, или добавьте путь в переменную окружения через профиль оболочки. Установка служб требует прав root или выполнения через sudo.

ln -s /opt/1cv8/x86_64/<версия>/ring /usr/local/bin/ring
ring help

После настройки проверьте, что утилита вызывается без указания полного пути. Если команда не находится, проверьте содержимое переменной PATH командой echo $PATH и корректность символической ссылки. Типичная причина проблемы — ссылка указывает на несуществующий путь из-за ошибки в номере версии.

Основные команды ring для проверки и работы

Базовый синтаксис утилиты: ring <модуль> <команда> [параметры]. Модули — это устанавливаемые компоненты: cluster (агент кластера серверов), cs (хранилище конфигураций) и другие. Узнать актуальный список модулей и команд можно через встроенную справку.

Перед установкой службы обязательно изучите параметры конкретного модуля через help: для агента кластера обычно задаются сетевой порт, каталог данных и имя экземпляра. Неверно указанный порт, уже занятый другим приложением, приведёт к тому, что служба зарегистрируется, но не запустится.

Проверка результата установки

Признак успешной настройки ring — утилита вызывается из любого каталога командой ring help и выводит справку без ошибок. После установки службы проверьте её состояние: в Windows — через оснастку «Службы» или команду sc query, в Linux — через systemctl status с именем созданного юнита.

Для агента кластера дополнительная проверка — процесс ragent.exe (или ragent в Linux) присутствует в списке процессов и слушает назначенный порт. Если служба есть, но процесса нет, смотрите журнал событий системы и технологический журнал 1С — чаще всего причина в правах на каталог данных или конфликте портов.

Типичные ошибки и их устранение

Самая частая проблема — «ring не является внутренней или внешней командой» в Windows или «command not found» в Linux. Причина всегда одна: каталог с утилитой не добавлен в PATH или сеанс командной строки не был перезапущен после изменения переменных среды. Лечится добавлением пути и открытием нового окна терминала.

Вторая группа ошибок связана с правами: установка службы завершается отказом в доступе, если командная строка запущена без прав администратора или без sudo. Третья типичная ситуация — после обновления платформы PATH указывает на каталог старой версии, и ring вызывает модули устаревшей сборки. После каждого обновления платформы проверяйте, куда ведёт путь.

FAQ