Шпаргалка — Как активировать лицензии 1С при помощи утилиты Ring

см. так же: Как проверить актуальность лицензии 1С при помощи Ring

Идея этого поста - шпаргалка на будущее, но я буду рад, если кому-то пригодится приведенная информация.

Если Вы читаете это, значит примерно представляете, что такое Ring. В этом посте речь только об активации лицензий. Позднее здесь я представлю ссылки на следующие шпаргалки по работе с ring-ом.

Когда эта утилита может пригодиться? Мне в основном пригождалась для активации лицензий на Linux-ах, где нет графической оболочки и конфигуратор не запустить, однако, примеры скриптов будут использовать абсолютные пути в Windows, чтобы информация воспринималась лучше.

Стоит отметить, что в этом примере лицензии привязываются к параметрам машины!

Поехали.

Шаг 1: Формирование запроса на лицензию. Команда prepare-request

Ссылка на документацию.

set JAVA_HOME="C:\Program Files (x86)\Java\jre1.8.0_251"
set TOOLS="C:\Program Files (x86)\1C\1CE\components\1c-enterprise-ring-0.17.0+1-x86"

chcp 1251
echo "1. Делаем запрос" >  %TOOLS%\lic.log
call %TOOLS%\ring.cmd license prepare-request --serial 999999999 --pin 111-222-333-444-555 --company "Название компании" --country "Российская Федерация" --town "Санкт-Петербург" --street "Большой проспект П.С." --house 33  --zip-code 111111 --request %TOOLS%\LicData.txt >> %TOOLS%\lic.log

pause

• first-name ‑ имя владельца лицензии. При указания параметра company, данный параметр является необязательным.

• middle-name ‑ отчество владельца лицензии. При указания параметра company, данный параметр является необязательным.

• last-name ‑ фамилия владельца лицензии. При указания параметра company, данный параметр является необязательным.

• email ‑ электронная почта владельца лицензии.

• company ‑ организация владельца лицензии. При указании параметров first-name, middle-name, last-name, данный параметр является необязательным. Требуется не менее 5 символов, при этом не должно быть более 3 одинаковых символов подряд.

• country ‑ страна регистрации. Не может быть пустым.

• zip-code ‑ индекс. Не может быть пустым.

• region ‑ область/республика/край.

• district ‑ район.

• town ‑ город. Не может быть пустым.

• street ‑ улица. Не может быть пустым.

• house ‑ номер дома. При указании параметров building или apartment, данный параметр является необязательным. Не может быть пустым.

• building ‑ строение. При указании параметров house или apartment, данный параметр является необязательным. Не может быть пустым.

• apartment ‑ квартира. При указании параметров house или building, данный параметр является необязательным. Не может быть пустым.

• serial ‑ серийный номер программного продукта.

• pin ‑ пинкод, используемый при активации лицензии.

• previous-pin ‑ при повторной активации лицензии в данном параметре указывается пинкод, который использовался при первичной активации лицензии. Не должен совпадать со значением параметра pin.

• request ‑ указывает полный путь к файлу, в который будет помещена информация для передачи в центр лицензирования. Если не указан, то текст запроса в центр лицензирования будет выведен в стандартный поток вывода.

• validate ‑ если указан, то выполнение команды будет завершено с ошибкой, если при попытке получения какого-либо из ключевых параметров возникла ошибка времени исполнения. В случае если параметр не указан, возникновение ошибки при получении какого-либо ключевого параметра не будет препятствовать успешной активации лицензии. Однако, поля лицензии, соответствующие неполученным параметрам, будут заполнены пустыми значениями, что приведет к невозможности дальнейшего использования активированной лицензии.

Шаг 2: Получение ответа от центра лицензирования. Команда acquire

Ссылка на документацию.

echo "2. Получаем ответ" >>  %TOOLS%\lic.log
set JAVA_HOME="C:\Program Files (x86)\Java\jre1.8.0_251"
set TOOLS="C:\Program Files (x86)\1C\1CE\components\1c-enterprise-ring-0.17.0+1-x86"

chcp 1251

call ring license acquire --request %TOOLS%\LicData.txt --response %TOOLS%\response1.txt  >> %TOOLS%\lic.log

• request ‑ полное имя к файлу с запросом к центру лицензирования. Если параметр не указан, то содержимое файла запроса ожидается со стандартного потока ввода.

• response ‑ полное имя файла, в которое будет помещен ответ центра лицензирования. Если параметр не указан, то содержимое файла ответа будет выведено в стандартный поток вывода.

Шаг 3: Сборка файла лицензии. Команда generate

Ссылка на документацию.

set JAVA_HOME="C:\Program Files (x86)\Java\jre1.8.0_251"
set TOOLS="C:\Program Files (x86)\1C\1CE\components\1c-enterprise-ring-0.17.0+1-x86"

chcp 1251
echo "3. Собираем лицензию" >>  %TOOLS%\lic.log
REM license = request + response
call %TOOLS%\ring.cmd license generate --request %TOOLS%\LicData.txt --response %TOOLS%\response1.txt --license %TOOLS%\license1.txt >> %TOOLS%\lic.log

pause

• license ‑ полное имя к файлу с получившейся лицензией. Если параметр не указан, то содержимое файла активированной лицензии выводится в стандартный поток вывода.

• request ‑ полное имя к файлу с запросом к центру лицензирования.

• response ‑ полное имя файла, в которое будет помещен ответ центра лицензирования.

В результате у нас появится файл с активированной лицензией.

Шаг 4: Поместить лицензию в хранилище 1С. Команда put

Ссылка на документацию.

set JAVA_HOME="C:\Program Files (x86)\Java\jre1.8.0_251"
set TOOLS="C:\Program Files (x86)\1C\1CE\components\1c-enterprise-ring-0.17.0+1-x86"

chcp 1251
echo "4. Помещаем в хранилище" >>  %TOOLS%\lic.log
call %TOOLS%\ring.cmd license put --license %TOOLS%\license1.txt >> %TOOLS%\lic.log

pause

• license ‑ полный путь к файлу активированной лицензии, который будет помещен в хранилище лицензий.

Шаг 5: Вывести содержимое хранилища лицензий. Команда list

Ссылка на документацию.

set JAVA_HOME="C:\Program Files (x86)\Java\jre1.8.0_251"
set TOOLS="C:\Program Files (x86)\1C\1CE\components\1c-enterprise-ring-0.17.0+1-x86"

chcp 1251
echo "5. Список лицензий" >>  %TOOLS%\lic.log
call %TOOLS%\ring.cmd license list >> %TOOLS%\licenses.txt

pause

В результате будет выведен список всех имеющихся и добавленных в хранилище лицензий.