Diagnostic Logging

pblogd, pbrun, pbmasterd, pblocald, pblogd, pbksh, pbsh, and pbguid can produce diagnostic messages that can be stored in individual files.

kshlog

• Version 3.5 and earlier: kshlog setting not available.
• Version 4.0 and later: kshlog setting available.

kshlog contains the name of the pbksh diagnostic log file.

kshlog /var/log/pbksh.log

Default

During the install, depending on the operating system standards, this can be any of the following:

kshlog /var/log/pbksh.log

kshlog /usr/log/pbksh.log

kshlog /var/adm/pbksh.log

kshlog /usr/adm/pbksh.log

Used on

Submit hosts

pbguidlog

• Version 4.0.0 and later: pbguidlog setting available.

pbguidlog contains the name of the pbguid diagnostic log file.

pbguidlog /var/log/pbguid.log

Default

During the install, depending on the operating system standards, this can be any of the following:

pbguidlog /var/log/pbguid.log

pbguidlog /usr/log/pbguid.log

pbguidlog /var/adm/pbguid.log

pbguidlog /usr/adm/pbguid.log

Used on

GUI hosts

pblocaldlog

• Version 4.0.0 and later: pblocaldlog setting available.

pblocaldlog contains the name of the pblocald diagnostic log file.

This keyword does not apply to pbssh. If it is present in the settings file, it does not have any effect on pbssh and is ignored.

pblocaldlog /var/log/pblocald.log

Default

During the install, depending on the operating system standards, this can be any of the following:

pblocaldlog /var/log/pblocald.log

pblocaldlog /usr/log/pblocald.log

pblocaldlog /var/adm/pblocald.log

pblocaldlog /usr/adm/pblocald.log

Used on

Run hosts

pblogdlog

• Version 4.0.0 and later: pblogdlog setting available.

pblogdlog contains the name of the pblogd diagnostic log file.

pblogdlog /var/log/pblogd.log

Default

During the install, depending on the operating system standards, this can be any of the following:

pblogdlog /var/log/pblogd.log

pblogdlog /usr/log/pblogd.log

pblogdlog /var/adm/pblogd.log

pblogdlog /usr/adm/pblogd.log

Used on

Log hosts

pbmasterdlog

• Version 4.0.0 and later: pbmasterdlog setting available.

pbmasterdlog contains the name of the pbmasterd diagnostic log file.

pbmasterdlog /var/log/pbmasterd.log

Default

During the install, depending on the operating system standards, this can be any of the following:

pbmasterdlog /var/log/pbmasterd.log

pbmasterdlog /usr/log/pbmasterd.log

pbmasterdlog /var/adm/pbmasterd.log

pbmasterdlog /usr/adm/pbmasterd.log

Used on

Policy server hosts

pbrunlog

• Version 4.0.0 and later: pbrunlog setting available.

pbrunlog contains the name of the pbrun diagnostic log file.

pbrunlog /var/log/pbrun.log

Default

No default value

Used on

Submit hosts

pbpinglog

• Version 6.2 and earlier: pbpinglog setting not available.
• Version 7.0 and later: pbpinglog setting available.

pbpinglog contains the name of the pbping diagnostic log file.

pbpinglog /var/log/pbping.log

Default

No default value

Used on

Policy server hosts

shlog

• Version 3.5 and earlier: shlog setting not available.
• Version 4.0 and later: shlog setting available.

shlog contains the name of the pbsh diagnostic log file.

shlog /var/log/pbsh.log

Default

During the install, depending on the operating system standards, this can be any of the following:

shlog /var/log/pbsh.log

shlog /usr/log/pbsh.log

shlog /var/adm/pbsh.log

shlog /usr/adm/pbsh.log

Used on

Submit hosts

enabletraceonexit

• Version 22.2.0 and later: enabletraceonexit setting available.

Controls extended diagnostic logging when certain error conditions are encountered.

This should only be used in coordination with BeyondTrust Technical Support.

This is disabled (set to no) by default.

Example

enabletraceonexit yes

Default

no

Used on

All EPM-UL hosts

pbadminlog

• Version 22.1 and earlier: pbadminlog setting not available.
• Version 22.2 and later: pbadminlog available.

The pbadminlog setting defines the pathname of the log file containing any diagnostics messages generated when running the pbadmin program.

pbadmin is the same program as pbdbutil, which may still be referenced in this documentation.

The pbadmin program is used during the installation of EPM-UL. Immediately after running pbinstall for the first time on a host, you may find this log entry which can be ignored:

3887.22 Error retrieving license - Failed to retrieve your license

Example

Depending on the operating system standards, this can be any of the following:

/var/log/<prefix>pbadmin.log<suffix>

/var/adm/<prefix>pbadmin.log<suffix>

/usr/adm/<prefix>pbadmin.log<suffix>

Default

pbadminlog /var/log/pbadmin.log

Used On

All hosts