Установка ЕдиногоАгента на Z/OS

Материал из Документация Ключ-АСТРОМ

Установка модуля zRemote

Модуль zRemote обрабатывает данные мониторинга, полученные от zLocal, и направляет эти данные, сжатые и зашифрованные, через свой локальный АктивныйШлюз в Ключ-АСТРОМ. Таким образом, модуль zRemote выгружает большую часть работы по обработке из модулей кода CICS, IMS и z/OS Java, выполняемой в подсистемах и приложениях инструментирования, в открытую систему.

Вы можете настроить модуль zRemote, чтобы включить дополнительные функции, такие как группы хостов и выборку операторов SQL Db2 .

Требования к оборудованию

Требования к оборудованию машины, на которой работает модуль zRemote, зависят от ожидаемого количества транзакций CICS и IMS, которые необходимо отслеживать в секунду. См. требования к оборудованию для машин с архитектурой x86-64 и s390 (ниже).

  • Для сред разработки CICS и IMS: машина небольшого или среднего размера.
  • Для производственных сред CICS и IMS: большая или очень большая машина.
  • Для сред z/OS Java: машина небольшого или среднего размера.
Требования к оборудованию Маленький (DEV) Средний (DEV) Большой (PROD) Очень большой (PROD)
Ожидаемое количество отслеживаемых транзакций CICS/IMS в секунду 4000 7500 15000 30000
Требуемые ядра ЦП на архитектуре x86-64 (серия Xeon E5-2600) 2 4 8 16
Требуемые процессоры IFL на архитектуре s390 1 1 1 2
Требуемая память 4ГБ 6ГБ 8ГБ 16 ГБ
Необходимое дисковое пространство 20ГБ 20ГБ 20ГБ 20ГБ
  • Требования к оборудованию указаны для случая, когда модуль zRemote и его АктивныйШлюз используются только для мониторинга мэйнфрейма.
  • К одному zRemote можно подключить несколько подсистем zDC , если количество отслеживаемых транзакций соответствует требованиям к оборудованию.

Системные требования

Мы рекомендуем установить модуль zRemote на мэйнфрейм IBM Z или LinuxONE, на поддерживаемой операционной системе Linux для s390. Применяются следующие системные требования:

  • Подсистема zDC и модуль zRemote, к которому она подключается, должны располагаться в одном центре обработки данных, чтобы избежать проблем с производительностью и безопасностью.
    • zRemote запишет предупреждение в свои логи после задержки соединения в 3 секунды.
    • zRemote разорвет соединение после задержки соединения в 10 секунд.
  • zRemote поддерживает только установку АктивногоШлюза на основе хоста, настроенную для одной среды.
  • Мониторинг хоста, на котором запущен zRemote с ЕдинымАгентом, поддерживается только в режиме мониторинга полного стека.

Поддерживаемые операционные системы

Вы можете установить модуль zRemote в любой из перечисленных ниже операционных систем Linux и Windows.

Дистрибутив Версии Архитектура ЦП
Oracle Linux 8.10, 9.5 ARM64 (AArch64), x86-64
Red Hat Enterprise Linux 8.8, 8.10, 9.2, 9.4, 9.5 s390, x86-64
Red Hat Enterprise Linux 8.10, 9.4, 9.5 ARM64 (AArch64)
Rocky Linux 8.10, 9.5 ARM64 (AArch64), x86-64
SUSE Enterprise Linux 15.6 ARM64 (AArch64), s390, x86-64
Ubuntu 16.04, 18.04, 20.04, 22.04, 24.04 x86-64
Ubuntu 20.04, 22.04, 24.04 ARM64 (AArch64), s390
Windows 10, 11 x86-64
Windows Server 2016, 2019, 2022, 2025 x86-64

Обзор установщика

Обзор описывает ключевые компоненты приложения zRemote, конфигурацию zRemote и их установочные директории по умолчанию. Непостоянные директории заменяются во время обновлений и удаления.

Директории приложений и установок zRemote

Linux - /opt/Astromkey/zremote

Windows - C:/Program Files/Astromkey/zremote

Все следующие директории не сохраняются в случае обновления или удаления zRemote. Если вы внесете изменения здесь, они будут перезаписаны или удалены.

Директория Компонент Описание
agent/lib64 noneagentz Двоичный файл zRemote
agent/lib64 oneagentzwatchdog Двоичный файл, который обеспечивает возможности сервиса zRemote и управляет ограничениями ресурсов.
agent/lib64 oneagentdumpproc Двоичный файл, поддерживающий создание дампов при сбое основного приложения.
agent/lib64/zos-s390-64/<version> dtzagent Двоичный файл, развернутый в UNIX-части мэйнфрейма для поддержки коммуникаций OneAget. Для получения более подробной информации см. Установка подсистемы zDC
agent/lib64/zos-s390-64/<version> libdtzagent.so Двоичный файл, развернутый в UNIX-части мэйнфрейма для поддержки агентских коммуникаций. Для получения более подробной информации см. Установка подсистемы zDC
agent/conf ruxitagent.conf Файл конфигурации zRemote по умолчанию
agent/conf oneagentzwatchdog.ini Файл конфигурации сторожевого таймера по умолчанию
agent/conf .pem Сертификаты приложений
agent installer.version Установочная версия двоичного файла zRemote, которая обычно совпадает с версией zRemote
agent zremote только для Linux Скрипт сервиса для запуска приложения zRemote
uninstallation.sh только для Linux Скрипт службы для удаления приложения zRemote.

Он удаляет все, кроме постоянной конфигурации пользователя и файлов журналов.

Конфигурация и директории установки zRemote

Linux - /var/lib/Astromkey/zremote

Windows - C:/Program Files/Astromkey/zremote

Все следующие директории не сохраняются в случае обновления или удаления zRemote. Если вы внесете изменения здесь, они будут перезаписаны или удалены.

Директория Компонент Описание
agent runtime Содержит сведения о подключении, указанные в вашей среде Ключ-АСТРОМ.
config instance.properties Содержит идентификатор текущего зарегистрированного экземпляра.
config version.properties Содержит полный номер версии модуля zRemote.
state Содержит адрес последнего успешного подключения к серверу для указания правильно установленного соединения.

Следующие директории сохраняются в случае обновления или удаления. Вы можете внести изменения здесь. Для получения более подробной информации см. раздел Настройка модуля zRemote (ниже).

Директория Компонент Описание
agent/conf zremoteagentuserconfig.conf Файл конфигурации для настройки модуля zRemote
agent/conf watchdoguserconfig.conf Файл конфигурации для настройки watchdog таймера

Установка

Модуль zRemote загружается и устанавливается автоматически во время процедуры установки АктивногоШлюза в Linux или Windows.

  1. Войдите в Ключ-АСТРОМ. Выберите АктивныйШлюз > Настроить.
  2. На странице Установка среды АктивногоШлюза выберите Linux или Windows.
  3. только для Linux Выберите тип установщика s390 (рекомендуется) или x86/64.
  4. Выберите цель Установить модуль zRemote для мониторинга z/OS , загрузите установщик и запустите процедуру установки.
  5. необязательный Настройте выбор порта. По умолчанию модуль zRemote проверяет порт 8898 на предмет подключений от zLocal, работающего как часть zDC. Чтобы проверить другой порт, задайте параметру zdclistenerport ваш порт в файле zremoteagentuserconfig.conf. Убедитесь, что этот порт не заблокирован брандмауэром.

Подробную информацию о параметрах установки по умолчанию см. в разделе Параметры установки АктивногоШлюза по умолчанию для Linux или Windows.

Подробную информацию о настройке установки см. в разделе Настройка установки АктивногоШлюза в Linux или Windows.

Ведение логов

Логи zRemote создаются на машине, где установлен модуль zRemote, в директориях по умолчанию для Linux и Windows. Вы можете просматривать логи zRemote либо непосредственно на машине, на которой размещен zRemote, либо запросив их из Ключ-АСТРОМ через рабочий процесс диагностики ЕдиногоАгента.

Фактический лог zRemote должен содержать следующие сообщения:

  • Регистрация сообщений, отправляемых всеми модулями кода CICS/IMS и zDC.
  • Регистрация сообщений, отправляемых из zLocal.

Обновление и обслуживание

Чтобы оставаться в курсе событий, вы можете автоматически обновить модуль zRemote до более новой версии, используя процедуру автоматического обновления АктивногоШлюза.

Чтобы вручную обновить модуль zRemote

Для Linux

Для выполнения этих команд вам потребуются права root.

Чтобы запросить текущий статус модуля zRemote:

service zremote status

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

service zremote stop|start|restart|forcestop

Разница между stop и forcestop заключается в том, что команда stop позволяет выполнить процедуру контролируемого завершения работы, а команда forcestop принудительно завершает работу процесса.

Для Windows

Для выполнения этих команд вам потребуются права администратора.

В Windows модуль zRemote можно обслуживать с помощью вкладки Службы диспетчера задач Windows. Вы также можете использовать следующую команду:

sc stop|start|restart "Astromkey zRemote"

Команда sc асинхронная, поэтому вам необходимо запросить состояние службы, чтобы определить, когда она полностью остановилась:

sc query "Astromkey zRemote"

Настройка модуля zRemote

Вы можете настроить модуль zRemote, чтобы включить дополнительные функции и оптимизировать его производительность.

Файлы конфигурации пользователя

Следующие файлы конфигурации сохраняются в случае обновления или удаления zRemote. Вы можете внести изменения здесь.

Для применения новых настроек необходимо перезапустить службу zRemote.

Конфигурация пользователя модуля zRemote

Файл конфигурации пользователя модуля zRemote (zremoteagentuserconfig.conf) позволяет переопределить конфигурацию по умолчанию, определенную в ruxitagent.conf.

Для Linux

/var/lib/Astromkey/zremote/agent/conf/zremoteagentuserconfig.conf

Для Windows

C:/ProgramData/Astromkey/zremote/agent/conf/zremoteagentuserconfig.conf

Конфигурация пользователя Watchdog

Ключ-АСТРОМ версии 1.277+

Файл конфигурации пользователя watchdog (watchdoguserconfig.conf) позволяет переопределить конфигурацию по умолчанию, определенную в oneagentzwatchdog.ini.

Для Linux

/var/lib/Astromkey/zremote/agent/conf/watchdoguserconfig.conf

Для Windows

C:/ProgramData/Astromkey/zremote/agent/conf/watchdoguserconfig.conf

Доступные параметры для настройки:

Параметр Единица измерения Значение по умолчанию Описание
-healthcheck.heartbeat.timeout Секунды 900 Время ожидания соединения между службой zRemote и вашей средой Ключ-АСТРОМ
-healthcheck.memory.limit_absolute МБ 500 Абсолютный ввод для лимита вычислений памяти дочернего процесса
-healthcheck.memory.limit_percentage % 20 Процентный ввод для лимита вычисления памяти дочернего процесса

Расчет эффективного лимита памяти

Эффективный лимит = процентный лимит × доступная физическая память в системе + абсолютный лимит

Например:

0,2 × 5 ГБ + 500 МБ = 1,5 ГБ эффективного лимита памяти

Организация LPAR по группам хостов

Группы хостов полезны, когда вы хотите организовать несколько LPAR, подключенных к одному модулю zRemote. LPAR можно назначить группе хостов, установив атрибут [HostGroup] в файле zremoteagentuserconfig.conf. LPAR может принадлежать только одной группе хостов.

Чтобы назначить LPAR группе хостов, укажите имя группы между парой атрибутов [HostGroup]. Пара атрибутов [HostGroup] может находиться в любом месте файла zremoteagentuserconfig.conf.

[HostGroup]

<LPAR_Name1>=<HostGroupName>

<LPAR_Name2>=<HostGroupName>

[HostGroup]

Имя LPAR — это 8-символьное имя логического раздела, определенное LPARNAME() в параметре IEASYMxx member в z/OS.

Имя LPAR также отображается в разделе на экране хоста Properties and tags.

К строке <HostGroupName> предъявляются следующие требования :

  • Может содержать только буквенно-цифровые символы, дефисы (-), подчеркивания (_) и точки (.)
  • Не должно начинаться с dt.
  • Максимальная длина — 100 символов.

Объединение трех LPAR в одну группу хостов

В этом примере мы добавляем три LPAR — LPARA, LPARB, и LPARC в одну группу хостов TEST_HOST.

[HostGroup]

LPARA=TEST_HOST

LPARB=TEST_HOST

LPARC=TEST_HOST

[HostGroup]

Назначение трех LPAR разным группам хостов

В этом примере мы назначаем каждый LPAR отдельной группе хостов.

[HostGroup]

LPARA=TEST_HOST

LPARB=PROD_HOST

LPARC=PERF_HOST

[HostGroup]

  • В настройках хоста для группы хостов z/OS применимы только меню Общие , Мониторинг и Обнаруженные процессы.
  • Сохраняйте настройки группы хостов только в файле zremoteagentuserconfig.conf и переносите настройки группы хостов из файла ruxitagent.conf.
  • Настройки группы хостов вступают в силу во время запуска zRemote. После определения группы хостов в файле необходимо перезапустить модуль zRemote zremoteagentuserconfig.conf.

Извлечение полных SQL-выражений из баз данных Db2

Ключ-АСТРОМ может предоставить информацию об операторах SQL на основе трассировки вызовов баз данных Db2 и DL/I. Эти операторы SQL отображаются в Ключ-АСТРОМ, например, как:

  • FETCH (PROGNAME;165;3)
  • CLOSE (PROGNAME;441;2)

Строка представляет собой имя программы (имя DBRM), номер строки и номер раздела.

Модуль zRemote версии 1.241+ Ключ-АСТРОМ может обеспечить более глубокое понимание вызовов базы данных Db2, извлекая полные операторы SQL из директории Db2. При включенной функции извлечения операторов SQL операторы SQL отображаются в Ключ-АСТРОМ, например, как:

  • FETCH (GETTAB INTO : H , : H , : H , : H , : H)
  • CLOSE (GETTAB)

Включение выборки SQL-выражений

Функция выборки SQL-выражений по умолчанию отключена. Чтобы включить ее

1. Установите и настройте IBM Data Server Driver для программного обеспечения ODBC и CLI на Linux или Windows .

Дополнительные материалы: Информация о загрузке и установке драйвера IBM Db2 ODBC CLI.

На этапе установки обратите внимание на расположение библиотеки драйвера CLI:

  • libdb2.so для Linux
  • db2app64.dll для Windows

Перед настройкой драйвера может потребоваться обратиться к администратору базы данных с запросом информации о подключении к базе данных (такой как учетные данные базы данных, местоположение, IP и порт). На этапе настройки обратите внимание на псевдонимы Db2 (или DSN).

Оба эти условия потребуются на следующих этапах.

  • Модуль zRemote поддерживает только 64-битный драйвер CLI.
  • Мы настоятельно рекомендуем вам установить тайм-аут соединения для каждого BD, например, ConnectTimeout=2 на две секунды в db2cli.ini на Linux.
  • Обязательно протестируйте конфигурацию драйвера CLI, чтобы обеспечить хорошее соединение с DB2, например:
\<cli-driver-path\>/bin/db2cli validate -connect -database \<db-location\>:\<ip\>:\<port\> -user \<id\> -passwd \<pw\>

\<cli-driver-path\>/bin/db2cli validate -connect -dsn \<db-alias\>

  • Для настройки драйвера CLI вам потребуются учетные данные Db2, которые предоставляют доступ к соединениям Db2 (из распределенных с использованием DDF/DRDA) и права выбора в CATALOG, в частности в SYSPACKSTMT.

2. В файле модуля zRemote zremoteagentuserconfig.conf определите библиотеку драйвера CLI и группу псевдонимов Db2 (аналогично определению групп хостов), например:

# Linux

cli_driver_lib=/opt/IBM/CLIDRIVER/lib/libdb2.so

# ... or Windows

cli_driver_lib=C:/IBM/CLIDRIVER/bin/db2app64.dll

[DbAlias]

dbHost1.dbName1=alias1

dbHost2.dbName2=alias2

dbHostN.dbNameN=aliasN

[DbAlias]

# Beginning with zRemote 1.279 it is possible to set the new flag sqlStmtExtended, if

# true the full (fetched) SQL statement is appended with its old (unfetched) format,

# for example, from an example above "FETCH (GETTAB INTO : H , : H , : H , : H , : H)"

# would be shown as "FETCH (GETTAB INTO : H , : H , : H , : H , : H) (PROGNAME;165;3)".

# The default is false. Note: if enabled this setting would affect the aggregation count.

sqlStmtExtended=false

где dbHost— идентификатор SMF z/OS, а dbName— имя подсистемы Db2. Все регистрозависимо.

3. необязательно Определите sqlStmtCacheFileName=/tmp/sqlStmtCacheFileName, например, для кэширования извлеченных SQL-выражений в файл и использования его при перезапуске модуля zRemote, тем самым уменьшая взаимодействие с Db2. Обязательно используйте соответствующее полное имя файла.

4. Перезапустите модуль zRemote.

  • Модуль zRemote включит функцию выборки SQL-операторов только в том случае, если драйвер CLI может быть успешно загружен и определен хотя бы один псевдоним DB2.
  • Если впоследствии выяснится, что псевдоним Db2 недействителен, функция будет отключена.

Включение безопасного соединение zLocal-zRemote

Модуль zRemote версии 1.267+

По умолчанию zLocal и zRemote используют фирменный протокол связи через простые сокеты. Вы можете настроить их для связи через TLS, настроив AT-TLS для zLocal и установив флаги SSL для zRemote, как показано ниже.

Конфигурация AT-TLS для zLocal

В зависимости от ваших требований существуют различные способы настройки AT-TLS для zLocal. Более подробную информацию см. в разделе Application Transparent Transport Layer Security data protection в документации IBM. Вы можете использовать пример конфигурации AT-TLS ниже в качестве шаблона.

Пример конфигурации AT-TLS
TTLSRule                       <client-rule>

{

    RemoteAddr                 <ALL | specific-ip-addr>

    RemotePortRange            <zdclistenerport>

    Direction                  Outbound

    TTLSGroupActionRef         <group-action>

    TTLSEnvironmentActionRef   <environment-action>

    TTLSConnectionActionRef    <connection-action>

}

TTLSGroupAction                <group-action>

{

    TTLSEnabled                On

   Trace                       <trace-level>

}

TTLSEnvironmentAction          <environment-action>

{

    HandshakeRole              Client

    TTLSKeyringParmsRef        <keyring-parms>

    TTLSCipherParmsRef         <cipher-parms>

}

TTLSKeyringParms               <keyring-parms>

{

#   A certificate matches that of the zRemote's certificate

#   must be loaded into RACF and connected to the Keyring here.

    Keyring                    <pub-key-or-certificate>

}

TTLSCipherParms                <cipher-parms>

{

    ...

    V3CipherSuites             TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

    V3CipherSuites             TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384

    V3CipherSuites             TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

    V3CipherSuites             TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384

    ...

}

TTLSConnectionAction           <connection-action>

{

    TTLSConnectionAdvancedParmsRef  <connection-advanced-parms>

}

TTLSConnectionAdvancedParms    <connection-advanced-parms>

{

    SSLv2                      Off

    SSLv3                      Off

    TLSv1                      Off

    TLSv1.1                    Off

    TLSv1.2                    On

    TLSv1.3                    On

}

Убедитесь, что userId, используемый в zDC, совпадает с тем, который в сертификате. В противном случае подключение к TSL не будет выполнено (с ошибкой SSL accept -1 и кодом 5).

Настройки SSL/TLS для zRemote

Чтобы включить SSL/TLS для zRemote

  1. Откройте файл zremoteagentuserconfig.conf.
  2. Установите sslEnabled на true.
  3. Укажите абсолютные пути к файлам PEM вашего закрытого ключа (sslPrivateKey) и сертификата (sslCertificate).
  4. необязательный Определите конкретные наборы шифров TLS. Для получения информации о разрешенных именах наборов шифров и их строковом формате обратитесь к документации OpenSSL.
Шаблон конфигурации
# Must be true to enable secure connection; all other SSL settings are ignored if false

sslEnabled=true

# Absolute paths to your private key (with the pass-phrase stripped) and certificate PEM files.

# Beginning with zRemote module version 1.301.0, multiple private-key/certificate pairs delimited

# by a semicolon can be specified. For example:

# sslPrivateKey=<private-key-1.pem; private-key-2.pem; ...; private-key-n.pem>

# sslCertificate=<certificate-1.pem; certificate-2.pem; ...; certificate-n.pem>

sslPrivateKey=<private-key.pem>

sslCertificate=<certificate.pem>

# Optional: TLS cipher suites allowed according to OpenSSL

# Example: sslCiphers=ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384

sslCiphers=<cipher-suites>

Игнорирование недействительных попыток подключения

Если определенный процесс регулярно пингует модуль zRemote, чтобы определить его доступность, и эти пинги достигают порта zRemote, модуль zRemote регистрирует недопустимую попытку подключения. Эти недопустимые попытки подключения со временем увеличивают размер логов zRemote.

Чтобы игнорировать попытки подключения от определенных процессов, перечислите их IP-адреса (через точку с запятой) в файле, например zremoteagentuserconfig.conf:

ignoreHandshakeEndpoints=192.168.0.1;10.0.0.2

Отказ от нового расчета идентификатора процесса IMS MPR

Модуль zRemote версии 1.253+

Идентификаторы процессов области обработки сообщений IMS (MPR) могут измениться, что приведет к появлению новых процессов и объектов служб в Ключ-АСТРОМ. Чтобы предотвратить изменение идентификатора процесса, мы ввели более стабильный расчет идентификатора, в результате чего все процессы и объекты служб IMS MPR изменятся один раз, и затем останутся стабильными после обновления модуля zRemote до версии 1.253.

Чтобы отказаться от расчета нового идентификатора процесса IMS MPR, установите флаг useOldImsPgiCalc в файле zremoteagentuserconfig.conf на true.

useOldImsPgiCalc=true

Установка z/OSMF workflow

Фреймворк z/OSMF — IBM z/OS Management Facility — повышает производительность труда программистов систем z/OS за счет использования упрощенных, оптимизированных и автоматизированных рабочих процессов.

Вы можете установить Ключ-АСТРОМ Мониторинг на z/OS с помощью настраимовой установки z/OSMF workflow для модулей zDC, CICS и IMS, а затем использовать z/OSMF для поддержки Ключ-АСТРОМ Мониторинг.

Предустановка

  • z/OS версии 2.5+ с активным z/OSMF
  • zRemote версии 1.287+ установлен и подключен к вашей среде Ключ-АСТРОМ
  • zlocal версия 1.1+ установлен и подключен к zRemote

Загрузка файла

Файл определения z/OSMF workflow автоматически развертывается в вашей среде USS при загрузке zLocal. Убедитесь, что zRemote содержит файл определения z/OSMF workflow. Либо вы можете вручную скопировать его в USS.

Чтобы найти файл определения z/OSMF workflow, перейдите в следующую директорию zRemote:

Linux - /opt/Astromkey/zremote/agent/lib64/zos-installer/AstromkeyInstallWorkflow.xml

Windows - C:/Program Files/Astromkey/zremote/agent/lib64/zos-installer/AstromkeyInstallWorkflow.xml

Установка файла

Чтобы установить файл определения z/OSMF workflow

  1. Откройте Workflows и выберите Actions > Create Workflow.
  2. Укажите путь к файлу определения workflow и нажмите Далее.
  3. Определите идентификатор пользователя-владельца и систему, затем нажмите Готово.

Файл определения успешно загружен, когда в списке workflow отобразится workflow Установка Ключ-АСТРОМ Мониторинг.

Запуск workflow

Подготовка установки z/OSMF workflow

  1. Выберите workflow Установка Ключ-АСТРОМ Мониторинг и активируйте интересующие вас шаги.
  2. Чтобы добавить исполнителей для всех активированных шагов, выберите Действия > Назначение и владение > Добавить исполнителей.
  3. Добавьте доступных исполнителей и нажмите ОК.
  4. Выберите Действия > Принять для назначенных вам шагов.

Установка workflow Ключ-АСТРОМ Мониторинг теперь готова. Следуйте шагам workflow, пока установка Ключ-АСТРОМ Мониторинг не будет завершена.

Загрузка датасетов продуктов z/OS

Вы можете загрузить файл PAX, содержащий модули CICS, IMS, z/OS Java и zDC двумя способами:

  • Ключ-АСТРОМ версии 1.272+ Загрузка через API развертывания.
  • Ключ-АСТРОМ версии 1.276+ Загрузка через веб-интерфейс.
Начиная с версии ЕдиногоАгента 1.275, файл PAX больше не будет публиковаться на нашем FTP-сервере.

Загрузка PAX-файла

Вы можете загрузить последнюю или конкретную версию файла PAX через веб-интерфейс или API развертывания ЕдиногоАгента.

Версия файла PAX должна быть меньше или равна версии модуля zRemote.

Загрузите последнюю версию через веб-интерфейс

  1. В меню Ключ-АСТРОМ перейдите в раздел Развертывание и выберите Начать установку.
  2. Выберите z/OS и загрузите наборы данных продуктов z/OS, чтобы загрузить последнюю версию файла PAX.

Имя файла Astromkey-zos-1.nnn.m.pax включает основную nnn и m второстепенную версии релиза.

Загрузите определенную версию через веб-интерфейс

Вы можете загрузить определенную версию файла PAX через веб-интерфейс следующим образом:

  1. Перейдите в Настройки > Мониторинг > Обзор мониторинга.
  2. Выберите Скачать установщик ЕдиногоАгента или АктивногоШлюза и укажите предпочтительную версию:
    1. Установщик: ЕдиныйАгент - z/OS
    2. Сборка: выберите предпочтительную основную версию
    3. Ревизия: выберите предпочтительную второстепенную версию Image2001.png
  3. Выберите Продолжить и Загрузить наборы данных продуктов z/OS, чтобы загрузить определенную вами версию файла PAX. Имя файла Astromkey-zos-1.nnn.m.paxвключает основную nnn и m второстепенную версии релиза.

Загрузите последнюю версию через API развертывания

Вы можете загрузить последнюю версию файла PAX через API развертывания следующим образом:

  1. Сгенерируйте токен доступа с помощью интеграции PaaS - загрузка установщика (InstallerDownload).
  2. Загрузите последнюю версию файла PAX через API развертывания — Загрузите последнюю версию ЕдиногоАгента :
HTPP-метод Среда Ключ-АСТРОМ Конечная точка
GET SaaS https://{your-environment-id}.live.Astromkey.com/api/v1/deployment/installer/agent/zos/mainframe/latest
GET Managed https://{your-domain}/e/{your-environment-id}/api/v1/deployment/installer/agent/zos/mainframe/latest

Ниже приведен пример curl команды для среды SaaS, которая использует API развертывания для загрузки последней версии файла PAX:

curl -X GET "https://<environment>.live.Astromkey.com/api/v1/deployment/installer/agent/zos/mainframe/latest" -H "accept: */*" -H "Authorization: Api-Token <accessToken>" --output Astromkey-zos.pax

Замените <environment> на идентификатор вашей среды Ключ-АСТРОМ и сгенерированный вами токен доступа <accessToken>.

Загрузите определенную версию через API развертывания

Вы можете загрузить определенную версию файла PAX через API развертывания следующим образом:

1. Сгенерируйте токен доступа с помощью интеграции PaaS - загрузка установщика (InstallerDownload).

2. Список всех доступных версий PAX-файлов через API развертывания — список доступных версий ЕдиногоАгента.

HTPP-метод Среда Ключ-АСТРОМ Конечная точка
GET SaaS https://{your-environment-id}.live.Astromkey.com/api/v1/deployment/installer/agent/versions/zos/mainframe
GET Managed https://{your-domain}/e/{your-environment-id}/api/v1/deployment/installer/agent/versions/zos/mainframe

Ниже приведен пример curl команды для среды SaaS, которая использует API развертывания для вывода списка всех доступных версий файла PAX:

curl -X GET "https://<environment>.live.Astromkey.com/api/v1/deployment/installer/agent/versions/zos/mainframe" -H "accept: */*" -H "Authorization: Api-Token <accessToken>"

Замените <environment> на идентификатор вашей среды Ключ-АСТРОМ и сгенерированный вами токен доступа <accessToken>.

3. Загрузите определенную версию файла PAX через API развертывания — загрузите ЕдиныйАгент определенной версии :

HTPP-метод Среда Ключ-АСТРОМ Конечная точка
GET SaaS https://{your-environment-id}.live.Astromkey.com/api/v1/deployment/installer/agent/zos/mainframe/version/{version}
GET Managed https://{your-domain}/e/{your-environment-id}/api/v1/deployment/installer/agent/zos/mainframe/version/{version}

Ниже приведен пример curl команды для среды SaaS, которая использует API развертывания для загрузки определенной версии файла PAX:

curl -X GET "https://<environment>.live.Astromkey.com/api/v1/deployment/installer/agent/zos/mainframe/version/<version>" -H "accept: */*" -H "Authorization: Api-Token <accessToken>" --output Astromkey-zos.pax

Замените <environment> на идентификатор вашей среды Ключ-АСТРОМ, <version> на выбранную вами версию файла PAX и сгенерированный вами токен доступа <accessToken>.

Извлечение датасетов продукта

Вы можете извлечь наборы данных о продуктах из файла PAX следующим образом:

  1. Перенесите файл PAX в z/OS USS в двоичном режиме.
  2. Переименуйте файл PAX из Astromkey-zos-1.nnn.m.pax в Astromkey-zos.pax.
  3. Используйте EXTRACT ниже для извлечения датасетов продукта из установочных файлов. Перед запуском задания измените следующее:
    1. Определите желаемый высокоуровневый квалификатор для имен датасетов установки и задайте переменную HLQ соответствующим образом.
    2. Установите путь к директории z/OS USS MYUSS, куда вы поместили файл Astromkey-zos.pax. Если путь к директории превышает 42 символа, это может привести к ошибке в работе STEP3. В таком случае вам необходимо изменить JCL, чтобы учесть символ продолжения.
    3. Измените серийный номер тома VOLSER в соответствии со стандартами сайта.
EXTRACT job
//EXTRACT JOB ('ACCTINFO'),'User name or comment',NOTIFY=&SYSUID,

//             MSGLEVEL=(1,1),CLASS=A,MSGCLASS=X,REGION=0M,

//             COND=(0,NE)

//*

//* !!!!!!!! IMPORTANT !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

//*

//* When upgrading the zDC to version 1.213+ while

//* the CICS code module is enabled, it is important to follow

//* the below steps in the given sequence.

//*

//* 1. Stop the zDC

//* 2. Wait for 15 minutes for the CICS code module to

//*    reset/cleanup the control blocks

//* 3. Upgrade the zDC to newer version

//* 4. Start the zDC

//*

//* !!!!!!!! IMPORTANT !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

//*

//* This job extracts the product installation datasets from

//* the installation files at <MYUSS>/GIMZIP to

//* <hlq>.<rel>.SZDT* libraries.

//*

//* Change the JOB card and the SET statements below to meet             

//* site standards.

//*

//* Verify if the SMPCPATH and SMPJHOME DD below points to the

//* correct PATH to meet site standards.

//*

//* WARNING!

//* This JCL must be in mixed case and sequence numbers are not allowed

//*

// EXPORT SYMLIST=*

// SET HLQ='DT'             <== HLQ of the target PDS datasets

// SET REL='R12770'         <== Release number

// SET VOLSER='NSM001'      <== Volume of the target PDS datasets

// SET MYUSS='/u/dt'        <== USS work directory

//*

//*

//STEP1   EXEC PGM=IKJEFT01,DYNAMNBR=10

//SYSPRINT DD SYSOUT=*

//SYSTSPRT DD SYSOUT=*

//STDOUT   DD SYSOUT=*

//STDERR   DD SYSOUT=*

//SYSIN    DD DUMMY

//SYSTSIN  DD *,SYMBOLS=EXECSYS

BPXBATCH SH rm -Rf &MYUSS/GIMZIP

BPXBATCH SH cd &MYUSS &&  +

         pax -rvf Astromkey-zos.pax GIMZIP

//*

//*

//STEP2    EXEC PGM=GIMUNZIP,PARM='HASH=YES'

//SMPDIR   DD PATH='&MYUSS/GIMZIP/',PATHDISP=KEEP

//SMPCPATH DD PATH='/usr/lpp/smp/classes/',PATHDISP=KEEP

//SMPJHOME DD PATH='/usr/lpp/java/J8.0/',PATHDISP=KEEP

//SMPOUT   DD SYSOUT=*

//SYSPRINT DD SYSOUT=*

//SYSUT3   DD UNIT=SYSALLDA,SPACE=(CYL,(25,5))

//SYSUT4   DD UNIT=SYSALLDA,SPACE=(CYL,(25,5))

//SYSIN    DD *,SYMBOLS=EXECSYS

<GIMUNZIP>

  <ARCHDEF archid="AUTHLIB"

           replace="YES"

           volume="&VOLSER"

           newname="&HLQ..&REL..SZDTAUTH">

  </ARCHDEF>

  <ARCHDEF archid="LOAD"

           replace="YES"

           volume="&VOLSER"

           newname="&HLQ..&REL..SZDTLOAD">

  </ARCHDEF>

  <ARCHDEF archid="SAMPLE"

           replace="YES"

           volume="&VOLSER"

           newname="&HLQ..&REL..SZDTSAMP">

  </ARCHDEF>

</GIMUNZIP>

/*

//*

//STEP3   EXEC PGM=IKJEFT01,DYNAMNBR=10

//SYSPRINT DD SYSOUT=*

//SYSTSPRT DD SYSOUT=*

//STDOUT   DD SYSOUT=*

//STDERR   DD SYSOUT=*

//SYSIN    DD DUMMY

//SYSTSIN  DD *,SYMBOLS=EXECSYS

BPXBATCH SH export ussdir=&MYUSS &&+

            cp ${ussdir}/GIMZIP/Astromkey-oneagent-zos-java.jar +

            ${ussdir}/Astromkey-oneagent-zos-java.jar

//*

//*

//STEP4   EXEC PGM=IKJEFT01,DYNAMNBR=55

//SYSPRINT DD SYSOUT=*

//SYSTSPRT DD SYSOUT=*

//STDOUT   DD SYSOUT=*

//STDERR   DD SYSOUT=*

//SYSIN    DD DUMMY

//SYSTSIN  DD *,SYMBOLS=EXECSYS

BPXBATCH SH rm -Rf &MYUSS/GIMZIP

//

Если работа завершается с кодом возврата 0, извлечение прошло успешно.

необязательный Удалите Astromkey-zos.pax и Astromkey-oneagent-zos-java.jar (если не нужно) и освободите место на диске.

Датасеты продуктов

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

  • DT.R1nnnx.SZDTAUTH: Содержит подсистему zDC и модуль IMS, включая IMS Connect
  • DT.R1nnnx.SZDTLOAD: Содержит модуль CICS
  • DT.R1nnnx.SZDTSAMP: Включает примеры определений JCL и CICS RDO
Использование дискового пространства датасетами продуктов
Dsname                Tracks(3390) %Used

---------------------------------------

DT.R1nnnm.SZDTAUTH      893          5

DT.R1nnnm.SZDTLOAD       61         27

DT.R1nnnm.SZDTSAMP     1221         24

./GIMZIP/                      8K

./Astromkey-zos-1.nnn.m.pax    5M

Определение псевдонимов

Мы рекомендуем определять ALIAS без номера версии для датасетов продукта. Используйте ALIAS в работах по внедрению модулей zDC, CICS и IMS. Затем вы можете выполнять обслуживание без обновления работ.

Например:

DEFINE ALIAS(NAME('DT.DYNTRC.SZDTAUTH') RELATE('DT.R12770.SZDTAUTH'))

DEFINE ALIAS(NAME('DT.DYNTRC.SZDTLOAD') RELATE('DT.R12770.SZDTLOAD'))

Установка подсистемы zDC

Подсистема z/OS Data Collection (zDC) взаимодействует с модулями CICS, IMS и z/OS Java через объект общей памяти (SMO) на LPAR. Подсистема zDC поддерживает этот SMO, и модули записывают в него свои данные мониторинга.

zLocal (libdtzagent.so), размещенный в среде z/OS Unix System Services (USS), работает как часть zDC. Он управляет подключением сокета TCP/IP к модулю zRemote, считывает данные мониторинга из SMO и передает эти данные в zRemote.

Загрузчик (dtzagent), размещенный в среде z/OS USS, работает как часть zDC. Он управляет процессом обновления zLocal.

Когда zDC инициализируется (запуск системы или ручной запуск), он запускает загрузчик, а загрузчик запускает zLocal. Когда zDC завершает работу, zLocal и загрузчик останавливаются.

Безопасность системы

zDC (zLocal) использует соединения сокетов TCP/IP, поэтому может потребоваться обновить правила доступа вашей системы безопасности, если они настроены на запрет доступа по протоколу TCP/IP по умолчанию.

zDC не ограничивает идентификаторы пользователей, которые могут вводить команды оператора.

Вы можете контролировать разрешения, назначаемые файлам, созданным zLocal и загрузчиком, установив DT_UMASK. Значение по умолчанию — umask(022).

Установка

zDC работает как авторизованный процесс z/OS (обычно как системная задача). Это означает, что программы должны находиться в авторизованной библиотеке. Он предназначен для автоматического запуска в качестве запущенной задачи в системной IPL. Это обеспечивает zDC постоянную доступность для сбора данных мониторинга из модулей.

zDC также может быть запущен, как пакетное задание. Класс обслуживания zDC должен быть достаточно высоким, чтобы он всегда был доступен для сообщений keep-alive от zRemote. zDC должен иметь приоритет, равный или превышающий приоритет контролируемых регионов CICS и IMS.

Подсистема zDC должна быть установлена ​​на каждом LPAR, который вы хотите отслеживать.

1. Загрузите наборы данных продуктов z/OS. Запишите высокоуровневый квалификатор, используемый в процедуре загрузки.

2. Создайте идентификатор пользователя RACF для процесса zDC. Этот идентификатор должен иметь сегмент z/OS USS. Рекомендуемое имя домашней директории — /u/dt.

Если задана домашняя директории, отличная от /u/dt, измените путь к загрузчику на шаге 8, которая по умолчанию равна /u/dt/agent/lib64/dtzagent. Имена домашней директории ниже не могут быть изменены.

Домашняя директория или заменяющий ее квалификатор высокого уровня должны быть доступны для записи процессом zDC.

  • Он записывает двоичный файл zLocal в /u/dt/agent/downloads/native/a.b.c.d/zos-s390-64/libdtzagent.so, где a.b.c.d— версия zLocal (т. е. 1.0.1.0).
  • Он записывает логи zDC и zLocal в /u/dt/log/dtxxx.log.

В случае сбоя записи процессы zDC используют директорию /tmp/Astromkey.

Если zDC запускается, как запущенная задача, идентификатор должен соответствовать запущенной задаче zDC и иметь доступ к указанному выше пути USS.

3. Измените высокоуровневый квалификатор датасетов, представленный в элементе <hlq>, COPYAGNT на значение SZDTSAMP, которое вы использовали в процедуре загрузки наборов данных продуктов z/OS.

4. Запустите работу COPYAGNT, чтобы создать необходимые поддиректории z/OS USS в домашней директории запущенной работы zDC.

5. Скопируйте двоичный файл dtzagent и сделайте его исполняемым SZDTSAMP.

Если вы используете домашнюю директорию по умолчанию /u/dt, то результирующий путь будет /u/dt/agent/lib64/dtzagent.

Если используется домашняя директория, отличная от /u/dt, путь в этой работе должен быть изменен соответствующим образом. Имена файлов и директорий чувствительны к регистру. Имена путей ниже домашней директории не могут быть изменены.

Работа COPYAGNT должна выполняться под идентификатором пользователя, который был создан для процесса zDC, так что этот идентификатор пользователя владеет двоичным файлом dtzagent. Если это неудобно, вы также можете использовать команды chown и chgrp для сброса пользователя-владельца и группы для двоичного файла dtzagent после запуска COPYAGNT.

6. Разрешите <hlq>.SZDTAUTH, где <hlq> значение высокоуровневого квалификатора, которое вы использовали в процедуре загрузки датасетов продуктов z/OS.

Например, создайте элемент с именем, SYS1.PARMLIB(PROGDT) содержащим:

APF FORMAT(DYNAMIC)

APF ADD DSNAME(<hlq>.SZDTAUTH) VOLUME(XXXXXX)

Затем введите консольную команду:

SET PROG=DT

7. Скопируйте образец запущенной задачи zDC PROC ZDCMEPC из системной PROCLIB SZDTSAMP, используемой для запущенных задач.

Имя по умолчанию для PROC — MEPC. Настройте его по мере необходимости для местных стандартов. Если выбрано другое имя подсистемы, измените параметр SUBSYSTEM_ID() в параметрах SYSIN для соответствия.

//SYSIN DD DISP=SHR,DSN=<hlq>.SZDTSAMP(ZDCSYSIN)

SUBSYSTEM_ID(MEPC)

Элементы PROC и JCL SYSIN ZDCSYSIN и ZDCMEPCA, которые они используют, содержат имена датасетов, которые необходимо отредактировать, заменив <hlq>. соответствующими высокоуровневыми квалификаторами.

8. Обновите параметр SYSIN DTAGTCMD(), чтобы он отражал ваши определения.

//SYSIN DD DISP=SHR,DSN=<hlq>.SZDTSAMP(ZDCSYSIN)

DTAGTCMD(/u/dt/agent/lib64/dtzagent

nobootstrap=false

zremoteagent=<ipaddress>[:port])

  • /u/dt/agent/lib64/dtzagent задает путь к загрузчику. Имя домашней директории по умолчанию — /u/dt. Если вы задали другую домашнюю директорию на шаге 2, измените ее соответствующим образом.
  • nobootstrap=false позволяет загрузчику автоматически обновлять zLocal, как только становится доступна более новая версия. По умолчанию zLocal получает автоматические обновления. Установите значение на true для отключения автоматических обновлений и вручную обновите zLocal .
  • zremoteagent=<ipaddress>[:port] установите IP-адрес и порт установленного модуля zRemote. IP-адрес обязателен, порт необязателен и по умолчанию равен 8898.

9. Убедитесь, что выход SMF U86 активен.

  • необходимый Вам необходимо использовать z/OS 2.3 или более позднюю версию.
  • необходимый Выход U86 необходим для отчета об использовании LPAR для метрик DPS и выставления счетов. Ключ-АСТРОМ может приостановить трассировку без метрик DPS.
Начиная с версии ЕдиногоАгента 1.315, трассировка будет автоматически приостановлена, если метрика host.zos.msu_hours не будет получена в течение 12 часов подряд.

Когда это происходит, в логах zRemote регистрируется следующее сообщение:

Tracing has been disabled. The LPAR[LPAR] has not sent valid billing metrics.

Отслеживание будет автоматически возобновлено после повторного получения действительных показателей host.zos.msu_hours.

Чтобы проверить активность выхода SMF U86, выполните следующую команду:

D SMF,O

Найдите в выводе команды (EXITS(IEFU86)).

  • Если вы это нашли, выход SMF U86 активен. Переходите к следующему шагу.
  • Если вы его не нашли, вам необходимо добавить его в parmlib SMFPRMxx.
SUBSYS(STC,EXITS(IEFU86)

Затем включите его.

D PROG,EXIT,EN=SYS.IEFU86,DIAG

10. необязательный Добавьте команду в автозагрузку системы для автоматического запуска подсистемы zDC при IPL.

11. Используйте ZDCIVP PROC SZDTSAMP для проверки установки zDC и подключения zRemote.

Хороший тест на подключение zRemote возвращает Connection timeout, так как zRemote не поддерживает протокол FTP. Если существует проблема подключения zRemote, это обозначается EDC8128I Connection refused. Это означает, что zRemote не прослушивает ожидаемый порт.

Проверка установки

После завершения установки проверьте ее правильность.

Убедитесь, что zDC запущен правильно

Убедитесь, что zDC запустил правильную версию, успешно инициализировался и запустил zLocal. Найдите следующие сообщения в zDC SYSPRINT DD.

ZDC000I INITIALIZATION STARTED FOR zDC  VER 1.195.00

ZDC052I zDC IS RUNNING ON Z/OS RELEASE 02.02.00

ZDC053I LPAR NAME IBMSYS1    CVTSNAME S0W1

.

.

.

.

ZDC955L Astromkey connection being processed ZDC-Job/ID:AFVBZ021/Z021

ZDC958L Astromkey INIT completed, ZDC AgentId received ZDC-Job/ID:AFVBZ021/Z021

ZDC993I Opn1RFD:0008  /u/labuser/adcdk/ci/7.2build/log/dt_Z021_Z021_33620108.0.log

ZDC955I Astromkey connection being processed ZDC-Job/ID:AFVBZ021/Z021

Если в логах работы zDC появляется следующее сообщение SUBSYSTEM_ID (имя вашей подсистемы может отличаться от MEPC), перезапустите zDC с другими параметрами SYSIN.

11:55:30.419083 ZDC006E SUBSYSTEM MEPC ALREADY EXISTS AND IS ACTIVE

Убедитесь, что zLocal правильно запущен и подключен к zRemote.

zLocal записывает сообщения логов в zDC SYSPRINT DD в дополнение к среде z/OS USS /u/dt/log. Логи zLocal содержат информацию, касающуюся запуска zLocal, управления версиями и подключения к zRemote.

Чтобы убедиться, что все каналы в zLocal подключены к zRemote, найдите следующие сообщения в SYSPRINT:

info    [native] Astromkey z Remote Agent data channel connected successfully, performing handshake.

info    [native] Astromkey z Remote Agent client handshake performed.

info    [native] Astromkey z Remote Agent data channel handshake successful, version[rr.rr.rr.bbbb].

info    [native] Astromkey z Remote Agent control channel connected successfully, performing handshake

info    [native] Astromkey z Remote Agent handshakes are complete, all channels are fully operational.

Используйте команду z/OS MODIFY ниже, чтобы указать zDC на необходимость отображения статуса zLocal и поиска путей к файлам логов zLocal и zRemote.

MODIFY <zdc-jobname>,DT1 STDO

После того, как файл логов zLocal найден, вы можете получить к нему доступ, используя стандартные методы. Используйте OMVS, ssh/telnet или просмотрите его в веб-интерфейсе Ключ-АСТРОМ, как обычный файл логов ЕдиногоАгента.

Также найдите следующие сообщения в соответствующем файле логов zRemote (значения в скобках должны отражать ваши текущие данные).

info    [native] Astromkey z Local Agent handshakes are complete, all channels are fully operational, version[rr.rr.rr.bbbb].

info    [native] Data client socket listener thread started

info    [native] ASID[48], smfID[S0W1], sysid[Z208], jobName[AF71Z208], subagentid[da57ff16] smfID.JobID[S0W1    .JOB92014], zDC release 65 was successfully initialized with protocol version=6.5.0

info    [native] zDC[Z208] SMO is initialized with size=10M.

info    [native] Registering the zdc[48]

Проверьте уровень обслуживания модуля нагрузки zLocal

Просмотрите библиотеку установки <hlq>.R1nnnxx.SZDTAUTH, где <hlq> находится высокоуровневый квалификатор набора данных продукта, чтобы найти загрузочный модуль для zLocal ZDCDTAGT.

В примере заголовка ниже вы можете увидеть 1.nnn.00, что указывает на то, что это версия загрузочного модуля без какого-либо обслуживания. Когда применяется обслуживание, поле содержит номер подверсии, например 1.nnn.01. Даты меняются со временем.

ZDCDTAGT 00000000 YYYYMMDD HH.MM VER 1.nnn.00 COPYRIGHT (C)...

Загрузочный модуль ZDCDTAGT может выдавать диагностические сообщения в следующем формате:

ZDC99<n><i>

Где n - уровень логов, а i где — приоритет.

Сообщение о недостаточности прав доступа при запуске zDC

Если в логах заданий zDC появляются следующие сообщения (или что-то похожее):

H408I USER(xxxxxxxx) GROUP(xxxx) NAME(STARTED TASK )

BPX.FILEATTR.PROGCTL CL(FACILITY)

INSUFFICIENT ACCESS AUTHORITY

ACCESS INTENT(READ ) ACCESS ALLOWED(NONE )

А соответствующие сообщения появляются в файле логов zLocal:

JJJJ-MM-DD HH:MM:SS  3f8bbe02¨ info  native¨ Server requests us to use Agent

dTMajor.dTMinorVersion.0.dTBuild with a hash of 0317af199c1ab1a03dda2cee90c2ea61

JJJJ-MM-DD HH:MM:SS  3f8bbe02¨ info  native¨ Requesting Agent library from Server

JJJJ-MM-DD HH:MM:SS  3f8bbe02¨ info  native¨ Error setting Agent library program

controlled: EDC5139I Operation not permitted.

JJJJ-MM-DD HH:MM:SS  3f8bbe02¨ info  native¨ Loading Agent

/dt/Astromkey-<dTMajor.dTMinorVersion.0>/agent/downloads/<dTMajor.dTMinorVersion.0.dTBuild>

/native/zos-s390-64/libdtzagent.so

Их можно игнорировать.

После первоначальной загрузки zLocal операционная система пытается установить флаг для загруженной библиотеки, которая необходима в определенных обстоятельствах. Флаг не устанавливается во время второго запуска, поскольку библиотека больше не будет загружена, если она уже существует.

Набор данных SYSIN

Все значения, которые настраивают выполнение zDC, находятся в датасетах, на который указывает DDNAME SYSIN. Образец запущенной задачи PROC ZDCMEPC ссылается на JCL SYSIN ZDCSYSINSZDTSAMP, как показано ниже:

//SYSIN DD DISP=SHR,DSN=<hlq>.SZDTSAMP(ZDCSYSIN)

Датасет должен содержать 80 записей символов, кратных 80 байтам.

При внесении любых изменений в набор данных SYSIN необходимо перезапустить процесс zDC, чтобы изменения вступили в силу.

Параметры SYSIN

Позиции с 1 по 71 каждого оператора могут содержать значения параметров. Позиции с 72 по 80 игнорируются и могут опционально содержать порядковый номер.

Каждый параметр использует формат KEYWORD(value). Каждое ключевое слово и требования к связанным с ним значениям задокументированы в JCL ZDCSYSIN SYSIN SZDTSAMP.

Если значение параметра занимает несколько строк, укажите значение до позиции 71 и продолжите значение в следующем операторе, начиная с позиции 1.

Как добавить комментарий к выражению

Если вы хотите использовать комментарий, укажите это, поставить звездочку в позицию 1 утверждения. Все утверждение считается частью комментария.

/* This is a comment. */

Комментарий можно заключить между косой чертой и звездочкой, и звездочкой и косой чертой.

Параметр (значение по умолчанию) Описание
DTAGTCMD(/u/dt/agent/lib64/dtzagent) Устанавливает путь к загрузчику dtzagent.

Дополнительные параметры:

  • nobootstrap=false позволяет загрузчику автоматически обновлять zLocal, как только становится доступна более новая версия. Установите значение на true для отключения автоматических обновлений.
  • zremoteagent=<ipaddress>[:port] устанавливает IP-адрес и порт установленного модуля zRemote. IP-адрес обязателен, порт необязателен и по умолчанию равен 8898.
  • name=zlocal_<lpar> определяет имя zLocal для файлов логов. Имя должно отражать, что это zLocal. Оно может включать идентификатор SMF обслуживаемого LPAR.
  • loglevel=<value> устанавливает уровень логов zLocal. Значения уровня логов включают FINEST, FINER, FINE, CONFIG, INFO, WARNING, SEVERE, DEBUG, NONE). Значение по умолчанию отсутствует.
SUBSYSTEM_ID(MEPC) Определяет имя подсистемы zDC. Оно должно состоять из четырех непустых символов:
  • Первый символ должен быть заглавной буквой (A:Z).
  • Последние три символа — заглавные буквы или цифры (#,$,@,A:Z,0-9).
DEFAULT(YES) Определяет подсистему zDC, как подсистему по умолчанию. Данные мониторинга собираются подсистемой zDC по умолчанию, которая определяет DEFAULT(YES). Если вы запускаете несколько подсистем zDC на одном LPAR, вам необходимо указать DEFAULT(NO) для каждой дополнительной zDC, в противном случае они не будут инициализированы.
DISPLAY_NAME() Определяет отображаемое имя для этой подсистемы zDC для ее идентификации в определенных сообщениях логов.
DTLOGLEVEL(3) Устанавливает уровень логов zDC. Диапазон значений уровня логов от 0 до 8. Установите значение 4 для подавления информационных сообщений. Значения ниже 3 следует использовать только для диагностической отладки.
DTMSG_SMOSIZE(1) Устанавливает максимальный объем хранилища (МБ) для сообщений, которые могут быть поставлены в очередь в объекте общей памяти zDC при ожидании записи в модули z/OS. Значение по умолчанию 1 МБ должно быть достаточным в большинстве случаев, когда включена буферизация транзакций. Если буферизация транзакций отключена (не рекомендуется), установите размер SMO на 10 МБ, если отслеживаются очень большие объемы транзакций.
DTCHDIR(/u/dt) Изменяет текущую директорию z/OS USS, в котором загрузчик dtzagent создает временные файлы для stdin, stdout, и stderr. По умолчанию используется домашняя директория соответствующего идентификатора пользователя.
DTMSG_TRANBUFSIZE(n,m) Переопределяет количество и размер буферов транзакций по умолчанию. Буферы транзакций обеспечивают лучшую производительность для модулей CICS и IMS, помещая сообщения о событиях, связанные с каждой распределенной трассировкой, в выделенные буферы. Вместо того чтобы отправлять отдельные сообщения о событиях для каждой распределенной трассировки по мере их возникновения, они блокируются в одном или нескольких буферах и отправляются вместе. Кроме того, буфер связанных сообщений обрабатывается zRemote более эффективно.

Параметр n— это количество буферов в тысячах. Например, 2 = 2000 буферов. Нулевое значение отключает буферы транзакций. Параметр m должен быть либо 2 или 4 для указания размера буфера 2 КБ или 4 КБ. Мы рекомендуем размер буфера 4 КБ, если потребление хранилища не является существенной проблемой. Минимальное неотключаемое значение — 1,2. Максимальное — 126,4 или 248,2, что соответствует общему размеру 512 МБ. Верхняя граница количества буферов, которые могут потребоваться, — один для каждой области сообщений IMS и MAXTASK, умноженное на количество областей CICS, но фактические требования, вероятно, будут значительно меньше.

Ведение логов

Уровень логов zDC устанавливается параметром DTLOGLEVEL() в параметрах SYSIN. Вы можете динамически изменять этот уровень логов, выполнив команду z/OS MODIFY.

//SYSIN DD DISP=SHR,DSN=<hlq>.SZDTSAMP(ZDCSYSIN)

DTLOGLEVEL(3)

MODIFY <jobName>,DT1 LOG=1

Просмотр выходных сообщений логов в очереди работы zDC. Очередь заданий помогает определить ошибки, которые могут возникнуть во время запуска zDC или при подключении к zRemote. После успешного подключения zDC к zRemote сообщения об ошибках из подсистемы zDC и модулей CICS и IMS направляются в zRemote.

Уровень логов zLocal задается параметром DTAGTCMD(loglevel=INFO) в параметрах SYSIN. Вы можете динамически изменять этот уровень логов, выполнив команду z/OS MODIFY. DTAGTCMD(name=zlocal_<lpar>) определяет имя zLocal для файлов логов. Имя должно отражать, что это zLocal. Оно может включать идентификатор SMF обслуживаемого LPAR.

//SYSIN DD DISP=SHR,DSN=<hlq>.SZDTSAMP(ZDCSYSIN)

DTAGTCMD(loglevel=INFO name=zlocal_<lpar>)

MODIFY <jobname>,DT1 ZLALOGLEVEL=FINE

Для zLocal создано два набора логов. Оба они создаются в файловой системе OMVS. Один набор — это временный набор логов, действительный только для текущего выполнения zDC, и местоположение этих логов по умолчанию — домашняя директория идентификатора пользователя zDC. Вы можете переопределить местоположение, используя параметр DTCHDIR() в параметрах SYSIN.

ZLocal также создает стандартный набор логов, один для загрузчика и один для самого zLocal. Эти логи находятся в стандартных местах логов Ключ-АСТРОМ в файловой системе OMVS.

Обновление и обслуживание

  1. Загрузите датасеты продуктов z/OS и извлеките их.
  2. Обновите работу zDC, чтобы оно указывало на новый <hlq>.SZDTAUTH. Если вы определили псевдоним, переопределите его. Например:
DELETE 'DT.DYNTRC.SZDTAUTH' NOSCRATCH

DEFINE ALIAS(NAME('DT.DYNTRC.SZDTAUTH') RELATE('DT.R12710.SZDTAUTH'))

Обновление подсистемы zDC с версии 1.211 или более ранней

Требуется специальная обработка, чтобы избежать аварийных ситуаций в регионах CICS, которые вы отслеживаете при обновлении подсистемы zDC с версии 1.211 или более ранней.

  1. Остановите zDC.
  2. Подождите 15 минут, пока модуль CICS перезагрузится и очистит блоки управления.
  3. Обновите zDC до новой версии.
  4. Запустите zDC.

zLocal

По умолчанию zLocal получает автоматические обновления, если DTAGTCMD(nobootstrap=false) установлено в параметрах SYSIN. При каждом запуске zDC загрузчик запрашивает модуль zRemote на наличие доступных обновлений. Последняя версия zLocal устанавливается как часть установки zRemote. Если доступно обновление, zLocal будет автоматически загружен из zRemote и обновлен.

Примеры сообщений логов в выходных данных задания zDC в случае автоматических обновлений
info    (native) The bootstrap channel connected successfully, requesting version: a.b.c.d

info    (native) Interprocess lock acquired for /u/dt/agent/downloads/native/a.b.c.d/zos-s390-64/libdtzagent.so

info    (native) Fetching agent binary succeeded for /u/dt/agent/downloads/native/a.b.c.d/zos-s390-64/libdtzagent.so

Обновление zLocal вручную

  • Не используйте ручной процесс обновления zLocal при первом подключении к среде Ключ-АСТРОМ, поскольку zDC не запустится успешно.
  • Модуль zRemote должен быть запущен при первом запуске zDC, чтобы избежать U103 аварийного завершения работы пользователем .

Предположим, вы не хотите получать автоматические обновления для zLocal, установленные DTAGTCMD(nobootstrap=true) в параметрах SYSIN. Для ручного процесса обновления двоичный файл zLocal libdtzagent.so должен присутствовать на LPAR в директории /u/dt/agent/lib64.

Чтобы достичь этого:

  1. Запустите загрузчик dtzagent хотя бы один раз в производственном LPAR-разделе или в непроизводственном LPAR-разделе.
  2. Копируйте двоичный файл zLocal в целевой LPAR. В датасете SZDTSAMP участник OCOPYAGT— это работа, которое копирует двоичный файл zLocal libdtzagent.so в директории /u/dt/agent/lib64.
  3. Выполните инструкции по запуску zDC и подключите его к среде Ключ-АСТРОМ.
  4. Если zDC успешно подключается к Ключ-АСТРОМ, libdtzagent.so копируется в директорию /u/dt/agent/downloads/native/a.b.c.d/zos-s390-64/libdtzagent.so, где находится версия zLocal a.b.c.d (т.е. 1.0.1.0)
Примеры сообщений логов в выходных данных работ zDC в случае ручных обновлений
info    (native) Configured to not download module - loading local module

info    (native) Start loading local agent binary

info    (native) Successfully loaded agent binary /u/dt/agent/lib64/libdtzagent.so

Пользователь завершает работу zDC

ZDC может завершиться с пользовательским аварийным завершением из-за внутренних ошибок и сбоев инициализации. Все пользовательские аварийные завершения, за исключением U103 и U106, создают файл дампа. См. список возможных пользовательских аварийных завершений ниже.

Abend Описание
U100 Произошла внутренняя ошибка из-за сбоя инициализации zDC.
U101 Инициализация zDC не удалась, и сообщение об ошибке не отображается.
U102 Хранилище ECSA недоступно для zDC.
U103 Возникла проблема во время операции RETRY из процедуры выхода из режима восстановления.
U104 Задача очереди завершилась ненормально. Это аварийное завершение сопровождается сообщением ZDC066E в SYSLOG.
U105 Задача очереди завершилась аварийно, когда выключение НЕ выполнялось.
U106 Произошла фатальная ошибка в процедуре TCPSP.
U110 Это аварийное завершение может произойти по разным причинам внутренних ошибок. Оно сопровождается одним из следующих сообщений об ошибках zDC в SYSLOG:
  • ZDC988E
  • ZDC987E
  • ZDC985E
  • ZDC984E
  • ZDC983E
  • ZDC982E
  • ZDC981E
  • ZDC988E
  • ZDC982E
  • ZDC981E
  • ZDC979E
  • ZDC978E
U111 Произошла внутренняя ошибка в одном из модулей zDC. Аварийное завершение сопровождается одним из следующих сообщений об ошибке в SYSLOG:
  • AgtSt:DqrIErr-Get Token/Name for FML failed
  • AgtSt:DqrILod LOAD failed
  • AgtSt:Waiting for Que Data Space failed-Abort
U205 zDC не может открыть SYSPRINT или SYSPRIN3 DD для отображения сообщений логов.
U222 Произошла внутренняя ошибка в одном из модулей zDC. Аварийное завершение сопровождается одним из следующих сообщений в SYSLOG:
  • 066E IEAVRLS Error limit!
  • 066E Freed dead TBC Error-Abend222
Источник — https://doc.fit4u.kz/index.php?title=Установка_ЕдиногоАгента_на_Z/OS&oldid=5415