NetWorker: Jak používat příkaz nsrpolicy

Skript nsrpolicy je administrativní příkaz NetWorker, který se používá ke správě a monitorování zásad NetWorker. Mnoho stejných funkcí se provádí z NetWorker Management (NMC) a webového uživatelského rozhraní (NWUI). Nicméně nsrpolicy Poskytuje správcům možnosti příkazového řádku.

 

nsrpolicy musí být spuštěn za jedné z následujících podmínek:

• Příkaz spouštíte z příkazového řádku se zvýšenými oprávněními. Buď příkazem správce/příkazem PowerShell v systému Windows, nebo příkazem root/sudo shell na Linuxu.
• Spouštíte příkaz z nezvýšeného řádku, ale vystavili jste ověřovací token NetWorker: nsrlogin -u USERNAME

Obecný přehled použití:

nsrpolicy
       policy
           create | delete | display | update | list
       workflow
           create | delete | display | update | list
       action
          create | delete | display | update | list
       group
           create | delete | display | update
       start
           Must have: -p [policy] -w [workflow]
           Other options (NetWorker 9.2 and above for -c option):  -c { <client_name1:[save_set_path_1;save_set_path_2],client_name2...>   -s [NetWorker server] -D [debug level] -h
       stop
            Must have:  Either -j [jobid] or -p [policy] -w [workflow]
            Other options: -s [NetWorker server] -D [debug level] -h
       monitor
            Must have:  -p [policy]
            Other options:   -w [workflow] -c [client] -g [group] -d [details] -n [non-tabular] -j [jobid] -s [NetWorker server] -D [debug level] -h
       input-file
             Must have:  -f [file name]
             Other options:   [--stop_on_error -S <0/1; default:0 (Do not stop)>]      [--stop_on_error -S <0/1; default:0 (Do not stop)>]  -D [debug level] -h
      restart
             Must have:  Either -j [jobid] or -p [policy] -w [workflow]
             Other options: -s [NetWorker server] -D [debug level] -h
       migrate
             Must have what is to be migrated: group | schedule_clone | nas_device | vmware_policy
             Other options:  -s [NetWorker server] -D [debug level] -h
       help

Příklady:

Seznam objektů v datové zóně:

nsrpolicy [object] list

Objekty: zásada, workflow, akce

nsrpolicy policy list
nsrpolicy workflow list -p "VMware Protection"
nsrpolicy action list -p "VMware Protection" -w "Full VM"

Zobrazení vlastností akce:
nsrpolicy action display -p [policy] -w [workflow] -A [action]

nsrpolicy action display -p "VMware Protection" -w "Full VM" -A backup

Zobrazení vlastností skupiny:
nsrpolicy group display -g [group]

nsrpolicy group display -g "VMware Protection - Full VM"

Zakázání nebo povolení akce:
nsrpolicy action update [action type backup subtype] -p [policy] -w [workflow] -A [action] -e [no/yes]

nsrpolicy action update backup traditional -p "Client Protection" -w "Traditional Client" -A backup -e no
nsrpolicy action update backup traditional -p "Client Protection" -w "Traditional Client" -A backup -e yes

Chcete-li změnit plán přidružený k akci, postupujte takto:
nsrpolicy action update [action type backup subtype] -p [policy] -w [workflow] -A [action] -t [schedule]

nsrpolicy action update backup traditional -p "Client Protection" -w "Traditional Client" -A backup -t full,incr,incr,incr,incr,incr,incr

Přidání klienta do skupiny pomocí vstupního souboru (instance klienta již musí existovat):
Vytvořte vstupní soubor s textem:
group update client -g [group] --add_clnt_list [client]:[saveset]

[root@nsr ~]# cat AddTraditionalClient.txt
group update client -g "Client Protection - Traditional Client" --add_clnt_list win-client03.amer.lan:All

nsrpolicy input-file -f  "[path to input file]"

[root@nsr ~]# nsrpolicy input-file -f /root/AddTraditionalClient.txt
121415:nsrpolicy: Command from file: group update client -g "Client Protection - Traditional Client" --add_clnt_list win-client03.amer.lan:All
133584:nsrpolicy: Group 'Client Protection - Traditional Client' was successfully updated

Vytvořte nový pracovní postup s nevýchozími hodnotami pro komentář, čas zahájení a skupinu:
nsrpolicy workflow create -p [policy] -w [workflow] -c [comment] -g [group] -S [start time]

nsrpolicy workflow create -p "Client Protection" -w "Traditional Client - Linux"  -c "Linux Clients" -g "Linux - Clients" -S "10:00"

Vytvořte novou akci s jinými než výchozími hodnotami pro cílový fond a prahovou hodnotu úspěchu:
nsrpolicy action create [action type backup subtype] -p [policy] -w [workflow] -A [action] -o [target pool] -u [success threshold]

nsrpolicy action create backup traditional -p "Client Protection" -w "Traditional Client - Linux" -A backup -o "Data Domain Default" -u success

Spusťte pracovní postup (tímto způsobem nelze spustit akci. Je nutné spustit celý pracovní postup).
nsrpolicy start -p [policy] -w [workflow]

nsrpolicy start -p "Client Protection" -w "Traditional Client - Linux"

Zastavení pracovního postupu:
nsrpolicy stop -p [policy] -w [workflow]

nsrpolicy stop -p "Client Protection" -w "Traditional Client - Linux"

[root@nsr ~]# nsrpolicy start -p "Client Protection" -w "Traditional Client - Linux"
144091:nsrpolicy: Workflow 'Client Protection/Traditional Client - Linux' started and has job id 1248743
[root@nsr ~]#
[root@nsr ~]# jobkill -j 1248743
Terminating job 1248743

Spusťte jednoho klienta v pracovním postupu:
nsrpolicy start -p [policy] -w [workflow] -c "[client]:[saveset]

nsrpolicy start -p "Client Protection" -w "Traditional Client - Linux" -c "rhel-client03.amer.lan:All"

Monitorování nejnovějšího spuštění pracovních postupů v zásadě:
nsrpolicy monitor -p [policy] -dn

nsrpolicy monitor -p "Client Protection" -dn

Podrobný výstup úlohy pro konkrétní nedávnou úlohu:
nsrpolicy monitor -j [job id]

nsrpolicy monitor -j 290473

Chcete-li spustit pracovní postup v režimu ladění, nsrpolicy není tak účinný jako nsrworkflow příkaz, protože 'nsrpolicy start' neloguje výstup ladění do /nsr/logs/policy složka, která nsrworkflow vůle k .raw .
nsrworkflow -D[Debug Level] -p [policy] -w [workflow] -A "[action]"

nsrworkflow -D9 -p "Client Protection" -w "Traditional Client - Linux"

Další informace o úrovních ladění NetWorker naleznete v tématu: NetWorker: Úrovně informací ladění

Příklad povolení save -D3 Zálohování v klientovi NetWorker pomocí nástroje příkazového řádku nsradmin:

[root@nsr ~]#  nsradmin
NetWorker administration program.
Use the "help" command for help, "visual" for full-screen mode.
nsradmin> . type : NSR Client; name : rhel-client03.amer.lan
Current query set
nsradmin> update backup command : save -D3
              backup command: save -D3;
Update? y
updated resource id 48.0.46.11.0.0.0.0.231.177.13.90.10.60.28.121(13)

Ve výše uvedeném příkladu se při spuštění pracovního postupu pro klienta save Proces je spuštěn na klientovi s povoleným laděním (-D3) v tomto případě.
Informace o ladění konkrétních funkcí zálohování najdete tady: NetWorker: Jak ladit operace zálohování

Protokolování:

Všechny zálohy zásad a pracovních postupů se protokolují do adresáře protokolů NetWorker:

Linux: /nsr/logs/policy/POLICY_NAME
Windows (výchozí): C:\Program Files\EMC NetWorker\nsr\logs\policy\POLICY_NAME

 

Obecné zprávy serveru se zaznamenávají do daemon.raw:

Linux: /nsr/logs/daemon.raw
Windows (výchozí): C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw

NetWorker: Jak pomocí nsr_render_log vykreslit .raw soubory protokolu

Příklady skriptů:

Linux:

Příklad 1:  Uveďte všechny zásady a jejich pracovní postupy. Tento skript prostředí projde seznam zásad v konfiguraci NetWorker a spustí příkaz "nsrpolicy workflow list" pro každou z nich, takže vypíše seznam názvů pracovních postupů pro každou zásadu.

#!/usr/bin/sh
IFS=$'\n'
fullpolicylist=(`nsrpolicy policy list`)

for lp in "${fullpolicylist[@]}"
do
echo " "
echo "POLICY: $lp"
echo "Workflows"
nsrpolicy workflow list -p "$lp"
done

Příklad 2:  Uveďte všechny zásady a jejich pracovní postupy a akce a cílový fond. Tento skript prostředí spustí tři smyčky, aby získal seznam zásad, pracovních postupů a akcí. Výstupem jsou názvy každého z nich a parametr cílového uzlu úložiště akce.

#!/usr/bin/env bash
set -euo pipefail

# Read policies into an array (one per line)
mapfile -t fullpolicylist < <(nsrpolicy policy list)

for lp in "${fullpolicylist[@]}"; do
  echo "------------------"
  echo "POLICY: $lp"

  # Read workflows for this policy
  mapfile -t wflist < <(nsrpolicy workflow list -p "$lp")

  for w in "${wflist[@]}"; do
    echo
    echo "WORKFLOW: $w"

    # Read actions for this workflow
    mapfile -t alist < <(nsrpolicy action list -p "$lp" -w "$w")

    for a in "${alist[@]}"; do
      echo "ACTION: $a"

      # Pull DestinationPool value
      destpool=$(
        nsrpolicy action display -p "$lp" -w "$w" -A "$a" \
          | awk -F': ' '/DestinationPool/ {print $2; exit}'
      )

      echo "Destination Pool: ${destpool:-<none>}"
    done
  done
done

Windows PowerShell:

Příklad 1: Seznam pracovních postupů. Zobrazí seznam zásad a jejich pracovních postupů tak, že projde seznam zásad a pro každou zásadu spustíte příkaz "nsrpolicy workflow list".

$listp = nsrpolicy policy list
foreach  ($i in $listp)
{
write-host "-----"
write-host "POLICY: $i"
write-host "WORKFLOWS: "
nsrpolicy workflow list -p "$i"
}

Příklad 2:  Seznam akcí. Vytvoří se tři smyčky. Smyčka pro výpis zásad a potom smyčka pro výpis všech pracovních postupů pro každou zásadu a pak smyčka pro výpis všech akcí pro každý pracovní postup.

$listp = nsrpolicy policy list
foreach  ($p in $listp)
{
write-host "-----"
write-host "POLICY: $p"
write-host "WORKFLOWS: "
   $wlist = nsrpolicy workflow list -p $p
   foreach ($w in $wlist)
   {
   write-host "$w"
   
   write-host "ACTIONS:"
   $alist = nsrpolicy action list -p "$p" -w "$w"
   foreach  ($a in $alist)
     {
      write-host "$a"
     }
   }
}

nsrpolicy je příkaz pro správu zásad NetWorker počínaje platformou NetWorker 9.  Velká část správy příkazového řádku nástroje NetWorker, která se dříve prováděla pomocí programu nsradmin, se nyní provádí pomocí příkazu nsrpolicy.

Prvním krokem je přihlášení k serveru NetWorker z příkazového řádku pomocí příkazu nsrlogin se stejnými přihlašovacími údaji, jaké používáte pro přihlášení do konzole NetWorker Management Console. Když spustíte příkaz nsrlogin, hostitel NetWorker kontaktuje službu NetWorker AuthenticationService, aby ověřil přihlašovací údaje uživatele.

nsrlogin -u [uživatelské jméno] - p [heslo]

Příkaz nsrpolicy nabízí na každé úrovni řadu různých možností.  Stisknutím klávesy Enter v každém kroku získáte úplný seznam dostupných možností pro další část příkazu:

nsrpolicy

policy create | delete | display | update |
listworkflow
create | delete | display | update |
list action
create | delete | display | update |list group create | delete | display | display | display | update |

list group create | delete | display |update
start
Musí mít:                                                                                         -p [zásady] -w [workflow]
           Další možnosti (NetWorker 9.2 a vyšší pro parametr -c):  -c { <client_name1:[save_set_path_1; save_set_path_2],client_name2...>   -s [server NetWorker] -D [úroveň ladění] -h
       Stop
            Musí mít:  Buď -j [jobid], nebo -p [zásada] -w [workflow]
            Další možnosti: -s [server NetWorker] -D [úroveň ladění] -h
       monitor
            Musí mít:  -p [zásady]
            Další možnosti:   -w [workflow] -c [klient] -g [skupina] -d [podrobnosti] -n [netabulkové] -j [jobid] -s [server NetWorker] -D [úroveň ladění] -h
       vstupní soubor
             Musí mít:  -f [název souboru]
             Další možnosti:   [--stop_on_error -S <0/1; přednastaveno:0 (Nezastavovat)>] [--stop_on_error -S <0/1; přednastaveno:0 (Nezastavovat)>] -D [úroveň ladění] -h
      restart
             Musí mít:  Buď -j [jobid], nebo -p [zásada] -w [workflow]
             Další možnosti: -s [server NetWorker] -D [úroveň ladění] -h
migrovat
Co se má migrovat: skupina | schedule_clone | nas_device | vmware_policy
             Další možnosti:                      -s [server NetWorker] -D [úroveň ladění] -h
Pomoc

PŘÍKLADY PŘÍKAZOVÉHO ŘÁDKU:

Výpis zásad v seznamu
zásad nsrpolicydatové zóny
Seznam zásad nsrpolicy Zobrazí

vlastnosti akce:            
   nsrpolicy action display -p [zásada] -w [workflow] -A [akce]
   nsrpolicy action display -p Mona -w Mona_wf -A backup

Zobrazení vlastností skupiny:
   nsrpolicy group display -g [skupina]
   nsrpolicy group display -g Felix

Zakázání akce:
   nsrpolicy action update [typ akce backup subtype] -p [zásada] -w [workflow] -A [akce] -e ne
nsrpolicy action update backup traditional -p FrankHoenikker -w FrankH -A backup -e no
 
Chcete-li změnit plán přidružený k akci, postupujte takto:
   nsrpolicy action update [typ akce backup subtype] -p [zásada] -w [workflow] -A [akce] -t [plán]
nsrpolicy action update backup traditional -p Mona -w Mona_wf -A backup -t full,incr,incr,incr,incr,incr,incr,incr
 
Přidejte klienta do skupiny pomocí vstupního souboru (instance klienta už musí existovat):
   Vytvořte vstupní soubor s textem: group update client -g [group] --add_clnt_list [client]:[saveset]
cat AddAlicetoTheHook.input
group update client -g TheHook --add_clnt_list vm-lego-231:/alice

   nsrpolicy input-file -f "[cesta ke vstupnímu souboru]"
nsrpolicy input-file -f "/nsr/AddAlicetoTheHook.input"
 
Vytvořte nový pracovní postup s jinými než výchozími hodnotami pro comment, start-time a group:
   nsrpolicy workflow create -p [zásada] -w [workflow] -c [komentář] -g [skupina] -S [čas zahájení]
nsrpolicy workflow create -p Mona -w Papa -c "Workflow for RedHat 6 clients" -g PapaMgroup -S "10:00"

Vytvořte novou akci s jinými než výchozími hodnotami pro cílový fond a prahovou hodnotu
úspěšnosti nsrpolicy action create [typ akce backup subtype] -p [policy] -w [workflow] -A [akce] -o [cílový fond] -u [práh úspěchu]
nsrpolicy action create backup tradiční -p Mona -w Papa -A papabackup -o SanLorenzoDDPool -u úspěch

Spusťte pracovní postup (Upozorňujeme, že tímto způsobem nelze spustit akci.  Je nutné spustit celý pracovní postup).
   nsrpolicy start -p [zásada] -w [workflow]
nsrpolicy start -p Mona -w Mona_wf

Zastavte pracovní postup (ID příslušné úlohy můžete získat pomocí příkazu "nsrpolicy monitor" – viz níže):
   nsrpolicy stop -j [jobid]
nsrpolicy stop -j 320819

Spusťte jednoho klienta v pracovním postupu:
   nsrpolicy start -p [zásada] -w [workflow] -c "[klient]:[uložit]
nsrpolicy start -p Mona -w Mona_wf -c "vm-wego-231:/felix"

Monitorování nejnovějšího spuštění pracovních postupů v zásadě:
   nsrpolicy monitor -p [zásada] -dn
   nsrpolicy monitor -p Mona -dn

Podrobný výstup úlohy pro konkrétní nedávnou úlohu:
   nsrpolicy monitor -j [id úlohy]
nsrpolicy monitor -j 290473

Chcete-li spustit pracovní postup v režimu ladění, není program nsrpolicy tak účinný jako příkaz nsrworkflow, protože příkaz nsrpolicy start nezaznamená výstup ladění do složky /nsr/logs/policy, což nástroj nsrworkflow zaznamená do nezpracovaného souboru.
   nsrworkflow -p [zásada] -w [workflow] -A "[akce]"
   nsrworkflow -D9 -p Newt -w newt1 -A "backup"

Kam chcete ladění umístit, závisí na přesné části procesu zálohování, na kterou se musíte podívat podrobněji.  Výše uvedený příkaz nsrworkflow vloží operace savegrp na straně serveru NetWorker do D9 a vypíše data ladění do nezpracovaného souboru v umístění /nsr/logs/policy.  Příznak ladění však nebude předán procesu ukládání na straně klienta NetWorker.  K tomu je třeba upravit pole "backup command" pro klienta.  K tomu můžete použít NMC nebo z příkazového řádku:

To způsobí, že se proces ukládání spustí v režimu ladění (D3 v níže uvedeném příkladu) a vypíše data protokolu ladění do složky

/nsr/logs/policy/[název zásady]/[název pracovního postupu]/_logs.NWserver121:> Program pro správu nsradmin
NetWorker.
Pro nápovědu použijte příkaz "help", pro režim
celé obrazovky použijte příkaz "visual".nsradmin> . Typ : Klient NSR; jméno : vm-lego-231
Aktuální sada
dotazů nsradmin> update záložní příkaz : save -D3
záložní příkaz: save -D3;
Aktualizace? y
aktualizováno ID zdroje 48.0.46.11.0.0.0.0.231.177.13.90.10.60.28.121(13)
záložní příkaz: save -D3;
Aktualizace? y
aktualizováno ID zdroje 45.0.185.125.0.0.0.0.126.197.192.89.10.60.28.121(34)
záložní příkaz: save -D3;
Aktualizace? y
Aktualizované ID zdroje 47.0.28.24.0.0.0.0.123.60.218.88.10.60.28.121(39)
záložní příkaz: save -D3;
Aktualizace? y
Aktualizované ID zdroje 64.0.28.24.0.0.0.0.123.60.218.88.10.60.28.121(35)
záložní příkaz: save -D3;
Aktualizace? y
Aktualizované ID zdroje 57.0.46.11.0.0.0.0.231.177.13.90.10.60.28.121(8)
záložní příkaz: save -D3;
Aktualizace? y
aktualizováno ID zdroje 49.0.62.11.0.0.0.0.118.31.239.89.10.60.28.121(5)

/nsr/logs/policy/Zinka/zinka_wf/zinka_backup_357042_logs


PŘÍKLADY SKRIPTŮ:

Tyto skripty jsou uvedeny jako příklady toho, co lze skriptovat pomocí tohoto příkazu.  Neměly by být implementovány v produkčním prostředí bez důkladného testování.

LINUX:
Příklad 1:  Výpis všech zásad a jejich pracovních postupů
Tento skript prostředí projde seznam zásad v konfiguraci NetWorker a u každé z nich spustí příkaz "nsrpolicy workflow list", takže výstupem je seznam názvů pracovních postupů pro každou zásadu.
cat listofworkflows.sh

#!/usr/bin/sh
IFS=$'\n'fullpolicylist
=('nsrpolicy policy list')

pro LP v "${fullpolicylist[@]}"
do
echo " "
echo "ZÁSADY: $lp"
echo "Workflows"
nsrpolicy workflow list -p "$lp"
done

Příklad 2:  Uveďte všechny zásady a jejich pracovní postupy a akce a cílový fond
.Tento skript prostředí spustí tři smyčky, aby získal seznam zásad, pracovních postupů a akcí.  Výstupem jsou názvy každého z nich a také parametr cílového uzlu úložiště akce.

cat listofworkflows_actions.sh
#!/usr/bin/sh
IFS=$'\n'fullpolicylist
=('nsrpolicy policy list')

pro LP v "${fullpolicylist[@]}"
do
echo "------------------ "
echo "POLICY: $lp"
wflist=('nsrpolicy workflow list -p $lp')
for w in "${wflist[@]}"
do
echo " "
echo "WORKFLOW: $w"
alist=('nsrpolicy action list -p $lp -w $w')
for a in "${alist[@]}"
do
echo "ACTION: $a"
destpool='nsrpolicy action display -p $lp -w $w -A $a | grep DestinationPool | cut -d ":" -f2'
echo "Cílový fond: $destpool"
done
done
donedone

Příklad 3 Spuštění zálohy pouze v případě, že existuje
konkrétní adresář Tento shellový skript zkontroluje, zda existuje adresář s názvem /k7app.  Pokud ano, spustí pracovní postup s názvem newt1 a zaznamená to do vyhrazeného souboru protokolu.  Pokud adresář neexistuje, zálohování se nespustí, tato skutečnost se zaznamená do stejného souboru protokolu.  Stejnou strukturu skriptu lze použít pro všechny okolnosti, kdy chcete, aby byl pracovní postup spuštěn pouze v případě, že je splněna určitá podmínka.

#!/usr/bin/sh
IFS=$'\n'dir
="/k7app"
log="/nsr/logs/k7applog.log"
DATE='date'if

[ -d "$dir" ]
then
nsrpolicy start -p Newt -w newt1
printf $DATE >> $log
printf " $dir je přítomen, proto se spustí pracovní postup newt1 \n" >> $log
else
printf $DATE >> $log
printf " $dir není k dispozici, proto se nespustí pracovní postup newt1 \n">>$log fi




WINDOWS POWERSHELL:

Příklad 1: Seznam pracovních postupů
Zobrazí seznam zásad a jejich pracovních postupů tak, že projde seznam zásad a pro každou zásadu spustíte příkaz "nsrpolicy workflow list".

$listp = nsrpolicy policy list
foreach ($i in $listp)
{
write-host "-----"
write-host "ZÁSADA: $i"
write-host "WORKFLOWS: "
nsrpolicy workflow list -p "$i"
}

Příklad 2:  Seznam akcí
Vytvoří se tři smyčky.  Smyčka pro výpis zásad a potom smyčka pro výpis všech pracovních postupů pro každou zásadu a pak smyčka pro výpis všech akcí pro každý pracovní postup.

$listp = nsrpolicy policy list
foreach ($p v $listp)
{
write-host "-----"
write-host "ZÁSADA: $p"
write-host "WORKFLOWS: "
$wlist = nsrpolicy workflow list -p $p
foreach ($w v $wlist)
{
write-host "$w"
   
write-host "ACTIONS:"
   $alist = nsrpolicy action list -p "$p" -w "$w"
foreach ($a v $alist)
{
write-host "$a"
}
}
}

Příklad 3 Spuštění zálohy pouze v případě, že existuje
určitý adresář Tento skript zkontroluje, zda existuje adresář s názvem C:\basicdata.  Pokud ano, spustí pracovní postup s názvem Star a zaprotokoluje to do vyhrazeného souboru protokolu.  Pokud adresář neexistuje, zálohování se nespustí, tato skutečnost se zaznamená do stejného souboru protokolu.  Stejnou strukturu skriptu lze použít pro všechny okolnosti, kdy chcete, aby byl pracovní postup spuštěn pouze v případě, že je splněna určitá podmínka.

$dir = "C:\basicdata"
$log = "C:\Program Files\EMC NetWorker\nsr\logs\star.log"$LogTime
= get-date -format "mm-dd-yyyy_hh-mm-ss"

if ( test-path "$dir" )
{ nsrpolicy start -p Star -w Workflow1
"------------------" | Out-File $log -Připojit -Vynutit
$LogTime | Out-File $log -Append -Force
"Started Star" | Out-File $log -Append -Force
}
else
{
"------------------" | Out-File $log -Připojit -Vynutit
$LogTime | Out-File $log -Append -Force
"Hvězda nebyla spuštěna, protože $dir neexistuje" | Out-File $log -Append -Force
}