Sorteringsveiledning for NetWorker REST API

Se på YouTube

Startveiledning

Koble til NetWorker:

• Content-Type: application/json
• Godta: søknad/json
• Godkjenning: Grunnleggende med Base 64-kodet brukernavn og passord

I miljøer der det er flere NetWorker-datasoner som godkjennes via én enkelt NetWorker AUTC-server, kreves et ekstra hode:

• 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 fullstendige json-skjemaet er tilgjengelig på

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

REST API-funksjoner

Noen eksempler:

GET

Liste over alle klienter.                                            

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

Bare én klient, som bare viser tre felt (vertsnavn, saveSets og protectionGroups)      

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

Oppgi beskyttelsesgruppene som én klient er i.     

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

Vis gjeldende varsler.                                     

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

Vis nylig mislykkede jobber.                               

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

Vis arbeidsflytene i én policy (kalt WinFS i dette eksemplet).                   

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

Oppgi egenskapene for bare én saveset-forekomst (som definert av klientvertsnavn og lagringssett).      

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

INNLEGG:

Start en arbeidsflythandling.                                 

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

Opprett en ny klientforekomst (med standardverdier for alle egenskaper unntatt de fire som er oppført).           

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

Nødvendig informasjon for kundestøtte

Miljø:

• Navn på NetWorker-server
• NetWorker-versjon og buildnummer
• NetWorker-serververtsoperativsystemtype og -versjon

Linux:

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

Windows:

nsrwatch

• Forklar hvilken REST API-operasjon som utføres (GET, POST, PUT, DELETE), URI-en som brukes, eventuelt JSON-innhold (der det er aktuelt). 
• REST API-svarkode og eventuell feilmelding som vises.
• Har den første tilkoblingen og autorisasjonen vært vellykket mellom REST API-klienten og NetWorker?

• Gjengitt daemon.raw loggfil fra NetWorker-serveren:
  • Linux: /nsr/logs/daemon.raw
  • Windows: C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw
  • NetWorker: Hvordan du bruker nsr_render_log
• REST API-logger fra NetWorker-serveren:  /nsr/logs/restapi (linux) eller EMC NetWorker\nsr\logs\restapi (Windows)
• Hvis du har godkjenningsproblemer, kan du se standard NetWorker-godkjenningspålogging i /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}'

Disse utdataene viser standard topputdata, men med lesbare tidsstempler i mennesker. Dette kan brukes til å gjennomgå CPU- og minneforbruket ved hjelp av prosessen og hvor lenge det holdt seg i en bestemt tilstand når et REST-anrop ble foretatt. Dette kan sammenlignes med restapi.log- og AUTHC-loggene for å se hvilke anrop som ble foretatt og hvor ofte.
 

Windows: For Windows-servere må du installere noe sånt som "Performance Monitor:

1. Åpne Performance Monitor som administrator.
2. Fra venstre rute utvider du Overvåkingsverktøy og velger Ytelsesmåler.
3. Høyreklikk i høyre rute og velg Fjern alle tellere.
4. Høyreklikk i høyre rute og velg Legg til tellere.
5. Under Tilgjengelige tellere utvider du Minne, velger % utfør byte og klikker Legg til.6
. Velg Tilgjengelige byte under Minne,  og klikk Legg til.
7. Under Tilgjengelige tellere utviderdu Prosess og velger % prosessortid, og under Forekomster av valgt objekt velger du den første Java-oppføringen, klikker du Legg til.
8. Under Tilgjengelige tellere utviderdu Prosessorinformasjon og velger % prosessorverktøy ved å klikke på Legg til.
9. Tellerne som er lagt til i ruten til høyre, skal vise:

10. Klikk på OK. Høyreklikk på Ytelsesmåler, >og klikk på Nytt datainnsamlingssett.
11. Oppgi et navn, for eksempel: RESTAPI_MON.
12. Klikk Neste i skjermbildet for plassering,  med mindre du velger å angi en alternativ utdataplassering.
13. Velg Lagre og lukk, og klikk på Fullfør.
14. I den venstre ruten under Data Collector Sets-User> Defined åpner du egenskapene RESTAPI_MON og velger Kommadelt for loggformatet, klikker du OK.

15. I den venstre ruten under Data Collector Sets-User> Defined velger du RESTAPI_MON datainnsamlingssett og klikker Start (Spill av-knappen).
16. Hvis standard utdataplassering ble brukt, vises filen .csv under C:\PerfLogs\Admin\RESTAPI_MON.
17. Når problemet er observert og registrert i utdatafilen, kan du stoppe overvåkingsklikk ved å klikke Stopp under Datainnsamlingssett-Brukerdefinert.

Flere ressurser

Alle støttede REST API-endepunkter og brukseksempler er gitt i: Referanseveiledning for NetWorker REST API