• Non-CDB:

  -- Для Oracle 11g эту строку не выполняйте.
  ALTER SESSION SET "_ORACLE_SCRIPT"=true;
  
  CREATE USER protoobp IDENTIFIED BY "<PASSWORD>";
  GRANT CONNECT TO protoobp;
  GRANT SELECT ON GV_$PROCESS TO protoobp;
  GRANT SELECT ON GV_$SYSMETRIC TO protoobp;
  GRANT SELECT ON SYS.DBA_DATA_FILES TO protoobp;
  GRANT SELECT ON SYS.DBA_TABLESPACES TO protoobp;
  GRANT SELECT ON SYS.DBA_TABLESPACE_USAGE_METRICS TO protoobp;
  

• Мультитенантная база (CDB), Oracle 12c и 19c — в корневом контейнере:

  ALTER SESSION SET CONTAINER = CDB$ROOT;
  CREATE USER c##protoobp IDENTIFIED BY "<PASSWORD>" CONTAINER=ALL;
  GRANT CREATE SESSION TO c##protoobp CONTAINER=ALL;
  GRANT SELECT ANY DICTIONARY TO c##protoobp CONTAINER=ALL;
  GRANT SELECT ON GV_$PROCESS TO c##protoobp CONTAINER=ALL;
  GRANT SELECT ON GV_$SYSMETRIC TO c##protoobp CONTAINER=ALL;
  

Клиентских библиотек Oracle в составе агента 7.40.2 нет. Агент выбирает способ подключения автоматически:

1. если на хосте найден Oracle Instant Client — подключается через него;
2. иначе — через JDBC-драйвер. Этот способ работает только на Linux и требует Java 8 или новее.

Установите один из двух клиентов. Если не установлен ни один, либо Instant Client установлен, но агент не находит его библиотеки, проверка переходит на JDBC и завершается ошибкой No JVM shared library file (libjvm.so) found.

Oracle Instant Client — Linux

1. Скачайте с сайта Oracle пакеты Instant Client Basic и Instant Client SDK и распакуйте оба в один общий каталог, например /opt/oracle:

   mkdir -p /opt/oracle && cd /opt/oracle
   unzip instantclient-basic-linux.x64-<VERSION>.zip
   unzip instantclient-sdk-linux.x64-<VERSION>.zip
   

2. Сделайте библиотеки доступными для компоновщика:

   echo /opt/oracle/instantclient_<VERSION> > /etc/ld.so.conf.d/oracle-instantclient.conf
   ldconfig
   

Oracle Instant Client — Windows

1. Установите Microsoft Visual C++ Redistributable нужной для Instant Client версии.
2. Распакуйте Instant Client Basic и Instant Client SDK в один общий каталог, например C:\oracle\instantclient_19.
3. Добавьте этот каталог в системную переменную PATH (служба агента не видит пользовательские переменные) и перезапустите службу агента.

На Windows JDBC не поддерживается — Instant Client обязателен.

JDBC-драйвер — только Linux

1. Установите Java 8 или новее (например, пакет openjdk-11-jre-headless).

2. Скачайте с сайта Oracle JDBC-драйвер (ojdbc8.jar или новее) и положите в каталог, доступный пользователю агента pobp-agent, например /opt/oracle/jdbc/ojdbc8.jar.

3. Укажите путь к файлу в параметре jdbc_driver_path конфигурации проверки (см. Конфигурация ProtoOBP агента).

4. Если Java установлена не в стандартный каталог /usr/lib/jvm, передайте агенту JAVA_HOME. В 7.40.2 служба агента не читает /etc/protoobp-agent/environment, поэтому используйте drop-in:

   mkdir -p /etc/systemd/system/protoobp-agent.service.d
   cat > /etc/systemd/system/protoobp-agent.service.d/oracle.conf <<'EOF'
   [Service]
   Environment=JAVA_HOME=/usr/lib/jvm/<JAVA_DIR>
   EOF
   systemctl daemon-reload
   

init_config:

instances:
  - server: <ORACLE_HOST>:1521
    # SELECT value FROM v$parameter WHERE name='service_names'
    service_name: <SERVICE_NAME>
    username: protoobp          # для CDB — c##protoobp
    password: "<PASSWORD>"
    # Только при подключении через JDBC:
    # jdbc_driver_path: /opt/oracle/jdbc/ojdbc8.jar
    tags:
      - env:<ENV>

Подключение по TCPS — укажите protocol: TCPS и порт TCPS-слушателя:

instances:
  - server: <ORACLE_HOST>:2484
    service_name: <SERVICE_NAME>
    username: protoobp
    password: "<PASSWORD>"
    protocol: TCPS

• Через Instant Client настройки SSL (wallet) берутся из sqlnet.ora клиента. Проверьте подключение с хоста агента:

  sqlplus <USER>/<PASSWORD>@"(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCPS)(HOST=<HOST>)(PORT=<PORT>)))(CONNECT_DATA=(SERVICE_NAME=<SERVICE_NAME>)))"
  

• Через JDBC обязательно укажите хранилище доверенных сертификатов:

      jdbc_driver_path: /opt/oracle/jdbc/ojdbc8.jar
      jdbc_truststore_path: /opt/oracle/truststore/cwallet.sso
      jdbc_truststore_type: SSO          # JKS, SSO или PKCS12
      # jdbc_truststore_password: <TRUSTSTORE_PASSWORD>  # для SSO не нужен
  

Перезапустите агента:

• Linux — systemctl restart protoobp-agent
• Windows — "C:\Program Files\Protoobp\Protoobp Agent\bin\agent.exe" restart-service

В контейнере используется подключение через JDBC: Java есть только в образе агента с суффиксом -jmx.

1. Смонтируйте JDBC-драйвер в контейнер агента, например /opt/oracle/jdbc/ojdbc8.jar:/opt/oracle/jdbc/ojdbc8.jar:ro.

2. Добавьте autodiscovery-лейблы к Docker контейнеру с OracleDB.

   • в docker-compose.yaml

     labels:
       com.protoobp.ad.check_names: '["oracle"]'
       com.protoobp.ad.init_configs: "[{}]"
       com.protoobp.ad.instances: '[{"server": "%%host%%:1521", "service_name": "<SERVICE_NAME>", "username": "protoobp", "password": "<PASSWORD>", "jdbc_driver_path": "/opt/oracle/jdbc/ojdbc8.jar"}]'
     

   • или в Dockerfile

     LABEL "com.protoobp.ad.check_names"='["oracle"]'
     LABEL "com.protoobp.ad.init_configs"='[{}]'
     LABEL "com.protoobp.ad.instances"='[{"server": "%%host%%:1521", "service_name": "<SERVICE_NAME>", "username": "protoobp", "password": "<PASSWORD>", "jdbc_driver_path": "/opt/oracle/jdbc/ojdbc8.jar"}]'
     

3. Примените изменения лейблов для контейнера с OracleDB (перезапуском контейнера), а также перезапустите контейнер с агентом ProtoOBP.