Утилита pServerAdmin
Консольная утилита pServerAdmin позволяет осуществлять:
- управление Pilot-Server:
- включение и отключение службы;
- проверка статуса службы;
- проверка версии Pilot-Server;
- дефрагментацию базы данных;
- резервное копирование основного файла базы данных *.dbp и файла переписки *.messages.dbp без остановки службы Pilot-Server;
- управление файловыми архивами.
Список команд pServerAdmin
| Команда | Описание команды | Вывод | Описание вывода |
|---|---|---|---|
|
-h, -?, --help |
Помощь по работе с программой | Список доступных команд программы с кратким описанием | |
| -v, --version |
Показывает версию Pilot-Server | Pilot-Server version is: [current version] | |
| Error: [System Core] Время ожидания операции истекло. |
Сервер не работает. Попробуйте запустить сервер командой:
pserveradmin --start |
||
| -s, --status |
Показывает статус Pilot-Server |
Pilot-Server service is running |
Pilot-Server работает. |
| Pilot-Server service is stopped | Pilot-Server остановлен. | ||
| -1, --start |
Запускает службу Pilot-Server | Pilot-Server service is running | Pilot-Server запущен. |
| Pilot-Server service is already running | Pilot-Server уже был запущен. | ||
| -0, --stop |
Останавливает службу Pilot-Server | Pilot-Server is stopped | Pilot-Server остановлен. |
| Pilot-Server is already stopped | Pilot-Server уже был остановлен. | ||
| -a, --admin [login] [password] |
Добавляет администратора сервера. | Success | Администратор добавлен успешно. Пример команды: pServerAdmin -a Admin 123456 |
| Unknown number of parameters | Пропущены необходимые параметры - логин и/или пароль. | ||
| -l, --listdb | Информация о базах данных. | Список всех баз данных на сервере. | |
| -c, --compress [database name] | Запускает дефрагментацию базы данных с именем [database_name] | Compress completed | Дефрагментация завершена. |
| Database path is incorrect | База данных с указанным именем не найдена. | ||
| Error: [System Core] Время ожидания операции истекло. |
Сервер не работает. Попробуйте запустить сервер командой:
pbimadmin --start |
||
|
-at, --attach [database name] [database file path] [file archive folder or marker file] |
Подключает базу данных к работающему серверу | Database attachment completed successfully | База данных успешно подключена. |
| Database with such name [имя базы данных] is alredy registered | База данных с указанным именем уже подключена. | ||
| File archive marker file [название файла] does not exist | Маркерный файл с указанным именем не найден. | ||
| Database path [путь] does not exist | База данных с указанным именем не найдена. | ||
|
-de, --detach [database name] |
Останавливает и отсоединяет базу данных от сервера без сброса идентификатора | Database detachment completed successfully | Отключение базы данных прошло успешно. |
| Database [имя базы данных] not found | База данных с указанным именем не найдена. | ||
| Database [имя базы данных] is unavailable | База данных с указанным именем не доступна для отключения. Проверьте, что она подключена. | ||
|
-b, --backup [database name] [destination] |
Запускает резервное копирование основного файла базы данных *.dbp и файла переписки *.messages.dbp без остановки службы Pilot-Server. [database_name] и [destination] — см. пример. |
Backup completed | Резервное копирование завершено. |
| Database was not found | База данных с указанным именем не найдена. | ||
| Error: [System Core] Время ожидания операции истекло. |
Сервер не работает. Попробуйте запустить сервер командой:
pbimadmin --start |
||
| -rc, --readconfiguration [path to configuration file] |
Сохраняет из PostgreSQL настройки конфигурационной базы в файл. | Success | Настройки сохранены в файл. Пример команды: pServerAdmin -rc C:\somefile.xml |
| Pilot-Server is not clustered | Невозможно прочитать настройки конфигурационной базы из PostgreSQL, так как Pilot-Server не запущен в кластерном режиме. | ||
| -wc, --writeconfiguration [path to configuration file] |
Записывает в PostgreSQL настройки конфигурационной базы из файла. Требуется перазапуск Pilot-Server, чтобы изменения применились. | Success | Настройки сохранены в базе PostgreSQL. Пример команды: pServerAdmin -wc C:\somefile.xml |
| Pilot-Server is not clustered | Невозможно записать настройки конфигурационной базы в PostgreSQL, так как Pilot-Server не запущен в кластерном режиме. | ||
| -fai,--fainfo [database name] | Информация о файловых архивах. | 1 929cdd36-b9f1-4091-a7de-8037fb455354, Name: [Файловый архив 1], Writable: False, folder: C:\DBases\dbname\FileArchive 2 7ca1258f-3df8-499c-a59d-1b87007faaf6, Name: [Файловый архив 2], Writable: True, folder: C:\DBases\dbname\FileArchive2 |
Список файловых архивов, принадлежащих базе, с информацией об ID архива, его имени, статусе, расположении. Пример команды: pServerAdmin -fai dbname |
| -faa,--faadd [database name] [file archive name] [destination folder] | Добавляет новый файловый архив к базе данных. | File archive is added with the id: e4fa5248-54d4-4312-8f07-eee810a86cfb | Файловый архив с ID e4fa5248-54d4-4312-8f07-eee810a86cfb добавлен. Пример команды: pServerAdmin -faa dbname "Файловый архив 3" "C:\DBases\dbname\FileArchive3" |
| -fad,--fadelete [database name] [file archive name] | Удаляет файловый архив. | File archive [Файловый архив 3] (e4fa5248-54d4-4312-8f07-eee810a86cfb) is deleted from the database. | Файловый архив с ID e4fa5248-54d4-4312-8f07-eee810a86cfb удалён из базы данных. Пример команды: pServerAdmin -fad dbname "Файловый архив 3" "C:\DBases\dbname\FileArchive3" |
| -fam, --famigrate [database name] [source file archive] [destination file archive] [document version] --from=[from date] --to=[to date] --mask=[file mask] | Переносит файлы из одного файлового архива в другой. См. пример. | 16 files are transferred between file archives with total size 2864453 | [16] файлов общим размером [2864453 Б] перенесено между файловыми архивами. Пример команды: pServerAdmin -fam demobim "Файловый архив 1" "Файловый архив 2" nonactual --from=01.06.2019 --to=01.06.2020 --mask=doc;docx |
| Migration failed: Unknown name of the destination file archive [Файловый архив 3] | Миграция прошла не успешно: указано некорректное имя целевого файлового архива [Файловый архив 3] | ||
| Document version is not specified | Не указано, какие версии документов следует перенести. Могут быть указаны значения actual - только актуальные, nonactual - только неактуальные и all - все. | ||
| Unknown key for the named parameter: [имя параметра] | Неизвестное значение указанного параметра. Проверьте корректность вводимых данных. | ||
| -fama, --famigrateanalysis [database name] [source file archive] [document version] --from=[from date] --to=[to date] --mask=[file mask] | Выполняет предварительный анализ миграции файлов. | [76] files will be transferred between file archives with total size [34155180] | [76] файлов общим размером [34155180 Б] будет перенесено между файловыми архивами. Пример команды: pServerAdmin -fama demobim "Файловый архив 1" nonactual --from=01.06.2019 |
| Document version is not specified | Не указано, какие версии документов следует перенести. Могут быть указаны значения actual - только актуальные, nonactual - только неактуальные и all - все. | ||
| Unknown key for the named parameter: [имя параметра] | Неизвестное значение указанного параметра. Проверьте корректность вводимых данных. | ||
| -fav,--faverify [database name] | Проверяет целостность файлового архива. | No errors found | Ошибок не найдено. Пример команды: pServerAdmin -fav dbname |
| FileArchiveNotFoundByRefInMediatorTable | Файловый архив, на который ссылаются таблицы базы данных, не найден на диске. | ||
| ReferencedObjectIsMissesInMediator | Идентификаторы файлов, на которые ссылаются основные объекты базы данных, не найдены в таблице. | ||
| FileFromMediatorTableIsNotFoundOnDisk | Файл, на который ссылается запись таблицы базы данных, не найден на диске. | ||
| TablesCrossReferenceInconsistency | Проверка того, что файл находится в правильном файловом архиве. | ||
| MissedInFaTable | Отсутствует запись в таблице файлового архива для файла, найденного на диске. | ||
| -faw,--fawritable [database name] [file archive name] | Присваивает файловому архиву статус записываемый. | File archive Файловый архив 1 has been set writable | Архив с именем "Файловый архив 1 " установлен в качестве записываемого. Пример команды: pServerAdmin -faw dbname "Файловый архив 1" |
|
В командах -fam, -fama дата вводится в формате, установленном в региональных настройках вашей операционной системы. Пример на рисунке 1.
Рис. 1. Пример формата даты. |
Примеры использования
Дефрагментация базы данных
Консольная утилита pServerAdmin позволяет осуществлять дефрагментацию базы данных. Запустите командную строку и введите:
pserveradmin -c [database name]
[database name] — имя подключенной к серверу базы данных, которую нужно дефрагментировать.
Например, для дефрагментирования подключенной к серверу базы pilot-ice_ru запустите консоль и введите:
pserveradmin -с pilot-ice_ru
Резервное копирование данных
Пример использования см. Резервное копирование данных