Резервное копирование и восстановление вашей установки

Рабочее пространство Enterprise Server может содержать широкий спектр ценных данных, включая определённых пользователей, группы, задачи синхронизации LDAP, данные проектирования (включая проекты, компоненты, модели, шаблоны), а также конфигурации служб PLS и NIS (и, как правило, ряд приобретённых продуктов и расширений, а также определённые пакеты развертывания для последних). Ключевое требование для обеспечения долгосрочной целостности этих данных — создание резервных копий. Стандартная установка Enterprise Server включает инструмент резервного копирования и восстановления, доступный через командную строку.

Расположение инструмента резервного копирования по умолчанию — в папке \Program Files (x86)\Altium\Altium365\Tools\BackupTool.

Имя инструмента резервного копирования — avbackup.exe.

Доступ к Backup Tool

Чтобы использовать инструмент:

1. Запустите командную строку Windows.

   Командную строку необходимо запускать в режиме администратора, чтобы иметь возможность использовать инструмент резервного копирования и восстановления. Если вы запускаете CMD не от имени администратора Windows, попытка выполнить команду резервного копирования или восстановления Enterprise Server приведёт к появлению понятного сообщения: Access Denied. Administrator permissions are needed to use the selected options. Use an administrator command prompt to complete these tasks.

2. Перейдите в нужную папку. Для установки по умолчанию на диске C хост-компьютера это будет: cd C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\

3. Чтобы запустить инструмент и вывести список доступных параметров, введите в командной строке: avbackup ?

Доступ к инструменту резервного копирования через командную строку (запущенную от имени администратора).

Обратите внимание на ?: при его добавлении отображается справка по функциям, доступным в инструменте резервного копирования:

• backup – резервное копирование данных в ZIP-архив.

• restore – восстановление данных из ZIP-архива. Точка восстановления будет создана автоматически.

• help – отображение экрана справки (? можно использовать вместо строки help).

Содержимое Zip-архива

Инструмент выполняет резервное копирование всего Enterprise Server и пользовательских данных, включая:

• Полную резервную копию базы данных, включая: все элементы данных (модели, компоненты, управляемые листы, шаблоны, выпущенные проекты и т. д.), пользователей, группы, установки, полученные через Network Installation Service, и настройки синхронизации LDAP.

• Все ревизии перечисленного выше.

• Репозитории и включённые проекты Workspace.

• Индекс поиска.

• Пользовательские (кастомные) настройки.

Синтаксис резервного копирования и переключатели

Следующие переключатели доступны при использовании функции резервного копирования инструмента:

avbackup backup -z [-t] [-h] [-i] [-m] [-d] [-c] [--split] [--skip-shadow-copy]

• -z – путь и имя файла целевого zip-файла, который нужно создать. Если в строке есть пробелы, заключите её в кавычки. Этот переключатель обязателен.

• -t, --test – если указан этот переключатель, zip-файл будет проверен после резервного копирования.

• -h, --hash – если указан этот переключатель, будет создан файл хэша MD5 (*.md5).

• -i – полный путь к файлу LocalVault.ini Enterprise Server, который содержит информацию о расположении данных для резервного копирования Enterprise Server. Путь по умолчанию к этому файлу: C:\Program Files (x86)\Altium\Altium365\LocalVault.ini. Если этот переключатель не указан, инструмент попытается найти файл автоматически, исходя из расположения установки по умолчанию. Если в строке есть пробелы, заключите её в кавычки.

• -m – позволяет определить, должна ли операция резервного копирования выполняться в тихом режиме (-m silent, режим по умолчанию) или должно появляться диалоговое окно с предложением повторить попытку в случае сбоя (-m dialog). Если этот переключатель не указан, будет использован тихий режим.

• -d, --debug – если указан этот переключатель, будет использован режим отладки, который позволит создавать больше журналов для диагностики и для передачи инженерам Altium.

• -c – позволяет задать уровень сжатия целевого zip-файла. Используйте число от 0 до 9. Также можно использовать следующие значения:

  • Default – соответствует уровню сжатия 6 (используется, если этот переключатель не указан)

  • None – соответствует уровню сжатия 0

  • BestSpeed – соответствует уровню сжатия 1

  • BestCompression – соответствует уровню сжатия 9.

• --split – если указан этот переключатель, будут созданы отдельные zip-файлы для репозиториев и ревизий (без сжатия) в дополнение к zip-файлу для остальных данных.

• --skip-shadow-copy – если указан этот переключатель, теневая копия создаваться не будет. Обратите внимание: при использовании этого переключателя увеличивается время простоя сервера (период между остановкой и запуском служб).

Если ввести только avbackup backup, эти переключатели будут выведены списком в качестве полезной подсказки.

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

Синтаксис восстановления и переключатели

Следующие переключатели доступны при использовании функции восстановления инструмента:

avbackup restore -z [--skip-backup] [-i] [-m] [-d] [-c] [--split] [--skip-shadow-copy]

• -z – путь и имя файла zip-архива резервной копии, из которого нужно восстановить. Если в строке есть пробелы, заключите её в кавычки. Этот переключатель обязателен.

• --skip-backup – позволяет пропустить создание точки восстановления перед началом восстановления Enterprise Server. Используйте с осторожностью, поскольку при сбое восстановления данных откат будет невозможен.

• -i – полный путь к файлу LocalVault.ini Enterprise Server, который содержит информацию о расположениях, в которые нужно восстановить данные Enterprise Server. Путь по умолчанию к этому файлу: C:\Program Files (x86)\Altium\Altium365\LocalVault.ini. Если этот переключатель не указан, инструмент попытается найти файл автоматически, исходя из расположения установки по умолчанию. Если в строке есть пробелы, заключите её в кавычки.

• -m – позволяет определить, должна ли операция восстановления выполняться в тихом режиме (-m silent, режим по умолчанию) или должно появляться диалоговое окно с предложением повторить попытку в случае сбоя (-m dialog). Если этот переключатель не указан, будет использован тихий режим.

• -d, --debug – если указан этот переключатель, будет использован режим отладки, который позволит создавать больше журналов для диагностики и для передачи инженерам Altium.

• -c – позволяет задать уровень сжатия целевого zip-файла для точки восстановления (резервной копии текущей установки Enterprise Server). Используйте число от 0 до 9. Также можно использовать следующие значения:

  • Default – соответствует уровню сжатия 6 (используется, если этот переключатель не указан)

  • None – соответствует уровню сжатия 0

  • BestSpeed – соответствует уровню сжатия 1

  • BestCompression – соответствует уровню сжатия 9.

• --split – если указан этот переключатель, будут созданы отдельные zip-файлы для репозиториев и ревизий (без сжатия) в дополнение к zip-файлу для остальных данных — для точки восстановления (резервной копии текущей установки Enterprise Server).

• --skip-shadow-copy –  если указан этот переключатель, теневая копия не будет создаваться для точки восстановления (резервной копии текущей установки Enterprise Server). Обратите внимание: при использовании этого переключателя увеличивается время простоя сервера (период между остановкой и запуском служб).

Если ввести только avbackup restore, эти переключатели будут выведены списком в качестве полезной подсказки.

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

Точка восстановления

Инструмент резервного копирования автоматически создаёт точку восстановления перед началом восстановления Enterprise Server (если для восстановления не использовался --skip-backup ). Для этого инструмент резервного копирования выполняет резервное копирование существующего Enterprise Server и копирует ZIP восстановления в следующее расположение:

C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\Backups\

ZIP именуется в формате: Backup_<Date>_<Time>.zip.

Ошибки при резервном копировании или восстановлении

Ошибки, возникающие при резервном копировании или восстановлении, отображаются непосредственно в окне CMD вместе с полной информацией о пути к журналу ошибок:

C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\errors.log

При резервном копировании или восстановлении Enterprise Server сведения о любых ошибках, а также полный путь к файлу errors.log, отображаются непосредственно в окне CMD.