Recherche dans <book_title>…

Guide de dépannage NetBackup™

Last Published: 2024-05-14

Product(s): NetBackup & Alta Data Protection (10.4)

Résolution des problèmes liés au service NetBackup Messaging Broker (ou nbmqbroker)

Le service NetBackup Messaging Broker ne s'exécute pas

Procédez comme suit :

Assurez-vous que le service est configuré et démarré sur le serveur principal. Pour configurer le service, exécutez la commande configureMQ.
Consultez le Guide de référence des commandes NetBackup.

Le service NetBackup Messaging Broker ne démarre pas

Raisons :

Les ports configurés pour le service sont utilisés par un autre processus.
Le fichier de configuration est endommagé.

Procédez comme suit :

Vérifiez les journaux de la commande configureMQ pour découvrir les défaillances.
Vérifiez les journaux du service nbmqbroker pour découvrir les défaillances.
Exécutez la commande configureMQ.
Consultez le Guide de référence des commandes NetBackup.

Le service NetBackup Messaging Broker n'est pas connecté au client NAT

Raisons :

Le port configuré pour le service n'est pas disponible.
Échec de la connexion avec quelques exceptions SSL.
Le service nbmqbroker ne redémarre pas après l'exécution de la commande configureWebServerCerts sur le serveur principal.

Procédez comme suit :

Assurez-vous que le port configuré pour le service nbmqbroker est disponible et accessible aux hôtes NetBackup.
Vérifiez la connectivité entre le serveur principal et le client NAT en utilisant la commande nbcertcmd -ping.
- Si la commande n'est pas correctement exécutée, consultez la section de dépannage pour NetBackup Web Service.
- Si la commande est exécutée correctement, exécutez la commande configureMQ pour configurer le service nbmqbroker.
Redémarrez le service nbmqbroker.

L'abonné ou l'éditeur ne peut pas se connecter au service NetBackup Messaging Broker.

Raisons :

Impossible d'actualiser le jeton Web JSON (JWT) du client NAT.
Le certificat de sécurité du client NAT est révoqué.
Le service NetBackup Web Management Console (ou nbwmc) n'est pas en cours d'exécution.

Procédez comme suit :

Consultez les étapes de dépannage de l'abonné.
Si le certificat de sécurité du client est révoqué, émettez-le à nouveau.
Démarrez le service nbwmc.

Le service NetBackup Messaging Broker ne démarre pas après une reprise après incident.

Raisons :

Le package de reprise après incident est perdu.
La commande configureMQ n'a pas été exécutée après l'installation de reprise après incident.

Procédez comme suit :

Exécutez la commande configureMQ ou configureMQ -defaultPorts.
Consultez le Guide de référence des commandes NetBackup.

Le démarrage du service NetBackup Messaging Broker échoue sous Windows si le paramètre de nom de fichier court 8dot3 est désactivé sur le volume où NetBackup est installé

Pour vérifier si le paramètre de nom de fichier 8dot3 est activé pour le dossier racine d'installation, exécutez la commande suivante à partir de votre dossier :

>dir /x

Exemple : le paramètre de nom de fichier 8dot3 est activé pour le répertoire « Program Files » ; le nom court « PROGRA~1 » est donc généré,

mais il diffère pour le répertoire « not8 Dot3 ».

C:\>dir /x

Le volume du lecteur C n'est pas étiqueté.

Le numéro de série de volume est FE21-2F8E

Répertoire de C:\

-5.6.3

12/06/2019  02:24 PM    <DIR>   	            not8 Dot3

12/02/2019  06:35 AM    <DIR>   PROGRA~1     Program Files

12/02/2019  10:44 AM    <DIR>   PROGRA~2     Program Files (x86)

Pour résoudre ce problème, procédez comme suit :

Activez le paramètre de nom de fichier 8dot3 pour le dossier racine d'installation NetBackup à l'aide de la commande fsutil.
Consultez l'article suivant : Fsutil 8dot3name
Si le problème persiste, contactez le support technique.

Le service de courtier de messagerie NetBackup se comporte de manière inattendue après la restauration du package de reprise après incident en cas de configuration de l'autorité de certification externe

Imaginez le scénario suivant :

NetBackup est configuré pour utiliser uniquement les certificats signés par l'autorité de certification externe lors de la sauvegarde du catalogue. Par conséquent, le package de reprise après incident créé lors de la sauvegarde du catalogue contient les certificats externes requis. Si l'identité de l'hôte est récupérée à l'aide de ce package de reprise après incident après l'installation de NetBackup, le service nbmqbroker peut se comporter de manière inattendue en raison des certificats signés par l'autorité de certification NetBackup qui ont été émis lors de l'installation.

Pour résoudre le problème

Vérifiez si votre environnement NetBackup utilise uniquement des certificats signés par une autorité de certification externe. Exécutez la commande suivante :
nbcertcmd -getSecConfig -caUsage
Vérifiez les certificats utilisés par le service nbmqbroker. Exécutez la commande suivante :
Sous UNIX : cat /usr/openv/var/global/mqbroker/mqbroker.config | grep ssl_options
Sous Windows : type "NetBackup_Install_path\var\global\mqbroker\mqbroker.config" | findstr "ssl_options"
Si seuls des certificats signés par une autorité de certification externe sont utilisés dans votre environnement, la commande affiche le chemin d'accès avec l'entrée externalcacreds.
Si la commande affiche le chemin d'accès avec l'entrée nbcacreds, des certificats signés par une autorité de certification NetBackup sont utilisés.
Par exemple :
{ssl_options, [{cacertfile, "/usr/openv/var/global/mqbroker/certstore/nbcacreds/ca.pem"}, {ssl_options, [{cacertfile, "/usr/openv/var/global/mqbroker/certstore/nbcacreds/ca.pem"},
Vous devez supprimer les certificats NetBackup de sorte que le service nbmqbroker fonctionne correctement.
Exécutez la commande suivante pour supprimer les certificats NetBackup :
configureWebServerCerts -removeNBCert
Redémarrez le service NetBackup Web Management Console (nbwmc) et le service nbqmbroker pour appliquer les modifications.
Vérifiez les certificats utilisés par le service nbmqbroker. Exécutez la commande suivante :
Sous UNIX : cat /usr/openv/var/global/mqbroker/mqbroker.config | grep ssl_options
Sous Windows : type "NetBackup_Install_path\var\global\mqbroker\mqbroker.config" | findstr "ssl_options"
Sortie attendue pour le mode certificat externe uniquement :
{ssl_options, [{cacertfile, "/usr/openv/var/global/mqbroker/certstore/externalcacreds/ca.pem"}, {ssl_options, [{cacertfile, "/usr/openv/var/global/mqbroker/certstore/externalcacreds/ca.pem"},
Se reporter à Restauration de package de reprise après incident sous Unix.
Se reporter à Restauration de package de reprise après incident sous Windows.

Les nouvelles notifications spécifiques au service nbmqbroker ne sont pas affichées dans l'interface utilisateur Web NetBackup sous Linux.

Les journaux du service nbmqbroker affichent les erreurs suivantes :

escript: exception error: undefined function rabbitmqctl_escript:main/1

in function  escript:run/2 (escript.erl, line 758)

in call from escript:start/1 (escript.erl, line 277)

in call from init:start_em/1

in call from init:do_boot/3

Origine du problème :

Certains changements apportés à la configuration sur le serveur principal peuvent entraîner une incohérence dans la configuration du service nbmqbroker. Pour résoudre le problème, vous devez reconfigurer le service nbmqbroker.

Pour reconfigurer le service nbmqbroker :

Arrêtez le service nbmqbroker en exécutant la commande suivante :
/usr/openv/mqbroker/bin/nbmqbroker stop
Exécutez la commande suivante pour configurer l'environnement nbmqbroker :
/usr/openv/mqbroker/bin/install/configureMQEnv
Exécutez la commande suivante pour configurer le service nbmqbroker :
/usr/openv/mqbroker/bin/install/configureMQ
Démarrez le service nbmqbroker en exécutant l'une des commandes suivantes :
- /usr/openv/mqbroker/bin/nbmqbroker start
- bp.start_all command
Pour plus d'informations sur les commandes, consultez le Guide de référence des commandes NetBackup.

Le service NetBackup Messaging Broker ne démarre pas sur un serveur principal qui utilise uniquement IPv6

Raisons :

Le nom du serveur principal est probablement résolu en adresses IPv4 et IPv6, alors que seule l'adresse IPv6 est utilisée.

Exécutez la commande suivante pour vérifier si la sortie contient une adresse IPv4 : nslookup primary_server_name

Exemple de sortie :

# nslookup primary-server.com

Server: 2600:100:f0a1:9000::a

Address: 2600:100:f0a1:9000::a#53

Non-authoritative answer:

Name: primary-server.com

Address: 10.200.100.60

Name: primary-server.com

Address: 2600:100:f0a1:9014::335

Sortie attendue :

# nslookup primary-server.com

Server: 2600:100:f0a1:9000::a

Address: 2600:100:f0a1:9000::a#53

Non-authoritative answer:

Name: primary-server.com

Address: 2600:100:f0a1:9014::335

Procédez comme suit :

Réparez toutes les configurations pour créer une installation appropriée pour IPv6 uniquement.
Si le problème persiste, apportez les modifications de configuration suivantes pour démarrer le service nbmqbroker.
Avec cette configuration, le service nbmqbroker tentera toujours d'utiliser l'adresse IPv6 en premier lieu pour la résolution du nom.

Pour modifier les configurations

Procédez comme suit pour créer le fichier requis.
À l'aide d'un éditeur de texte approprié (vi sous Linux ou le bloc-notes sous Windows), créez un fichier nommé erl_inetrc dans le répertoire indiqué :
Sous Linux, créez le fichier erl_inetrc dans le répertoire suivant :
/usr/openv/var/global/mqbroker/erl_inetrc
Exécutez la commande suivante :
cat > /usr/openv/var/global/mqbroker/erl_inetrc
Sous Windows, créez le fichier erl_inetrc dans le répertoire suivant : NetBackup_Install_path\var\global\mqbroker\
Ajoutez la ligne suivante au fichier erl_inetrc :
{inet6,true}.
Notez que le point final (.) est obligatoire.
Sous UNIX, exécutez la commande suivante pour vérifier les autorisations du fichier /usr/openv/mqbroker/bin/setmqenv :
ls -l /usr/openv/mqbroker/bin/setmqenv
La sortie est la suivante :
```
-rwxr-x---. 1 nbwebsvc nbwebgrp 3869 date
 /usr/openv/mqbroker/bin/setmqenv
```
Procédez comme suit :
Sous Linux :
Ajoutez les lignes suivantes au fichier /usr/openv/var/global/mqbroker/advanced_setmqenv :
RABBITMQ_SERVER_ADDITIONAL_ERL_ARGS="-kernel inetrc '/usr/openv/var/global/mqbroker/erl_inetrc' -proto_dist inet6_tcp"
RABBITMQ_CTL_ERL_ARGS="-proto_dist inet6_tcp"
Sous Windows :
Ajoutez les lignes suivantes au fichier NetBackup_Install_path\var\global\mqbroker\advanced_setmqenv :
RABBITMQ_SERVER_ADDITIONAL_ERL_ARGS=-kernel inetrc 'E:/NetBackup/var/global/mqbroker/erl_inetrc' -proto_dist inet6_tcp
RABBITMQ_CTL_ERL_ARGS=-proto_dist inet6_tcp
Assurez-vous que les autorisations de fichier ne sont pas modifiées après la mise à jour.
Démarrez le service nbmqbroker.