Este contenido no está disponible en el idioma seleccionado.

Chapter 10. Troubleshooting the DNS service


By reviewing the Red Hat OpenStack Platform DNS service (designate) logs and using some simple commands, you can verify that the service is running properly. These actions are the first steps in troubleshooting the DNS service.

The topics included in this section are:

10.1. DNS service and BIND logs

Reviewing the Red Hat OpenStack Platform DNS service (designate) logs, can be useful when troubleshooting issues.

The DNS service logs are located in /var/log/containers/designate. There is one log for each of the component services:

  • central.log
  • designate-api.log
  • mdns.log
  • producer.log
  • worker.log

The logs for the BIND server that Red Hat supplies with the RHOSP DNS service are located in /var/log/containers/designate/designate-bind:

  • central.log
  • designate-api.log

10.2. Exporting the DNS service pool configuration

You can use a copy of the DNS pool configuration to troubleshoot the Red Hat OpenStack Platform (RHOSP) DNS service (designate).

Note

In RHOSP 17.1, multiple pools are not supported.

Procedure

  1. Log in to one of the Controller nodes and display the current running DNS service pool configuration to the console.

    Example

    In this example, the administrator accesses a Controller node, controller-0.ctlplane, through SSH as the tripleo-admin user and executes the designate-manage pool show_config command running in the designate_central container:

    $ ssh tripleo-admin@controller-0.ctlplane sudo podman exec \
    designate_central designate-manage pool show_config
    Copy to Clipboard Toggle word wrap

    Sample output

    Pool Configuration:
    -------------------
    also_notifies: []
    attributes: {}
    description: Default Pool
    id: 794ccc2c-d751-44fe-b57f-8894c9f5c842
    name: default
    nameservers:
    - host: 192.0.2.111
      port: 53
    - host: 192.0.2.109
      port: 53
    - host: 192.0.2.131
      port: 53
    ns_records:
    - hostname: ns2.example.com.
      priority: 2
    - hostname: ns1.example.com.
      priority: 1
    - hostname: ns3.example.com.
      priority: 3
    targets:
    - description: BIND9 Server 3
      masters:
      - host: 192.0.2.137
        port: 16002
      - host: 192.0.2.137
        port: 16001
      - host: 192.0.2.137
        port: 16000
      options:
        host: 192.0.2.111
        port: '53'
        rndc_config_file: /etc/designate/private/bind3.conf
        rndc_host: 192.0.2.111
        rndc_port: '953'
      type: bind9
    - description: BIND9 Server 2
      masters:
      - host: 192.0.2.137
        port: 16001
      - host: 192.0.2.137
        port: 16002
      - host: 192.0.2.137
        port: 16000
      options:
        host: 192.0.2.131
        port: '53'
        rndc_config_file: /etc/designate/private/bind2.conf
        rndc_host: 192.0.2.131
        rndc_port: '953'
      type: bind9
    - description: BIND9 Server 1
      masters:
      - host: 192.0.2.137
        port: 16002
      - host: 192.0.2.137
        port: 16001
      - host: 192.0.2.137
        port: 16000
      options:
        host: 192.0.2.109
        port: '53'
        rndc_config_file: /etc/designate/private/bind1.conf
        rndc_host: 192.0.2.109
        rndc_port: '953'
      type: bind9
    Copy to Clipboard Toggle word wrap

  2. If you want to export the current pool configuration to a file, use the designate-manage pool generate_file command.

    Example

    In this example, the administrator accesses a Controller node, controller-0.ctlplane, through SSH as the tripleo-admin user and executes the designate-manage pool generate_file --file <file_name> command running in the designate_central container. The DNS service exports the current pool configuration to a file that is specified by the --file option, in this example, ~/my_dns_service_config.yaml:

    $ ssh tripleo-admin@controller-0.ctlplane sudo podman exec \
    designate_central designate-manage pool generate_file \
    --file ~/my_dns_service_config.yaml
    Copy to Clipboard Toggle word wrap
    Tip

    Use the podman cp command to copy files from a container to your local system.

10.3. Listing available DNS service endpoints

Determining the Red Hat OpenStack Platform DNS service (designate) endpoint and its status, can be useful when troubleshooting issues.

Procedure

  1. Source your credentials file.

    Example

    $ source ~/overcloudrc
    Copy to Clipboard Toggle word wrap
  2. List the available RHOSP service endpoints:

    $ openstack endpoint list --service designate -c Interface -c URL
    Copy to Clipboard Toggle word wrap

    Sample output

    +-----------+-------------------------+
    | Interface | URL                     |
    +-----------+-------------------------+
    | internal  | http://172.17.1.44:9001 |
    | public    | http://10.0.0.147:9001  |
    | admin     | http://172.17.1.44:9001 |
    +-----------+-------------------------+
    Copy to Clipboard Toggle word wrap

Volver arriba
Red Hat logoGithubredditYoutubeTwitter

Aprender

Pruebe, compre y venda

Comunidades

Acerca de la documentación de Red Hat

Ayudamos a los usuarios de Red Hat a innovar y alcanzar sus objetivos con nuestros productos y servicios con contenido en el que pueden confiar. Explore nuestras recientes actualizaciones.

Hacer que el código abierto sea más inclusivo

Red Hat se compromete a reemplazar el lenguaje problemático en nuestro código, documentación y propiedades web. Para más detalles, consulte el Blog de Red Hat.

Acerca de Red Hat

Ofrecemos soluciones reforzadas que facilitan a las empresas trabajar en plataformas y entornos, desde el centro de datos central hasta el perímetro de la red.

Theme

© 2025 Red Hat