Особенности настройки ОС, установки и размещения ПО для ключей 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
Откройте страницу настроек, кликнув по значку
.В форме авторизации введите пароль администратора GCC (по умолчанию при установке GCC этот пароль — admin).
Шаг 3
Перейдите на вкладку Логирование.
Шаг 4
Включите опции Технические события и События бизнес-логики.