Техподдержка 3CX отвечает: резервное копирование и восстановление 3CX из командной строки

Начиная с 3CX v15.5 SP1 мы добавили две консольные утилиты для резервного копирования и восстановления конфигурации АТС. Они используются, прежде всего, в скриптах автоматизации, либо если отсутсвует доступ к интерфейсу сервера.

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

Команда BackupCMD

BackupCMD — консольная команда резервного копирования. У нее сеть следующие параметры:

• l, --log=VALUE, имя или путь log-файла
• f, --file=VALUE, имя или путь zip-файла архива — обязательный параметр
• o, --options=VALUE, Опции резервирования (что резервируется) — обязательный параметр

• c, --cfg=VALUE, полный путь к файлу конфигурации
• h, --help, показать справку (список этих параметров)
• --pwd=Value, пароль шифрования архива (v15.5 SP2 и выше)

Использование параметров

При указании только имени файла (параметр --file), резервная копия будет создана в расположении, указанном в интерфейсе управления 3CX. Местом хранения может быть локальная папка, FTP-сервер или Google Drive. Но если в параметре указан полный путь к файлу, используется именно он, а настройки в интерфейсе игнорируются.

Если не указан параметр log-файла, файл создается в расположении по умолчанию C:Program Files3CX Phone SystemInstance1Binbackup.log (Windows) или /var/lib/3cxpbx/Instance1/Bin/backup.log (Linux). Если в параметре указано только имя файла, оно будет использовано в расположении по умолчанию. А если указан полный путь, он переопределяет расположение log-файла по умолчанию (указывать можно только локальный путь).

Обратите внимание, что при запуске системного скрипта резервирования, пользователь «phonesystem» должен иметь право на запись в папку резервной копии.

Параметр --cfg используется только, если утилита BackupCMD запускается не из папки по умолчанию (например, из вашей папки с утилитами). В этом случае значение параметра устанавливается так:

• C:Program Files3CX Phone SystemInstance1BinBackupCmd.exe.config (Windows)
• /var/lib/3cxpbx/Instance1/Bin/BackupCmd.exe.config (Linux)

Резервное копирование в Windows

1. Запустите командную строку от имени администратора и введите: cd C:Program Files3CX Phone SystemInstance1Bin
2. Для показа справки введите: BackupCmd.exe --help
3. Пример команды полного резервирования: BackupCmd.exe --file=backuptest.zip --options=ALL --log=backuptest.log
4. Пример команды резервирования истории вызовов, лицензии и FQDN: BackupCmd.exe --file=backuptest.zip --options=CH,LIC,FQDN --log=backuptest.log

Резервное копирование в Linux

Команды выполняются пользователем «phonesystem» с привилегиями sudo:

1. Запустите Terminal и введите: cd /var/lib/3cxpbx/Instance1/Bin/
2. Для показа справки введите: sudo -u phonesystem /usr/sbin/3CXBackupCmd --help
3. Пример команды полного резервирования: sudo -u phonesystem /usr/sbin/3CXBackupCmd --file=backuptest.zip --options=ALL --log=/tmp/backuptest.log
4. Пример команды резервирования истории вызовов, лицензии и FQDN: sudo -u phonesystem /usr/sbin/3CXBackupCmd --file=backuptest.zip --options=CH,LIC,FQDN --log=/tmp/backuptest.log

Команда RestoreCMD

RestoreCMD — консольная команда восстановления резервной копии сервера 3CX. У нее сеть следующие параметры:

• -l, --log=VALUE, имя или путь log-файла
• -f, --file=VALUE, имя или путь zip-файла архива — обязательный параметр
• -c, --cfg=VALUE, полный путь к файлу конфигурации
• -h, --help, показать справку (список этих параметров)
• --pwd=Value, пароль дешифрования архива (v15.5 SP2 и выше)
• --failover, отказоустойчивый режим (сервисы 3CX не запускаются после восстановления)

Использование параметров

При указании только имени файла (аргумент --file), резервная копия ищется в расположении, указанном в интерфейсе управления 3CX. Но если в параметре указан полный путь к файлу, используется именно он, а настройки в интерфейсе игнорируются.

Если не указан параметр log-файла, файл не создается. Если в параметре указано только имя файла, файл будет создан в расположении по умолчанию C:Program Files3CX Phone SystemInstance1Binbackup.log (Windows) или /var/lib/3cxpbx/Instance1/Bin/backup.log (Linux). А если вы указали полный путь, log-файл создается по этому пути.

Параметр --cfg используется только, если утилита RestoreCMD запускается не из папки по умолчанию. В этом случае параметр устанавливается так:

• C:Program Files3CX Phone SystemInstance1BinRestoreCmd.exe.config (Windows)
• /var/lib/3cxpbx/Instance1/Bin/RestoreCmd.exe.config (Linux)

Восстановление в Windows

1. Запустите командную строку от имени администратора и введите: cd C:Program Files3CX Phone SystemInstance1Bin
2. Для показа справки введите:  RestoreCmd.exe --help
3. Пример команды восстановления сервера 3CX: RestoreCmd.exe --file=restoretest.zip --log=restoretest.log
4. Пример команды восстановления отказоустойчивого узла: RestoreCmd.exe --file=restoretest.zip --failover --log=restoretest.log

Восстановление в Linux

Команды выполняются пользователем «phonesystem» с привилегиями sudo:

1. Запустите Terminal и введите: cd /var/lib/3cxpbx/Instance1/Bin/
2. Для показа справки введите: sudo -u phonesystem /usr/sbin/3CXRestoreCmd --help
3. Пример команды восстановления: sudo -u phonesystem /usr/sbin/3CXRestoreCmd --file=restoretest.zip --log=/tmp/restoretest.log
4. Пример команды восстановления отказоустойчивого узла: sudo -u phonesystem /usr/sbin/3CXRestoreCmd --file=restoretest.zip --failover --log=/tmp/restoretest.log

Автор: snezhko

Источник