説明なし

ytolsky 13ec1f2cd4 v 0.12.1		1 ヶ月前
.gitignore	13ec1f2cd4 v 0.12.1	1 ヶ月前
CHANGELOG.md	13ec1f2cd4 v 0.12.1	1 ヶ月前
README.md	13ec1f2cd4 v 0.12.1	1 ヶ月前
adminutl.zip	13ec1f2cd4 v 0.12.1	1 ヶ月前

AdminUtlSkin v0.12.1

Состав

В состав скина входят файлы:

adminutlskin.tar - Сам административный скин.
server.tar - Серверный обработчик запросов скина.
admhelper.pl - Файл помощника для взаимодействия с логами.
pbx.tar - Модифицированная версия конференции. Позволяет включать новую логику её работы или оставлять старую. Видеть и управлять подключенными к конференции аккаунтами.
install.pl - Автоматический установщик. Позволяет установить/обновить компоненты скина. Если не требуется установка помощника запуск может вестись с другого хоста если есть доступ к необходимым портам. В том числе и с компьютеров под windows.
README.md - Данное описание.

Установка

Автоматическая установка

Инсталлятор устанавливает необходимые библиотеки и устанавливает все компоненты по запросу. Включая редактирование манифеста.
Запускаем install.pl в консоли с root правами из каталога куда распаковали архив:
sudo ./install.pl
или
sudo perl ./install.pl
Для установки помощника инсталлятор надо запускать на хосте с CommuniGate Pro
При инсталляции в кластерной конфигурации необходимо будет поправить пути в /opt/CommuniGate/admhelper.pl

Установка скина

Создается скин с названием, например AdminUtl с нужным уровнем видимости (в нужном домене или в базовом каталоге, что бы был доступен всем доменам). И загружается туда.
Пользователи->Интерфейсы->Именованные Интерфейсы->Задать имя, например AdminUtl->Создать->Именованные Интерфейсы->AdminUtl->Выбрать файл adminutlskin.tar->Загрузить файл

Установка серверного обработчика

Загружается в корневую папку скинов. Содержит файл обработчика: adminutl.wcgp .
Пользователи->Интерфейсы->Выбрать файл server.tar->Загрузить файл

Установка файла помощника

Для работы с логами и конвертации папок необходимо установить файл помощника. Например, кладём его в каталог /opt/CommuniGate. Затем в настройках Помощника Приложений задаем Путь к Программе: /usr/bin/perl /opt/CommuniGate/admhelper.pl
Указываем название admhelper и ставим состояние "Включено".
Перед запуском настройте каталоги в admhelper.pl
Для работы необходимо установить необходимые библиотеки (обычно могут быть уже установлены): sudo apt install libmime-base64-perl libjson-perl libfile-path-perl libfile-copy-recursive-perl libencode-perl
либо sudo dnf -y install perl-MIME-Base64 perl-JSON perl-File-Path perl-File-Copy-Recursive-Reduced perl-Encode perl-Digest-MD5 perl-IO-Socket-SSL perl-LWP-Protocol-https perl-HTML-HTML5-Entities perl-HTML-Parser
Если используется Манифест Дочерних Процессов (файл: /var/CommuniGate/Settings/ChildProcs.data) - то нужно добавить туда строку /usr/bin/perl /opt/CommuniGate/admhelper.pl
При остановке помощника может высветиться ошибка: "Проблема с помощником admhelper. ошибка чтения". Не обращайте внимания. Проблема поправлена в CG 6.5.6alfa7 Если требуется более быстрый многопоточный поиск, например по кластеру - есть вариант, компилируемый в выполнимый файл. Ему не требуется установки дополнительных библиотек.

Для кластера требуется смонтировать (NFS,SSHFS,SMB,...) для всех членов кластера каталоги с логами: 
/var/CommuniGate/SystemLogs/ например в каталог /mnt/CGServers
NFS пример:  
  Члены кластера:  
    В файле /etc/exports добавляем: 
      /var/CommuniGate/SystemLogs IP_УТИЛИТЫ/255.255.255.0(ro,insecure,nohide,no_subtree_check)  
    Потом: 
      sudo exportfs -a  
    Открыть порты если надо: 
      sudo ufw allow from IP_УТИЛИТЫ to any port 111 ; sudo ufw allow from IP_УТИЛИТЫ to any port 2049  
  Член с утилитой:  
    mkdir /mnt/CGServers  
    Для все членов кластера:  
       mkdir /mnt/CGServers/host_IP_ЧЛЕНА_КЛАСТЕРА  
       в файл /etc/fstab добавить: 
         IP_ЧЛЕНА_КЛАСТЕРА:/var/CommuniGate/SystemLogs /mnt/CGServers/host_IP_ЧЛЕНА_КЛАСТЕРА nfs defaults 0 0  
       Потом: 
         sudo mount -a  
    Для члена кластера с утилитой добавляем свой каталог:  
      ln -s /var/CommuniGate/SystemLogs /mnt/CGServers/host_IP_УТИЛИТЫ

Установка модифицированной версии конференции

Загружается в область PBX. С нужной видимостью - в конкретный домен или глобально.
Пользователи->PBX->Выбрать файл pbx.tar->Загрузить файл

Работа с панелью

Общая информация

Запуск панели обычно происходит путем перехода по адресу:
http://YOUR_SERVER:8100/?Skin=AdminUtl
или
https://YOUR_SERVER:9100/?Skin=AdminUtl

В верхней строке можно выбрать домен, с которым работаем. Так же там указываются версии компонентов и можно настроить видимость закладок
Все таблицы обладают возможностью сортировки по столбцам, для этого нажать на соответствующий заголовок.
Также практически при выводе любых результатов есть возможность экспорта в TSV формате.
Для работы с панелью необходимы права "Может менять установки Всех Доменов и Пользователей". Для работы с логами нужны права: "Может наблюдать за Сервером".

Закладки скина

Аудиоконференции

Нажав "Настройки" можно включить "Модернизированный режим(выделенный хост)". Этот режим позволяет осуществлять аудиоконференции независимо от входа/выхода владельца. В интерфейсе, если конференция идёт, виден список подключенных участников. Возможно отключать от конференции или включать/отключать звук для отдельных участников.

Подписка Делегирование

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

Групповые операции

Сначала происходит выбор аккаунтов. Возможно выбрать всех, выбрать группу, загрузить список из внешнего файла, выбрать всех кроме списка, ввести аккаунты вручную или воспользоваться поиском. При выборе опции "Расширенный поиск" поиск идет и по полю "Настоящее имя".
После выбора нужных аккаунтов производится определённая операция с ними:

Информация об аккаунтах - Выводится базовая информация: когда создан, дата последнего логина, IP последнего логина и можно включить вывод информации об XIMSS и SIP сессиях.
Базовые CLI операции - Описание CLI команд. Вывод информации через самые основные CLI команды. Возможно выбрать нужный параметр отдельно. Например, в операции GetAccountInfo указать в параметре ключ Created. Возможно скрывать параметры связанные с паролем.
Произвольная CLI - Выполняется произвольная команда. Макрос %acc% заменяется на название аккаунта. Возможно выполнение CLI команд и без привязки к аккаунтам - добавляем в список выбранных один любой аккаунт и макрос не используем. Например "GETVERSION".
Операции с папками - Для работы данного раздела необходимо установить помощник. Позволяет конвертировать почтовые и календарные папки между четырьмя возможными форматами.Описание форматов. Помощник нужен для доступа к файловой системе аккаунта. Иначе, например папку INBOX штатными путями сменить формат не получится. Операцию необходимо производить аккуратно. В данный момент не рекомендуется конвертировать папки с большим количеством элементов в формат mslc. Это может замедлить в сотни раз.
Корзина второго уровня - Механизм просмотра и восстановления из корзины второго уровня. Работает с версии CG 6.5.6alpha7. После релиза возможно функционал рассширится.

Работа с логами

Для работы с данным пунктом необходима установка помощника.
Если удалить дату поиска, то поиск будет происходить по всем доступным файлам. Поиск по ключу использует механизм аналогичный как в стандартном административном скине.
Если требуется более быстрый многопоточный поиск, например по кластеру - есть вариант, компилируемый в выполнимый файл. Ему не требуется установки дополнительных библиотек.

README.md