Chapter 9. Configuration files, exit codes, and log files

Red Hat Update Appliance

/etc/pulp/*

Pulp config files

/etc/rhui/rhui-tools.conf

rhui-manager config files

/etc/pki/rhui/*

Certificates for Red Hat Update Infrastructure

/root/.rhui/answers.yaml

Used to set up the RHUA

/etc/rhui/rhui-subscription-sync.conf

Configuration for the subscription synchronization script

Content Delivery Server

/etc/pki/rhui/certs/

Certificates for CDS

HAProxy

/etc/haproxy/haproxy.cfg

HAProxy configuration file

0

Success

1

General error or a repository synchronization error

2

SSL certificate error on a CDS

32

Entitlement CA or SSL certificate expiration warning

64

Entitlement CA or SSL certificate expiration error

128

One or more RHUI services is not running on the RHUA, CDS, or HAProxy nodes

239

A repository could not be deleted because it does not exist.

240

There was an issue with a required resource. For example, it was impossible to build a client configuration RPM because no valid repository was found.

241

A synchronization task could not be scheduled because an unknown repository was specified.

To troubleshoot

* Check the spelling * Add the repository first * Check logs for Pulp issues

242

A custom repository could not be created due to a Pulp issue. Check the message and logs for details.

243

Red Hat repositories could not be added because some of them already exist in RHUI and some of them were not available in the entitlement.

244

A custom repository could not be created because it already exists in RHUI.

245

A Red Hat repository could not be added because it already exists in RHUI.

246

A Red Hat repository could not be added because it is not available in the entitlement. Check the spelling or remove the repository mapping cache using the command rm -f /var/cache/rhui/*, and try again.

247

A Red Hat repository could not be added due to a Pulp issue. Check the message and logs for details.

248

Migration from RHUI 3 to RHUI 4 was stopped because one or more Red Hat repositories are already present in RHUI 4. You must remove the repositories or use the --force flag.

249

The RHUI configuration, /etc/rhui/rhui-tools.conf, is invalid. Check the message for details.

250

The entitlement certificate is not writable.

251

The entitlement certificate has expired.

252

The entitlement certificate is invalid because it does not contain RHUI repositories.

253

The entitlement certificate file is not a valid certificate.

254

Command-line Error: The RHUI CLI could not run due to a network issue.

255

Argument Error: A required argument was not supplied.

Red Hat Update Appliance

/root/.rhui/rhui.log*, assuming rhui-manager is run as root

Red Hat Update Infrastructure Management Tool logs

/var/log/messages

The most recent four versions are kept in addition to the currently written file.

/var/log/nginx/*

NGINX logs

/var/log/messages

Qpid logs

/var/log/rhui-subscription-sync.log

Subscription synchronization log

Content Delivery Server

/var/log/nginx/*

NGINX logs

/nginx/ssl-access.log

Sample Logging – Successful yum repolist: the CDS nodes log this client activity

Client

/var/log/yum.log for RHEL 7 and earlier versions

yum command logs

Client

/var/log/dnf.log for RHEL 8 and later versions

dnf command logs

/var/log/messages

Client syslog

Console output from yum/dnf commands