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

Red Hat Update Infrastructure Management Tool logs

/var/log/messages

Pulp logs; for example, repository synchronization

/var/log/nginx/access.log and error.log

nginx logs

/var/log/rhui/rhua_ansible.log

CDS and HAproxy management log, service status log

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

Subscription synchronization log

/var/log/rhui/rhui-export-repos.log

Repository export log

/var/log/rhui/rhui-purge-upload-dirs.log

Temporary directory cleanup log

/var/log/rhui/rhui-update-mappings.log

Repository version mapping log

Content Delivery Server

/var/log/nginx/access.log and error.log

nginx logs

/var/log/nginx/ssl-access.log*

clients' requests for content

/var/log/nginx/gunicorn-auth.log

CDS authorizer plug-in logs; by default, requests without an entitlment certificate

/var/log/nginx/gunicorn-content_manager.log

CDS content manager plug-in logs; for example, on-demand package downloads

/var/log/nginx/gunicorn-mirror.log

CDS mirror plug-in logs; by default, only logs from starting and stopping the plug-in

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