Průvodce posouzením problémů s NetWorker REST API

Sledujte video na YouTube.

Začínáme

Připojení k nástroji NetWorker:

• Content-Type: application/json
• Přijmout: application/json
• Authorization: Basic s uživatelským jménem a heslem kódováním Base 64

V prostředích, kde se prostřednictvím jednoho serveru NetWorker AUTHC ověřuje více datových zón NetWorker, je vyžadována další hlavička:

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

Rozhraní NetWorker REST API je vystaveno v následujícím základním identifikátoru 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

Úplné schéma JSON je k dispozici na adrese

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

Funkce rozhraní REST API

Několik příkladů:

GET

Vypíše všechny klienty.                                            

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

Pouze jeden klient zobrazující pouze tři pole (název hostitele, saveSets a protectionGroups)      

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

Vypíše seznam skupin ochrany, ve kterých se nachází jeden klient.     

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

Zobrazit aktuální výstrahy.                                     

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

Zobrazí poslední neúspěšné úlohy.                               

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

Vypište pracovní postupy v jedné zásadě (v tomto příkladu s názvem WinFS ).                   

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

Vypíše vlastnosti pouze jedné instance sady uložení (jak je definováno názvem hostitele klienta a uloženou sadou).      

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

PŘÍSPĚVEK:

Spusťte akci pracovního postupu.                                 

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

Vytvořte novou instanci klienta (s výchozími hodnotami pro všechny vlastnosti kromě čtyř uvedených).           

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

Požadované informace pro podporu

Prostředí:

• Název serveru NetWorker
• Verze a číslo sestavení platformy NetWorker
• Typ a verze hostitelského operačního systému serveru NetWorker

Linux:

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

Windows:

nsrwatch

• Vysvětlete, která operace rozhraní REST API se provádí (GET, POST, PUT, DELETE), použitý identifikátor URI, veškerý obsah textu JSON (pokud je k dispozici). 
• Kód odpovědi rozhraní REST API a všechny poskytnuté chybové zprávy.
• Proběhlo počáteční připojení a autorizace mezi klientem REST API a nástrojem NetWorker úspěšně?

• Vykreslený soubor protokolu daemon.raw ze serveru NetWorker:
  • Linux: /nsr/logs/daemon.raw
  • Windows: C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw
  • NetWorker: Návod k použití nsr_render_log
• Protokoly rozhraní REST API ze serveru NetWorker:  /nsr/logs/restapi (linux) nebo EMC NetWorker\nsr\logs\restapi (Windows)
• Informace o problémech s ověřováním naleznete v protokolování standardní autentizace NetWorker v umístění /nsr/authc/logs (linux) nebo .. \EMC NetWorker\nsr\authc-server\tomcat\logs (Windows)

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

Tento výstup zobrazuje standardní horní výstup, ale s časovými razítky čitelnými pro člověka. To lze použít ke kontrole využití procesoru a paměti procesem a k tomu, jak dlouho zůstal v určitém stavu při volání REST. To lze porovnat s protokoly restapi.log a AUTHC a zjistit, která volání byla provedena a jak často.
 

Windows: U serverů se systémem Windows je nutné nainstalovat nástroj jako "Performance Monitor:

1. Spusťte nástroj Sledování výkonu jako správce.
2. V levém podokně rozbalte položku Monitorovací nástroje a vyberte Sledování výkonu.
3. Klikněte pravým tlačítkem do pravého podokna a vyberte Odebrat všechny čítače.
4. Klikněte pravým tlačítkem do pravého podokna a vyberte Přidat čítače.
5. V části Available Counters rozbalte položku Memory, vyberte % Commit Bytes a klikněte na Add.6
. V části Paměť  vyberte možnost Dostupné bajty a klikněte na tlačítko Přidat.
7. V části Dostupné čítače rozbalte položku Zpracovat a vyberte možnost % času procesoru a v části Instance vybraného objektu vyberte první položku Java a klikněte na tlačítko Přidat.
8. V části Dostupné čítače rozbalte položku Informace o procesoru a vyberte možnost % Processor Utility, klikněte na tlačítko Přidat.
9. V části Přidané čítače v pravém podokně by se měly zobrazit:

10. Klikněte na tlačítko OK. Klepněte pravým tlačítkem myši na položku Sledování výkonu a klepněte na položku >Sada kolekcí nových dat.
11. Zadejte název, např.: RESTAPI_MON.
12. Na obrazovce umístění klikněte na tlačítko Další,  pokud se nerozhodnete zadat alternativní umístění výstupu.
13. Vyberte Uložit a zavřít a klikněte na Dokončit.
14. V levém podokně pod položkou Sady kolekcí dat –> definováno uživatelem otevřete vlastnosti RESTAPI_MON a vyberte Oddělené čárkami pro formát protokolu klikněte na tlačítko OK.

15. V levém podokně pod položkou Sady kolekcí dat –> definováno uživatelem vyberte RESTAPI_MON sadu kolekcí dat a klikněte na tlačítko Start (tlačítko Přehrát).
16. Pokud bylo použito výchozí umístění výstupu, soubor .csv se zobrazí v umístění C:\PerfLogs\Admin\RESTAPI_MON.
17. Jakmile je problém pozorován a zaznamenán ve výstupním souboru, můžete sledování zastavit kliknutím na tlačítko Zastavit v části Sady kolekcí dat – definováno uživatelem.

Další zdroje

Všechny podporované koncové body rozhraní REST API a příklady použití jsou k dispozici v: Referenční příručka k rozhraní NetWorker REST API