NetWorker REST API -luokitteluopas

Katso YouTubessa

Aloittaminen

Yhteyden muodostaminen NetWorkeriin:

• Content-Type: application/json
• Hyväksy: application/json
• Valtuutus: Basic ja Base 64 koodattu käyttäjätunnus ja salasana

Ympäristöissä, joissa on useita NetWorker-tietovyöhykkeitä, jotka todennetaan yhden NetWorker AUTHC -palvelimen kautta, tarvitaan ylimääräinen otsikko:

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

NetWorker REST -ohjelmointirajapinta näkyy seuraavassa perus-URI:ssa:

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

Koko json-rakenne on saatavilla osoitteessa

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

REST API -funktiot

Esimerkkejä:

GET

Lisää kaikki asiakkaat.                                            

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

Vain yksi asiakasohjelma, jossa näkyy vain kolme kenttää (isäntänimi, saveSets ja protectionGroups)      

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

Näytä luettelo suojausryhmistä, joihin yksi asiakas kuuluu.     

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

Näytä nykyiset hälytykset.                                     

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

Näytä äskettäin epäonnistuneet työt.                               

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

Luettele työnkulut yhdessä käytännössä (tässä esimerkissä WinFS ).                   

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

Näytä luettelo vain yhden saveset-esiintymän ominaisuuksista (asiakkaan isäntänimen ja tallennusjoukon määrittämällä tavalla).      

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

VIESTI:

Aloita työnkulkutoiminto.                                 

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

Luo uusi asiakasesiintymä (jossa oletusarvot ovat kaikille muille ominaisuuksille paitsi neljälle luetellulle).           

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

Tuen edellyttämät tiedot

Ympäristö:

• NetWorker-palvelimen nimi
• NetWorker-version ja koontiversion numero
• NetWorker-palvelimen isäntäkäyttöjärjestelmän tyyppi ja versio

Linux:

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

Windows:

nsrwatch

• Selitä, mitä REST API -toimintoa suoritetaan (GET, POST, PUT, DELETE), käytetty URI, JSONin leipätekstin sisältö (tarvittaessa). 
• REST API -vastauskoodi ja mahdolliset virheilmoitukset.
• Onko alkuperäinen yhteys ja valtuutus REST API -asiakkaan ja NetWorkerin välillä onnistunut?

• Hahmonnettu daemon.raw lokitiedosto NetWorker-palvelimesta:
  • Linux: /nsr/logs/daemon.raw
  • Windows: C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw
  • NetWorker: Kuinka käyttää nsr_render_log
• REST API -lokit NetWorker-palvelimesta:  /nsr/logs/restapi (linux) tai EMC NetWorker\nsr\logs\restapi (Windows)
• Jos sinulla on todennusongelmia, katso NetWorkerin vakiotodennuslokiin kirjaaminen hakemistossa /nsr/authc/logs (linux) tai .. \EMC NetWorker\nsr\authc-server\tomcat\logs (Windows)

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

Tämä tulos näyttää tavallisen ylätuloksen, mutta siinä on ihmisen luettavissa olevat aikaleimat. Sen avulla voidaan tarkastella suorittimen ja muistin kulutusta prosessin mukaan ja kuinka kauan se pysyi tietyssä tilassa, kun REST-kutsu soitettiin. Tätä voidaan verrata restapi.log- ja AUTHC-lokeihin, jotta näet, mitä puheluita soitettiin ja kuinka usein.
 

Windows: Windows-palvelimille sinun on asennettava jotain "Performance Monitor:

1. Avaa suorituskyvyn valvonta järjestelmänvalvojana.
2. Laajenna vasemmasta ruudusta Valvontatyökalut ja valitse Suorituskyvyn valvonta.
3. Napsauta hiiren kakkospainikkeella oikeassa ruudussa ja valitse Poista kaikki laskurit.
4. Napsauta hiiren kakkospainikkeella oikeassa ruudussa ja valitse Lisää laskureita.
5. Laajenna Käytettävissä olevat laskurit -kohdassa Muisti, valitse % Vahvista tavuja ja valitse Lisää.6
. Valitse Memory-kohdassa Available Bytes ja Add.
7. Laajenna Käytettävissä olevat laskurit -kohdassa Prosessi ja valitse % suorittimen ajasta ja valitse Valitun objektin esiintymät -kohdassa ensimmäinen Java-merkintä ja valitse Lisää.
8. Laajenna Käytettävissä olevat laskurit-kohdassa Suorittimen tiedot ja valitse % Processor Utility, klikkaa Lisää.
9. Oikeanpuoleisen ruudun lisätyissä laskureissa pitäisi näkyä:

10. Valitse OK. Napsauta hiiren kakkospainikkeella Suorituskyvyn valvonta ja valitse New-Data> Collector Set.
11. Anna nimi, esimerkiksi: RESTAPI_MON.
12. Valitse sijaintinäytössä Seuraava,  ellet määritä vaihtoehtoista tulostussijaintia.
13. Valitse Tallenna ja sulje ja napsauta Valmis.
14. Avaa vasemmanpuoleisen ruudun kohdassa Data Collector Sets-User> DefinedRESTAPI_MON ominaisuudet ja valitse lokimuodoksi Pilkuilla eroteltu. Valitse OK.

15. Valitse vasemmanpuoleisesta ruudusta Data Collector Sets-User> Defined -kohdasta RESTAPI_MON tiedonkeruutyökalujen joukko ja napsauta Käynnistä (toistopainike).
16. Jos käytettiin oletusarvoista tulostussijaintia, .csv tiedosto näkyy kansiossa C:\PerfLogs\Admin\RESTAPI_MON.
17. Kun ongelma on havaittu ja tallennettu tulostiedostoon, voit lopettaa napsautuksen seurannan napsauttamalla Pysäytä kohdassa Data Collector Sets-User Defined.

Muita resursseja

Kaikki tuetut REST API -päätepisteet ja käyttöesimerkit ovat seuraavissa: NetWorker REST API -viiteopas