Guide de référence de Veritas NetBackup™ WebSocket Service (NBWSS)

Last Published:
Product(s): NetBackup & Alta Data Protection (8.1.1)
  1. Utilisation de NetBackup WebSocket Service (NBWSS) pour la communication avec une application cloud
    1.  
      Mises à jour de ce guide pour NetBackup 8.1.1
    2.  
      Documentation supplémentaire sur les API NetBackup
    3.  
      A propos du NetBackup WebSocket Service (NBWSS)
    4.  
      Présentation de la tâche de configuration de la communication NBWSS
    5.  
      Remarques sur les connexions de NetBackup aux applications cloud
    6.  
      Formats de message NBWSS
    7.  
      Appels d'API sur NBWSS
    8.  
      Notifications de NBWSS
    9. Exemples de messages NBWSS
      1.  
        NetBackup demande une connexion au terminal client
      2.  
        L'application cloud demande d'effectuer un appel REST API
      3.  
        Messages de notification de NetBackup pour un travail de sauvegarde
      4.  
        Autres messages de notification NetBackup
  2. Configuration des terminaux client WebSocket pour NBWSS
    1.  
      A propos des connexions de NetBackup aux terminaux client WebSocket
    2.  
      Informations du terminal client WebSocket et son formatage
    3.  
      Enregistrement des informations d'authentification de NetBackup pour un terminal client de serveur WebSocket
    4.  
      Boîte de dialogue de Serveur WebSocket
    5.  
      Suppression des informations d'authentification de NetBackup pour un terminal client de serveur WebSocket
    6.  
      Configuration des propriétés de NetBackup WebSocket Service (NBWSS)
    7.  
      Démarrage d'une connexion de NetBackup à une application cloud
  3. Dépannage NBWSS
    1.  
      Consignation de NBWSS
    2. Problèmes NBWSS
      1.  
        Des problèmes de validation du serveur de terminal client dans la boîte de dialogue WebSocket Server
      2.  
        Problèmes d'enregistrement des informations d'authentification dans la boîte de dialogue Serveur WebSocket
      3.  
        Problèmes de suppression de terminal client du serveur WebSocket à partir de NetBackup
      4.  
        Problèmes d'affichage de la liste des serveurs WebSocket qui ont été ajoutées dans NetBackup
      5.  
        Problèmes d'activation ou de désactivation du serveur de terminal client
      6.  
        Problèmes NBWSS supplémentaires

Remarques sur les connexions de NetBackup aux applications cloud

NBWSS utilise les règles suivantes pour établir une connexion à un terminal client :

  • S'il n'existe aucune connexion active à un terminal client dans un groupe de serveurs, NetBackup tente de se connecter au terminal client qui a la priorité la plus élevée.

  • S'il est impossible de se connecter à un terminal client au sein d'un groupe de serveurs (le serveur est arrêté), NetBackup tente de se connecter au terminal client qui a la priorité la plus élevée suivante dans ce groupe de serveurs.

Notez ces règles supplémentaires et limitations :

  • Au maximum une connexion peut exister par terminal client à la fois.

  • Au maximum une connexion peut exister par groupe de serveurs à la fois.

  • NBWSS ne ferme pas automatiquement une connexion existante lorsqu'une connexion de priorité plus élevée est en ligne. Par exemple, supposons que ce groupe de serveurs sg1 a deux terminaux client (ep1 et ep2) avec des priorités de 1 et 2, respectivement. Si NBWSS est actuellement connecté à ep2 (priorité 2) et ep1 (priorité 1) est en ligne, NBWSS ne se connecte pas automatiquement à ep1. L'application cloud doit fermer la connexion à ep2 avant que NBWSS ne tente de se connecter à ep1.

  • Un processus de connexion s'exécute sur un minuteur qui répond aux modifications de connexion de terminal client (comme pour la connexion aux nouveaux terminaux client ou la déconnexion à partir de terminaux client supprimés). La durée par défaut pour cette tâche est de 60 secondes. Par conséquent, cela peut prendre jusqu'à 1 minute avant que les modifications du terminal client n'entrent en vigueur.

    Vous pouvez utiliser la propriété connectionInfo.period pour configurer cette tâche.

    Se reporter à Configuration des propriétés de NetBackup WebSocket Service (NBWSS).

  • Lorsque le service de la console de gestion Web NetBackup est redémarré, le serveur web de NetBackup prend quelques minutes pour démarrer. En conséquence, les terminaux client actuellement configurés s'affichent après quelques minutes dans la console d'administration NetBackup. Les terminaux client s'affichent sous Gestion des médias et des périphériques > Informations d'authentification > serveurs WebSocket.

  • Une connexion établie ne dispose pas de limite de temps ; la connexion peut exister indéfiniment. Dans certains cas, la connexion devra peut-être être ré-établies, comme lorsque le jeton que NetBackup envoie à l'application cloud a expiré. Dans ce cas, les informations d'authentification de NetBackup pour le terminal client doivent être à nouveau ajoutées avec un nouveau jeton valide. La connexion est rétablie à la prochaine exécution du processus de connexion (déterminée par la propriété connectionInfo.period).

  • La taille du paquet entrant maximale autorisée sur le canal NetBackup WebSocket est de 2 Mo. Si le serveur NetBackup WebSocket reçoit un paquet dont la taille est supérieure à 2 Mo, la connexion est interrompue. Dans l'actualisation des connexions suivante (par défaut, 60 secondes plus tard), NBWSS tente de se reconnecter avec le terminal client à distance.