(C) Copyright IBM Corporation 1995,1996. Все права защищены. 1.0 ФАЙЛ README ДЛЯ IBM SYSTEMVIEW AGENT ДЛЯ OS/2 ВЕРСИИ 1.4.1 _______________________________________________________________ ПРИМЕЧАНИЕ. При выводе на экран файла README используйте шрифт с одинаковой фиксированной шириной символов (System Monospaced). Если в вашем редакторе используется шрифт System Proportional, то могут появиться нарушения в выравнивании и размещении данных. Ссылки на IBM SystemView Agent и IBM SystemView Common Agent указывают на один и тот же программный продукт. Файл README дополняет документацию, которая поставляется вместе с лицензионной программой IBM SystemView Agent для OS/2 версии 1.4.1. Readme содержит рекомендации по результатам тестирования, и информацию, которая отсутствовала при издании документов. ----- ДЛЯ ПОЛЬЗОВАТЕЛЕЙ WORLD WIDE WEB (WWW) ---------------------- Программа SystemView Agent для OS/2 входит в программный продукт SystemView. Для установки SystemView Agent для OS/2 можно использовать, например, компакт-диск Showcase for SystemView Server для AIX или WWW. Web-страница с SystemView Agent имеет следующий URL-адрес: http://www.software.ibm.com/sysman/technology/caprod.html В файле README приводятся инструкции по установке с дискет SystemView Agent для OS/2 на локальную станцию. Если вы приняли файл .ZIP с web-страницы, то перед выполнением установки распакуйте его с помощью утилиты PKUNZIP. ------------------------------------------------------------------- В данном файле описываются следующие темы: o Установка SystemView Agent для OS/2 (1.1) o Обновление версии 1.1 или более новой (1.2) o Требования к программным средствам (1.3) o Условия программной совместимости (1.4) o Поддержка SNMP в OS/2 (1.5) o Конфигурирование SNMP с SystemView Agent для OS/2 (1.6) o Средства разработки субагента DPI SNMP (1.7) o Преобразование типов данных субагентом DMI (1.8) o Порядок байтов (1.9) o Решение проблем (1.10) С вопросами по темам, описанным в данном файле README, вы можете обратиться в представительство IBM. 1.1 УСТАНОВКА SYSTEMVIEW AGENT ДЛЯ OS/2 _________________________________________ Чтобы установить программу SystemView Agent для OS/2: 1. Вставьте дискету 1 SystemView Agent в дисковод A рабочей станции. 2. В строке командного режима OS/2: o Введите "A:" и нажмите Ввод. Затем в строке с приглашением введите "INSTALL" и нажмите Ввод. или o Введите "A:INSTALL /S:A:" 3. Чтобы продолжить процесс установки, выберите ПРОДОЛЖИТЬ. Выполняйте инструкции, которые выводит на экран Software Installer for OS/2, чтобы: o Выбрать для установки компонент DMI AND SNMP. o Определить целевое устройство и каталог для установки. o Сконфигурировать параметры SNMP (если требуется). Если вы собираетесь конфигурировать SNMP после установки, выберите кнопку OK в записной книжке Конфигурация SNMP, чтобы продолжить установку. 4. Перезагрузите свою рабочую станцию, чтобы изменения вступили в силу. После перезагрузки можно проверить установку. Для этого откройте папку SystemView Agent для OS/2 и щелкните два раза по значку Браузер DMI MIF. Если DMI Service Layer активен, то в окне браузера появится его значок. Электронные документы с описанием программы SystemView Agent для OS/2 находятся в папке SystemView Agent для OS/2. 1.2 ОБНОВЛЕНИЕ SYSTEMVIEW AGENT ДЛЯ OS/2 ВЕРСИИ 1.1 ИЛИ БОЛЕЕ НОВОЙ _____________________________________________________________________ Если у вас установлен SystemView Agent для OS/2 версии 1.1 или более новый, есть два способа обновить этот продукт до версии 1.4.1. o Обновление с помощью программы установки Чтобы обновить установленные компоненты с помощью программы установки, выберите режим UPDATE и выполните предлагаемые действия. Завершив обновление, выполните программу установки еще раз, выбрав режим УСТАНОВИТЬ ДОПОЛНИТЕЛЬНЫЕ КОМПОНЕНТЫ и компонент DMI AND SNMP. Это гарантирует корректную установку версии 1.4.1 на предыдущие версии. o Удаление существующей версии и установка версии 1.4.1 с помощью программы установки Чтобы удалить предыдущую версию программы, СЛЕДУЕТ выполнить утилиту деинсталляции, которая находится в папке SystemView Agent для OS/2, и перезагрузить рабочую станцию. После успешного удаления предыдущей версии программы установите версию 1.4.1 с помощью программы установки. 1.3 ТРЕБОВАНИЯ К ПРОГРАММНЫМ СРЕДСТВАМ _______________________________________ В таблице ниже приводятся обязательные (минимальные) для SystemView Agent программные средства и пакеты обновлений и изменений, которые необходимы для корректной работы продукта: Программные средства Уровень -------------------------------------------------------- OS/2 Версия 3.0 или более новая -------------------------------------------------------- TCP/IP для OS/2 Версия 3.0 -------------------------------------------------------- 1.4 УСЛОВИЯ ПРОГРАММНОЙ СОВМЕСТИМОСТИ ______________________________________ В таблице ниже приводятся программные средства, для которых требуются пакеты изменений, чтобы обеспечить корректную работу c SystemView Agent для OS/2. Программные средства Пакет изменений --------------------------------------------------------------------- Multiple Protocol Transport Для Warp Connect: APAR IC11318 Services (MPTS) Для LAN Server 4.0: APAR IC11319 Примечание. Если выключить Remote Directory Services, то можно избежать несовместимости без установки APAR, указанных выше. --------------------------------------------------------------------- 1.5 ПОДДЕРЖКА SNMP В OS/2 __________________________ В версии 1.4.1 SystemView Agent для OS/2 предоставляется поддержка SNMP для платформы OS/2. Во время установки SystemView Agent для OS/2 удаляются следующие файлы, если они находятся в подкаталогах TCPIP или MPTN: o SNMP.EXE o SNMPD.EXE o SNMPGRP.EXE o SNMPTRAP.EXE o SNMPDLL.DLL o SNMPCOMM.DLL o DPI20DLL.DLL o DPI32DLL.DLL При установке SystemView Agent для OS/2 устанавливаются обновленные версии этих файлов. ПРИМЕЧАНИЕ. Если позже программа SystemView Agent для OS/2 будет удалена, эти файлы не восстановятся. 1.6 КОНФИГУРИРОВАНИЕ SNMP С SYSTEMVIEW AGENT ДЛЯ OS/2 ______________________________________________________ Чтобы изменить конфигурацию агента SNMP после установки программы SystemView Agent, воспользуйтесь утилитой конфигурирования агента SNMP, которая находится в папке IBM SystemView Agent для OS/2. Изменения конфигурации SNMP альтернативными средствами (например, из записной книжки с конфигурацией TCP/IP) не повлияют на агента SNMP. 1.7 СРЕДСТВА РАЗРАБОТКИ СУБАГЕНТА DPI SNMP ___________________________________________ Интерфейс субагента DPI 2.0 входит в средства разработки DMI SystemView Agent для OS/2. Файл включения, библиотека и файл примера, поставляемые вместе с интерфейсом, находятся в подкаталоге DPI каталога, в котором установлена программа SystemView Agent для OS/2 (по умолчанию это каталог SVA). При компилировании функции DPI 2.0 убедитесь, что файл snmp_dpi.h, который входит в средства разработки DMI, указан до файлов включения, которые поставляются со средствами разработки TCP/IP. Электронная документация по интерфейсу субагента DPI SNMP поставляется вместе с программой SystemView Agent для OS/2. Чтобы получить к ней доступ, нужно дважды щелкнуть мышью по значку DPI Programmer's Guide в папке IBM SystemView для OS/2. 1.8 ПРЕОБРАЗОВАНИЕ ТИПОВ ДАННЫХ И СУБАГЕНТ DMI _______________________________________________ Субагент DMI выполняет следующее преобразование типов данных DMI в типы данных SNMP: ----------------------------------------------------------------- Тип данных DMI Тип данных SNMP ----------------------------------------------------------------- Counter Counter ----------------------------------------------------------------- Counter64 Counter ----------------------------------------------------------------- Gauge Gauge ----------------------------------------------------------------- Octetstring Octetstring ----------------------------------------------------------------- Displaystring Displaystring ----------------------------------------------------------------- String Displaystring ----------------------------------------------------------------- Integer Integer ----------------------------------------------------------------- Integer64 Octetstringhex ----------------------------------------------------------------- Enumerated integer Integer ----------------------------------------------------------------- 1.9 ПОРЯДОК БАЙТОВ ___________________ Service Layer не выполняет байтового преобразования. По этой причине важно применять один и тот же механизм преобразования при упаковке 64-битового значения (counter64 или int64) для передачи в Service Layer и распаковке 64-битового значения, полученного из Service Layer. Чтобы 64-битовые данные соответствовали порядку байтов в машине, задавайте их следующей структурой: typedef struct { #ifdef LITTLE_ENDIAN unsigned long Low32; unsigned long High32; #else unsigned long High32; unsigned long Low32; #endif } int64; В этой структуре длина данных unsigned long равна 32 битам. 1.10 РЕШЕНИЕ ПРОБЛЕМ _____________________ Проблемы, описанные ниже, уже известны разработчикам продукта SystemView Agent для OS/2 и направлены соответствующим исполнителям. В некоторых случаях есть возможность обойти проблему или уменьшить ее влияние. 1.10.1 ПРЕКРАЩЕНИЕ УСТАНОВКИ Если вы прервали установку SystemView Agent для OS/2 до ее завершения, а затем удалили установленные файлы, то перед повторной установкой SystemView Agent перезагрузите рабочую станцию. Не рекомендуется отменять установку SystemView Agent до ее завершения, если установлена программа NetView для OS/2. Если вам пришлось отменить установку, не удаляйте установленные файлы. При удалении переданных файлов могут быть удалены некоторые файлы программы NetView для OS/2, и NetView для OS/2 перестанет работать. Если такое произойдет, деинсталлируйте и NetView для OS/2, и SystemView Agent, а затем заново установите эти программные продукты. 1.10.2 ВО ВРЕМЯ УСТАНОВКИ НЕ НАЙДЕН ФАЙЛ SNMP.INI Если во время установки SystemView Agent не находится файл SNMP.INI, в окнах утилиты Конфигурирование OS/2 Agent выводятся пустые поля. В этом случае выберите OK и продолжите установку. После перезагрузки рабочей станции проверьте, находится ли копия файла SNMP.INI в подкаталоге, определенном переменной среды SNMPDIR. Измените конфигурацию SNMP, используя утилиту конфигурирования агента OS/2, и выполните перезагрузку для повторного запуска процессов SNMPD и DMISA. 1.10.3 SNMPD МОЖЕТ ГЕНЕРИРОВАТЬ ПРЕДУПРЕЖДАЮЩЕЕ СООБЩЕНИЕ Процесс SNMP может вывести на экран следующее сообщение: "e1: snmp_moh.c(1088): Not expected to be here". Если получите это сообщение, проигнорируйте его. Процесс SNMP нормально работает после этой ошибки. 1.10.4 DMISA НЕ МОЖЕТ ЗАРЕГИСТРИРОВАТЬСЯ С SNMP (NETBIOS) Если процесс DMISA остановлен и повторно запущен, то он не может зарегистрироваться с SNMPD через NETBIOS. Если это произошло, перезапустите SNMPD, затем перезапустите DMISA, или перезагрузите свою систему. 1.10.5 ПРИ ЗАКРЫТИИ DMISA НА МАШИНЕ, ИСПОЛЬЗУЮЩЕЙ ТОЛЬКО NETBIOS, ВЫВОДЯТСЯ СООБЩЕНИЯ Останавливая процесс DMISA на машине, использующей только NETBIOS, вы можете получить несколько сообщений MESSAGE FILE NOT FOUND. Если это произойдет, проигнорируйте их. 1.10.6 SERVICE LAYER ВОЗВРАЩАЕТ КЛЮЧИ В ПОРЯДКЕ MIF Для неинструментированных компонентов Service Layer возвращает ключевые атрибуты в порядке, в каком они появляются в файле MIF. Для инструментированных компонентов Service Layer возвращает атрибуты в том порядке, в каком они передаются программным средством. 1.11 ТОРГОВЫЕ ЗНАКИ И МАРКИ ОБСЛУЖИВАНИЯ _________________________________________ Следующие термины, отмеченные в этом файле README звездочкой (*), являются торговыми знаками или зарегистрированными торговыми знаками IBM Corporation в Соединенных Штатах или других странах: IBM SystemView NetView OS/2 ФИРМА IBM ОБЪЯВЛЯЕТ НЕДЕЙСТВИТЕЛЬНЫМИ ВСЯКИЕ ГАРАНТИИ, БУДЬ ТО ПРЯМЫЕ ИЛИ КОСВЕННЫЕ, В ТОМ ЧИСЛЕ ВСЯКИЕ ПОДРАЗУМЕВАЕМЫЕ ГАРАНТИИ ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ ИЛИ КОММЕРЧЕСКОЙ ВЫГОДНОСТИ, ОСНОВАННЫЕ НА ИНФОРМАЦИИ ДАННОГО ДОКУМЕНТА. ПОСТАВЛЯЯ ДАННЫЙ ДОКУМЕНТ, ФИРМА IBM НЕ ПРЕДОСТАВЛЯЕТ РАЗРЕШЕНИЙ НА КАКИЕ-ЛИБО ПАТЕНТЫ ИЛИ АВТОРСКИЕ ПРАВА.