Instance detection

This page describes how dbcollect detects (running) Oracle instances and their correct ORACLE_HOMEs.

Running instances

If a logons file is provided (using --logons), dbcollect will NOT automatically detect instances, but only connect to the services listed in the logons file.
If no logons file is specified, dbcollect runs the command ps -eo pid,user,group,args to find all running processes on the OS.
Running instances are matched if the args match ora_pmon_<oracle_sid>
If the --included option is given, only instances that are explicitly included will be processed (a warning message is given for non-included instances)
If the --excluded option is given, only instances that are not explicitly excluded will be processed (a warning message is given for excluded instances)