NVP-vProxy: vCenter plug-in en gebruikersinterface (VCUI) probleemoplossing

De vCenter User Interface (VCUI) is een webinterface die is ingebouwd in de NetWorker-server. VCUI en de vSphere plug-in zijn optionele NetWorker VMware Protection (NVP)-beheerinterfaces. Ze zijn niet vereist om VMware back-up- of herstelbewerkingen met succes te plannen of uit te voeren. Deze interfaces bieden VMware-administraties toegang tot NVP-bewerkingen zonder toegang tot andere NetWorker-beheerinterfaces, zoals de NetWorker Management Console (NMC) en NetWorker Web User Interface (NWUI). 

VCUI is toegankelijk via het volgende:

• Rechtstreeks vanuit een webbrowser: https://<NETWORKER_SERVER_ADDRESS>:9090/vcui
• De VCUI kan rechtstreeks in VMware vSphere worden geïnstalleerd als plug-in. 

Zowel de zelfstandige webpagina als de vSphere plug-in gebruiken hetzelfde eindpunt op de NetWorker-server. Zie voor meer informatie over de installatie en het gebruik van de vSphere plug-in of VCUI de NetWorker VMware integratiehandleiding. NetWorker-documentatie is beschikbaar via: Support voor NetWorker | Handleidingen en documenten (U moet zich aanmelden met uw Dell Support account).

Eerste stappen voor probleemoplossing:

• De versie en het besturingssysteem van de NetWorker-server identificeren: NetWorker: Methoden voor het identificeren van de versie van de NetWorker-software
• Identificeer de vCenter-versie.
  • Selecteer in VMware vSphere het vCenter (bovenste object) in de inventaris en klik op het tabblad Samenvatting:
     
• Bekijk de NetWorker-compatibiliteitsdocumentatie om er zeker van te zijn dat de NetWorker-versie de VMware-versie ondersteunt: E-Lab Interoperability Navigator 2.0-HOME (U moet zich aanmelden met uw Dell supportaccount).
• Wordt hetzelfde probleem waargenomen buiten vSphere voor specifieke problemen met de vSphere-plug-in? Bijvoorbeeld bij het openen van https://<NETWORKER_SERVER_ADDRESS>:9090/vcui Direct. Als het probleem alleen specifiek is voor de vSphere plug-in, moeten vCenter-logboeken mogelijk worden bekeken om het probleem verder te beoordelen. Hiervoor kan ook betrokkenheid van de VMware-beheerder of VMware-support vereist zijn.
• Wordt het probleem waargenomen in meer dan één webbrowser? Problemen die specifiek zijn voor één webbrowser treden op buiten NetWorker.
• Noteer eventuele specifieke fouten die in de webbrowser worden waargenomen.

Problemen met de installatie van de vSphere plug-in:

• NVP vProxy: vSphere Web Client Plugin meldt een geslaagde installatie, maar wordt niet weergegeven
• NVP-vProxy: Kan vCenter-plug-in niet installeren "Kan geen geldig certificeringspad naar aangevraagd doel vinden"
• NVP: Kan vCenter-plug-in niet installeren in een omgeving met meerdere homed's
• NetWorker: vCenter plug-in en VCUI-aanmelding mislukt met 'vCenter niet geregistreerd bij NetWorker-server'

Logboekregistratie:

De VCUI- en vSphere plug-inlogboekinformatie bij het volgende bestand op de NetWorker-server:

• Linux: /nsr/authc/logs/vcui.log
• Windows (standaard installatiepad): C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\vcui.log

Het standaard logboekregistratieniveau is INFO. In sommige scenario's kan dit onvoldoende zijn. Voer het volgende uit om foutopsporing in te schakelen:

1. De VCUI bewerken logback.xml Bestand in een teksteditor:

• Linux: /nsr/authc/webapps/vcui/WEB-INF/classes/logback.xml
• Windows (standaard installatiepad): C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\webapps\vcui\WEB-INF\classes\logback.xml

2. Wijzig de root level Van INFO Aan DEBUGen sla de wijzigingen op:

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{55} - %msg%n</pattern>
        </encoder>
    </appender>

  <appender name="FILE" class="ch.qos.logback.core.FileAppender">
    <file>${catalina.base}/logs/vcui.log</file>
    <append>true</append>
    <encoder>
      <pattern>%d{yyyy-MM-ddTHH:mm:ss.SSS} [%thread] %-5level %logger{25}.%M %L - %msg%n</pattern>
    </encoder>
  </appender>

    <root level="DEBUG">
        <appender-ref ref="FILE"/>
        <appender-ref ref="STDOUT"/>
    </root>
</configuration>

3. NetWorker-serverservices opnieuw starten:

Linux:

systemctl restart networker

or 

nsr_shutdown
systemctl start networker

net stop nsrd
net start nsrd

Reproduceer het probleem in de VCUI- of vSphere-plug-in, de vcui.log bevat DEBUG-berichten. Wanneer foutopsporing niet langer nodig is, herhaalt u de bovenstaande stappen root level terug naar INFO. 

Authenticatieproblemen:

Voor verificatieproblemen moeten de logboeken van de NetWorker-verificatieserver (AUTHC) worden gecontroleerd:

AUTHC-foutopsporing kan ook worden ingeschakeld: NetWorker: AUTHC-foutopsporing inschakelen voor probleemoplossingsdoeleinden

Functionele problemen:

Naast de vcui.log, browser inspect console en NetWorker REST API-logboeken kunnen worden bekeken om operationele problemen vast te stellen:

1. Klik in de webbrowser met de rechtermuisknop in het venster en klik op Inspecteren; of druk op CTRL+SHIFT+I. (De exacte opties kunnen per browser verschillen.)
2. Klik in de console Inspecteren op het tabblad Netwerk :
    
3. Voer een bewerking uit in de vSphere plug-in of VCUI die een probleem veroorzaakt. De kolom Naam van de inspectieconsole bevat bewerkingen die worden uitgevoerd.
4. Klik op de bewerking die wordt weergegeven tijdens het probleem en controleer het tabblad Headers . De algemene informatie laat zien welke API-bewerking wordt uitgevoerd en wat het resultaat is.
    
5. Controleer ook de tabbladen Payload en Response voor aanvullende informatie over de bewerking. 

Aanvullende NetWorker-logboekregistratie:

De REST API-logboeken van de NetWorker-server moeten ook logboekregistratie bevatten die is afgestemd op bewerkingen die worden uitgevoerd in de vSphere-plug-in of VCUI. Het REST API-logboek bevindt zich op de volgende NetWorker-serverlocatie:

• Linux: /nsr/logs/restapi/restapi.log
• Windows (standaard installatiepad): C:\Program Files\EMC NetWorker\nsr\logs\restapi\restapi.log

REST API-foutopsporing kan ook worden ingeschakeld: NetWorker: Hoe REST API-foutopsporing in te schakelen

Algemene NetWorker-logboeken: NetWorker: Logbestanden en locaties

vCenter Logging:

De volgende logboeken kunnen worden bekeken vanuit een vCenter Server Support-bundel: