wiki.nntc.nnov.ru - Вклад участника [ru]

PK

2026-06-19T09:25:52Z

Shogun Sun: /* Принтеры */

=Общий каталог для сканеров=

==На сервере==

adduser share

passwd share

usermod -L share

smbpasswd -a share
smbpasswd -e share

mkdir /home/share/kiocera

mkdir /home/share/konica

<pre>
cat << EOF > /etc/samba/smb.conf
# Global parameters
[global]
log file = /var/log/samba/log.%m
logging = file
map to guest = Bad User
max log size = 1000
obey pam restrictions = Yes
pam password change = Yes
panic action = /usr/share/samba/panic-action %d
passwd chat = *Enter\snew\s*\spassword:* %n\n *Retype\snew\s*\spassword:* %n\n *password\supdated\ssuccessfully* .
passwd program = /usr/bin/passwd %u
server role = standalone server
server string = %h server (Samba, Ubuntu)
unix password sync = Yes
usershare allow guests = Yes
idmap config * : backend = tdb

[kiocera]
browseable = Yes
comment = share
valid users = share
create mask = 0755
directory mask = 0755
path = /home/share/kiocera
read only = No

[konica]
browseable = Yes
comment = share
valid users = share
create mask = 0755
directory mask = 0755
path = /home/share/konica
read only = No
EOF
</pre>

==На клиенте==

cat << EOF > /etc/samba/sambacreds
username=share
password=share
EOF

mkdir /home/pk/kiocera
mkdir /home/pk/konica

echo '//192.168.7.100/kiocera /home/pk/kiocera cifs uid=pk,credentials=/etc/samba/sambacreds 0 0' >> /etc/fatab
echo '//192.168.7.100/konica /home/pk/konica cifs uid=pk,credentials=/etc/samba/sambacreds 0 0' >> /etc/fatab

mount -a

=Принтеры=
==Отключение автоматического обнаружения==

Откройте конфигурационный файл в текстовом редакторе (например, nano):
<pre>
sudo nano /etc/avahi/avahi-daemon.conf
</pre>

В секции [server] найдите параметры use-ipv4 и use-ipv6 и установите для них значение no, чтобы запретить обнаружение принтеров по соответствующим протоколам:
<pre>
[server]
use-ipv4=no
use-ipv6=no
</pre>

Сохраните изменения и закройте редактор. Перезапустите устройство:
<pre>
reboot
</pre>

1c

2026-06-15T12:11:51Z

Shogun Sun: /* Включение поддержки OData */

=В GNU/Linux=

==Установка учебной платформы 8.5.x на ОС Альт Стартеркит p11 GNOME==

===Обновить ОС и ядро===

su -
apt-get update -y && apt-get dist-upgrade -y && update-kernel -y

===Поставить пакеты===

su -
apt-get install -f alt-tour evince firefox libwebkit2gtk 1c-preinstall-full libglui

===Включить sudo su===

Раскоментировать в файле:

/etc/sudoers

строчку:

WHEEL_USERS ALL=(ALL:ALL) ALL

или строчку:

WHEEL_USERS ALL=(ALL:ALL) NOPASSWD: ALL

(если необходимо выполнять sudo su без пароля)

===Установить платформу===

Предполагается, что есть файл установки платформы:

setup-training-8.5.1.1150-x86_64.run

Тогда установка осуществляетс следующим образом:

chmod +x setup-training-8.5.1.1150-x86_64.run
sudo ./setup-training-8.5.1.1150-x86_64.run

Далее следуем инструкциям установщика. В установщике необходимо выбрать пункты "Установить ярлыки" и "Зависимости".

Установщик сам переключится в режим текстового интерфейса, если не найдёт дисплей (например, при установке по ssh). А вообще он имеет графический интерфейс...

===Починить запуск платформы (актуально для ОС Альт веток p10 и p11 как минимум)===

Пробуем запустить:

/opt/1cv8t/x86_64/8.5.1.1150/1cv8t

Получилось? Если да, то странно... Должна быть такая ошибка:

/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.30' not found (required by /lib64/libwebkit2gtk-4.0.so.37)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.31' not found (required by /lib64/libwebkit2gtk-4.0.so.37)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.29' not found (required by /lib64/libwebkit2gtk-4.0.so.37)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.31' not found (required by /lib64/libjavascriptcoregtk-4.0.so.18)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.30' not found (required by /lib64/libjavascriptcoregtk-4.0.so.18)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.29' not found (required by /lib64/libjavascriptcoregtk-4.0.so.18)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.30' not found (required by /lib64/libicuuc.so.74)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.29' not found (required by /lib64/libjxl.so.0.11)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libgcc_s.so.1: version `GCC_12.0.0' not found (required by /lib64/libhwy.so.1)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libgcc_s.so.1: version `GCC_13.0.0' not found (required by /lib64/libhwy.so.1)

Не такая ошибка? Если да, то вы точно все пункты до этого выполнили (точно пакеты все установлены, которые выше в команде установки пакетовв перечислены)?

Если ошибка такая, то чиним:

sudo rm -f /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6
sudo rm -f /opt/1cv8t/x86_64/8.5.1.1150/libgcc_s.so.1

Пробуем запустить ещё раз:

/opt/1cv8t/x86_64/8.5.1.1150/1cv8t

Всё должно работать. Теперь можно запускать платформу посредством ярлыков (кнопок меню приложений)

По прежнему не запускается? Если да, то спешим на встречу новым приключениям!

===Переопределить настройки по умолчанию для ОС Альт===

====Каталог для файловых баз данных платформы 1С и sgid-bit====

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

Например, так:

mkdir ~/bases

При публикации базы данных через веб-сервер необходимо чтобы у процесса веб-сервера, запущенного от пользователя

apache2

был доступ на чтение и запись в каталог с базой данных конфигурации 1С.

Один из вариантов это сделать следующий:

1. Разрешаем членам группы-владельца каталога чтение и запись

sudo chmod g+rwx /home/user/bases -R

2. Устанавливаем sgid бит на каталог

sudo chmod g+s /home/user/bases -R

3. Добавляем пользователя apache2 в группу-владельца каталога

sudo usermod -aG user apache2

==Публикация REST/Odata на веб-сервере==

Предполагается что до этого были выполнены все действия в предыдущем разделе...

===Устанавливаем и включаем веб-сервер apache2===

sudo apt-get install -y apache2
sudo systemctl enable --now httpd2

===Создаём симлинк для httpd2===

Для скриптов платформы 1С это важно...

sudo ln -s /sbin/httpd2 /sbin/httpd

===Публикуем командой===

Сначала создаём файл (оно само не может):

sudo touch /etc/httpd2/conf/sites-enabled/1c_odata.conf

Потом публикуем:

sudo HOME=/home/user /opt/1cv8t/x86_64/8.5.1.1150/webinstt -apache24 -wsdir odata_base -dir /var/www/odata_base -connstr "File=/home/user/bases/base1;" -confPath /etc/httpd2/conf/sites-enabled/1c_odata.conf

В ответ должно прийти что-то типа этого:

Публикация выполнена

или этого:

Публикация обновлена

Примерное содержимое файла в контексте конфигурационных файлов веб-сервера apache2:

cat /etc/httpd2/conf/sites-enabled/1c_odata.conf

<pre>
LoadModule _1cws_module "/opt/1cv8t/x86_64/8.5.1.1150/wsap24t.so"

# 1c publication
Alias "/odata_base" "/var/www/odata_base/"
<Directory "/var/www/odata_base/">
AllowOverride All
Options None
Require all granted
SetHandler 1c-application
ManagedApplicationDescriptor "/var/www/odata_base/default.vrd"
</Directory>
</pre>

===Исправляем группу-владельца на файл ===

По каким-то причинам после выполнения публикации утилитой webinstt файл:

/var/www/odata_base/default.vrd

имеет группу-владельца:

apache

(привет разработчикам платформы 1С, ориентирующимся, поди, на Ubuntu, а не на ОС из реестра минцифры)...

Исправляем:

sudo chgrp apache2 /var/www/odata_base/default.vrd

===Исправляем параметр в конфигурации сервиса===

Исправляем значение параметра:

sudo sed -i 's/ProtectHome=yes/ProtectHome=no/g' /lib/systemd/system/httpd2.service

После этого перезагрузим демона systemd и сервис httpd2

sudo systemctl daemon-reload
sudo systemctl restart httpd2

Перед редактированием конфигурации необходимо передать права на папку публикации самому веб-серверу. По умолчанию она может быть закрыта для него. Если этого не сделать, веб-сервер не сможет прочитать файл настроек default.vrd и вернет ошибку доступа при обращении к базе через браузер.
<pre>
chown -R apache2: /var/www/odata_base
chmod -R 755 /var/www/odata_base
</pre>

Домашние каталоги пользователей (например, /home/user/) по умолчанию полностью изолированы от системных служб. Чтобы веб-сервер apache2 смог добраться до папки с базой данных, ему нужно дать разрешение на «транзитный проход» сквозь вышестоящие директории. Флаг +x для папок как раз открывает эту возможность, не нарушая при этом приватность остальных личных файлов пользователя.
<pre>
sudo chmod a+x /home/user/
sudo chmod a+x /home/user/bases/
</pre>

Перед конфигурацией OData необходимо также предоставить веб-серверу права на чтение и запись внутри папки с самой базой. Чтобы не нарушать логику прав Linux и оставить пользователя владельцем файлов, мы добавляем apache2 в его группу и выставляем права 775 совместно с флагом SGID. Это позволит платформе беспрепятственно создавать файлы блокировок (.1CL), а новые файлы будут автоматически наследоваться группой.
<pre>
sudo chmod -R 2775 /home/user/bases/base1/
</pre>

===Перезапускаем веб-сервер===

sudo systemctl restart httpd2

===Проверяем публикацию===
Идём браузером по адресу:

<pre>
http://localhost/odata_base/
</pre>

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

<pre>
{"#exception":"{http://v8.1c.ru/8.2/virtual-resource-system}Exception","exception":{"clsid":"580392e6-ba49-4280-ac67-fcd6f2180121","reason":404,"descr":"HTTP: Not found\nError executing the query GET to resource /en/scripts/mod_bootstrap_bootstrap.js:","category":"00000000000000000000000000","creationStack":"mngsrvt:0x0000000000252DF5 mngsrvt:0x000000000024F8F4 vrsbaset:0x00000000006D7791 vrsbaset:0x00000000006540C5 vrsbaset:0x00000000006EBDE6 vrsbaset:0x00000000006D2A9C vrsbaset:0x00000000006EC4A9 vrsbaset:0x00000000006ED4A0 core85t:0x00000000008D4EBF core85t:0x00000000006B238C libc.so:0x0000000000000000 libc.so:0x0000000000000000 "}}
</pre>

(ещё один привет разработчикам платформы 1С, по всей видимости, совсем не ориентирующимся на ОС на базе GNU/Linux, раз в учебной версии под GNU/Linux с веб-интерфейсом что-то не так).

НО!

Это не помешает нам работать с OData REST!

===Включение поддержки OData===

Любым текстовым редактором открываем конфигурационный файл публикации:
<pre>
nano /var/www/odata_base/default.vrd
</pre>

Внутри тега <standardOdata> меняем значение параметра enable с false на true:
<pre>
<standardOdata enable="true"
</pre>

Итоговый вид файла default.vrd:
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<point xmlns="http://v8.1c.ru/8.2/virtual-resource-system"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
base="/odata_base"
ib="File=/home/user/bases/base1;">
<ws pointEnableCommon="true"/>
<standardOdata enable="true"
reuseSessions="autouse"
sessionMaxAge="20"
poolSize="10"
poolTimeout="5"/>
<analytics enable="true"
sessionMaxAge="1200"
poolSize="500"
poolTimeout="5"/>
</point>
</pre>

В блоке

<pre>
<standardOdata enable="true"
reuseSessions="autouse"
sessionMaxAge="20"
poolSize="10"
poolTimeout="5"/>
</pre>

измените значения параметров на

<pre>
reuseSessions="dontuse"
sessionMaxAge="0"
poolSize="0"
poolTimeout="0"
</pre>

Это решит проблему блокировки REST-сервиса на учебной версии 1С. При стандартных настройках веб-сервер удерживает соединения в пуле. Из-за этого даже при малом таймауте (sessionMaxAge) несколько идущих подряд запросов порождают новые параллельные сессии, что запрещено ограничениями учебной платформы (доступен только 1 сеанс). Обнуление пула гарантирует, что сессия будет закрываться сразу после выдачи данных.

После изменения конфигурации перезапускаем службу веб-сервера для применения настроек:
<pre>
sudo systemctl restart httpd2
</pre>

Для проверки доступности интерфейса OData отправляем GET-запрос по адресу:
<pre>
http://localhost/odata_base/odata/standard.odata?$format=json
</pre>

Пример успешного ответа (корневой контейнер для пустой информационной базы):
<pre>
<service xml:base="http://localhost/odata_base/odata/standard.odata">
<workspace>
<atom:title>Default</atom:title>
</workspace>
</service>
</pre>

===Внесение объектов в OData===
====Шаг 1. Создание внешней обработки====
Запустите Конфигуратор 1С, выберите в главном меню '''Файл''' -> '''Новый...''' и в открывшемся списке выберите '''Внешняя обработка'''.

[[Файл:1c-1.png|thumb|center|900px|Создание новой внешней обработки в Конфигураторе]]

[[Файл:1c-2.png|thumb|center|900px|Выбор типа создаваемого документа]]

====Шаг 2. Настройка свойств и создание формы====
В открывшемся окне свойств новой обработки выполните следующие действия:
# '''Имя''': Задайте понятное имя (например, `НастройкаOData`).
# '''Создание формы''': Перейдите на вкладку '''Формы''' и нажмите на кнопку «Добавить», чтобы создать основную форму обработки. На этой форме мы разместим кнопку и пропишем логику внесения объектов в OData.

[[Файл:1c-3.png|thumb|center|900px|Настройка имени обработки и инициализация создания формы]]

====Шаг 3. Добавление команды и программного кода====
В редакторе формы перейдите на вкладку '''Команды''' (в правой части экрана) и добавьте новую команду формы, задав ей имя (например, `ВыполнитьНастройку`).

Перетащите созданную команду мышкой в левую верхнюю часть окна — в структуру элементов формы, чтобы она превратилась в физическую кнопку.

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

[[Файл:1c-4.png|thumb|center|900px|Проектирование интерфейса формы и привязка клиент-серверного действия к кнопке]]

* '''1''' — Кнопка добавления на вкладке «Команды» в правой панели, с помощью которой создается новая команда формы.
* '''2''' — Элемент формы в левой панели (структура элементов), получившийся в результате перетаскивания команды мышкой из правой части.
* '''3''' — Пункт контекстного меню '''Действие команды''', открывающийся по правому клику мыши на перенесенном элементе для генерации шаблонов процедур.

В модуле формы замените сгенерированные шаблоны процедур следующим кодом:

<pre>
&НаКлиенте
Процедура ВыполнитьНастройку(Команда)
ВыполнитьНастройкуНаСервере();
КонецПроцедуры

&НаСервереБезКонтекста
Процедура ВыполнитьНастройкуНаСервере()
// 1. Создаем массив для объектов, которые пойдут в веб-сервис
МассивОбъектов = Новый Массив;

// 2. Добавляем в массив необходимый справочник (например, Сотрудники)
МассивОбъектов.Добавить(Метаданные.Справочники.Сотрудники);

// 3. Передаем этот массив платформе для регистрации в OData
УстановитьСоставСтандартногоИнтерфейсаOData(МассивОбъектов);
КонецПроцедуры
</pre>

====Шаг 4. Сохранение обработки====
Закройте окна редактора формы и программного модуля. Вернувшись в основное окно создания внешней обработки, нажмите кнопку '''Закрыть'''. Платформа автоматически предложит сохранить изменения — выберите удобный каталог на диске и сохраните файл обработки (с расширением `.epf`).

[[Файл:1c-5.png|thumb|center|900px|Процесс сохранения внешней обработки на диск]]

====Шаг 5. Запуск обработки в режиме предприятия====
Запустите 1С:Предприятие. В главном меню выберите '''Файл''' -> '''Открыть...''', найдите сохраненную ранее внешнюю обработку и откройте её. Если система безопасности выдаст предупреждение о потенциальной опасности подключаемого модуля, согласитесь с рисками и подтвердите открытие.

[[Файл:1c-6.png|thumb|center|900px|Открытие файла внешней обработки через пользовательский интерфейс 1С]]

====Шаг 6. Инициализация OData====
На экране появится созданная нами форма. Нажмите на ней кнопку '''Выполнить настройку'''. В этот момент отработает заложенная нами серверная логика, и состав стандартного интерфейса OData обновится. После этого обработку и само приложение 1С можно закрывать.

[[Файл:1c-7.png|thumb|center|900px|Финальное выполнение логики обработки по нажатию кнопки]]

====Шаг 7. Проверка доступности объектов в OData====
Чтобы убедиться, что внешняя обработка успешно зарегистрировала наши метаданные в веб-сервисе, откройте браузер и повторно отправьте GET-запрос по уже знакомому адресу:

<pre>
http://localhost/odata_base/odata/standard.odata
</pre>

Если всё сделано правильно, в ответе от сервера (в формате JSON или XML, в зависимости от настроек) вместо пустого корневого контейнера вы увидите структуру метаданных, содержащую зарегистрированный нами справочник.

Внутри тега `<workspace>` появится коллекция доступных сущностей (EntitySet), среди которых будет фигурировать URL для работы со справочником сотрудников: `Catalog_Сотрудники`.

==Автоматизация резервного копирования информационных баз==

Предполагается, что платформа "1С Предприятие" работает на GNU/Linux системе и скрипт резервного копирования выполняется от пользователя

administrator

, графическое окружение которого автоматически запускается после загрузки компьютера.

Дело в том, что по каким-то причинам, разработчики платформы "1С Предприятие" не заложили в систему запуск резервного копирования в headless-режиме, поэтому платформе необходим дисплей X-сервера.

Также предполагается, что файл с паролем от пользователя платформы "1С Предприятие", которому разрешено выполнять резервное копирование, хранится в файле

/home/administrator/.1c-cluster-infobases-backup.pass

и рекомендуемые права на этот файл

0400

===Подготовка каталога для скриптов===

mkdir /opt/1c_backup_scripts

===Базовый скрипт===

При необходимости, в тексте скрипта, отредактируйте строчку

bin1c="/opt/1cv8/x86_64/8.3.23.1912/1cv8"

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

Ниже предоставлен текст, который можно выделить, скопировать в текстовый редактор, при необходимости поправить, затем весь этот текст можно бросить в консоль для создания файла посредством heredoc-синтаксиса:
<pre>
cat << 'EOF' > /opt/1c_backup_scripts/backup_infobase_1c_generic.sh
#!/bin/bash
export LANG=ru_RU.UTF-8

NON_ROOT_USER="administrator"
DISPLAY=":0"
STORAGE="${1}"
SRV="${2}"
REF="${3}"
LOGIN="${4}"
PASSWORD_FILE="${5}"
KEEP_BACKUPS_FOR_LAST_DAYS="${6}"
BACKUP_TIMEOUT_SEC="${7}"
TIMEOUT_COUNTER=0
LOCK_FILE_PATH="/home/usr1cv8/.1cv8/1C/1cv8/reg_1541/snccntx8e79a393-c2af-4fd7-b25a-af6b5ed19bfa/snccntx.dat"
#-----------------------------
export DISPLAY="${DISPLAY}"
bin1c="/opt/1cv8/x86_64/8.3.23.1912/1cv8"
PASSWORD=`cat ${PASSWORD_FILE} | head -1`
infobase_suffix="$(date +%Y-%m-%d-%H-%M-%S).dt"
TMP_STORAGE="/opt/1c_backup_scripts/tmp_storage"
ib_tmp_filepath="${TMP_STORAGE}/${REF}__${infobase_suffix}"
ib_tmp_log="${ib_tmp_filepath}.log"
ib_filepath="${STORAGE}/${REF}__${infobase_suffix}"
ib_log="${ib_filepath}.log"

function rotate_backups(){
filenames_cmd="${STORAGE}/${REF}*"
current_unixtime=`date +%s --date="$(date +%Y-%m-%d) 00:00:00"`
test_unixtime=$(($current_unixtime-$KEEP_BACKUPS_FOR_LAST_DAYS*60*60*24))

for f in $(/bin/ls $filenames_cmd); do
#echo "f=$f"
datetime_from_file=`echo ${f} | awk -F '__' {'print $2'} | awk -F '.' {'print $1'}`
#echo "datetime_from_file=${datetime_from_file}"

#2023-12-24-22-01-02
Y=`echo ${datetime_from_file} | awk -F '-' {'print $1'}`
M=`echo ${datetime_from_file} | awk -F '-' {'print $2'}`
D=`echo ${datetime_from_file} | awk -F '-' {'print $3'}`
h=`echo ${datetime_from_file} | awk -F '-' {'print $4'}`
m=`echo ${datetime_from_file} | awk -F '-' {'print $5'}`
s=`echo ${datetime_from_file} | awk -F '-' {'print $6'}`

unixtime_from_file=`date +%s --date="${Y}-${M}-${D} ${h}:${m}:${s}"`

if [[ $unixtime_from_file -lt $test_unixtime ]]; then
echo "delete file: ${f}"
/bin/rm ${f}
else
echo "keep file: ${f}"
fi
done
}

function wait(){

if [[ $TIMEOUT_COUNTER -ge $BACKUP_TIMEOUT_SEC ]]; then
kill -9 ${1}
fi

if [ ! -d /proc/${1}/ ]; then
nice_text="Выгрузка информационной базы успешно завершена"
res_text=$(grep -o -i "${nice_text}" ${ib_tmp_log})

# start apache2
sudo systemctl start httpd2

if [ "${res_text}" = "${nice_text}" ]; then
/bin/cp ${ib_tmp_filepath} ${ib_filepath} && /bin/rm ${ib_tmp_filepath}
/bin/cp ${ib_tmp_log} ${ib_log} && /bin/rm ${ib_tmp_log}
#echo "TEST: ${ib_filepath} AND ${ib_log}"
rotate_backups
exit 0
fi

exit 1
fi
#echo "pid alive: ${1}"
sleep 1
TIMEOUT_COUNTER=$(($TIMEOUT_COUNTER+1))
wait ${1}
}

# prepare tmp storage
[ ! -d ${TMP_STORAGE} ] && sudo mkdir "${TMP_STORAGE}" && sudo chown administrator: "${TMP_STORAGE}" -R

# stop apache2
sudo systemctl stop httpd2
sleep 2

# reset srv1cv8 sessions
sudo systemctl stop srv1cv8
sleep 2
sudo /bin/rm -f "${LOCK_FILE_PATH}"
sudo systemctl start srv1cv8
sleep 2

DISPLAY=:0 XAUTHORITY=/home/administrator/.Xauthority ${bin1c} CONFIG /N "${LOGIN}" /P "${PASSWORD}" /S "${SRV}/${REF}" /DumpIB "${ib_tmp_filepath}" /OUT "${ib_tmp_log}" &
main_process_pid=$!

wait ${main_process_pid}
</pre>

Делаем файл исполняемым

chmod +x /opt/1c_backup_scripts/backup_infobase_1c_generic.sh

===Скрипт для резервирования конкретной базы данных===
Данный скрипт представляет из себя обёртку над выше приведённым скриптом, с заданием конкретных параметров резервирования

<pre>
cat << 'EOF' > /opt/1c_backup_scripts/backup__my_super_infobase.sh
#!/bin/bash

### PARAMETERS ###
STORAGE="/mnt/storage/my-1c-host-backups" # каталог для сохранения резервных копий
SRV="my-1c-host" # хост, на котором работает платформа "1С: Предприятие"
REF="my_super_infobase" # имя базы данных, которую резервируем
LOGIN="backupuser" # 1с-пользователь, которому разрешено резервировать базу данных
PASSWORD_FILE="/home/administrator/.1c-cluster-infobases-backup.pass" # в этом файле должен находиться только пароль от 1с-пользоателя
KEEP_BACKUPS_FOR_LAST_DAYS="2" # сохранить резервные копии только за эти несколько последных дней (в текущем примере - за 2 последних дня)
BACKUP_TIMEOUT_SEC="300" # таймаут, в течение которого разрешено работать процессу резервирования (процессу платформы "1С: Предприятие". Если за этот таймаут процесс не успел сделать резервную копию, то он снимается с выполнения)

# ------------------------------------------------------------------------------------------------

### BOT PARAMETERS
TELEGRAM_BOT_TOKEN="" # сюда нужно вписать токен телеграм-бота, который будет отсылать уведомления
TELEGRAM_DESTINATION_GROUP_ID="" # сюда нужно вписать идентификатор телеграм-пользователя или телеграм-группы (не забывайте про минус в начале, если это идентификатор группы), в которого (или в которую, если это группа) бот будет писать сообщения

function send_message_telegram(){
#exit 0 # раскомментируйте эту строчку, если отсылка сообщений телеграм-ботом не нужна (следовательно, и параметры дя бота при этом можно не задавать)
message=${1}
curl -s -X POST \
-H 'Content-Type: application/json' \
-d "{\"chat_id\": \"${TELEGRAM_DESTINATION_GROUP_ID}\", \"text\": \"${message}\", \"disable_notification\": true}" \
https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage > /dev/null
}
# ------------------------------------------------------------------------------------------------

### START ###
BASE=`dirname ${0}`
${BASE}/backup_infobase_1c_generic.sh "${STORAGE}" "${SRV}" "${REF}" "${LOGIN}" "${PASSWORD_FILE}" "${KEEP_BACKUPS_FOR_LAST_DAYS}" "${BACKUP_TIMEOUT_SEC}"
res=$?

if [ ${res} -eq 0 ]; then
send_message_telegram "[Успешно]\nРезервное копирование информационной базы '${REF}' выполнено успешно"
else
send_message_telegram "[Ошибка]\nРезервное копирование информационной базы '${REF}' не выполнено"
fi
EOF
</pre>

Делаем файл исполняемым

chmod +x /opt/1c_backup_scripts/backup__my_super_infobase.sh

===Ставим задачу для планировщика cron===

Под пользователем

administrator

в терминале открываем временный файл для настройки crontab

EDITOR=nano crontab -e

в результате редактором

nano

будет открыт временный файл для установки параметров планировщика для текущего пользователя. Отредактировав и сохранив (Ctrl+O - Enter) изменения в этом файле и закрыв редактор (Ctrl+X) будет сконфигурирован планировщик для текущего пользователя.

Проверить корректность заданных параметров планировщика можно выполнением команды

crontab -l

В случае, если планировщик был сконфигурирован на запуск скрипта резервного копирования каждые сутки с 23:01, вывод команды проверки должен быть примерно такой:
<pre>
#minute (0-59),
#| hour (0-23),
#| | day of the month (1-31),
#| | | month of the year (1-12),
#| | | | day of the week (0-6 with 0=Sunday).
#| | | | | commands
1 23 * * * /opt/1c_backup_scripts/backup__my_super_infobase.sh
</pre>

1c

2026-06-15T12:10:50Z

Shogun Sun: /* Включение поддержки OData */

1c

2026-06-13T09:19:56Z

Shogun Sun: /* Шаг 3. Добавление команды и программного кода */

=В GNU/Linux=

==Установка учебной платформы 8.5.x на ОС Альт Стартеркит p11 GNOME==

===Обновить ОС и ядро===

su -
apt-get update -y && apt-get dist-upgrade -y && update-kernel -y

===Поставить пакеты===

su -
apt-get install -f alt-tour evince firefox libwebkit2gtk 1c-preinstall-full libglui

===Включить sudo su===

Раскоментировать в файле:

/etc/sudoers

строчку:

WHEEL_USERS ALL=(ALL:ALL) ALL

или строчку:

WHEEL_USERS ALL=(ALL:ALL) NOPASSWD: ALL

(если необходимо выполнять sudo su без пароля)

===Установить платформу===

Предполагается, что есть файл установки платформы:

setup-training-8.5.1.1150-x86_64.run

Тогда установка осуществляетс следующим образом:

chmod +x setup-training-8.5.1.1150-x86_64.run
sudo ./setup-training-8.5.1.1150-x86_64.run

Далее следуем инструкциям установщика. В установщике необходимо выбрать пункты "Установить ярлыки" и "Зависимости".

Установщик сам переключится в режим текстового интерфейса, если не найдёт дисплей (например, при установке по ssh). А вообще он имеет графический интерфейс...

===Починить запуск платформы (актуально для ОС Альт веток p10 и p11 как минимум)===

Пробуем запустить:

/opt/1cv8t/x86_64/8.5.1.1150/1cv8t

Получилось? Если да, то странно... Должна быть такая ошибка:

/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.30' not found (required by /lib64/libwebkit2gtk-4.0.so.37)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.31' not found (required by /lib64/libwebkit2gtk-4.0.so.37)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.29' not found (required by /lib64/libwebkit2gtk-4.0.so.37)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.31' not found (required by /lib64/libjavascriptcoregtk-4.0.so.18)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.30' not found (required by /lib64/libjavascriptcoregtk-4.0.so.18)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.29' not found (required by /lib64/libjavascriptcoregtk-4.0.so.18)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.30' not found (required by /lib64/libicuuc.so.74)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.29' not found (required by /lib64/libjxl.so.0.11)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libgcc_s.so.1: version `GCC_12.0.0' not found (required by /lib64/libhwy.so.1)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libgcc_s.so.1: version `GCC_13.0.0' not found (required by /lib64/libhwy.so.1)

Не такая ошибка? Если да, то вы точно все пункты до этого выполнили (точно пакеты все установлены, которые выше в команде установки пакетовв перечислены)?

Если ошибка такая, то чиним:

sudo rm -f /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6
sudo rm -f /opt/1cv8t/x86_64/8.5.1.1150/libgcc_s.so.1

Пробуем запустить ещё раз:

/opt/1cv8t/x86_64/8.5.1.1150/1cv8t

Всё должно работать. Теперь можно запускать платформу посредством ярлыков (кнопок меню приложений)

По прежнему не запускается? Если да, то спешим на встречу новым приключениям!

===Переопределить настройки по умолчанию для ОС Альт===

====Каталог для файловых баз данных платформы 1С и sgid-bit====

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

Например, так:

mkdir ~/bases

При публикации базы данных через веб-сервер необходимо чтобы у процесса веб-сервера, запущенного от пользователя

apache2

был доступ на чтение и запись в каталог с базой данных конфигурации 1С.

Один из вариантов это сделать следующий:

1. Разрешаем членам группы-владельца каталога чтение и запись

sudo chmod g+rwx /home/user/bases -R

2. Устанавливаем sgid бит на каталог

sudo chmod g+s /home/user/bases -R

3. Добавляем пользователя apache2 в группу-владельца каталога

sudo usermod -aG user apache2

==Публикация REST/Odata на веб-сервере==

Предполагается что до этого были выполнены все действия в предыдущем разделе...

===Устанавливаем и включаем веб-сервер apache2===

sudo apt-get install -y apache2
sudo systemctl enable --now httpd2

===Создаём симлинк для httpd2===

Для скриптов платформы 1С это важно...

sudo ln -s /sbin/httpd2 /sbin/httpd

===Публикуем командой===

Сначала создаём файл (оно само не может):

sudo touch /etc/httpd2/conf/sites-enabled/1c_odata.conf

Потом публикуем:

sudo HOME=/home/user /opt/1cv8t/x86_64/8.5.1.1150/webinstt -apache24 -wsdir odata_base -dir /var/www/odata_base -connstr "File=/home/user/bases/base1;" -confPath /etc/httpd2/conf/sites-enabled/1c_odata.conf

В ответ должно прийти что-то типа этого:

Публикация выполнена

или этого:

Публикация обновлена

Примерное содержимое файла в контексте конфигурационных файлов веб-сервера apache2:

cat /etc/httpd2/conf/sites-enabled/1c_odata.conf

<pre>
LoadModule _1cws_module "/opt/1cv8t/x86_64/8.5.1.1150/wsap24t.so"

# 1c publication
Alias "/odata_base" "/var/www/odata_base/"
<Directory "/var/www/odata_base/">
AllowOverride All
Options None
Require all granted
SetHandler 1c-application
ManagedApplicationDescriptor "/var/www/odata_base/default.vrd"
</Directory>
</pre>

===Исправляем группу-владельца на файл ===

По каким-то причинам после выполнения публикации утилитой webinstt файл:

/var/www/odata_base/default.vrd

имеет группу-владельца:

apache

(привет разработчикам платформы 1С, ориентирующимся, поди, на Ubuntu, а не на ОС из реестра минцифры)...

Исправляем:

sudo chgrp apache2 /var/www/odata_base/default.vrd

===Исправляем параметр в конфигурации сервиса===

Исправляем значение параметра:

sudo sed -i 's/ProtectHome=yes/ProtectHome=no/g' /lib/systemd/system/httpd2.service

После этого перезагрузим демона systemd и сервис httpd2

sudo systemctl daemon-reload
sudo systemctl restart httpd2

Перед редактированием конфигурации необходимо передать права на папку публикации самому веб-серверу. По умолчанию она может быть закрыта для него. Если этого не сделать, веб-сервер не сможет прочитать файл настроек default.vrd и вернет ошибку доступа при обращении к базе через браузер.
<pre>
chown -R apache2: /var/www/odata_base
chmod -R 755 /var/www/odata_base
</pre>

Домашние каталоги пользователей (например, /home/user/) по умолчанию полностью изолированы от системных служб. Чтобы веб-сервер apache2 смог добраться до папки с базой данных, ему нужно дать разрешение на «транзитный проход» сквозь вышестоящие директории. Флаг +x для папок как раз открывает эту возможность, не нарушая при этом приватность остальных личных файлов пользователя.
<pre>
sudo chmod a+x /home/user/
sudo chmod a+x /home/user/bases/
</pre>

Перед конфигурацией OData необходимо также предоставить веб-серверу права на чтение и запись внутри папки с самой базой. Чтобы не нарушать логику прав Linux и оставить пользователя владельцем файлов, мы добавляем apache2 в его группу и выставляем права 775 совместно с флагом SGID. Это позволит платформе беспрепятственно создавать файлы блокировок (.1CL), а новые файлы будут автоматически наследоваться группой.
<pre>
sudo chmod -R 2775 /home/user/bases/base1/
</pre>

===Перезапускаем веб-сервер===

sudo systemctl restart httpd2

===Проверяем публикацию===
Идём браузером по адресу:

<pre>
http://localhost/odata_base/
</pre>

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

<pre>
{"#exception":"{http://v8.1c.ru/8.2/virtual-resource-system}Exception","exception":{"clsid":"580392e6-ba49-4280-ac67-fcd6f2180121","reason":404,"descr":"HTTP: Not found\nError executing the query GET to resource /en/scripts/mod_bootstrap_bootstrap.js:","category":"00000000000000000000000000","creationStack":"mngsrvt:0x0000000000252DF5 mngsrvt:0x000000000024F8F4 vrsbaset:0x00000000006D7791 vrsbaset:0x00000000006540C5 vrsbaset:0x00000000006EBDE6 vrsbaset:0x00000000006D2A9C vrsbaset:0x00000000006EC4A9 vrsbaset:0x00000000006ED4A0 core85t:0x00000000008D4EBF core85t:0x00000000006B238C libc.so:0x0000000000000000 libc.so:0x0000000000000000 "}}
</pre>

(ещё один привет разработчикам платформы 1С, по всей видимости, совсем не ориентирующимся на ОС на базе GNU/Linux, раз в учебной версии под GNU/Linux с веб-интерфейсом что-то не так).

НО!

Это не помешает нам работать с OData REST!

===Включение поддержки OData===

Любым текстовым редактором открываем конфигурационный файл публикации:
<pre>
nano /var/www/odata_base/default.vrd
</pre>

Внутри тега <standardOdata> меняем значение параметра enable с false на true:
<pre>
<standardOdata enable="true"
</pre>

Итоговый вид файла default.vrd:
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<point xmlns="http://v8.1c.ru/8.2/virtual-resource-system"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
base="/odata_base"
ib="File=/home/user/bases/base1;">
<ws pointEnableCommon="true"/>
<standardOdata enable="true"
reuseSessions="autouse"
sessionMaxAge="20"
poolSize="10"
poolTimeout="5"/>
<analytics enable="true"
sessionMaxAge="1200"
poolSize="500"
poolTimeout="5"/>
</point>
</pre>

В блоке

<pre>
<standardOdata enable="true"
reuseSessions="autouse"
sessionMaxAge="20"
poolSize="10"
poolTimeout="5"/>
</pre>

увеличьте значение параметра

sessionMaxAge

до

1200

чтобы доступ к REST на учебной версии платформы не блокировался (при нескольких запросах с малым значением параметра sessionMaxAge платформа будет создавать более одной сессии, а учебная версия предусматривает только одну сессию!).

После изменения конфигурации перезапускаем службу веб-сервера для применения настроек:
<pre>
sudo systemctl restart httpd2
</pre>

Для проверки доступности интерфейса OData отправляем GET-запрос по адресу:
<pre>
http://localhost/odata_base/odata/standard.odata?$format=json
</pre>

Пример успешного ответа (корневой контейнер для пустой информационной базы):
<pre>
<service xml:base="http://localhost/odata_base/odata/standard.odata">
<workspace>
<atom:title>Default</atom:title>
</workspace>
</service>
</pre>

===Внесение объектов в OData===
====Шаг 1. Создание внешней обработки====
Запустите Конфигуратор 1С, выберите в главном меню '''Файл''' -> '''Новый...''' и в открывшемся списке выберите '''Внешняя обработка'''.

[[Файл:1c-1.png|thumb|center|900px|Создание новой внешней обработки в Конфигураторе]]

[[Файл:1c-2.png|thumb|center|900px|Выбор типа создаваемого документа]]

====Шаг 2. Настройка свойств и создание формы====
В открывшемся окне свойств новой обработки выполните следующие действия:
# '''Имя''': Задайте понятное имя (например, `НастройкаOData`).
# '''Создание формы''': Перейдите на вкладку '''Формы''' и нажмите на кнопку «Добавить», чтобы создать основную форму обработки. На этой форме мы разместим кнопку и пропишем логику внесения объектов в OData.

[[Файл:1c-3.png|thumb|center|900px|Настройка имени обработки и инициализация создания формы]]

====Шаг 3. Добавление команды и программного кода====
В редакторе формы перейдите на вкладку '''Команды''' (в правой части экрана) и добавьте новую команду формы, задав ей имя (например, `ВыполнитьНастройку`).

Перетащите созданную команду мышкой в левую верхнюю часть окна — в структуру элементов формы, чтобы она превратилась в физическую кнопку.

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

[[Файл:1c-4.png|thumb|center|900px|Проектирование интерфейса формы и привязка клиент-серверного действия к кнопке]]

* '''1''' — Кнопка добавления на вкладке «Команды» в правой панели, с помощью которой создается новая команда формы.
* '''2''' — Элемент формы в левой панели (структура элементов), получившийся в результате перетаскивания команды мышкой из правой части.
* '''3''' — Пункт контекстного меню '''Действие команды''', открывающийся по правому клику мыши на перенесенном элементе для генерации шаблонов процедур.

В модуле формы замените сгенерированные шаблоны процедур следующим кодом:

<pre>
&НаКлиенте
Процедура ВыполнитьНастройку(Команда)
ВыполнитьНастройкуНаСервере();
КонецПроцедуры

&НаСервереБезКонтекста
Процедура ВыполнитьНастройкуНаСервере()
// 1. Создаем массив для объектов, которые пойдут в веб-сервис
МассивОбъектов = Новый Массив;

// 2. Добавляем в массив необходимый справочник (например, Сотрудники)
МассивОбъектов.Добавить(Метаданные.Справочники.Сотрудники);

// 3. Передаем этот массив платформе для регистрации в OData
УстановитьСоставСтандартногоИнтерфейсаOData(МассивОбъектов);
КонецПроцедуры
</pre>

====Шаг 4. Сохранение обработки====
Закройте окна редактора формы и программного модуля. Вернувшись в основное окно создания внешней обработки, нажмите кнопку '''Закрыть'''. Платформа автоматически предложит сохранить изменения — выберите удобный каталог на диске и сохраните файл обработки (с расширением `.epf`).

[[Файл:1c-5.png|thumb|center|900px|Процесс сохранения внешней обработки на диск]]

====Шаг 5. Запуск обработки в режиме предприятия====
Запустите 1С:Предприятие. В главном меню выберите '''Файл''' -> '''Открыть...''', найдите сохраненную ранее внешнюю обработку и откройте её. Если система безопасности выдаст предупреждение о потенциальной опасности подключаемого модуля, согласитесь с рисками и подтвердите открытие.

[[Файл:1c-6.png|thumb|center|900px|Открытие файла внешней обработки через пользовательский интерфейс 1С]]

====Шаг 6. Инициализация OData====
На экране появится созданная нами форма. Нажмите на ней кнопку '''Выполнить настройку'''. В этот момент отработает заложенная нами серверная логика, и состав стандартного интерфейса OData обновится. После этого обработку и само приложение 1С можно закрывать.

[[Файл:1c-7.png|thumb|center|900px|Финальное выполнение логики обработки по нажатию кнопки]]

====Шаг 7. Проверка доступности объектов в OData====
Чтобы убедиться, что внешняя обработка успешно зарегистрировала наши метаданные в веб-сервисе, откройте браузер и повторно отправьте GET-запрос по уже знакомому адресу:

<pre>
http://localhost/odata_base/odata/standard.odata
</pre>

Если всё сделано правильно, в ответе от сервера (в формате JSON или XML, в зависимости от настроек) вместо пустого корневого контейнера вы увидите структуру метаданных, содержащую зарегистрированный нами справочник.

Внутри тега `<workspace>` появится коллекция доступных сущностей (EntitySet), среди которых будет фигурировать URL для работы со справочником сотрудников: `Catalog_Сотрудники`.

==Автоматизация резервного копирования информационных баз==

Предполагается, что платформа "1С Предприятие" работает на GNU/Linux системе и скрипт резервного копирования выполняется от пользователя

administrator

, графическое окружение которого автоматически запускается после загрузки компьютера.

Дело в том, что по каким-то причинам, разработчики платформы "1С Предприятие" не заложили в систему запуск резервного копирования в headless-режиме, поэтому платформе необходим дисплей X-сервера.

Также предполагается, что файл с паролем от пользователя платформы "1С Предприятие", которому разрешено выполнять резервное копирование, хранится в файле

/home/administrator/.1c-cluster-infobases-backup.pass

и рекомендуемые права на этот файл

0400

===Подготовка каталога для скриптов===

mkdir /opt/1c_backup_scripts

===Базовый скрипт===

При необходимости, в тексте скрипта, отредактируйте строчку

bin1c="/opt/1cv8/x86_64/8.3.23.1912/1cv8"

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

Ниже предоставлен текст, который можно выделить, скопировать в текстовый редактор, при необходимости поправить, затем весь этот текст можно бросить в консоль для создания файла посредством heredoc-синтаксиса:
<pre>
cat << 'EOF' > /opt/1c_backup_scripts/backup_infobase_1c_generic.sh
#!/bin/bash
export LANG=ru_RU.UTF-8

NON_ROOT_USER="administrator"
DISPLAY=":0"
STORAGE="${1}"
SRV="${2}"
REF="${3}"
LOGIN="${4}"
PASSWORD_FILE="${5}"
KEEP_BACKUPS_FOR_LAST_DAYS="${6}"
BACKUP_TIMEOUT_SEC="${7}"
TIMEOUT_COUNTER=0
LOCK_FILE_PATH="/home/usr1cv8/.1cv8/1C/1cv8/reg_1541/snccntx8e79a393-c2af-4fd7-b25a-af6b5ed19bfa/snccntx.dat"
#-----------------------------
export DISPLAY="${DISPLAY}"
bin1c="/opt/1cv8/x86_64/8.3.23.1912/1cv8"
PASSWORD=`cat ${PASSWORD_FILE} | head -1`
infobase_suffix="$(date +%Y-%m-%d-%H-%M-%S).dt"
TMP_STORAGE="/opt/1c_backup_scripts/tmp_storage"
ib_tmp_filepath="${TMP_STORAGE}/${REF}__${infobase_suffix}"
ib_tmp_log="${ib_tmp_filepath}.log"
ib_filepath="${STORAGE}/${REF}__${infobase_suffix}"
ib_log="${ib_filepath}.log"

function rotate_backups(){
filenames_cmd="${STORAGE}/${REF}*"
current_unixtime=`date +%s --date="$(date +%Y-%m-%d) 00:00:00"`
test_unixtime=$(($current_unixtime-$KEEP_BACKUPS_FOR_LAST_DAYS*60*60*24))

for f in $(/bin/ls $filenames_cmd); do
#echo "f=$f"
datetime_from_file=`echo ${f} | awk -F '__' {'print $2'} | awk -F '.' {'print $1'}`
#echo "datetime_from_file=${datetime_from_file}"

#2023-12-24-22-01-02
Y=`echo ${datetime_from_file} | awk -F '-' {'print $1'}`
M=`echo ${datetime_from_file} | awk -F '-' {'print $2'}`
D=`echo ${datetime_from_file} | awk -F '-' {'print $3'}`
h=`echo ${datetime_from_file} | awk -F '-' {'print $4'}`
m=`echo ${datetime_from_file} | awk -F '-' {'print $5'}`
s=`echo ${datetime_from_file} | awk -F '-' {'print $6'}`

unixtime_from_file=`date +%s --date="${Y}-${M}-${D} ${h}:${m}:${s}"`

if [[ $unixtime_from_file -lt $test_unixtime ]]; then
echo "delete file: ${f}"
/bin/rm ${f}
else
echo "keep file: ${f}"
fi
done
}

function wait(){

if [[ $TIMEOUT_COUNTER -ge $BACKUP_TIMEOUT_SEC ]]; then
kill -9 ${1}
fi

if [ ! -d /proc/${1}/ ]; then
nice_text="Выгрузка информационной базы успешно завершена"
res_text=$(grep -o -i "${nice_text}" ${ib_tmp_log})

# start apache2
sudo systemctl start httpd2

if [ "${res_text}" = "${nice_text}" ]; then
/bin/cp ${ib_tmp_filepath} ${ib_filepath} && /bin/rm ${ib_tmp_filepath}
/bin/cp ${ib_tmp_log} ${ib_log} && /bin/rm ${ib_tmp_log}
#echo "TEST: ${ib_filepath} AND ${ib_log}"
rotate_backups
exit 0
fi

exit 1
fi
#echo "pid alive: ${1}"
sleep 1
TIMEOUT_COUNTER=$(($TIMEOUT_COUNTER+1))
wait ${1}
}

# prepare tmp storage
[ ! -d ${TMP_STORAGE} ] && sudo mkdir "${TMP_STORAGE}" && sudo chown administrator: "${TMP_STORAGE}" -R

# stop apache2
sudo systemctl stop httpd2
sleep 2

# reset srv1cv8 sessions
sudo systemctl stop srv1cv8
sleep 2
sudo /bin/rm -f "${LOCK_FILE_PATH}"
sudo systemctl start srv1cv8
sleep 2

DISPLAY=:0 XAUTHORITY=/home/administrator/.Xauthority ${bin1c} CONFIG /N "${LOGIN}" /P "${PASSWORD}" /S "${SRV}/${REF}" /DumpIB "${ib_tmp_filepath}" /OUT "${ib_tmp_log}" &
main_process_pid=$!

wait ${main_process_pid}
</pre>

Делаем файл исполняемым

chmod +x /opt/1c_backup_scripts/backup_infobase_1c_generic.sh

===Скрипт для резервирования конкретной базы данных===
Данный скрипт представляет из себя обёртку над выше приведённым скриптом, с заданием конкретных параметров резервирования

<pre>
cat << 'EOF' > /opt/1c_backup_scripts/backup__my_super_infobase.sh
#!/bin/bash

### PARAMETERS ###
STORAGE="/mnt/storage/my-1c-host-backups" # каталог для сохранения резервных копий
SRV="my-1c-host" # хост, на котором работает платформа "1С: Предприятие"
REF="my_super_infobase" # имя базы данных, которую резервируем
LOGIN="backupuser" # 1с-пользователь, которому разрешено резервировать базу данных
PASSWORD_FILE="/home/administrator/.1c-cluster-infobases-backup.pass" # в этом файле должен находиться только пароль от 1с-пользоателя
KEEP_BACKUPS_FOR_LAST_DAYS="2" # сохранить резервные копии только за эти несколько последных дней (в текущем примере - за 2 последних дня)
BACKUP_TIMEOUT_SEC="300" # таймаут, в течение которого разрешено работать процессу резервирования (процессу платформы "1С: Предприятие". Если за этот таймаут процесс не успел сделать резервную копию, то он снимается с выполнения)

# ------------------------------------------------------------------------------------------------

### BOT PARAMETERS
TELEGRAM_BOT_TOKEN="" # сюда нужно вписать токен телеграм-бота, который будет отсылать уведомления
TELEGRAM_DESTINATION_GROUP_ID="" # сюда нужно вписать идентификатор телеграм-пользователя или телеграм-группы (не забывайте про минус в начале, если это идентификатор группы), в которого (или в которую, если это группа) бот будет писать сообщения

function send_message_telegram(){
#exit 0 # раскомментируйте эту строчку, если отсылка сообщений телеграм-ботом не нужна (следовательно, и параметры дя бота при этом можно не задавать)
message=${1}
curl -s -X POST \
-H 'Content-Type: application/json' \
-d "{\"chat_id\": \"${TELEGRAM_DESTINATION_GROUP_ID}\", \"text\": \"${message}\", \"disable_notification\": true}" \
https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage > /dev/null
}
# ------------------------------------------------------------------------------------------------

### START ###
BASE=`dirname ${0}`
${BASE}/backup_infobase_1c_generic.sh "${STORAGE}" "${SRV}" "${REF}" "${LOGIN}" "${PASSWORD_FILE}" "${KEEP_BACKUPS_FOR_LAST_DAYS}" "${BACKUP_TIMEOUT_SEC}"
res=$?

if [ ${res} -eq 0 ]; then
send_message_telegram "[Успешно]\nРезервное копирование информационной базы '${REF}' выполнено успешно"
else
send_message_telegram "[Ошибка]\nРезервное копирование информационной базы '${REF}' не выполнено"
fi
EOF
</pre>

Делаем файл исполняемым

chmod +x /opt/1c_backup_scripts/backup__my_super_infobase.sh

===Ставим задачу для планировщика cron===

Под пользователем

administrator

в терминале открываем временный файл для настройки crontab

EDITOR=nano crontab -e

в результате редактором

nano

будет открыт временный файл для установки параметров планировщика для текущего пользователя. Отредактировав и сохранив (Ctrl+O - Enter) изменения в этом файле и закрыв редактор (Ctrl+X) будет сконфигурирован планировщик для текущего пользователя.

Проверить корректность заданных параметров планировщика можно выполнением команды

crontab -l

В случае, если планировщик был сконфигурирован на запуск скрипта резервного копирования каждые сутки с 23:01, вывод команды проверки должен быть примерно такой:
<pre>
#minute (0-59),
#| hour (0-23),
#| | day of the month (1-31),
#| | | month of the year (1-12),
#| | | | day of the week (0-6 with 0=Sunday).
#| | | | | commands
1 23 * * * /opt/1c_backup_scripts/backup__my_super_infobase.sh
</pre>

1c

2026-06-13T09:14:42Z

Shogun Sun: /* Внесение объектов в OData */

=В GNU/Linux=

==Установка учебной платформы 8.5.x на ОС Альт Стартеркит p11 GNOME==

===Обновить ОС и ядро===

su -
apt-get update -y && apt-get dist-upgrade -y && update-kernel -y

===Поставить пакеты===

su -
apt-get install -f alt-tour evince firefox libwebkit2gtk 1c-preinstall-full libglui

===Включить sudo su===

Раскоментировать в файле:

/etc/sudoers

строчку:

WHEEL_USERS ALL=(ALL:ALL) ALL

или строчку:

WHEEL_USERS ALL=(ALL:ALL) NOPASSWD: ALL

(если необходимо выполнять sudo su без пароля)

===Установить платформу===

Предполагается, что есть файл установки платформы:

setup-training-8.5.1.1150-x86_64.run

Тогда установка осуществляетс следующим образом:

chmod +x setup-training-8.5.1.1150-x86_64.run
sudo ./setup-training-8.5.1.1150-x86_64.run

Далее следуем инструкциям установщика. В установщике необходимо выбрать пункты "Установить ярлыки" и "Зависимости".

Установщик сам переключится в режим текстового интерфейса, если не найдёт дисплей (например, при установке по ssh). А вообще он имеет графический интерфейс...

===Починить запуск платформы (актуально для ОС Альт веток p10 и p11 как минимум)===

Пробуем запустить:

/opt/1cv8t/x86_64/8.5.1.1150/1cv8t

Получилось? Если да, то странно... Должна быть такая ошибка:

/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.30' not found (required by /lib64/libwebkit2gtk-4.0.so.37)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.31' not found (required by /lib64/libwebkit2gtk-4.0.so.37)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.29' not found (required by /lib64/libwebkit2gtk-4.0.so.37)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.31' not found (required by /lib64/libjavascriptcoregtk-4.0.so.18)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.30' not found (required by /lib64/libjavascriptcoregtk-4.0.so.18)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.29' not found (required by /lib64/libjavascriptcoregtk-4.0.so.18)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.30' not found (required by /lib64/libicuuc.so.74)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.29' not found (required by /lib64/libjxl.so.0.11)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libgcc_s.so.1: version `GCC_12.0.0' not found (required by /lib64/libhwy.so.1)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libgcc_s.so.1: version `GCC_13.0.0' not found (required by /lib64/libhwy.so.1)

Не такая ошибка? Если да, то вы точно все пункты до этого выполнили (точно пакеты все установлены, которые выше в команде установки пакетовв перечислены)?

Если ошибка такая, то чиним:

sudo rm -f /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6
sudo rm -f /opt/1cv8t/x86_64/8.5.1.1150/libgcc_s.so.1

Пробуем запустить ещё раз:

/opt/1cv8t/x86_64/8.5.1.1150/1cv8t

Всё должно работать. Теперь можно запускать платформу посредством ярлыков (кнопок меню приложений)

По прежнему не запускается? Если да, то спешим на встречу новым приключениям!

===Переопределить настройки по умолчанию для ОС Альт===

====Каталог для файловых баз данных платформы 1С и sgid-bit====

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

Например, так:

mkdir ~/bases

При публикации базы данных через веб-сервер необходимо чтобы у процесса веб-сервера, запущенного от пользователя

apache2

был доступ на чтение и запись в каталог с базой данных конфигурации 1С.

Один из вариантов это сделать следующий:

1. Разрешаем членам группы-владельца каталога чтение и запись

sudo chmod g+rwx /home/user/bases -R

2. Устанавливаем sgid бит на каталог

sudo chmod g+s /home/user/bases -R

3. Добавляем пользователя apache2 в группу-владельца каталога

sudo usermod -aG user apache2

==Публикация REST/Odata на веб-сервере==

Предполагается что до этого были выполнены все действия в предыдущем разделе...

===Устанавливаем и включаем веб-сервер apache2===

sudo apt-get install -y apache2
sudo systemctl enable --now httpd2

===Создаём симлинк для httpd2===

Для скриптов платформы 1С это важно...

sudo ln -s /sbin/httpd2 /sbin/httpd

===Публикуем командой===

Сначала создаём файл (оно само не может):

sudo touch /etc/httpd2/conf/sites-enabled/1c_odata.conf

Потом публикуем:

sudo HOME=/home/user /opt/1cv8t/x86_64/8.5.1.1150/webinstt -apache24 -wsdir odata_base -dir /var/www/odata_base -connstr "File=/home/user/bases/base1;" -confPath /etc/httpd2/conf/sites-enabled/1c_odata.conf

В ответ должно прийти что-то типа этого:

Публикация выполнена

или этого:

Публикация обновлена

Примерное содержимое файла в контексте конфигурационных файлов веб-сервера apache2:

cat /etc/httpd2/conf/sites-enabled/1c_odata.conf

<pre>
LoadModule _1cws_module "/opt/1cv8t/x86_64/8.5.1.1150/wsap24t.so"

# 1c publication
Alias "/odata_base" "/var/www/odata_base/"
<Directory "/var/www/odata_base/">
AllowOverride All
Options None
Require all granted
SetHandler 1c-application
ManagedApplicationDescriptor "/var/www/odata_base/default.vrd"
</Directory>
</pre>

===Исправляем группу-владельца на файл ===

По каким-то причинам после выполнения публикации утилитой webinstt файл:

/var/www/odata_base/default.vrd

имеет группу-владельца:

apache

(привет разработчикам платформы 1С, ориентирующимся, поди, на Ubuntu, а не на ОС из реестра минцифры)...

Исправляем:

sudo chgrp apache2 /var/www/odata_base/default.vrd

===Исправляем параметр в конфигурации сервиса===

Исправляем значение параметра:

sudo sed -i 's/ProtectHome=yes/ProtectHome=no/g' /lib/systemd/system/httpd2.service

После этого перезагрузим демона systemd и сервис httpd2

sudo systemctl daemon-reload
sudo systemctl restart httpd2

Перед редактированием конфигурации необходимо передать права на папку публикации самому веб-серверу. По умолчанию она может быть закрыта для него. Если этого не сделать, веб-сервер не сможет прочитать файл настроек default.vrd и вернет ошибку доступа при обращении к базе через браузер.
<pre>
chown -R apache2: /var/www/odata_base
chmod -R 755 /var/www/odata_base
</pre>

Домашние каталоги пользователей (например, /home/user/) по умолчанию полностью изолированы от системных служб. Чтобы веб-сервер apache2 смог добраться до папки с базой данных, ему нужно дать разрешение на «транзитный проход» сквозь вышестоящие директории. Флаг +x для папок как раз открывает эту возможность, не нарушая при этом приватность остальных личных файлов пользователя.
<pre>
sudo chmod a+x /home/user/
sudo chmod a+x /home/user/bases/
</pre>

Перед конфигурацией OData необходимо также предоставить веб-серверу права на чтение и запись внутри папки с самой базой. Чтобы не нарушать логику прав Linux и оставить пользователя владельцем файлов, мы добавляем apache2 в его группу и выставляем права 775 совместно с флагом SGID. Это позволит платформе беспрепятственно создавать файлы блокировок (.1CL), а новые файлы будут автоматически наследоваться группой.
<pre>
sudo chmod -R 2775 /home/user/bases/base1/
</pre>

===Перезапускаем веб-сервер===

sudo systemctl restart httpd2

===Проверяем публикацию===
Идём браузером по адресу:

<pre>
http://localhost/odata_base/
</pre>

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

<pre>
{"#exception":"{http://v8.1c.ru/8.2/virtual-resource-system}Exception","exception":{"clsid":"580392e6-ba49-4280-ac67-fcd6f2180121","reason":404,"descr":"HTTP: Not found\nError executing the query GET to resource /en/scripts/mod_bootstrap_bootstrap.js:","category":"00000000000000000000000000","creationStack":"mngsrvt:0x0000000000252DF5 mngsrvt:0x000000000024F8F4 vrsbaset:0x00000000006D7791 vrsbaset:0x00000000006540C5 vrsbaset:0x00000000006EBDE6 vrsbaset:0x00000000006D2A9C vrsbaset:0x00000000006EC4A9 vrsbaset:0x00000000006ED4A0 core85t:0x00000000008D4EBF core85t:0x00000000006B238C libc.so:0x0000000000000000 libc.so:0x0000000000000000 "}}
</pre>

(ещё один привет разработчикам платформы 1С, по всей видимости, совсем не ориентирующимся на ОС на базе GNU/Linux, раз в учебной версии под GNU/Linux с веб-интерфейсом что-то не так).

НО!

Это не помешает нам работать с OData REST!

===Включение поддержки OData===

Любым текстовым редактором открываем конфигурационный файл публикации:
<pre>
nano /var/www/odata_base/default.vrd
</pre>

Внутри тега <standardOdata> меняем значение параметра enable с false на true:
<pre>
<standardOdata enable="true"
</pre>

Итоговый вид файла default.vrd:
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<point xmlns="http://v8.1c.ru/8.2/virtual-resource-system"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
base="/odata_base"
ib="File=/home/user/bases/base1;">
<ws pointEnableCommon="true"/>
<standardOdata enable="true"
reuseSessions="autouse"
sessionMaxAge="20"
poolSize="10"
poolTimeout="5"/>
<analytics enable="true"
sessionMaxAge="1200"
poolSize="500"
poolTimeout="5"/>
</point>
</pre>

В блоке

<pre>
<standardOdata enable="true"
reuseSessions="autouse"
sessionMaxAge="20"
poolSize="10"
poolTimeout="5"/>
</pre>

увеличьте значение параметра

sessionMaxAge

до

1200

чтобы доступ к REST на учебной версии платформы не блокировался (при нескольких запросах с малым значением параметра sessionMaxAge платформа будет создавать более одной сессии, а учебная версия предусматривает только одну сессию!).

После изменения конфигурации перезапускаем службу веб-сервера для применения настроек:
<pre>
sudo systemctl restart httpd2
</pre>

Для проверки доступности интерфейса OData отправляем GET-запрос по адресу:
<pre>
http://localhost/odata_base/odata/standard.odata?$format=json
</pre>

Пример успешного ответа (корневой контейнер для пустой информационной базы):
<pre>
<service xml:base="http://localhost/odata_base/odata/standard.odata">
<workspace>
<atom:title>Default</atom:title>
</workspace>
</service>
</pre>

===Внесение объектов в OData===
====Шаг 1. Создание внешней обработки====
Запустите Конфигуратор 1С, выберите в главном меню '''Файл''' -> '''Новый...''' и в открывшемся списке выберите '''Внешняя обработка'''.

[[Файл:1c-1.png|thumb|center|900px|Создание новой внешней обработки в Конфигураторе]]

[[Файл:1c-2.png|thumb|center|900px|Выбор типа создаваемого документа]]

====Шаг 2. Настройка свойств и создание формы====
В открывшемся окне свойств новой обработки выполните следующие действия:
# '''Имя''': Задайте понятное имя (например, `НастройкаOData`).
# '''Создание формы''': Перейдите на вкладку '''Формы''' и нажмите на кнопку «Добавить», чтобы создать основную форму обработки. На этой форме мы разместим кнопку и пропишем логику внесения объектов в OData.

[[Файл:1c-3.png|thumb|center|900px|Настройка имени обработки и инициализация создания формы]]

====Шаг 3. Добавление команды и программного кода====
В редакторе формы перейдите на вкладку '''Команды''' (в правой части экрана) и добавьте новую команду формы, задав ей имя (например, `ВыполнитьНастройку`).

Перетащите созданную команду мышкой в левую верхнюю часть окна — в структуру элементов формы, чтобы она превратилась в физическую кнопку.

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

[[Файл:1c-4.png|thumb|center|900px|Проектирование интерфейса формы и привязка клиент-серверного действия к кнопке]]

В модуле формы замените сгенерированные шаблоны процедур следующим кодом:

<pre>
&НаКлиенте
Процедура ВыполнитьНастройку(Команда)
ВыполнитьНастройкуНаСервере();
КонецПроцедуры

&НаСервереБезКонтекста
Процедура ВыполнитьНастройкуНаСервере()
// 1. Создаем массив для объектов, которые пойдут в веб-сервис
МассивОбъектов = Новый Массив;

// 2. Добавляем в массив необходимый справочник (например, Сотрудники)
МассивОбъектов.Добавить(Метаданные.Справочники.Сотрудники);

// 3. Передаем этот массив платформе для регистрации в OData
УстановитьСоставСтандартногоИнтерфейсаOData(МассивОбъектов);
КонецПроцедуры
</pre>

====Шаг 4. Сохранение обработки====
Закройте окна редактора формы и программного модуля. Вернувшись в основное окно создания внешней обработки, нажмите кнопку '''Закрыть'''. Платформа автоматически предложит сохранить изменения — выберите удобный каталог на диске и сохраните файл обработки (с расширением `.epf`).

[[Файл:1c-5.png|thumb|center|900px|Процесс сохранения внешней обработки на диск]]

====Шаг 5. Запуск обработки в режиме предприятия====
Запустите 1С:Предприятие. В главном меню выберите '''Файл''' -> '''Открыть...''', найдите сохраненную ранее внешнюю обработку и откройте её. Если система безопасности выдаст предупреждение о потенциальной опасности подключаемого модуля, согласитесь с рисками и подтвердите открытие.

[[Файл:1c-6.png|thumb|center|900px|Открытие файла внешней обработки через пользовательский интерфейс 1С]]

====Шаг 6. Инициализация OData====
На экране появится созданная нами форма. Нажмите на ней кнопку '''Выполнить настройку'''. В этот момент отработает заложенная нами серверная логика, и состав стандартного интерфейса OData обновится. После этого обработку и само приложение 1С можно закрывать.

[[Файл:1c-7.png|thumb|center|900px|Финальное выполнение логики обработки по нажатию кнопки]]

====Шаг 7. Проверка доступности объектов в OData====
Чтобы убедиться, что внешняя обработка успешно зарегистрировала наши метаданные в веб-сервисе, откройте браузер и повторно отправьте GET-запрос по уже знакомому адресу:

<pre>
http://localhost/odata_base/odata/standard.odata
</pre>

Если всё сделано правильно, в ответе от сервера (в формате JSON или XML, в зависимости от настроек) вместо пустого корневого контейнера вы увидите структуру метаданных, содержащую зарегистрированный нами справочник.

Внутри тега `<workspace>` появится коллекция доступных сущностей (EntitySet), среди которых будет фигурировать URL для работы со справочником сотрудников: `Catalog_Сотрудники`.

==Автоматизация резервного копирования информационных баз==

Предполагается, что платформа "1С Предприятие" работает на GNU/Linux системе и скрипт резервного копирования выполняется от пользователя

administrator

, графическое окружение которого автоматически запускается после загрузки компьютера.

Дело в том, что по каким-то причинам, разработчики платформы "1С Предприятие" не заложили в систему запуск резервного копирования в headless-режиме, поэтому платформе необходим дисплей X-сервера.

Также предполагается, что файл с паролем от пользователя платформы "1С Предприятие", которому разрешено выполнять резервное копирование, хранится в файле

/home/administrator/.1c-cluster-infobases-backup.pass

и рекомендуемые права на этот файл

0400

===Подготовка каталога для скриптов===

mkdir /opt/1c_backup_scripts

===Базовый скрипт===

При необходимости, в тексте скрипта, отредактируйте строчку

bin1c="/opt/1cv8/x86_64/8.3.23.1912/1cv8"

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

Ниже предоставлен текст, который можно выделить, скопировать в текстовый редактор, при необходимости поправить, затем весь этот текст можно бросить в консоль для создания файла посредством heredoc-синтаксиса:
<pre>
cat << 'EOF' > /opt/1c_backup_scripts/backup_infobase_1c_generic.sh
#!/bin/bash
export LANG=ru_RU.UTF-8

NON_ROOT_USER="administrator"
DISPLAY=":0"
STORAGE="${1}"
SRV="${2}"
REF="${3}"
LOGIN="${4}"
PASSWORD_FILE="${5}"
KEEP_BACKUPS_FOR_LAST_DAYS="${6}"
BACKUP_TIMEOUT_SEC="${7}"
TIMEOUT_COUNTER=0
LOCK_FILE_PATH="/home/usr1cv8/.1cv8/1C/1cv8/reg_1541/snccntx8e79a393-c2af-4fd7-b25a-af6b5ed19bfa/snccntx.dat"
#-----------------------------
export DISPLAY="${DISPLAY}"
bin1c="/opt/1cv8/x86_64/8.3.23.1912/1cv8"
PASSWORD=`cat ${PASSWORD_FILE} | head -1`
infobase_suffix="$(date +%Y-%m-%d-%H-%M-%S).dt"
TMP_STORAGE="/opt/1c_backup_scripts/tmp_storage"
ib_tmp_filepath="${TMP_STORAGE}/${REF}__${infobase_suffix}"
ib_tmp_log="${ib_tmp_filepath}.log"
ib_filepath="${STORAGE}/${REF}__${infobase_suffix}"
ib_log="${ib_filepath}.log"

function rotate_backups(){
filenames_cmd="${STORAGE}/${REF}*"
current_unixtime=`date +%s --date="$(date +%Y-%m-%d) 00:00:00"`
test_unixtime=$(($current_unixtime-$KEEP_BACKUPS_FOR_LAST_DAYS*60*60*24))

for f in $(/bin/ls $filenames_cmd); do
#echo "f=$f"
datetime_from_file=`echo ${f} | awk -F '__' {'print $2'} | awk -F '.' {'print $1'}`
#echo "datetime_from_file=${datetime_from_file}"

#2023-12-24-22-01-02
Y=`echo ${datetime_from_file} | awk -F '-' {'print $1'}`
M=`echo ${datetime_from_file} | awk -F '-' {'print $2'}`
D=`echo ${datetime_from_file} | awk -F '-' {'print $3'}`
h=`echo ${datetime_from_file} | awk -F '-' {'print $4'}`
m=`echo ${datetime_from_file} | awk -F '-' {'print $5'}`
s=`echo ${datetime_from_file} | awk -F '-' {'print $6'}`

unixtime_from_file=`date +%s --date="${Y}-${M}-${D} ${h}:${m}:${s}"`

if [[ $unixtime_from_file -lt $test_unixtime ]]; then
echo "delete file: ${f}"
/bin/rm ${f}
else
echo "keep file: ${f}"
fi
done
}

function wait(){

if [[ $TIMEOUT_COUNTER -ge $BACKUP_TIMEOUT_SEC ]]; then
kill -9 ${1}
fi

if [ ! -d /proc/${1}/ ]; then
nice_text="Выгрузка информационной базы успешно завершена"
res_text=$(grep -o -i "${nice_text}" ${ib_tmp_log})

# start apache2
sudo systemctl start httpd2

if [ "${res_text}" = "${nice_text}" ]; then
/bin/cp ${ib_tmp_filepath} ${ib_filepath} && /bin/rm ${ib_tmp_filepath}
/bin/cp ${ib_tmp_log} ${ib_log} && /bin/rm ${ib_tmp_log}
#echo "TEST: ${ib_filepath} AND ${ib_log}"
rotate_backups
exit 0
fi

exit 1
fi
#echo "pid alive: ${1}"
sleep 1
TIMEOUT_COUNTER=$(($TIMEOUT_COUNTER+1))
wait ${1}
}

# prepare tmp storage
[ ! -d ${TMP_STORAGE} ] && sudo mkdir "${TMP_STORAGE}" && sudo chown administrator: "${TMP_STORAGE}" -R

# stop apache2
sudo systemctl stop httpd2
sleep 2

# reset srv1cv8 sessions
sudo systemctl stop srv1cv8
sleep 2
sudo /bin/rm -f "${LOCK_FILE_PATH}"
sudo systemctl start srv1cv8
sleep 2

DISPLAY=:0 XAUTHORITY=/home/administrator/.Xauthority ${bin1c} CONFIG /N "${LOGIN}" /P "${PASSWORD}" /S "${SRV}/${REF}" /DumpIB "${ib_tmp_filepath}" /OUT "${ib_tmp_log}" &
main_process_pid=$!

wait ${main_process_pid}
</pre>

Делаем файл исполняемым

chmod +x /opt/1c_backup_scripts/backup_infobase_1c_generic.sh

===Скрипт для резервирования конкретной базы данных===
Данный скрипт представляет из себя обёртку над выше приведённым скриптом, с заданием конкретных параметров резервирования

<pre>
cat << 'EOF' > /opt/1c_backup_scripts/backup__my_super_infobase.sh
#!/bin/bash

### PARAMETERS ###
STORAGE="/mnt/storage/my-1c-host-backups" # каталог для сохранения резервных копий
SRV="my-1c-host" # хост, на котором работает платформа "1С: Предприятие"
REF="my_super_infobase" # имя базы данных, которую резервируем
LOGIN="backupuser" # 1с-пользователь, которому разрешено резервировать базу данных
PASSWORD_FILE="/home/administrator/.1c-cluster-infobases-backup.pass" # в этом файле должен находиться только пароль от 1с-пользоателя
KEEP_BACKUPS_FOR_LAST_DAYS="2" # сохранить резервные копии только за эти несколько последных дней (в текущем примере - за 2 последних дня)
BACKUP_TIMEOUT_SEC="300" # таймаут, в течение которого разрешено работать процессу резервирования (процессу платформы "1С: Предприятие". Если за этот таймаут процесс не успел сделать резервную копию, то он снимается с выполнения)

# ------------------------------------------------------------------------------------------------

### BOT PARAMETERS
TELEGRAM_BOT_TOKEN="" # сюда нужно вписать токен телеграм-бота, который будет отсылать уведомления
TELEGRAM_DESTINATION_GROUP_ID="" # сюда нужно вписать идентификатор телеграм-пользователя или телеграм-группы (не забывайте про минус в начале, если это идентификатор группы), в которого (или в которую, если это группа) бот будет писать сообщения

function send_message_telegram(){
#exit 0 # раскомментируйте эту строчку, если отсылка сообщений телеграм-ботом не нужна (следовательно, и параметры дя бота при этом можно не задавать)
message=${1}
curl -s -X POST \
-H 'Content-Type: application/json' \
-d "{\"chat_id\": \"${TELEGRAM_DESTINATION_GROUP_ID}\", \"text\": \"${message}\", \"disable_notification\": true}" \
https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage > /dev/null
}
# ------------------------------------------------------------------------------------------------

### START ###
BASE=`dirname ${0}`
${BASE}/backup_infobase_1c_generic.sh "${STORAGE}" "${SRV}" "${REF}" "${LOGIN}" "${PASSWORD_FILE}" "${KEEP_BACKUPS_FOR_LAST_DAYS}" "${BACKUP_TIMEOUT_SEC}"
res=$?

if [ ${res} -eq 0 ]; then
send_message_telegram "[Успешно]\nРезервное копирование информационной базы '${REF}' выполнено успешно"
else
send_message_telegram "[Ошибка]\nРезервное копирование информационной базы '${REF}' не выполнено"
fi
EOF
</pre>

Делаем файл исполняемым

chmod +x /opt/1c_backup_scripts/backup__my_super_infobase.sh

===Ставим задачу для планировщика cron===

Под пользователем

administrator

в терминале открываем временный файл для настройки crontab

EDITOR=nano crontab -e

в результате редактором

nano

будет открыт временный файл для установки параметров планировщика для текущего пользователя. Отредактировав и сохранив (Ctrl+O - Enter) изменения в этом файле и закрыв редактор (Ctrl+X) будет сконфигурирован планировщик для текущего пользователя.

Проверить корректность заданных параметров планировщика можно выполнением команды

crontab -l

В случае, если планировщик был сконфигурирован на запуск скрипта резервного копирования каждые сутки с 23:01, вывод команды проверки должен быть примерно такой:
<pre>
#minute (0-59),
#| hour (0-23),
#| | day of the month (1-31),
#| | | month of the year (1-12),
#| | | | day of the week (0-6 with 0=Sunday).
#| | | | | commands
1 23 * * * /opt/1c_backup_scripts/backup__my_super_infobase.sh
</pre>

1c

2026-06-13T09:13:34Z

Shogun Sun: /* Внесение объектов в OData */

=В GNU/Linux=

==Установка учебной платформы 8.5.x на ОС Альт Стартеркит p11 GNOME==

===Обновить ОС и ядро===

su -
apt-get update -y && apt-get dist-upgrade -y && update-kernel -y

===Поставить пакеты===

su -
apt-get install -f alt-tour evince firefox libwebkit2gtk 1c-preinstall-full libglui

===Включить sudo su===

Раскоментировать в файле:

/etc/sudoers

строчку:

WHEEL_USERS ALL=(ALL:ALL) ALL

или строчку:

WHEEL_USERS ALL=(ALL:ALL) NOPASSWD: ALL

(если необходимо выполнять sudo su без пароля)

===Установить платформу===

Предполагается, что есть файл установки платформы:

setup-training-8.5.1.1150-x86_64.run

Тогда установка осуществляетс следующим образом:

chmod +x setup-training-8.5.1.1150-x86_64.run
sudo ./setup-training-8.5.1.1150-x86_64.run

Далее следуем инструкциям установщика. В установщике необходимо выбрать пункты "Установить ярлыки" и "Зависимости".

Установщик сам переключится в режим текстового интерфейса, если не найдёт дисплей (например, при установке по ssh). А вообще он имеет графический интерфейс...

===Починить запуск платформы (актуально для ОС Альт веток p10 и p11 как минимум)===

Пробуем запустить:

/opt/1cv8t/x86_64/8.5.1.1150/1cv8t

Получилось? Если да, то странно... Должна быть такая ошибка:

/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.30' not found (required by /lib64/libwebkit2gtk-4.0.so.37)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.31' not found (required by /lib64/libwebkit2gtk-4.0.so.37)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.29' not found (required by /lib64/libwebkit2gtk-4.0.so.37)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.31' not found (required by /lib64/libjavascriptcoregtk-4.0.so.18)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.30' not found (required by /lib64/libjavascriptcoregtk-4.0.so.18)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.29' not found (required by /lib64/libjavascriptcoregtk-4.0.so.18)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.30' not found (required by /lib64/libicuuc.so.74)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.29' not found (required by /lib64/libjxl.so.0.11)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libgcc_s.so.1: version `GCC_12.0.0' not found (required by /lib64/libhwy.so.1)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libgcc_s.so.1: version `GCC_13.0.0' not found (required by /lib64/libhwy.so.1)

Не такая ошибка? Если да, то вы точно все пункты до этого выполнили (точно пакеты все установлены, которые выше в команде установки пакетовв перечислены)?

Если ошибка такая, то чиним:

sudo rm -f /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6
sudo rm -f /opt/1cv8t/x86_64/8.5.1.1150/libgcc_s.so.1

Пробуем запустить ещё раз:

/opt/1cv8t/x86_64/8.5.1.1150/1cv8t

Всё должно работать. Теперь можно запускать платформу посредством ярлыков (кнопок меню приложений)

По прежнему не запускается? Если да, то спешим на встречу новым приключениям!

===Переопределить настройки по умолчанию для ОС Альт===

====Каталог для файловых баз данных платформы 1С и sgid-bit====

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

Например, так:

mkdir ~/bases

При публикации базы данных через веб-сервер необходимо чтобы у процесса веб-сервера, запущенного от пользователя

apache2

был доступ на чтение и запись в каталог с базой данных конфигурации 1С.

Один из вариантов это сделать следующий:

1. Разрешаем членам группы-владельца каталога чтение и запись

sudo chmod g+rwx /home/user/bases -R

2. Устанавливаем sgid бит на каталог

sudo chmod g+s /home/user/bases -R

3. Добавляем пользователя apache2 в группу-владельца каталога

sudo usermod -aG user apache2

==Публикация REST/Odata на веб-сервере==

Предполагается что до этого были выполнены все действия в предыдущем разделе...

===Устанавливаем и включаем веб-сервер apache2===

sudo apt-get install -y apache2
sudo systemctl enable --now httpd2

===Создаём симлинк для httpd2===

Для скриптов платформы 1С это важно...

sudo ln -s /sbin/httpd2 /sbin/httpd

===Публикуем командой===

Сначала создаём файл (оно само не может):

sudo touch /etc/httpd2/conf/sites-enabled/1c_odata.conf

Потом публикуем:

sudo HOME=/home/user /opt/1cv8t/x86_64/8.5.1.1150/webinstt -apache24 -wsdir odata_base -dir /var/www/odata_base -connstr "File=/home/user/bases/base1;" -confPath /etc/httpd2/conf/sites-enabled/1c_odata.conf

В ответ должно прийти что-то типа этого:

Публикация выполнена

или этого:

Публикация обновлена

Примерное содержимое файла в контексте конфигурационных файлов веб-сервера apache2:

cat /etc/httpd2/conf/sites-enabled/1c_odata.conf

<pre>
LoadModule _1cws_module "/opt/1cv8t/x86_64/8.5.1.1150/wsap24t.so"

# 1c publication
Alias "/odata_base" "/var/www/odata_base/"
<Directory "/var/www/odata_base/">
AllowOverride All
Options None
Require all granted
SetHandler 1c-application
ManagedApplicationDescriptor "/var/www/odata_base/default.vrd"
</Directory>
</pre>

===Исправляем группу-владельца на файл ===

По каким-то причинам после выполнения публикации утилитой webinstt файл:

/var/www/odata_base/default.vrd

имеет группу-владельца:

apache

(привет разработчикам платформы 1С, ориентирующимся, поди, на Ubuntu, а не на ОС из реестра минцифры)...

Исправляем:

sudo chgrp apache2 /var/www/odata_base/default.vrd

===Исправляем параметр в конфигурации сервиса===

Исправляем значение параметра:

sudo sed -i 's/ProtectHome=yes/ProtectHome=no/g' /lib/systemd/system/httpd2.service

После этого перезагрузим демона systemd и сервис httpd2

sudo systemctl daemon-reload
sudo systemctl restart httpd2

Перед редактированием конфигурации необходимо передать права на папку публикации самому веб-серверу. По умолчанию она может быть закрыта для него. Если этого не сделать, веб-сервер не сможет прочитать файл настроек default.vrd и вернет ошибку доступа при обращении к базе через браузер.
<pre>
chown -R apache2: /var/www/odata_base
chmod -R 755 /var/www/odata_base
</pre>

Домашние каталоги пользователей (например, /home/user/) по умолчанию полностью изолированы от системных служб. Чтобы веб-сервер apache2 смог добраться до папки с базой данных, ему нужно дать разрешение на «транзитный проход» сквозь вышестоящие директории. Флаг +x для папок как раз открывает эту возможность, не нарушая при этом приватность остальных личных файлов пользователя.
<pre>
sudo chmod a+x /home/user/
sudo chmod a+x /home/user/bases/
</pre>

Перед конфигурацией OData необходимо также предоставить веб-серверу права на чтение и запись внутри папки с самой базой. Чтобы не нарушать логику прав Linux и оставить пользователя владельцем файлов, мы добавляем apache2 в его группу и выставляем права 775 совместно с флагом SGID. Это позволит платформе беспрепятственно создавать файлы блокировок (.1CL), а новые файлы будут автоматически наследоваться группой.
<pre>
sudo chmod -R 2775 /home/user/bases/base1/
</pre>

===Перезапускаем веб-сервер===

sudo systemctl restart httpd2

===Проверяем публикацию===
Идём браузером по адресу:

<pre>
http://localhost/odata_base/
</pre>

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

<pre>
{"#exception":"{http://v8.1c.ru/8.2/virtual-resource-system}Exception","exception":{"clsid":"580392e6-ba49-4280-ac67-fcd6f2180121","reason":404,"descr":"HTTP: Not found\nError executing the query GET to resource /en/scripts/mod_bootstrap_bootstrap.js:","category":"00000000000000000000000000","creationStack":"mngsrvt:0x0000000000252DF5 mngsrvt:0x000000000024F8F4 vrsbaset:0x00000000006D7791 vrsbaset:0x00000000006540C5 vrsbaset:0x00000000006EBDE6 vrsbaset:0x00000000006D2A9C vrsbaset:0x00000000006EC4A9 vrsbaset:0x00000000006ED4A0 core85t:0x00000000008D4EBF core85t:0x00000000006B238C libc.so:0x0000000000000000 libc.so:0x0000000000000000 "}}
</pre>

(ещё один привет разработчикам платформы 1С, по всей видимости, совсем не ориентирующимся на ОС на базе GNU/Linux, раз в учебной версии под GNU/Linux с веб-интерфейсом что-то не так).

НО!

Это не помешает нам работать с OData REST!

===Включение поддержки OData===

Любым текстовым редактором открываем конфигурационный файл публикации:
<pre>
nano /var/www/odata_base/default.vrd
</pre>

Внутри тега <standardOdata> меняем значение параметра enable с false на true:
<pre>
<standardOdata enable="true"
</pre>

Итоговый вид файла default.vrd:
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<point xmlns="http://v8.1c.ru/8.2/virtual-resource-system"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
base="/odata_base"
ib="File=/home/user/bases/base1;">
<ws pointEnableCommon="true"/>
<standardOdata enable="true"
reuseSessions="autouse"
sessionMaxAge="20"
poolSize="10"
poolTimeout="5"/>
<analytics enable="true"
sessionMaxAge="1200"
poolSize="500"
poolTimeout="5"/>
</point>
</pre>

В блоке

<pre>
<standardOdata enable="true"
reuseSessions="autouse"
sessionMaxAge="20"
poolSize="10"
poolTimeout="5"/>
</pre>

увеличьте значение параметра

sessionMaxAge

до

1200

чтобы доступ к REST на учебной версии платформы не блокировался (при нескольких запросах с малым значением параметра sessionMaxAge платформа будет создавать более одной сессии, а учебная версия предусматривает только одну сессию!).

После изменения конфигурации перезапускаем службу веб-сервера для применения настроек:
<pre>
sudo systemctl restart httpd2
</pre>

Для проверки доступности интерфейса OData отправляем GET-запрос по адресу:
<pre>
http://localhost/odata_base/odata/standard.odata?$format=json
</pre>

Пример успешного ответа (корневой контейнер для пустой информационной базы):
<pre>
<service xml:base="http://localhost/odata_base/odata/standard.odata">
<workspace>
<atom:title>Default</atom:title>
</workspace>
</service>
</pre>

===Внесение объектов в OData===

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

====Шаг 1. Создание внешней обработки====
Запустите Конфигуратор 1С, выберите в главном меню '''Файл''' -> '''Новый...''' и в открывшемся списке выберите '''Внешняя обработка'''.

[[Файл:1c-1.png|thumb|center|900px|Создание новой внешней обработки в Конфигураторе]]

[[Файл:1c-2.png|thumb|center|900px|Выбор типа создаваемого документа]]

====Шаг 2. Настройка свойств и создание формы====
В открывшемся окне свойств новой обработки выполните следующие действия:
# '''Имя''': Задайте понятное имя (например, `НастройкаOData`).
# '''Создание формы''': Перейдите на вкладку '''Формы''' и нажмите на кнопку «Добавить», чтобы создать основную форму обработки. На этой форме мы разместим кнопку и пропишем логику внесения объектов в OData.

[[Файл:1c-3.png|thumb|center|900px|Настройка имени обработки и инициализация создания формы]]

====Шаг 3. Добавление команды и программного кода====
В редакторе формы перейдите на вкладку '''Команды''' (в правой части экрана) и добавьте новую команду формы, задав ей имя (например, `ВыполнитьНастройку`).

Перетащите созданную команду мышкой в левую верхнюю часть окна — в структуру элементов формы, чтобы она превратилась в физическую кнопку.

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

[[Файл:1c-4.png|thumb|center|900px|Проектирование интерфейса формы и привязка клиент-серверного действия к кнопке]]

В модуле формы замените сгенерированные шаблоны процедур следующим кодом:

<pre>
&НаКлиенте
Процедура ВыполнитьНастройку(Команда)
ВыполнитьНастройкуНаСервере();
КонецПроцедуры

&НаСервереБезКонтекста
Процедура ВыполнитьНастройкуНаСервере()
// 1. Создаем массив для объектов, которые пойдут в веб-сервис
МассивОбъектов = Новый Массив;

// 2. Добавляем в массив необходимый справочник (например, Сотрудники)
МассивОбъектов.Добавить(Метаданные.Справочники.Сотрудники);

// 3. Передаем этот массив платформе для регистрации в OData
УстановитьСоставСтандартногоИнтерфейсаOData(МассивОбъектов);
КонецПроцедуры
</pre>

====Шаг 4. Сохранение обработки====
Закройте окна редактора формы и программного модуля. Вернувшись в основное окно создания внешней обработки, нажмите кнопку '''Закрыть'''. Платформа автоматически предложит сохранить изменения — выберите удобный каталог на диске и сохраните файл обработки (с расширением `.epf`).

[[Файл:1c-5.png|thumb|center|900px|Процесс сохранения внешней обработки на диск]]

====Шаг 5. Запуск обработки в режиме предприятия====
Запустите 1С:Предприятие. В главном меню выберите '''Файл''' -> '''Открыть...''', найдите сохраненную ранее внешнюю обработку и откройте её. Если система безопасности выдаст предупреждение о потенциальной опасности подключаемого модуля, согласитесь с рисками и подтвердите открытие.

[[Файл:1c-6.png|thumb|center|900px|Открытие файла внешней обработки через пользовательский интерфейс 1С]]

====Шаг 6. Инициализация OData====
На экране появится созданная нами форма. Нажмите на ней кнопку '''Выполнить настройку'''. В этот момент отработает заложенная нами серверная логика, и состав стандартного интерфейса OData обновится. После этого обработку и само приложение 1С можно закрывать.

[[Файл:1c-7.png|thumb|center|900px|Финальное выполнение логики обработки по нажатию кнопки]]

====Шаг 7. Проверка доступности объектов в OData====
Чтобы убедиться, что внешняя обработка успешно зарегистрировала наши метаданные в веб-сервисе, откройте браузер и повторно отправьте GET-запрос по уже знакомому адресу:

<pre>
http://localhost/odata_base/odata/standard.odata
</pre>

Если всё сделано правильно, в ответе от сервера (в формате JSON или XML, в зависимости от настроек) вместо пустого корневого контейнера вы увидите структуру метаданных, содержащую зарегистрированный нами справочник.

Внутри тега `<workspace>` появится коллекция доступных сущностей (EntitySet), среди которых будет фигурировать URL для работы со справочником сотрудников: `Catalog_Сотрудники`.

==Автоматизация резервного копирования информационных баз==

Предполагается, что платформа "1С Предприятие" работает на GNU/Linux системе и скрипт резервного копирования выполняется от пользователя

administrator

, графическое окружение которого автоматически запускается после загрузки компьютера.

Дело в том, что по каким-то причинам, разработчики платформы "1С Предприятие" не заложили в систему запуск резервного копирования в headless-режиме, поэтому платформе необходим дисплей X-сервера.

Также предполагается, что файл с паролем от пользователя платформы "1С Предприятие", которому разрешено выполнять резервное копирование, хранится в файле

/home/administrator/.1c-cluster-infobases-backup.pass

и рекомендуемые права на этот файл

0400

===Подготовка каталога для скриптов===

mkdir /opt/1c_backup_scripts

===Базовый скрипт===

При необходимости, в тексте скрипта, отредактируйте строчку

bin1c="/opt/1cv8/x86_64/8.3.23.1912/1cv8"

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

Ниже предоставлен текст, который можно выделить, скопировать в текстовый редактор, при необходимости поправить, затем весь этот текст можно бросить в консоль для создания файла посредством heredoc-синтаксиса:
<pre>
cat << 'EOF' > /opt/1c_backup_scripts/backup_infobase_1c_generic.sh
#!/bin/bash
export LANG=ru_RU.UTF-8

NON_ROOT_USER="administrator"
DISPLAY=":0"
STORAGE="${1}"
SRV="${2}"
REF="${3}"
LOGIN="${4}"
PASSWORD_FILE="${5}"
KEEP_BACKUPS_FOR_LAST_DAYS="${6}"
BACKUP_TIMEOUT_SEC="${7}"
TIMEOUT_COUNTER=0
LOCK_FILE_PATH="/home/usr1cv8/.1cv8/1C/1cv8/reg_1541/snccntx8e79a393-c2af-4fd7-b25a-af6b5ed19bfa/snccntx.dat"
#-----------------------------
export DISPLAY="${DISPLAY}"
bin1c="/opt/1cv8/x86_64/8.3.23.1912/1cv8"
PASSWORD=`cat ${PASSWORD_FILE} | head -1`
infobase_suffix="$(date +%Y-%m-%d-%H-%M-%S).dt"
TMP_STORAGE="/opt/1c_backup_scripts/tmp_storage"
ib_tmp_filepath="${TMP_STORAGE}/${REF}__${infobase_suffix}"
ib_tmp_log="${ib_tmp_filepath}.log"
ib_filepath="${STORAGE}/${REF}__${infobase_suffix}"
ib_log="${ib_filepath}.log"

function rotate_backups(){
filenames_cmd="${STORAGE}/${REF}*"
current_unixtime=`date +%s --date="$(date +%Y-%m-%d) 00:00:00"`
test_unixtime=$(($current_unixtime-$KEEP_BACKUPS_FOR_LAST_DAYS*60*60*24))

for f in $(/bin/ls $filenames_cmd); do
#echo "f=$f"
datetime_from_file=`echo ${f} | awk -F '__' {'print $2'} | awk -F '.' {'print $1'}`
#echo "datetime_from_file=${datetime_from_file}"

#2023-12-24-22-01-02
Y=`echo ${datetime_from_file} | awk -F '-' {'print $1'}`
M=`echo ${datetime_from_file} | awk -F '-' {'print $2'}`
D=`echo ${datetime_from_file} | awk -F '-' {'print $3'}`
h=`echo ${datetime_from_file} | awk -F '-' {'print $4'}`
m=`echo ${datetime_from_file} | awk -F '-' {'print $5'}`
s=`echo ${datetime_from_file} | awk -F '-' {'print $6'}`

unixtime_from_file=`date +%s --date="${Y}-${M}-${D} ${h}:${m}:${s}"`

if [[ $unixtime_from_file -lt $test_unixtime ]]; then
echo "delete file: ${f}"
/bin/rm ${f}
else
echo "keep file: ${f}"
fi
done
}

function wait(){

if [[ $TIMEOUT_COUNTER -ge $BACKUP_TIMEOUT_SEC ]]; then
kill -9 ${1}
fi

if [ ! -d /proc/${1}/ ]; then
nice_text="Выгрузка информационной базы успешно завершена"
res_text=$(grep -o -i "${nice_text}" ${ib_tmp_log})

# start apache2
sudo systemctl start httpd2

if [ "${res_text}" = "${nice_text}" ]; then
/bin/cp ${ib_tmp_filepath} ${ib_filepath} && /bin/rm ${ib_tmp_filepath}
/bin/cp ${ib_tmp_log} ${ib_log} && /bin/rm ${ib_tmp_log}
#echo "TEST: ${ib_filepath} AND ${ib_log}"
rotate_backups
exit 0
fi

exit 1
fi
#echo "pid alive: ${1}"
sleep 1
TIMEOUT_COUNTER=$(($TIMEOUT_COUNTER+1))
wait ${1}
}

# prepare tmp storage
[ ! -d ${TMP_STORAGE} ] && sudo mkdir "${TMP_STORAGE}" && sudo chown administrator: "${TMP_STORAGE}" -R

# stop apache2
sudo systemctl stop httpd2
sleep 2

# reset srv1cv8 sessions
sudo systemctl stop srv1cv8
sleep 2
sudo /bin/rm -f "${LOCK_FILE_PATH}"
sudo systemctl start srv1cv8
sleep 2

DISPLAY=:0 XAUTHORITY=/home/administrator/.Xauthority ${bin1c} CONFIG /N "${LOGIN}" /P "${PASSWORD}" /S "${SRV}/${REF}" /DumpIB "${ib_tmp_filepath}" /OUT "${ib_tmp_log}" &
main_process_pid=$!

wait ${main_process_pid}
</pre>

Делаем файл исполняемым

chmod +x /opt/1c_backup_scripts/backup_infobase_1c_generic.sh

===Скрипт для резервирования конкретной базы данных===
Данный скрипт представляет из себя обёртку над выше приведённым скриптом, с заданием конкретных параметров резервирования

<pre>
cat << 'EOF' > /opt/1c_backup_scripts/backup__my_super_infobase.sh
#!/bin/bash

### PARAMETERS ###
STORAGE="/mnt/storage/my-1c-host-backups" # каталог для сохранения резервных копий
SRV="my-1c-host" # хост, на котором работает платформа "1С: Предприятие"
REF="my_super_infobase" # имя базы данных, которую резервируем
LOGIN="backupuser" # 1с-пользователь, которому разрешено резервировать базу данных
PASSWORD_FILE="/home/administrator/.1c-cluster-infobases-backup.pass" # в этом файле должен находиться только пароль от 1с-пользоателя
KEEP_BACKUPS_FOR_LAST_DAYS="2" # сохранить резервные копии только за эти несколько последных дней (в текущем примере - за 2 последних дня)
BACKUP_TIMEOUT_SEC="300" # таймаут, в течение которого разрешено работать процессу резервирования (процессу платформы "1С: Предприятие". Если за этот таймаут процесс не успел сделать резервную копию, то он снимается с выполнения)

# ------------------------------------------------------------------------------------------------

### BOT PARAMETERS
TELEGRAM_BOT_TOKEN="" # сюда нужно вписать токен телеграм-бота, который будет отсылать уведомления
TELEGRAM_DESTINATION_GROUP_ID="" # сюда нужно вписать идентификатор телеграм-пользователя или телеграм-группы (не забывайте про минус в начале, если это идентификатор группы), в которого (или в которую, если это группа) бот будет писать сообщения

function send_message_telegram(){
#exit 0 # раскомментируйте эту строчку, если отсылка сообщений телеграм-ботом не нужна (следовательно, и параметры дя бота при этом можно не задавать)
message=${1}
curl -s -X POST \
-H 'Content-Type: application/json' \
-d "{\"chat_id\": \"${TELEGRAM_DESTINATION_GROUP_ID}\", \"text\": \"${message}\", \"disable_notification\": true}" \
https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage > /dev/null
}
# ------------------------------------------------------------------------------------------------

### START ###
BASE=`dirname ${0}`
${BASE}/backup_infobase_1c_generic.sh "${STORAGE}" "${SRV}" "${REF}" "${LOGIN}" "${PASSWORD_FILE}" "${KEEP_BACKUPS_FOR_LAST_DAYS}" "${BACKUP_TIMEOUT_SEC}"
res=$?

if [ ${res} -eq 0 ]; then
send_message_telegram "[Успешно]\nРезервное копирование информационной базы '${REF}' выполнено успешно"
else
send_message_telegram "[Ошибка]\nРезервное копирование информационной базы '${REF}' не выполнено"
fi
EOF
</pre>

Делаем файл исполняемым

chmod +x /opt/1c_backup_scripts/backup__my_super_infobase.sh

===Ставим задачу для планировщика cron===

Под пользователем

administrator

в терминале открываем временный файл для настройки crontab

EDITOR=nano crontab -e

в результате редактором

nano

будет открыт временный файл для установки параметров планировщика для текущего пользователя. Отредактировав и сохранив (Ctrl+O - Enter) изменения в этом файле и закрыв редактор (Ctrl+X) будет сконфигурирован планировщик для текущего пользователя.

Проверить корректность заданных параметров планировщика можно выполнением команды

crontab -l

В случае, если планировщик был сконфигурирован на запуск скрипта резервного копирования каждые сутки с 23:01, вывод команды проверки должен быть примерно такой:
<pre>
#minute (0-59),
#| hour (0-23),
#| | day of the month (1-31),
#| | | month of the year (1-12),
#| | | | day of the week (0-6 with 0=Sunday).
#| | | | | commands
1 23 * * * /opt/1c_backup_scripts/backup__my_super_infobase.sh
</pre>

1c

2026-06-13T09:09:55Z

Shogun Sun:

=В GNU/Linux=

==Установка учебной платформы 8.5.x на ОС Альт Стартеркит p11 GNOME==

===Обновить ОС и ядро===

su -
apt-get update -y && apt-get dist-upgrade -y && update-kernel -y

===Поставить пакеты===

su -
apt-get install -f alt-tour evince firefox libwebkit2gtk 1c-preinstall-full libglui

===Включить sudo su===

Раскоментировать в файле:

/etc/sudoers

строчку:

WHEEL_USERS ALL=(ALL:ALL) ALL

или строчку:

WHEEL_USERS ALL=(ALL:ALL) NOPASSWD: ALL

(если необходимо выполнять sudo su без пароля)

===Установить платформу===

Предполагается, что есть файл установки платформы:

setup-training-8.5.1.1150-x86_64.run

Тогда установка осуществляетс следующим образом:

chmod +x setup-training-8.5.1.1150-x86_64.run
sudo ./setup-training-8.5.1.1150-x86_64.run

Далее следуем инструкциям установщика. В установщике необходимо выбрать пункты "Установить ярлыки" и "Зависимости".

Установщик сам переключится в режим текстового интерфейса, если не найдёт дисплей (например, при установке по ssh). А вообще он имеет графический интерфейс...

===Починить запуск платформы (актуально для ОС Альт веток p10 и p11 как минимум)===

Пробуем запустить:

/opt/1cv8t/x86_64/8.5.1.1150/1cv8t

Получилось? Если да, то странно... Должна быть такая ошибка:

/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.30' not found (required by /lib64/libwebkit2gtk-4.0.so.37)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.31' not found (required by /lib64/libwebkit2gtk-4.0.so.37)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.29' not found (required by /lib64/libwebkit2gtk-4.0.so.37)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.31' not found (required by /lib64/libjavascriptcoregtk-4.0.so.18)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.30' not found (required by /lib64/libjavascriptcoregtk-4.0.so.18)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.29' not found (required by /lib64/libjavascriptcoregtk-4.0.so.18)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.30' not found (required by /lib64/libicuuc.so.74)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.29' not found (required by /lib64/libjxl.so.0.11)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libgcc_s.so.1: version `GCC_12.0.0' not found (required by /lib64/libhwy.so.1)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libgcc_s.so.1: version `GCC_13.0.0' not found (required by /lib64/libhwy.so.1)

Не такая ошибка? Если да, то вы точно все пункты до этого выполнили (точно пакеты все установлены, которые выше в команде установки пакетовв перечислены)?

Если ошибка такая, то чиним:

sudo rm -f /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6
sudo rm -f /opt/1cv8t/x86_64/8.5.1.1150/libgcc_s.so.1

Пробуем запустить ещё раз:

/opt/1cv8t/x86_64/8.5.1.1150/1cv8t

Всё должно работать. Теперь можно запускать платформу посредством ярлыков (кнопок меню приложений)

По прежнему не запускается? Если да, то спешим на встречу новым приключениям!

===Переопределить настройки по умолчанию для ОС Альт===

====Каталог для файловых баз данных платформы 1С и sgid-bit====

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

Например, так:

mkdir ~/bases

При публикации базы данных через веб-сервер необходимо чтобы у процесса веб-сервера, запущенного от пользователя

apache2

был доступ на чтение и запись в каталог с базой данных конфигурации 1С.

Один из вариантов это сделать следующий:

1. Разрешаем членам группы-владельца каталога чтение и запись

sudo chmod g+rwx /home/user/bases -R

2. Устанавливаем sgid бит на каталог

sudo chmod g+s /home/user/bases -R

3. Добавляем пользователя apache2 в группу-владельца каталога

sudo usermod -aG user apache2

==Публикация REST/Odata на веб-сервере==

Предполагается что до этого были выполнены все действия в предыдущем разделе...

===Устанавливаем и включаем веб-сервер apache2===

sudo apt-get install -y apache2
sudo systemctl enable --now httpd2

===Создаём симлинк для httpd2===

Для скриптов платформы 1С это важно...

sudo ln -s /sbin/httpd2 /sbin/httpd

===Публикуем командой===

Сначала создаём файл (оно само не может):

sudo touch /etc/httpd2/conf/sites-enabled/1c_odata.conf

Потом публикуем:

sudo HOME=/home/user /opt/1cv8t/x86_64/8.5.1.1150/webinstt -apache24 -wsdir odata_base -dir /var/www/odata_base -connstr "File=/home/user/bases/base1;" -confPath /etc/httpd2/conf/sites-enabled/1c_odata.conf

В ответ должно прийти что-то типа этого:

Публикация выполнена

или этого:

Публикация обновлена

Примерное содержимое файла в контексте конфигурационных файлов веб-сервера apache2:

cat /etc/httpd2/conf/sites-enabled/1c_odata.conf

<pre>
LoadModule _1cws_module "/opt/1cv8t/x86_64/8.5.1.1150/wsap24t.so"

# 1c publication
Alias "/odata_base" "/var/www/odata_base/"
<Directory "/var/www/odata_base/">
AllowOverride All
Options None
Require all granted
SetHandler 1c-application
ManagedApplicationDescriptor "/var/www/odata_base/default.vrd"
</Directory>
</pre>

===Исправляем группу-владельца на файл ===

По каким-то причинам после выполнения публикации утилитой webinstt файл:

/var/www/odata_base/default.vrd

имеет группу-владельца:

apache

(привет разработчикам платформы 1С, ориентирующимся, поди, на Ubuntu, а не на ОС из реестра минцифры)...

Исправляем:

sudo chgrp apache2 /var/www/odata_base/default.vrd

===Исправляем параметр в конфигурации сервиса===

Исправляем значение параметра:

sudo sed -i 's/ProtectHome=yes/ProtectHome=no/g' /lib/systemd/system/httpd2.service

После этого перезагрузим демона systemd и сервис httpd2

sudo systemctl daemon-reload
sudo systemctl restart httpd2

Перед редактированием конфигурации необходимо передать права на папку публикации самому веб-серверу. По умолчанию она может быть закрыта для него. Если этого не сделать, веб-сервер не сможет прочитать файл настроек default.vrd и вернет ошибку доступа при обращении к базе через браузер.
<pre>
chown -R apache2: /var/www/odata_base
chmod -R 755 /var/www/odata_base
</pre>

Домашние каталоги пользователей (например, /home/user/) по умолчанию полностью изолированы от системных служб. Чтобы веб-сервер apache2 смог добраться до папки с базой данных, ему нужно дать разрешение на «транзитный проход» сквозь вышестоящие директории. Флаг +x для папок как раз открывает эту возможность, не нарушая при этом приватность остальных личных файлов пользователя.
<pre>
sudo chmod a+x /home/user/
sudo chmod a+x /home/user/bases/
</pre>

Перед конфигурацией OData необходимо также предоставить веб-серверу права на чтение и запись внутри папки с самой базой. Чтобы не нарушать логику прав Linux и оставить пользователя владельцем файлов, мы добавляем apache2 в его группу и выставляем права 775 совместно с флагом SGID. Это позволит платформе беспрепятственно создавать файлы блокировок (.1CL), а новые файлы будут автоматически наследоваться группой.
<pre>
sudo chmod -R 2775 /home/user/bases/base1/
</pre>

===Перезапускаем веб-сервер===

sudo systemctl restart httpd2

===Проверяем публикацию===
Идём браузером по адресу:

<pre>
http://localhost/odata_base/
</pre>

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

<pre>
{"#exception":"{http://v8.1c.ru/8.2/virtual-resource-system}Exception","exception":{"clsid":"580392e6-ba49-4280-ac67-fcd6f2180121","reason":404,"descr":"HTTP: Not found\nError executing the query GET to resource /en/scripts/mod_bootstrap_bootstrap.js:","category":"00000000000000000000000000","creationStack":"mngsrvt:0x0000000000252DF5 mngsrvt:0x000000000024F8F4 vrsbaset:0x00000000006D7791 vrsbaset:0x00000000006540C5 vrsbaset:0x00000000006EBDE6 vrsbaset:0x00000000006D2A9C vrsbaset:0x00000000006EC4A9 vrsbaset:0x00000000006ED4A0 core85t:0x00000000008D4EBF core85t:0x00000000006B238C libc.so:0x0000000000000000 libc.so:0x0000000000000000 "}}
</pre>

(ещё один привет разработчикам платформы 1С, по всей видимости, совсем не ориентирующимся на ОС на базе GNU/Linux, раз в учебной версии под GNU/Linux с веб-интерфейсом что-то не так).

НО!

Это не помешает нам работать с OData REST!

===Включение поддержки OData===

Любым текстовым редактором открываем конфигурационный файл публикации:
<pre>
nano /var/www/odata_base/default.vrd
</pre>

Внутри тега <standardOdata> меняем значение параметра enable с false на true:
<pre>
<standardOdata enable="true"
</pre>

Итоговый вид файла default.vrd:
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<point xmlns="http://v8.1c.ru/8.2/virtual-resource-system"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
base="/odata_base"
ib="File=/home/user/bases/base1;">
<ws pointEnableCommon="true"/>
<standardOdata enable="true"
reuseSessions="autouse"
sessionMaxAge="20"
poolSize="10"
poolTimeout="5"/>
<analytics enable="true"
sessionMaxAge="1200"
poolSize="500"
poolTimeout="5"/>
</point>
</pre>

В блоке

<pre>
<standardOdata enable="true"
reuseSessions="autouse"
sessionMaxAge="20"
poolSize="10"
poolTimeout="5"/>
</pre>

увеличьте значение параметра

sessionMaxAge

до

1200

чтобы доступ к REST на учебной версии платформы не блокировался (при нескольких запросах с малым значением параметра sessionMaxAge платформа будет создавать более одной сессии, а учебная версия предусматривает только одну сессию!).

После изменения конфигурации перезапускаем службу веб-сервера для применения настроек:
<pre>
sudo systemctl restart httpd2
</pre>

Для проверки доступности интерфейса OData отправляем GET-запрос по адресу:
<pre>
http://localhost/odata_base/odata/standard.odata?$format=json
</pre>

Пример успешного ответа (корневой контейнер для пустой информационной базы):
<pre>
<service xml:base="http://localhost/odata_base/odata/standard.odata">
<workspace>
<atom:title>Default</atom:title>
</workspace>
</service>
</pre>

===Внесение объектов в OData===

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

====Шаг 1. Создание внешней обработки====
Запустите Конфигуратор 1С, выберите в главном меню '''Файл''' -> '''Новый...''' и в открывшемся списке выберите '''Внешняя обработка'''.

[[Файл:1c-1.png|thumb|center|900px|Создание новой внешней обработки в Конфигураторе]]

[[Файл:1c-2.png|thumb|center|900px|Выбор типа создаваемого документа]]

====Шаг 2. Настройка свойств и создание формы====
В открывшемся окне свойств новой обработки выполните следующие действия:
# '''Имя''': Задайте понятное имя (например, `НастройкаOData`).
# '''Создание формы''': Перейдите на вкладку '''Формы''' и нажмите на кнопку «Добавить», чтобы создать основную форму обработки. На этой форме мы разместим кнопку и пропишем логику внесения объектов в OData.

[[Файл:1c-3.png|thumb|center|900px|Настройка имени обработки и инициализация создания формы]]

====Шаг 3. Добавление команды и программного кода====
В редакторе формы перейдите на вкладку '''Команды''' (в правой части экрана) и добавьте новую команду формы, задав ей имя (например, `ВыполнитьНастройку`).

Перетащите созданную команду мышкой в левую верхнюю часть окна — в структуру элементов формы, чтобы она превратилась в физическую кнопку.

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

[[Файл:1c-4.png|thumb|center|900px|Проектирование интерфейса формы и привязка клиент-серверного действия к кнопке]]

В модуле формы замените сгенерированные шаблоны процедур следующим кодом:

<pre>
&НаКлиенте
Процедура ВыполнитьНастройку(Команда)
ВыполнитьНастройкуНаСервере();
КонецПроцедуры

&НаСервереБезКонтекста
Процедура ВыполнитьНастройкуНаСервере()
// 1. Создаем массив для объектов, которые пойдут в веб-сервис
МассивОбъектов = Новый Массив;

// 2. Добавляем в массив необходимый справочник (например, Сотрудники)
МассивОбъектов.Добавить(Метаданные.Справочники.Сотрудники);

// 3. Передаем этот массив платформе для регистрации в OData
УстановитьСоставСтандартногоИнтерфейсаOData(МассивОбъектов);
КонецПроцедуры
</pre>

====Шаг 4. Сохранение обработки====
Закройте окна редактора формы и программного модуля. Вернувшись в основное окно создания внешней обработки, нажмите кнопку '''Закрыть'''. Платформа автоматически предложит сохранить изменения — выберите удобный каталог на диске и сохраните файл обработки (с расширением `.epf`).

[[Файл:1c-5.png|thumb|center|900px|Процесс сохранения внешней обработки на диск]]

====Шаг 5. Запуск обработки в режиме предприятия====
Запустите 1С:Предприятие. В главном меню выберите '''Файл''' -> '''Открыть...''', найдите сохраненную ранее внешнюю обработку и откройте её. Если система безопасности выдаст предупреждение о потенциальной опасности подключаемого модуля, согласитесь с рисками и подтвердите открытие.

[[Файл:1c-6.png|thumb|center|900px|Открытие файла внешней обработки через пользовательский интерфейс 1С]]

====Шаг 6. Инициализация OData====
На экране появится созданная нами форма. Нажмите на ней кнопку '''Выполнить настройку'''. В этот момент отработает заложенная нами серверная логика, и состав стандартного интерфейса OData обновится. После этого обработку и само приложение 1С можно закрывать.

[[Файл:1c-7.png|thumb|center|900px|Финальное выполнение логики обработки по нажатию кнопки]]

==Автоматизация резервного копирования информационных баз==

Предполагается, что платформа "1С Предприятие" работает на GNU/Linux системе и скрипт резервного копирования выполняется от пользователя

administrator

, графическое окружение которого автоматически запускается после загрузки компьютера.

Дело в том, что по каким-то причинам, разработчики платформы "1С Предприятие" не заложили в систему запуск резервного копирования в headless-режиме, поэтому платформе необходим дисплей X-сервера.

Также предполагается, что файл с паролем от пользователя платформы "1С Предприятие", которому разрешено выполнять резервное копирование, хранится в файле

/home/administrator/.1c-cluster-infobases-backup.pass

и рекомендуемые права на этот файл

0400

===Подготовка каталога для скриптов===

mkdir /opt/1c_backup_scripts

===Базовый скрипт===

При необходимости, в тексте скрипта, отредактируйте строчку

bin1c="/opt/1cv8/x86_64/8.3.23.1912/1cv8"

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

Ниже предоставлен текст, который можно выделить, скопировать в текстовый редактор, при необходимости поправить, затем весь этот текст можно бросить в консоль для создания файла посредством heredoc-синтаксиса:
<pre>
cat << 'EOF' > /opt/1c_backup_scripts/backup_infobase_1c_generic.sh
#!/bin/bash
export LANG=ru_RU.UTF-8

NON_ROOT_USER="administrator"
DISPLAY=":0"
STORAGE="${1}"
SRV="${2}"
REF="${3}"
LOGIN="${4}"
PASSWORD_FILE="${5}"
KEEP_BACKUPS_FOR_LAST_DAYS="${6}"
BACKUP_TIMEOUT_SEC="${7}"
TIMEOUT_COUNTER=0
LOCK_FILE_PATH="/home/usr1cv8/.1cv8/1C/1cv8/reg_1541/snccntx8e79a393-c2af-4fd7-b25a-af6b5ed19bfa/snccntx.dat"
#-----------------------------
export DISPLAY="${DISPLAY}"
bin1c="/opt/1cv8/x86_64/8.3.23.1912/1cv8"
PASSWORD=`cat ${PASSWORD_FILE} | head -1`
infobase_suffix="$(date +%Y-%m-%d-%H-%M-%S).dt"
TMP_STORAGE="/opt/1c_backup_scripts/tmp_storage"
ib_tmp_filepath="${TMP_STORAGE}/${REF}__${infobase_suffix}"
ib_tmp_log="${ib_tmp_filepath}.log"
ib_filepath="${STORAGE}/${REF}__${infobase_suffix}"
ib_log="${ib_filepath}.log"

function rotate_backups(){
filenames_cmd="${STORAGE}/${REF}*"
current_unixtime=`date +%s --date="$(date +%Y-%m-%d) 00:00:00"`
test_unixtime=$(($current_unixtime-$KEEP_BACKUPS_FOR_LAST_DAYS*60*60*24))

for f in $(/bin/ls $filenames_cmd); do
#echo "f=$f"
datetime_from_file=`echo ${f} | awk -F '__' {'print $2'} | awk -F '.' {'print $1'}`
#echo "datetime_from_file=${datetime_from_file}"

#2023-12-24-22-01-02
Y=`echo ${datetime_from_file} | awk -F '-' {'print $1'}`
M=`echo ${datetime_from_file} | awk -F '-' {'print $2'}`
D=`echo ${datetime_from_file} | awk -F '-' {'print $3'}`
h=`echo ${datetime_from_file} | awk -F '-' {'print $4'}`
m=`echo ${datetime_from_file} | awk -F '-' {'print $5'}`
s=`echo ${datetime_from_file} | awk -F '-' {'print $6'}`

unixtime_from_file=`date +%s --date="${Y}-${M}-${D} ${h}:${m}:${s}"`

if [[ $unixtime_from_file -lt $test_unixtime ]]; then
echo "delete file: ${f}"
/bin/rm ${f}
else
echo "keep file: ${f}"
fi
done
}

function wait(){

if [[ $TIMEOUT_COUNTER -ge $BACKUP_TIMEOUT_SEC ]]; then
kill -9 ${1}
fi

if [ ! -d /proc/${1}/ ]; then
nice_text="Выгрузка информационной базы успешно завершена"
res_text=$(grep -o -i "${nice_text}" ${ib_tmp_log})

# start apache2
sudo systemctl start httpd2

if [ "${res_text}" = "${nice_text}" ]; then
/bin/cp ${ib_tmp_filepath} ${ib_filepath} && /bin/rm ${ib_tmp_filepath}
/bin/cp ${ib_tmp_log} ${ib_log} && /bin/rm ${ib_tmp_log}
#echo "TEST: ${ib_filepath} AND ${ib_log}"
rotate_backups
exit 0
fi

exit 1
fi
#echo "pid alive: ${1}"
sleep 1
TIMEOUT_COUNTER=$(($TIMEOUT_COUNTER+1))
wait ${1}
}

# prepare tmp storage
[ ! -d ${TMP_STORAGE} ] && sudo mkdir "${TMP_STORAGE}" && sudo chown administrator: "${TMP_STORAGE}" -R

# stop apache2
sudo systemctl stop httpd2
sleep 2

# reset srv1cv8 sessions
sudo systemctl stop srv1cv8
sleep 2
sudo /bin/rm -f "${LOCK_FILE_PATH}"
sudo systemctl start srv1cv8
sleep 2

DISPLAY=:0 XAUTHORITY=/home/administrator/.Xauthority ${bin1c} CONFIG /N "${LOGIN}" /P "${PASSWORD}" /S "${SRV}/${REF}" /DumpIB "${ib_tmp_filepath}" /OUT "${ib_tmp_log}" &
main_process_pid=$!

wait ${main_process_pid}
</pre>

Делаем файл исполняемым

chmod +x /opt/1c_backup_scripts/backup_infobase_1c_generic.sh

===Скрипт для резервирования конкретной базы данных===
Данный скрипт представляет из себя обёртку над выше приведённым скриптом, с заданием конкретных параметров резервирования

<pre>
cat << 'EOF' > /opt/1c_backup_scripts/backup__my_super_infobase.sh
#!/bin/bash

### PARAMETERS ###
STORAGE="/mnt/storage/my-1c-host-backups" # каталог для сохранения резервных копий
SRV="my-1c-host" # хост, на котором работает платформа "1С: Предприятие"
REF="my_super_infobase" # имя базы данных, которую резервируем
LOGIN="backupuser" # 1с-пользователь, которому разрешено резервировать базу данных
PASSWORD_FILE="/home/administrator/.1c-cluster-infobases-backup.pass" # в этом файле должен находиться только пароль от 1с-пользоателя
KEEP_BACKUPS_FOR_LAST_DAYS="2" # сохранить резервные копии только за эти несколько последных дней (в текущем примере - за 2 последних дня)
BACKUP_TIMEOUT_SEC="300" # таймаут, в течение которого разрешено работать процессу резервирования (процессу платформы "1С: Предприятие". Если за этот таймаут процесс не успел сделать резервную копию, то он снимается с выполнения)

# ------------------------------------------------------------------------------------------------

### BOT PARAMETERS
TELEGRAM_BOT_TOKEN="" # сюда нужно вписать токен телеграм-бота, который будет отсылать уведомления
TELEGRAM_DESTINATION_GROUP_ID="" # сюда нужно вписать идентификатор телеграм-пользователя или телеграм-группы (не забывайте про минус в начале, если это идентификатор группы), в которого (или в которую, если это группа) бот будет писать сообщения

function send_message_telegram(){
#exit 0 # раскомментируйте эту строчку, если отсылка сообщений телеграм-ботом не нужна (следовательно, и параметры дя бота при этом можно не задавать)
message=${1}
curl -s -X POST \
-H 'Content-Type: application/json' \
-d "{\"chat_id\": \"${TELEGRAM_DESTINATION_GROUP_ID}\", \"text\": \"${message}\", \"disable_notification\": true}" \
https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage > /dev/null
}
# ------------------------------------------------------------------------------------------------

### START ###
BASE=`dirname ${0}`
${BASE}/backup_infobase_1c_generic.sh "${STORAGE}" "${SRV}" "${REF}" "${LOGIN}" "${PASSWORD_FILE}" "${KEEP_BACKUPS_FOR_LAST_DAYS}" "${BACKUP_TIMEOUT_SEC}"
res=$?

if [ ${res} -eq 0 ]; then
send_message_telegram "[Успешно]\nРезервное копирование информационной базы '${REF}' выполнено успешно"
else
send_message_telegram "[Ошибка]\nРезервное копирование информационной базы '${REF}' не выполнено"
fi
EOF
</pre>

Делаем файл исполняемым

chmod +x /opt/1c_backup_scripts/backup__my_super_infobase.sh

===Ставим задачу для планировщика cron===

Под пользователем

administrator

в терминале открываем временный файл для настройки crontab

EDITOR=nano crontab -e

в результате редактором

nano

будет открыт временный файл для установки параметров планировщика для текущего пользователя. Отредактировав и сохранив (Ctrl+O - Enter) изменения в этом файле и закрыв редактор (Ctrl+X) будет сконфигурирован планировщик для текущего пользователя.

Проверить корректность заданных параметров планировщика можно выполнением команды

crontab -l

В случае, если планировщик был сконфигурирован на запуск скрипта резервного копирования каждые сутки с 23:01, вывод команды проверки должен быть примерно такой:
<pre>
#minute (0-59),
#| hour (0-23),
#| | day of the month (1-31),
#| | | month of the year (1-12),
#| | | | day of the week (0-6 with 0=Sunday).
#| | | | | commands
1 23 * * * /opt/1c_backup_scripts/backup__my_super_infobase.sh
</pre>

Файл:1c-7.png

2026-06-13T08:52:41Z

Shogun Sun:

Файл:1c-6.png

2026-06-13T08:52:28Z

Shogun Sun:

Файл:1c-5.png

2026-06-13T08:52:08Z

Shogun Sun:

Файл:1c-4.png

2026-06-13T08:51:50Z

Shogun Sun:

Файл:1c-3.png

2026-06-13T08:51:26Z

Shogun Sun:

Файл:1c-2.png

2026-06-13T08:50:11Z

Shogun Sun:

Файл:1c-1.png

2026-06-13T08:46:05Z

Shogun Sun:

1c

2026-06-13T06:15:46Z

Shogun Sun: /* Исправляем параметр в конфигурации сервиса */

=В GNU/Linux=

==Установка учебной платформы 8.5.x на ОС Альт Стартеркит p11 GNOME==

===Обновить ОС и ядро===

su -
apt-get update -y && apt-get dist-upgrade -y && update-kernel -y

===Поставить пакеты===

su -
apt-get install -f alt-tour firefox libwebkit2gtk 1c-preinstall-full libglui

===Включить sudo su===

Раскоментировать в файле:

/etc/sudoers

строчку:

WHEEL_USERS ALL=(ALL:ALL) ALL

или строчку:

WHEEL_USERS ALL=(ALL:ALL) NOPASSWD: ALL

(если необходимо выполнять sudo su без пароля)

===Установить платформу===

Предполагается, что есть файл установки платформы:

setup-training-8.5.1.1150-x86_64.run

Тогда установка осуществляетс следующим образом:

chmod +x setup-training-8.5.1.1150-x86_64.run
sudo ./setup-training-8.5.1.1150-x86_64.run

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

Установщик сам переключится в режим текстового интерфейса, если не найдёт дисплей (например, при установке по ssh). А вообще он имеет графический интерфейс...

===Починить запуск платформы (актуально для ОС Альт веток p10 и p11 как минимум)===

Пробуем запустить:

/opt/1cv8t/x86_64/8.5.1.1150/1cv8t

Получилось? Если да, то странно... Должна быть такая ошибка:

/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.30' not found (required by /lib64/libwebkit2gtk-4.0.so.37)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.31' not found (required by /lib64/libwebkit2gtk-4.0.so.37)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.29' not found (required by /lib64/libwebkit2gtk-4.0.so.37)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.31' not found (required by /lib64/libjavascriptcoregtk-4.0.so.18)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.30' not found (required by /lib64/libjavascriptcoregtk-4.0.so.18)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.29' not found (required by /lib64/libjavascriptcoregtk-4.0.so.18)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.30' not found (required by /lib64/libicuuc.so.74)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6: version `GLIBCXX_3.4.29' not found (required by /lib64/libjxl.so.0.11)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libgcc_s.so.1: version `GCC_12.0.0' not found (required by /lib64/libhwy.so.1)
/opt/1cv8t/x86_64/8.5.1.1150/1cv8t: /opt/1cv8t/x86_64/8.5.1.1150/libgcc_s.so.1: version `GCC_13.0.0' not found (required by /lib64/libhwy.so.1)

Не такая ошибка? Если да, то вы точно все пункты до этого выполнили (точно пакеты все установлены, которые выше в команде установки пакетовв перечислены)?

Если ошибка такая, то чиним:

sudo rm -f /opt/1cv8t/x86_64/8.5.1.1150/libstdc++.so.6
sudo rm -f /opt/1cv8t/x86_64/8.5.1.1150/libgcc_s.so.1

Пробуем запустить ещё раз:

/opt/1cv8t/x86_64/8.5.1.1150/1cv8t

Всё должно работать. Теперь можно запускать платформу посредством ярлыков (кнопок меню приложений)

По прежнему не запускается? Если да, то спешим на встречу новым приключениям!

===Переопределить настройки по умолчанию для ОС Альт===

Перезагрузиться

====Каталог для файловых баз данных платформы 1С и sgid-bit====

Поскольку полный путь до каталога с файловой базой данных будет фигурировать в конфигурационных файлах веб-сервера, его рекомендуется сделать отличным от пути по умолчанию, который предлагает платформа 1С.

Например, так:

mkdir ~/bases

При публикации базы данных через веб-сервер необходимо чтобы у процесса веб-сервера, запущенного от пользователя

apache2

был доступ на чтение и запись в каталог с базой данных конфигурации 1С.

Один из вариантов это сделать следующий:

1. Разрешаем членам группы-владельца каталога чтение и запись

chmod g+rwx ~/bases -R

2. Устанавливаем sgid бит на каталог

chmod g+s ~/bases -R

3. Добавляем пользователя apache2 в группу-владельца каталога

sudo usermod -aG user apache2

==Публикация REST/Odata на веб-сервере==

Предполагается что до этого были выполнены все действия в предыдущем разделе...

===Устанавливаем и включаем веб-сервер apache2===

sudo apt-get install -y apache2
sudo systemctl enable --now httpd2

===Создаём симлинк для httpd2===

Для скриптов платформы 1С это важно...

ln -s /sbin/httpd2 /sbin/httpd

===Публикуем командой===

Сначала создаём файл (оно само не может):

sudo touch /etc/httpd2/conf/sites-enabled/1c_odata.conf

Потом публикуем:

sudo HOME=/home/user /opt/1cv8t/x86_64/8.5.1.1150/webinstt -apache24 -wsdir odata_base -dir /var/www/odata_base -connstr "File=/home/user/bases/base1;" -confPath /etc/httpd2/conf/sites-enabled/1c_odata.conf

В ответ должно прийти что-то типа этого:

Публикация выполнена

или этого:

Публикация обновлена

Примерное содержимое файла в контексте конфигурационных файлов веб-сервера apache2:

cat /etc/httpd2/conf/sites-enabled/1c_odata.conf

<pre>
LoadModule _1cws_module "/opt/1cv8t/x86_64/8.5.1.1150/wsap24t.so"

# 1c publication
Alias "/odata_base" "/var/www/odata_base/"
<Directory "/var/www/odata_base/">
AllowOverride All
Options None
Require all granted
SetHandler 1c-application
ManagedApplicationDescriptor "/var/www/odata_base/default.vrd"
</Directory>
</pre>

===Исправляем параметр в конфигурации сервиса===

Исправляем значение параметра:

sed -i 's/ProtectHome=yes/ProtectHome=no/g' /lib/systemd/system/httpd2.service

После этого перезагрузим демона systemd

systemctl daemon-reload

Перед редактированием конфигурации необходимо передать права на папку публикации самому веб-серверу. По умолчанию она может быть закрыта для него. Если этого не сделать, веб-сервер не сможет прочитать файл настроек default.vrd и вернет ошибку доступа при обращении к базе через браузер.
<pre>
chown -R apache2: /var/www/odata_base
chmod -R 755 /var/www/odata_base
</pre>

Домашние каталоги пользователей (например, /home/user/) по умолчанию полностью изолированы от системных служб. Чтобы веб-сервер apache2 смог добраться до папки с базой данных, ему нужно дать разрешение на «транзитный проход» сквозь вышестоящие директории. Флаг +x для папок как раз открывает эту возможность, не нарушая при этом приватность остальных личных файлов пользователя.
<pre>
chmod a+x /home/user/
chmod a+x /home/user/bases/
</pre>

Перед конфигурацией OData необходимо также предоставить веб-серверу права на чтение и запись внутри папки с самой базой. Чтобы не нарушать логику прав Linux и оставить пользователя владельцем файлов, мы добавляем apache2 в его группу и выставляем права 775 совместно с флагом SGID. Это позволит платформе беспрепятственно создавать файлы блокировок (.1CL), а новые файлы будут автоматически наследоваться группой.
<pre>
chmod -R 2775 /home/user/bases/base1/
</pre>

===Перезапускаем веб-сервер===

systemctl restart httpd2

===Проверяем публикацию===
Идём браузером по адресу:

<pre>
http://localhost/odata_base/
</pre>

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

<pre>
{"#exception":"{http://v8.1c.ru/8.2/virtual-resource-system}Exception","exception":{"clsid":"580392e6-ba49-4280-ac67-fcd6f2180121","reason":404,"descr":"HTTP: Not found\nError executing the query GET to resource /en/scripts/mod_bootstrap_bootstrap.js:","category":"00000000000000000000000000","creationStack":"mngsrvt:0x0000000000252DF5 mngsrvt:0x000000000024F8F4 vrsbaset:0x00000000006D7791 vrsbaset:0x00000000006540C5 vrsbaset:0x00000000006EBDE6 vrsbaset:0x00000000006D2A9C vrsbaset:0x00000000006EC4A9 vrsbaset:0x00000000006ED4A0 core85t:0x00000000008D4EBF core85t:0x00000000006B238C libc.so:0x0000000000000000 libc.so:0x0000000000000000 "}}
</pre>

Но это не помешает нам работать с OData.

===Включение поддержки OData===

Любым текстовым редактором открываем конфигурационный файл публикации:
<pre>
nano /var/www/odata_base/default.vrd
</pre>

Внутри тега <standardOdata> меняем значение параметра enable с false на true:
<pre>
<standardOdata enable="true"
</pre>

Итоговый вид файла default.vrd:
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<point xmlns="http://v8.1c.ru/8.2/virtual-resource-system"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
base="/odata_base"
ib="File=/home/user/bases/base1;">
<ws pointEnableCommon="true"/>
<standardOdata enable="true"
reuseSessions="autouse"
sessionMaxAge="20"
poolSize="10"
poolTimeout="5"/>
<analytics enable="true"
sessionMaxAge="1200"
poolSize="500"
poolTimeout="5"/>
</point>
</pre>

После изменения конфигурации перезапускаем службу веб-сервера для применения настроек:
<pre>
sudo systemctl restart httpd2.service
</pre>

Для проверки доступности интерфейса OData отправляем GET-запрос по адресу:
<pre>
http://localhost/odata_base/odata/standard.odata/
</pre>

Пример успешного ответа (корневой контейнер для пустой информационной базы):
<pre>
<service xml:base="http://localhost/odata_base/odata/standard.odata">
<workspace>
<atom:title>Default</atom:title>
</workspace>
</service>
</pre>

==Автоматизация резервного копирования информационных баз==

Предполагается, что платформа "1С Предприятие" работает на GNU/Linux системе и скрипт резервного копирования выполняется от пользователя

administrator

, графическое окружение которого автоматически запускается после загрузки компьютера.

Дело в том, что по каким-то причинам, разработчики платформы "1С Предприятие" не заложили в систему запуск резервного копирования в headless-режиме, поэтому платформе необходим дисплей X-сервера.

Также предполагается, что файл с паролем от пользователя платформы "1С Предприятие", которому разрешено выполнять резервное копирование, хранится в файле

/home/administrator/.1c-cluster-infobases-backup.pass

и рекомендуемые права на этот файл

0400

===Подготовка каталога для скриптов===

mkdir /opt/1c_backup_scripts

===Базовый скрипт===

При необходимости, в тексте скрипта, отредактируйте строчку

bin1c="/opt/1cv8/x86_64/8.3.23.1912/1cv8"

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

Ниже предоставлен текст, который можно выделить, скопировать в текстовый редактор, при необходимости поправить, затем весь этот текст можно бросить в консоль для создания файла посредством heredoc-синтаксиса:
<pre>
cat << 'EOF' > /opt/1c_backup_scripts/backup_infobase_1c_generic.sh
#!/bin/bash
export LANG=ru_RU.UTF-8

NON_ROOT_USER="administrator"
DISPLAY=":0"
STORAGE="${1}"
SRV="${2}"
REF="${3}"
LOGIN="${4}"
PASSWORD_FILE="${5}"
KEEP_BACKUPS_FOR_LAST_DAYS="${6}"
BACKUP_TIMEOUT_SEC="${7}"
TIMEOUT_COUNTER=0
LOCK_FILE_PATH="/home/usr1cv8/.1cv8/1C/1cv8/reg_1541/snccntx8e79a393-c2af-4fd7-b25a-af6b5ed19bfa/snccntx.dat"
#-----------------------------
export DISPLAY="${DISPLAY}"
bin1c="/opt/1cv8/x86_64/8.3.23.1912/1cv8"
PASSWORD=`cat ${PASSWORD_FILE} | head -1`
infobase_suffix="$(date +%Y-%m-%d-%H-%M-%S).dt"
TMP_STORAGE="/opt/1c_backup_scripts/tmp_storage"
ib_tmp_filepath="${TMP_STORAGE}/${REF}__${infobase_suffix}"
ib_tmp_log="${ib_tmp_filepath}.log"
ib_filepath="${STORAGE}/${REF}__${infobase_suffix}"
ib_log="${ib_filepath}.log"

function rotate_backups(){
filenames_cmd="${STORAGE}/${REF}*"
current_unixtime=`date +%s --date="$(date +%Y-%m-%d) 00:00:00"`
test_unixtime=$(($current_unixtime-$KEEP_BACKUPS_FOR_LAST_DAYS*60*60*24))

for f in $(/bin/ls $filenames_cmd); do
#echo "f=$f"
datetime_from_file=`echo ${f} | awk -F '__' {'print $2'} | awk -F '.' {'print $1'}`
#echo "datetime_from_file=${datetime_from_file}"

#2023-12-24-22-01-02
Y=`echo ${datetime_from_file} | awk -F '-' {'print $1'}`
M=`echo ${datetime_from_file} | awk -F '-' {'print $2'}`
D=`echo ${datetime_from_file} | awk -F '-' {'print $3'}`
h=`echo ${datetime_from_file} | awk -F '-' {'print $4'}`
m=`echo ${datetime_from_file} | awk -F '-' {'print $5'}`
s=`echo ${datetime_from_file} | awk -F '-' {'print $6'}`

unixtime_from_file=`date +%s --date="${Y}-${M}-${D} ${h}:${m}:${s}"`

if [[ $unixtime_from_file -lt $test_unixtime ]]; then
echo "delete file: ${f}"
/bin/rm ${f}
else
echo "keep file: ${f}"
fi
done
}

function wait(){

if [[ $TIMEOUT_COUNTER -ge $BACKUP_TIMEOUT_SEC ]]; then
kill -9 ${1}
fi

if [ ! -d /proc/${1}/ ]; then
nice_text="Выгрузка информационной базы успешно завершена"
res_text=$(grep -o -i "${nice_text}" ${ib_tmp_log})

# start apache2
sudo systemctl start httpd2

if [ "${res_text}" = "${nice_text}" ]; then
/bin/cp ${ib_tmp_filepath} ${ib_filepath} && /bin/rm ${ib_tmp_filepath}
/bin/cp ${ib_tmp_log} ${ib_log} && /bin/rm ${ib_tmp_log}
#echo "TEST: ${ib_filepath} AND ${ib_log}"
rotate_backups
exit 0
fi

exit 1
fi
#echo "pid alive: ${1}"
sleep 1
TIMEOUT_COUNTER=$(($TIMEOUT_COUNTER+1))
wait ${1}
}

# prepare tmp storage
[ ! -d ${TMP_STORAGE} ] && sudo mkdir "${TMP_STORAGE}" && sudo chown administrator: "${TMP_STORAGE}" -R

# stop apache2
sudo systemctl stop httpd2
sleep 2

# reset srv1cv8 sessions
sudo systemctl stop srv1cv8
sleep 2
sudo /bin/rm -f "${LOCK_FILE_PATH}"
sudo systemctl start srv1cv8
sleep 2

DISPLAY=:0 XAUTHORITY=/home/administrator/.Xauthority ${bin1c} CONFIG /N "${LOGIN}" /P "${PASSWORD}" /S "${SRV}/${REF}" /DumpIB "${ib_tmp_filepath}" /OUT "${ib_tmp_log}" &
main_process_pid=$!

wait ${main_process_pid}
</pre>

Делаем файл исполняемым

chmod +x /opt/1c_backup_scripts/backup_infobase_1c_generic.sh

===Скрипт для резервирования конкретной базы данных===
Данный скрипт представляет из себя обёртку над выше приведённым скриптом, с заданием конкретных параметров резервирования

<pre>
cat << 'EOF' > /opt/1c_backup_scripts/backup__my_super_infobase.sh
#!/bin/bash

### PARAMETERS ###
STORAGE="/mnt/storage/my-1c-host-backups" # каталог для сохранения резервных копий
SRV="my-1c-host" # хост, на котором работает платформа "1С: Предприятие"
REF="my_super_infobase" # имя базы данных, которую резервируем
LOGIN="backupuser" # 1с-пользователь, которому разрешено резервировать базу данных
PASSWORD_FILE="/home/administrator/.1c-cluster-infobases-backup.pass" # в этом файле должен находиться только пароль от 1с-пользоателя
KEEP_BACKUPS_FOR_LAST_DAYS="2" # сохранить резервные копии только за эти несколько последных дней (в текущем примере - за 2 последних дня)
BACKUP_TIMEOUT_SEC="300" # таймаут, в течение которого разрешено работать процессу резервирования (процессу платформы "1С: Предприятие". Если за этот таймаут процесс не успел сделать резервную копию, то он снимается с выполнения)

# ------------------------------------------------------------------------------------------------

### BOT PARAMETERS
TELEGRAM_BOT_TOKEN="" # сюда нужно вписать токен телеграм-бота, который будет отсылать уведомления
TELEGRAM_DESTINATION_GROUP_ID="" # сюда нужно вписать идентификатор телеграм-пользователя или телеграм-группы (не забывайте про минус в начале, если это идентификатор группы), в которого (или в которую, если это группа) бот будет писать сообщения

function send_message_telegram(){
#exit 0 # раскомментируйте эту строчку, если отсылка сообщений телеграм-ботом не нужна (следовательно, и параметры дя бота при этом можно не задавать)
message=${1}
curl -s -X POST \
-H 'Content-Type: application/json' \
-d "{\"chat_id\": \"${TELEGRAM_DESTINATION_GROUP_ID}\", \"text\": \"${message}\", \"disable_notification\": true}" \
https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage > /dev/null
}
# ------------------------------------------------------------------------------------------------

### START ###
BASE=`dirname ${0}`
${BASE}/backup_infobase_1c_generic.sh "${STORAGE}" "${SRV}" "${REF}" "${LOGIN}" "${PASSWORD_FILE}" "${KEEP_BACKUPS_FOR_LAST_DAYS}" "${BACKUP_TIMEOUT_SEC}"
res=$?

if [ ${res} -eq 0 ]; then
send_message_telegram "[Успешно]\nРезервное копирование информационной базы '${REF}' выполнено успешно"
else
send_message_telegram "[Ошибка]\nРезервное копирование информационной базы '${REF}' не выполнено"
fi
EOF
</pre>

Делаем файл исполняемым

chmod +x /opt/1c_backup_scripts/backup__my_super_infobase.sh

===Ставим задачу для планировщика cron===

Под пользователем

administrator

в терминале открываем временный файл для настройки crontab

EDITOR=nano crontab -e

в результате редактором

nano

будет открыт временный файл для установки параметров планировщика для текущего пользователя. Отредактировав и сохранив (Ctrl+O - Enter) изменения в этом файле и закрыв редактор (Ctrl+X) будет сконфигурирован планировщик для текущего пользователя.

Проверить корректность заданных параметров планировщика можно выполнением команды

crontab -l

В случае, если планировщик был сконфигурирован на запуск скрипта резервного копирования каждые сутки с 23:01, вывод команды проверки должен быть примерно такой:
<pre>
#minute (0-59),
#| hour (0-23),
#| | day of the month (1-31),
#| | | month of the year (1-12),
#| | | | day of the week (0-6 with 0=Sunday).
#| | | | | commands
1 23 * * * /opt/1c_backup_scripts/backup__my_super_infobase.sh
</pre>

1c

2026-06-12T22:07:08Z

Shogun Sun: /* Исправляем параметр в конфигурации сервиса */

1c

2026-06-12T22:00:14Z

Shogun Sun:

1c

2026-06-12T21:47:46Z

Shogun Sun: /* В GNU/Linux */

1c

2026-06-12T21:45:05Z

Shogun Sun:

1c

2026-06-12T21:36:24Z

Shogun Sun: /* Проверяем публикацию */

1c

2026-06-12T21:35:26Z

Shogun Sun: /* Проверяем публикацию */

1c

2026-06-12T21:33:08Z

Shogun Sun: /* Исправляем параметр в конфигурации сервиса */

Интеграция Swagger в NestJS

2026-03-01T13:00:52Z

Shogun Sun: Shogun Sun переименовал страницу Настройка Swagger в NestJS в Интеграция Swagger в NestJS

== Установка необходимых зависимостей ==

<pre>npm install @nestjs/swagger</pre>

== Настройка файла main.ts ==

# Импорт модулей В начало файла добавляем:

<pre>import { SwaggerModule, DocumentBuilder } from '@nestjs/swagger'</pre>
<ol start="2" style="list-style-type: decimal;">
<li>Конфигурация спецификации Объект config определяет метаданные вашей документации. Его необходимо создать внутри функции bootstrap():</li></ol>

<pre>const config = new DocumentBuilder()
.setTitle('Заголовок документации')
.setDescription('Описание документации')
.setVersion('Версия документации')
.build() </pre>
<ol start="3" style="list-style-type: decimal;">
<li>Инициализация модуля Создание функции-фабрики, которая собирает спецификацию API на основе декораторов в контроллерах.</li></ol>

<pre>const documentFactory = () => SwaggerModule.createDocument(app, config);
SwaggerModule.setup('docs', app, documentFactory);</pre>
Метод setup подключает интерактивную документацию по пути /docs, связывая ее с приложением NestJS и созданным документом.

Настройка Swagger в NestJS

2026-03-01T13:00:52Z

Shogun Sun: Shogun Sun переименовал страницу Настройка Swagger в NestJS в Интеграция Swagger в NestJS

#перенаправление [[Интеграция Swagger в NestJS]]

Интеграция Swagger в NestJS

2026-03-01T12:56:15Z

Shogun Sun:

Интеграция Swagger в NestJS

2026-03-01T11:35:53Z

Shogun Sun: Добавлена инструкция настройки файла main.ts

= Интеграция Swagger в NestJS =


== Установка необходимых зависимостей ==

<pre>npm install @nestjs/swagger</pre>

== Настройка файла main.ts ==

# Импорт модулей В начало файла добавляем:

<pre>import { SwaggerModule, DocumentBuilder } from '@nestjs/swagger'</pre>
<ol start="2" style="list-style-type: decimal;">
<li>Конфигурация спецификации Объект config определяет метаданные вашей документации. Его необходимо создать внутри функции bootstrap():</li></ol>

<pre>const config = new DocumentBuilder()
.setTitle('Заголовок документации')
.setDescription('Описание документации')
.setVersion('Версия документации')
.build() </pre>
<ol start="3" style="list-style-type: decimal;">
<li>Инициализация модуля Создание функции-фабрики, которая собирает спецификацию API на основе декораторов в контроллерах.</li></ol>

<pre>const documentFactory = () => SwaggerModule.createDocument(app, config);
SwaggerModule.setup('docs', app, documentFactory);</pre>
Метод setup подключает интерактивную документацию по пути /docs, связывая ее с приложением NestJS и созданным документом.