pmdaoracle(1)

NAMN

pmdaoracle – PMDA för Oracle-databas

BESKRIVNING

pmdaoracle är en Performance Co-Pilot-PMDA som hämtar liveprestandadata från en körande Oracle-databas.

INSTALLATION

pmdaoracle använder en konfigurationsfil från följande platser, i denna ordning:

• /etc/pcpdbi.conf
• $PCP_PMDAS_DIR/oracle/oracle.conf
• ./oracle.conf

Denna fil kan innehålla överskrivna värden, i Perl-kod, för inställningarna som listas i början av pmdaoracle.pl, till exempel:

• $username – användarnamn för anslutning till databasen. Standardvärde: SYSTEM.
• $password – lösenord för anslutning till databasen. Standardvärde: manager.
• $host – värden där databasen körs. Standardvärde: localhost.
• $port – porten som databasen lyssnar på. Standardvärde: 1521.
• $os_user – operativsystemets användarnamn. PMDA:n körs med motsvarande användar-ID. Standardvärde: oracle.
• @sids – en array med databasidentifierare från $ORACLE_SID. Standardvärde: ('master').

För att testa de lokala inställningarna finns ett enkelt skript som ansluter till och kopplar från databasen. Det verifierar att den grundläggande konfigurationen finns på plats innan installationen fortsätter.

Om skriptet:

$PCP_PMDAS_DIR/oracle/connect.pl

inte kan ansluta ska du inte fortsätta med installationen av PMDA:n, eftersom den då inte kommer att lyckas. Korrigera först de lokala inställningarna.

När detta är konfigurerat kan du komma åt namn och värden för Oracle-prestandamätvärdena genom att göra följande som root:

# cd $PCP_PMDAS_DIR/oracle
# ./Install

För att avinstallera ska följande göras som root:

# cd $PCP_PMDAS_DIR/oracle
# ./Remove

pmdaoracle startas av pmcd(1) och ska aldrig köras direkt. Skripten Install och Remove meddelar pmcd(1) när agenten installeras eller tas bort.

ANSLUTNINGSTILLSTÅND

Som standard försöker pmdaoracle aktivt upprätthålla beständiga anslutningar till Oracle för att säkerställa snabba svar på sina frågor. Den återansluter automatiskt om en anslutning bryts.

I vissa situationer kan detta dock vara oönskat. Därför finns en manuell pmStore(3)-mekanism för att uttryckligen styra frånkoppling och återanslutning till en Oracle-instans.

Detta kan till exempel användas för att säkerställa att pmdaoracle inte är ansluten vid avstängning, så att Oracle kan stängas av rent.

Kommandot pmstore(1) kan användas för att koppla från och återansluta. Genom de individuella instanserna av mätvärdet oracle.control.connected kan anslutningstillståndet sättas till antingen uppe, 1, eller nere, 0.

Dessutom kan pminfo(1) rapportera aktuell status för Oracle-anslutningar.

# pminfo -f oracle.control.connected

oracle.control.connected
    inst [0 or "master"] value 1

# pmstore oracle.control.connected 0
oracle.control.connected inst [0 or "master"] old value=1 new value=0

FILER

/etc/pcpdbi.conf

Konfigurationsfil för alla PCP-databasövervakare.

$PCP_PMDAS_DIR/oracle/oracle.conf

Konfigurationsfil för pmdaoracle.

$PCP_PMDAS_DIR/oracle/sample.conf

Exempel på konfigurationsfil för pmdaoracle med $LD_LIBRARY_PATH.

$PCP_PMDAS_DIR/oracle/connect.pl

Konfigurationstestskript för anslutning till Oracle-databas.

$PCP_PMDAS_DIR/oracle/Install

Installationsskript för agenten pmdaoracle.

$PCP_PMDAS_DIR/oracle/Remove

Skript för att ångra installationen av agenten pmdaoracle.

$PCP_LOG_DIR/pmcd/oracle.log

Standardloggfil för felmeddelanden från pmdaoracle.

PCP-MILJÖ

Miljövariabler med prefixet PCP_ används för att parameterisera fil- och katalognamn som används av PCP.

På varje installation innehåller filen /etc/pcp.conf de lokala värdena för dessa variabler.

Variabeln $PCP_CONF kan användas för att ange en alternativ konfigurationsfil, enligt beskrivningen i pcp.conf(5).

SE ÄVEN

• PCPIntro(1)
• pmdadbping(1)
• pminfo(1)
• pmstore(1)
• DBI(3)
• pmStore(3)

KOLOFON

Den här sidan är en del av projektet PCP – Performance Co-Pilot.

Information om projektet finns på:

• http://www.pcp.io/

Om du har en felrapport för denna manualsida, skicka den till:

• pcp@groups.io

Denna sida hämtades från projektets uppströms Git-arkiv:

• https://github.com/performancecopilot/pcp.git

Sidan hämtades den 16 januari 2026. Vid den tidpunkten var datumet för den senaste commit som hittades i arkivet den 16 januari 2026.

Om du upptäcker renderingsproblem i denna HTML-version av sidan, känner till en bättre eller mer uppdaterad källa, eller har rättelser eller förbättringar av informationen i denna kolofon, som inte är en del av den ursprungliga manualsidan, skicka e-post till:

• man-pages@man7.org

Sidinformation

Projekt: Performance Co-Pilot, PCP.

HTML-renderingen skapades den 16 januari 2026 av Michael Kerrisk, författare till The Linux Programming Interface.

Mer information om Linux- och UNIX-systemprogrammeringskurser finns på:

• https://man7.org/training/