Конфигурирование агента с использованием файла ответов без вывода сообщений

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

Об этой задаче

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

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

Процедура

  1. Откройте в текстовом редакторе файл oracle_silent_config.txt:
    • Linux или AIXкаталог_установки /samples/oracle_database_silent_config.txt.
    • Windowsкаталог_установки \samples\oracle_database_silent_config.txt
  2. Введите в поле Имя пользователя по умолчанию имя пользователя базы данных по умолчанию для соединений с базой данных, которые создаются для этого экземпляра агента. Например, KRZ_CONN_USERID=user1.
    Прим.: У этого пользователя должны быть достаточные полномочия для выполнения операций, которые выполняет агент, соединенный с базой данных (например, запрос таблиц).
  3. В качестве пароля по умолчанию нужно указать пароль, связанный с указанным пользователем базы данных по умолчанию. Например, KRZ_CONN_PASSWORD=Password.
  4. Если версия агента Oracle - 8.0, то выполните следующие действия.
    1. Задайте Файл JAR JDBC Oracle. Это - полный путь к файлу JAR драйвера Oracle JDBC, используемому для взаимодействия с базой данных Oracle.
      Драйвер Java Database Connectivity (JDBC) Oracle, который поддерживает версии базы данных Oracle, отслеживаемые агентом Oracle, должен быть доступен на компьютере агента.
  5. Если версия агента Oracle - 6.3.1.10, то выполните следующие действия.
    1. Если компонент агент Oracle Database установлен на сервере базы данных Oracle, который нужно отслеживать, введите значение в поле Домашний каталог Oracle. Например, KRZ_ORACLE_HOME=домашний_каталог.
      Прим.: В случае необязательных параметров, подобных этому, удалите первый хэш-символ (#) в строке, чтобы их использовать.
      Если компонент агент Oracle Database не установлен на сервере базы данных Oracle, который нужно отслеживать, оставьте этот параметр пустым и выполните следующий шаг.
      Прим.: (Необязательно) В случае локального мониторинга поля Домашний каталог Oracle и Каталог установки клиента экземпляра Oracle можно оставить пустыми (закомментировав их с использованием хэш-символа (#) в первой позиции строки параметра в текстовом файле конфигурации в режиме без вывода сообщений); при этом будет использоваться системная переменная среды ORACLE_HOME.
    2. Если компонент агент Oracle Database является удаленным по отношению к серверу базы данных Oracle, который нужно отслеживать, введите Каталог установки клиента экземпляра Oracle. Если вы задали значение в поле Домашний каталог Oracle в предыдущем шаге, это значение будет проигнорировано.
      • WindowsЗадайте полное имя каталога установки Oracle, который содержит файлы библиотеки Oracle Call Interface (OCI). Если полное имя файла oci.dll - C:\instantclient_10_2\oci.dll, то укажите каталог C:\instantclient_10_2. Например, KRZ_INSTANT_CLIENT_LIBPATH=C:\instantclient_10_2
      • AIXЗадайте полное имя каталога установки Oracle, который содержит файлы библиотеки Oracle Call Interface (OCI). Если полное имя файла libocci.so.10.1 - /home/tivoli/oci/libocci.so.10.1, то укажите каталог /home/tivoli/oci. Например, KRZ_INSTANT_CLIENT_LIBPATH=/home/tivoli/oci
  6. Поле Каталоги файлов конфигурации сети можно оставить пустым; будет использоваться каталог по умолчанию. Агент агент Oracle Database использует этот каталог для получения файла tnsnames.ora. Этот каталог задается переменной среды TNS_ADMIN для каждого экземпляра базы данных Oracle. Каталог по умолчанию - Linux или AIX$ORACLE_HOME/network/admin или Windows%ORACLE_HOME%\NETWORK\ADMIN. Если вы введете этот параметр, но у вас есть несколько каталогов файлов конфигурации сети, используйте для разделения каталогов символ Windows";" или Linux или AIX":".

    При удаленном мониторинге баз данных Oracle можно скопировать файлы конфигурации сети с удаленного компьютера на компьютер, на котором установлен агент. Можно также объединить контент файлов конфигурации сети на удаленном компьютере с файлами конфигурации сети на компьютере, на котором установлен агент.

  7. Для динамического приемника проверьте, сконфигурирован ли динамический приемник по умолчанию. Динамический приемник по умолчанию - (PROTOCOL=TCP)(HOST=localhost)(PORT=1521). Если динамический приемник по умолчанию сконфигурирован, задайте значение TRUE, как показано ниже: KRZ_DYNAMIC_LISTENER=TRUE.

    Допустимые значения: TRUE и FALSE.

  8. Не заполняйте поле Имя пользовательского файла определения SQL. Не используется.
  9. Начиная с этого места создаются определения фактических экземпляров соединений с базой данных. Надо добавить хотя бы один. Записи для одного экземпляра приведены в файле oracle_silent_config.txt с именем экземпляра config1. Если вы измените имя экземпляра, обязательно измените все ссылки.

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

  10. Для типа соединения задайте одно из следующих значений: Basic, TNS или Advanced. Например, KRZ_CONN_TYPE.config1=Basic.
  11. Задайте нужные параметры для типа соединения, выбранного в предыдущем шаге:
    Базовое
    • В качестве имени хоста задайте IP-адрес или имя хоста базы данных Oracle (например, KRZ_CONN_HOST.config1= имя_хоста.
    • В качестве порта задайте порт приемника базы данных Oracle (например, #KRZ_CONN_PORT.config1= 1521).
    • В качестве имени службы задайте логическое представление базы данных, используя строку для глобального имени базы данных (например, KRZ_CONN_SERVICE.config1= orcl).
      Важное замечание: Если имя службы не задано, то нужно указать системный идентификатор Oracle (System Identifier - SID).

      В качестве системного идентификатора Oracle (SID) задайте SID, который идентифицирует конкретный экземпляр работающей базы данных (например, KRZ_CONN_SID.config1= sid).

    TNS
    В качестве алиаса TNS задайте имя алиаса сети из файла tnsnames.ora. Например, KRZ_CONN_TNS.config1= tnsalias.
    Advanced
    В качестве строки соединения Oracle задайте строку соединения с базой данных для OCI. Например, KRZ_CONN_STR.config1= //хост:порт/служба
    Эта строка поддерживает все методы именования сети Oracle, как это показано ниже.
    • Для строки URL SQL Connect:
      //хост:[порт][/имя службы]
    • Для пары ключевое слово:значение сети Oracle:
      "(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp) (HOST=dlsun242) (PORT=1521)) (CONNECT_DATA=(SERVICE_NAME=bjava21)))"
    Эта строка поддерживает также записи TNSNAMES (например, inst1), где задана переменная среды TNS_ADMIN или ORACLE_HOME и сконфигурированы файлы конфигурации.
    Важное замечание: Этот атрибут применим только к расширенному типу соединения.
  12. В качестве имени пользователя базы данных можно задать имя пользователя для соединения (например, KRZ_CONN_USERID=ID_пользователя).

    У этого пользователя должны быть достаточные полномочия для выполнения операций, которые агент должен выполнить с подсоединенной базой данных (например, создание, изменение и удаление таблиц).

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

  13. В качестве пароля по умолчанию нужно указать пароль, связанный с указанным пользователем базы данных (например, KRZ_CONN_PASSWORD=пароль.

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

  14. В качестве роли можно задать набор полномочий, связанных с этим соединением (например, KRZ_CONN_MODE.config1=DEFAULT).

    Допустимые значения: SYSDBA, SYSOPER, SYSASM и DEFAULT.

    Для пользователя, которому предоставлены системные полномочия SYSDBA, можно задать соединение, в которое включены полномочия. Если этот элемент не задан, то можно назначить пользователю роль DEFAULT.

  15. Для каталогов файлов журнала оповещений Oracle, включающих в себя имя файла журнала оповещений, можно задать абсолютный путь к отображенным файлам журнала оповещений для удаленных экземпляров базы данных в этом соединении базы данных. Например, KRZ_LOG_PATHS.config1=AlertLogPath.

    WindowsДля разделения нескольких файлов используйте точку с запятой (;).

    Linux или AIXДля разделения нескольких файлов используйте двоеточие (:).

    Каждый файл сопоставляется с экземпляром базы данных по шаблону имени файла alert_экземпляр.log. Если совпадений нет, то он игнорируется.

    Файлы журнала оповещений локальных экземпляров базы данных обнаруживаются автоматически.

    Если каталоги файлов журнала оповещений Oracle не сконфигурированы, то журнал оповещений недоступен.

  16. В качестве набора символов файла журнала оповещений Oracle можно задать кодовую страницу отображенных файлов журналов оповещений. Например, KRZ_LOG_CHARSET.config1= CharSet
    Если это поле оставить пустым, то используется текущая локаль системы:
    ISO8859_1: ISO 8859-1 Western European encoding
    UTF-8: UTF-8 encoding of Unicode
    GB18030: Simplified Chinese GB18030 encoding
    CP950: Traditional Chinese encoding
    EUC_JP: Japanese encoding
    		
  17. Сохраните и закройте файл oracle_database_silent_config.txt. Затем введите:
    каталог_установки /bin/oracle_database-agent.sh config имя_экземпляра каталог_установки /samples/oracle_database_silent_config.txt
    где имя_экземпляра - это имя экземпляра.
  18. Чтобы запустить агент, введите
    каталог_установки /bin/oracle_database-agent.sh start имя_экземпляра.

Дальнейшие действия

  • Войдите в консоль консоль Cloud APM, чтобы просмотреть данные, собранные агентом, в сводных панелях. Информацию об использовании консоли консоль Cloud APM смотрите в разделе Запуск консоль Cloud APM.