NetWorker REST API Triage-vejledning

Se på YouTube

Kom godt i gang

Opretter forbindelse til NetWorker:

• Indholdstype: applikation/json
• Accepter: ansøgning/json
• Godkendelse: Basic med Base 64-kodet brugernavn og adgangskode

I miljøer, hvor der er flere NetWorker-datazoner, der godkendes via en enkelt NetWorker AUTHC-server, kræves der en ekstra header:

• X-NW-AUTHC-BASE-URL:AUTHC_HOSTNAME_OR_IP:AUTHC_PORT

NetWorker REST API vises i følgende basis-URI:

https://[nw-server-hostname]:9090/nwrestapi/

https://[nw-server-hostname]:9090/nwrestapi/v1
https://[nw-server-hostname]:9090/nwrestapi/v2
https://[nw-server-hostname]:9090/nwrestapi/v3

Det fulde json-skema er tilgængeligt på

https://[nw-server-hostname]:9090/nwrestapi/v3/schemas/swagger.json

REST API-funktioner

Nogle eksempler:

GET

Angiv alle klienter.                                            

https://[nw-server-hostname]:9090/nwrestapi/v3/global/clients

Kun én klient, der kun viser tre felter (værtsnavn, saveSets og protectionGroups)      

https://[nw-server-hostname]:9090/nwrestapi/v3/global/clients?fl=hostname,saveSets,protectionGroups&q=hostname:nwserver121

Angiv de beskyttelsesgrupper, som en klient er i.     

https://[nw-server-hostname]:9090/nwrestapi/v3/global/clients?fl=protectionGroups&q=hostname:nwserver121

Vis aktuelle advarsler.                                     

https://[nw-server-hostname]:9090/nwrestapi/v3/global/alerts

Vis de seneste mislykkede job.                               

https://[nw-server-hostname]:9090/nwrestapi/v3/global/jobs?q=completionStatus:"Failed"&fl=clientHostname,startTime,name,message

Angiv arbejdsprocesserne i én politik (kaldet WinFS i dette eksempel).                   

https://[nw-server-hostname]:9090/nwrestapi/v3/global/protectionpolicies/WinFS/workflows

Angiv kun egenskaberne for én saveset-forekomst (som defineret af klientens værtsnavn og saveset).      

https://[nw-server-hostname]:9090/nwrestapi/v3/global/clients?q=hostname:vm-lego-231 and saveSets:"/etc"

INDLÆG:

Start en arbejdsgangshandling.                                 

https://[nw-server-hostname]:9090/nwrestapi/v3/global/protectionpolicies/Angela/workflows/WinFS/op/backup
                                                      JSON Body: 
                                                      {
                                                       }

Opret en ny klientforekomst (med standardværdier for alle ejendomme undtagen de fire, der er angivet).           

https://[nw-server-hostname]:9090/nwrestapi/v3/global/clients  
                                                     JSON Body 
                                                     {    
            "hostname": "vm-lego-231",
            "backupType": "Filesystem",
            "saveSets": [ "/etc" ],
            "protectionGroups" : [ "LinuxFS" ]
                                                          

Påkrævede oplysninger til support

Miljø:

• NetWorker-servernavn
• NetWorker-version og buildnummer
• NetWorker-serverværtens operativsystemtype og -version

Linux:

hostname
strings /usr/sbin/nsrd | grep -i "(#)"
cat /etc/*release
uname -a

Windows:

nsrwatch

• Forklar, hvilken REST API-handling der udføres (GET, POST, PUT, DELETE), den anvendte URI, eventuelt JSON-brødtekstindhold (hvis relevant). 
• REST API-svarkode og eventuelle fejlmeddelelser.
• Er den indledende forbindelse og godkendelse lykkedes mellem REST API-klienten og NetWorker?

• Gengivet daemon.raw logfil fra NetWorker-serveren:
  • Linux: /nsr/logfiler/daemon.raw
  • Windows: C:\Programmer\EMC NetWorker\nsr\logfiler\daemon.raw
  • NetWorker: Sådan bruger du nsr_render_log
• REST API-logfiler fra NetWorker-serveren:  /nsr/logs/restapi (linux) eller EMC NetWorker\nsr\logs\restapi (Windows)
• For godkendelsesproblemer henvises til standard NetWorker-godkendelse, når du logger på /nsr/authc/logs (linux) eller .. \EMC NetWorker\nsr\authc-server\tomcat\logs (Windows)

top -b | awk '/nsrtomc+/ {print strftime("%Y-%m-%d-%H:%M:%S", systime()), $0}'

Dette output viser standard topoutput, men med tidsstempler, der kan læses af mennesker. Dette kan bruges til at gennemgå CPU- og hukommelsesforbruget efter processen, og hvor længe den forblev i en bestemt tilstand, da der blev foretaget et REST-opkald. Dette kan sammenlignes med restapi.log- og AUTHC-logfilerne for at se, hvilke opkald der blev foretaget og hvor ofte.
 

Windows: For Windows-servere skal du installere noget som "Performance Monitor:

1. Åbn Ydelsesmåler som administrator.
2. Udvid Overvågningsværktøjer i venstre rude, og vælg Performance Monitor.
3. Højreklik inde i højre rude, og vælg Fjern alle tællere.
4. Højreklik inde i højre rude, og vælg Tilføj tællere.
5. Udvid Hukommelse under Tilgængelige tællere, vælg % Commit Bytes, og klik på Tilføj.6
. Vælg Tilgængelige bytes under Hukommelse,  og klik på Tilføj.
7. Udvid Proces under Tilgængelige tællere, og vælg % processortid, og vælg den første Java-post under Forekomster af markeret objekt, og klik på Tilføj.
8. Udvid Processoroplysninger under Tilgængelige tællere, og vælg % processorværktøj, og klik på Tilføj.
9. De tilføjede tællere i højre rude skal vise:

10. Klik på OK. Højreklik på Ydelsesmåler, og klik på >Nyt dataindsamlersæt.
11. Angiv et navn, f.eks.: RESTAPI_MON.
12. Klik på Næste på placeringsskærmen,  medmindre du vælger at angive en alternativ outputplacering.
13. Vælg Gem og luk , og klik på Udfør.
14. I venstre rude under Data Collector Sets –> User Defined skal du åbne de RESTAPI_MON egenskaber og vælge Kommasepareret som logformat, klikke på OK.

15. Vælg det RESTAPI_MON dataindsamlersæt under Data Collector Sets -> User Defined - i venstre rude, og klik på Start (knappen Afspil).
16. Hvis standardoutputplaceringen blev brugt, vises .csv filen under C:\PerfLogs\Admin\RESTAPI_MON.
17. Når problemet er observeret og registreret i outputfilen, kan du stoppe overvågningsklik ved at klikke på Stop under Data Collector Sets-User Defined.

Yderligere ressourcer

Alle understøttede REST API-slutpunkter og brugseksempler findes i: NetWorker REST API-referencevejledning