Особенности настройки ОС, установки и размещения ПО для ключей Guardant🔗

Сетевые настройки для ключей Guardant🔗

Для работы службы лицензирования Guardant (GCC, Guardant Control Centre) на тех хостах (компьютерах или виртуальных машинах), на которых запускаются серверные приложения Macroscop, необходимо разрешить входящие и исходящие TCP и UDP соединения по порту 3189. Это нужно сделать даже в том случае, если хост не подключён к сети (это может понадобиться, например, при первоначальной настройке сервера).

Для активации лицензии через интернет на сервере, имеющим локальный IP-адрес, необходимо настроить маршрутизацию таким образом, чтобы и на внешнем (публичном), и на внутреннем (локальном) адресах сервера использовался порт 3189.

Пример: 82.129.80.111:3189>192.168.50.40:3189

Установки и размещение ПО Guardant на Windows🔗

На операционных системах семейства Windows служба GCC устанавливается при установке серверного приложения Macroscop из полного дистрибутива; по умолчанию — в каталог C:\Program Files (x86)\Guardant\Guardant Control Center. Логи GCC по умолчанию хранятся в каталоге C:\ProgramData\Guardant; при использовании программного ключа там же хранятся данные этого ключа.

Логирование🔗

Логирование в хранилище DL позволяет отслеживать технические события программных ключей.

Ниже приведена пошаговая инструкция для настройки логирования на операционных системах Windows.

Подготовка хранилища DL🔗

Хранилище DL создается автоматически в момент активации лицензии или после запуска Guardant Control Center. Убедитесь, что структура каталогов хранилища создана. Для этого нужно перейти в директорию C:\ProgramData\Guardant\DL и проверить наличие следующей структуры каталогов:

  • .demo: Каталог с демо.

  • Licenses: Каталог с контейнерами.

  • Папки и файлы хранилищ лицензий. Пример наименования: .f1a95a6192c3b866c7c46a3c48....

Включение логирования🔗

Для включения логирования необходимо создать файл .log в директории C:\ProgramData\Guardant\DL.

  • Шаг 1 — Откройте командную строку (CMD):

    Нажмите комбинацию клавиш Win + R, введите cmd и нажмите клавишу Enter.

  • Шаг 2 — Перейдите в каталог хранилища DL:

    Введите команду:

    cd C:\ProgramData\Guardant\DL
    
  • Шаг 3 — Создайте каталог Logs:

    Введите команду:

    mkdir Logs
    
  • Шаг 4 — Создайте файл .log в каталоге Logs:

    Перейдите в созданный каталог с помощью команды:

    cd Logs
    

    Для создания файла .log введите команду:

    echo. > .log
    

Расширенное логирование🔗

Примечание

В Guardant Control Center версии 4.0 и выше доступно расширенное логирование.

Для включения расширенного логирования выполните шаги:

  • Шаг 1

    Перейдите в директорию C:\ProgramData\Guardant\Control Center.

  • Шаг 2

    Откройте файл C:\ProgramData\Guardant\Control Center\settings.xml с помощью текстового редактора файлов .xml. Например, с помощью встроенного текстового редактора Windows (Блокнот) или Visual Studio Code (VS Code).

  • Шаг 3

    Для параметра logLevel задайте значение 6.

    Пример:

    <property name="logLevel" value="6"/>
    

    Сохраните изменения в файле.

  • Шаг 4

    Перезапустите службу Guardant Control Center.

Установки и размещение ПО Guardant на GNU/Linux🔗

На операционных системах GNU/Linux служба GCC устанавливается при установке серверного приложения; установка осуществляется в каталог /var/guardant/. В этом же каталоге хранятся логи GCC; а при использовании программного ключа — данные этого ключа.

Совет

Для того чтобы поиск ключей в приложении Macroscop Конфигуратор выполнялся корректно, в службе GCC на вкладке Поиск сетевых лицензий отключите Широковещательный поиск, а в поле Поиск лицензий по списку адресов введите IP-адрес сервера.

Предупреждение

В GCC в поле Поиск лицензий по списку адресов не используйте доменные имена, вместо этого используйте IP-адреса.

Логирование🔗

Логирование в хранилище DL позволяет отслеживать технические события программных ключей.

Ниже приведена пошаговая инструкция для настройки логирования на операционных системах Linux.

Подготовка хранилища DL🔗

Хранилище DL создается автоматически в момент активации лицензии или после запуска Guardant Control Center. Убедитесь, что структура каталогов хранилища создана. Для этого нужно перейти в директорию /var/guardant/DL и проверить наличие следующей структуры каталогов:

  • .demo: Каталог с демо.

  • Licenses: Каталог с контейнерами.

  • Папки и файлы хранилищ лицензий. Пример наименования: .f1a95a6192c3b866c7c46a3c48....

Включение логирования🔗

Для включения логирования необходимо создать файл .log в директории /var/guardant/DL.

  • Шаг 1 — Запустите терминал.

  • Шаг 2 — Перейдите в каталог хранилища DL:

    Введите команду:

    cd /var/guardant/DL
    
  • Шаг 3 — Создайте каталог Logs:

    Введите команду:

    mkdir Logs
    
  • Шаг 4 — Создайте файл .log в каталоге Logs:

    Перейдите в созданный каталог с помощью команды:

    cd Logs
    

    Для создания файла .log введите команду:

    touch .log
    

Расширенное логирование🔗

Примечание

В Guardant Control Center версии 4.0 и выше доступно расширенное логирование.

Для включения расширенного логирования выполните шаги:

  • Шаг 1

    Перейдите в директорию /etc/guardant/gcc/settings.

  • Шаг 2

    Откройте файл /etc/guardant/gcc/settings.xml с помощью текстового редактора файлов .xml. Например, Visual Studio Code (VS Code).

  • Шаг 3

    Для параметра logLevel задайте значение 6.

    Пример:

    <property name="logLevel" value="6"/>
    

    Сохраните изменения в файле.

  • Шаг 4

    Перезапустите демона grdcontrol. Для этого откройте терминал и введите команду:

    sudo systemctl restart grdcontrol.service
    

Административная панель Guardant Control Center (GCC)🔗

Для доступа к службе GCC введите в адресной строке веб-браузера http://ip-адрес_сервера:3189.

Подключитесь к службе GCC на том сервере, на котором размещён ключ. Для этого введите в адресной строке веб-браузера http://имя_сервера:3189.

Примеры:

  • Для доступа к GCC, расположенному на том же сервере, на котором запущен веб-браузер, введите в адресной строке http://127.0.0.1:3189.

  • Для доступа к GCC, размещённому на удалённом сервере с адресом 192.168.1.5, введите в адресной строке http://192.168.1.5:3189. При этом указанный адрес и порт удалённого сервера должен быть доступен с компьютера, на котором запущен браузер.

Логирование🔗

Логирование в хранилище DL позволяет отслеживать технические события программных ключей.

Для включения логирования с помощью службы GCC выполните следующие шаги:

  • Шаг 1

    Подключитесь к службе GCC на том сервере, на котором размещён ключ. Для этого введите в адресной строке веб-браузера http://имя_сервера:3189.

    Примеры:

    • Для доступа к GCC, расположенному на том же сервере, на котором запущен веб-браузер, введите в адресной строке http://127.0.0.1:3189.

    • Для доступа к GCC, размещённому на удалённом сервере с адресом 192.168.1.5, введите в адресной строке http://192.168.1.5:3189. При этом указанный адрес и порт удалённого сервера должен быть доступен с компьютера, на котором запущен браузер.

  • Шаг 2

    Откройте страницу настроек, кликнув по значку ico-gcc-setting.

    В форме авторизации введите пароль администратора GCC (по умолчанию при установке GCC этот пароль — admin).

    ../../_images/window-guardant.png
  • Шаг 3

    Перейдите на вкладку Логирование.

    ../../_images/gcc-logging-settings.png
  • Шаг 4

    Включите опции Технические события и События бизнес-логики.