NetWorker: De opdracht nsrpolicy gebruiken

De nsrpolicy opdracht is een beheeropdracht voor NetWorker die wordt gebruikt om NetWorker-beleidsregels te beheren en te bewaken. Veel van dezelfde functies worden uitgevoerd vanuit NetWorker Management (NMC) en Web UI (NWUI); Echter nsrpolicy Biedt beheerders opdrachtregelmogelijkheden.

 

nsrpolicy moet worden uitgevoerd onder een van de volgende omstandigheden:

• U voert de opdracht uit vanaf een prompt met verhoogde bevoegdheid. Ofwel Administrator Command/PowerShell prompt op Windows, of root/sudo shell op Linux.
• U voert de opdracht uit vanaf een prompt zonder bevoegdheden, maar u hebt een NetWorker-authenticatietoken uitgegeven: nsrlogin -u USERNAME

Algemeen gebruiksoverzicht:

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

Voorbeelden:

Objecten in de datazone weergeven:

nsrpolicy [object] list

Objecten: beleid, workflow, actie

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

De eigenschappen van een actie weergeven:
nsrpolicy action display -p [policy] -w [workflow] -A [action]

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

De eigenschappen van een groep weergeven:
nsrpolicy group display -g [group]

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

Een actie in- of uitschakelen:
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

Ga als volgt te werk om het schema dat aan een actie is gekoppeld te wijzigen:
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

Een client toevoegen aan een groep met behulp van een invoerbestand (er moet al een clientinstantie bestaan):
Maak een invoerbestand met de tekst:
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

Maak een nieuwe werkstroom met niet-standaardwaarden voor opmerking, begintijd en groep:
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"

Maak een nieuwe actie met niet-standaardwaarden voor de doelgroep en de succesdrempel:
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

Start een workflow (u kunt op deze manier geen actie starten. U moet de hele workflow starten).
nsrpolicy start -p [policy] -w [workflow]

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

Een workflow stoppen:
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

Start een client in een workflow:
nsrpolicy start -p [policy] -w [workflow] -c "[client]:[saveset]

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

Bewaak de meest recente uitvoering van de werkstromen in een beleid:
nsrpolicy monitor -p [policy] -dn

nsrpolicy monitor -p "Client Protection" -dn

Gedetailleerde taakuitvoer voor een specifieke recente taak:
nsrpolicy monitor -j [job id]

nsrpolicy monitor -j 290473

Om een workflow in de foutopsporingsmodus te starten, nsrpolicy is niet zo effectief als de nsrworkflow commando omdat 'nsrpolicy start' logt geen debug-uitvoer naar de /nsr/logs/policy map die nsrworkflow wil aan de .raw Bestand.
nsrworkflow -D[Debug Level] -p [policy] -w [workflow] -A "[action]"

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

Zie voor meer informatie over foutopsporingsniveaus van NetWorker: NetWorker: Informatieniveaus voor foutopsporing

Voorbeeld van inschakelen save -D3 maakt back-ups op een NetWorker-client met behulp van het opdrachtregelhulpprogramma 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)

In het bovenstaande voorbeeld, wanneer de workflow voor de client wordt gestart, wordt het save proces wordt gestart op de client met debug ingeschakeld (-D3), in casu.
Zie voor het debuggen van specifieke back-upfuncties: NetWorker: Fouten opsporen in back-upbewerkingen

Logboekregistratie:

Alle beleids- en workflowback-ups worden vastgelegd in de map NetWorker-logboeken:

Linux: /nsr/logs/policy/POLICY_NAME
Windows (standaard): C:\Program Files\EMC NetWorker\nsr\logs\policy\POLICY_NAME

 

Algemene serverberichten worden gelogd in de daemon.raw:

Linux: /nsr/logs/daemon.raw
Windows (standaard): C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw

NetWorker: De nsr_render_log gebruiken om .raw logbestanden weer te geven

Voorbeelden van scripts:

Linux:

Voorbeeld 1:  Maak een lijst van alle beleidsregels en hun workflows. Dit shellscript voert een lus uit door de lijst met beleidsregels in de NetWorker-configuratie en voert de opdracht "nsrpolicy workflow list" tegen elk, zodat het een lijst met workflownamen voor elk beleid uitvoert.

#!/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

Voorbeeld 2:  Maak een lijst van alle beleidsregels en hun workflows en acties en de bestemmingspool. Dit shellscript voert drie lussen uit om de lijst met beleidsregels, werkstromen en acties te krijgen. De namen van elk worden uitgevoerd en de parameter van het doelstorageknooppunt van de actie.

#!/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:

Voorbeeld 1: Lijst met workflows. Hiermee worden de beleidsregels en hun werkstromen weergegeven door de beleidslijst te doorlopen en voor elk beleid de opdracht "nsrpolicy workflow list" uit te voeren.

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

Voorbeeld 2:  Lijst van acties. Er worden drie lussen gemaakt. Een lus om de beleidsregels weer te geven en vervolgens een lus om alle werkstromen voor elk beleid weer te geven en vervolgens een lus om alle acties voor elke werkstroom weer te geven.

$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 is de NetWorker Policy Administration-opdracht die begint met NetWorker 9.  Een groot deel van het beheer via de opdrachtregel van NetWorker, dat voorheen werd uitgevoerd met nsradmin, wordt nu uitgevoerd met de opdracht nsrpolicy.

De eerste stap is om u aan te melden bij de NetWorker-server op de opdrachtregel met de opdracht nsrlogin met dezelfde referenties die u gebruikt om u aan te melden bij de NetWorker Management Console. Wanneer u de opdracht nsrlogin uitvoert, neemt de NetWorker-host contact op met de NetWorker AuthenticationService om de aanmeldingsreferenties van de gebruiker te valideren.

nsrlogin -u [gebruikersnaam] - p [wachtwoord]

De opdracht nsrpolicy biedt een aantal verschillende opties op elk niveau.  Als u bij elke stap op de enter-toets drukt, krijgt u de volledige lijst met beschikbare opties voor het volgende deel van uw opdracht:

nsrpolicy
       policy
           create | delete | display | update | update | list
       workflow
           create | delete | display | update | list
       action
          create | delete | display | update | list
       group
           create | delete | display | update
       start
           Moet beschikken over: -p [beleid] -w [workflow]
           Andere opties (NetWorker 9.2 en hoger voor optie -c):  -c { <client_name1:[save_set_path_1; save_set_path_2],client_name2...>   -s [NetWorker server] -D [foutopsporingsniveau] -h
       stoppen
            Moet beschikken over:  Ofwel -j [jobid] of -p [policy] -w [workflow]
            Overige opties: -s [NetWorker server] -D [foutopsporingsniveau] -h
       monitor
            Moet beschikken over:  -p [beleid]
            Overige opties:   -w [workflow] -c [client] -g [group] -d [details] -n [niet-tabellarisch] -j [jobid] -s [NetWorker server] -D [foutopsporingsniveau] -h
       Input-bestand
             Moet beschikken over:  -f [bestandsnaam]
             Overige opties:   [--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:  Ofwel -j [jobid] of -p [policy] -w [workflow]
             Overige opties: -s [NetWorker server] -D [foutopsporingsniveau] -h
       trekken
             Moet hebben wat moet worden gemigreerd: groep | schedule_clone | nas_device | vmware_policy
             Andere opties:  -s [NetWorker server] -D [foutopsporingsniveau] -h
       Help

VOORBEELDEN VAN DE OPDRACHTREGEL:

Lijstbeleidsregels in de datazone
   NSRPOLICY-beleidslijst
   NSRPOLICY-beleidslijst

De eigenschappen van een actie weergeven:
   nsrpolicy action display -p [policy] -w [workflow] -A [action]
   nsrpolicy action display -p Mona -w Mona_wf -A backup

De eigenschappen van een groep weergeven:
   nsrpolicy group display -g [group]
   nsrpolicy group display -g Felix

Een actie uitschakelen:
   nsrpolicy action update [action type backup subtype] -p [policy] -w [workflow] -A [action] -e no
nsrpolicy action update backup traditional -p FrankHoenikker -w FrankH -A backup -e no
 
Ga als volgt te werk om het schema dat aan een actie is gekoppeld te wijzigen:
   nsrpolicy action update [action type backup subtype] -p [policy] -w [workflow] -A [action] -t [schedule]
nsrpolicy action update backup traditional -p Mona -w Mona_wf -A backup -t full,incr,incr,incr,incr,incr,incr,incr
 
Voeg een client toe aan een groep met behulp van een invoerbestand (clientinstantie moet al bestaan):
   Maak een invoerbestand aan met de tekst: 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 "[path to input file]"
nsrpolicy input-file -f "/nsr/AddAlicetoTheHook.input"
 
Create a new workflow with non-default values for comment, start-time and group:
   nsrpolicy workflow create -p [policy] -w [workflow] -c [comment] -g [group] -S [starttijd]
nsrpolicy workflow create -p Mona -w Papa -c "Workflow for RedHat 6 clients" -g PapaMgroup -S "10:00"

Create a new action with non-default values for the target pool and success threshold
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 Mona -w Papa -A papabackup -o SanLorenzoDDPool -u success

Start a workflow (Let op: u kunt op deze manier geen actie starten.  U moet de hele workflow starten).
   nsrpolicy start -p [policy] -w [workflow]
nsrpolicy start -p Mona -w Mona_wf

Stop een workflow (u kunt relevante jobid krijgen met behulp van de 'nsrpolicy monitor' comand - zie hieronder):
   nsrpolicy stop -j [jobid]
nsrpolicy stop -j 320819

Start een client in een workflow:
   nsrpolicy start -p [policy] -w [workflow] -c "[client]:[saveset]
nsrpolicy start -p Mona -w Mona_wf -c "vm-wego-231:/felix"

Bewaak de meest recente uitvoering van de werkstromen in een beleid:
   nsrpolicy monitor -p [policy] -dn
   nsrpolicy monitor -p Mona -dn

Gedetailleerde taakuitvoer voor een specifieke recente taak:
   nsrpolicy monitor -j [taak-id]
NSRPOLICY Monitor -J 290473

Om een werkstroom te starten in de foutopsporingsmodus, is nsrpolicy niet zo effectief als de opdracht nsrworkflow, omdat 'nsrpolicy start' de foutopsporingsuitvoer niet logt in de map /nsr/logs/policy, wat nsrworkflow wel zal doen in het RAW-bestand.
   nsrworkflow -p [policy] -w [workflow] -A "[action]"
   nsrworkflow -D9 -p Newt -w newt1 -A "backup"Waar u de foutopsporing wilt plaatsen,

hangt af van het precieze deel van het back-upproces dat u in meer detail moet bekijken.  De bovenstaande opdracht nsrworkflow plaatst de savegrp-bewerkingen aan de serverzijde van NetWorker in D9 en voert de foutopsporingsdata uit naar het RAW-bestand in /nsr/logs/policy.  De foutopsporingsvlag wordt echter niet doorgegeven aan het opslagproces aan de NetWorker-clientzijde.  Om dit te doen, moet u het veld "backup command" voor de client wijzigen.  U kunt hiervoor de NMC gebruiken, of via de opdrachtregel:

Hierdoor wordt het opslagproces uitgevoerd in de foutopsporingsmodus (D3 in het onderstaande voorbeeld) en voert u de foutopsporingslogboekgegevens uit naar de map /nsr/logs/policy/[policy name]/[workflownaam]/ _logs.

NWserver121:> nsradmin
NetWorker Administration Program.
Gebruik de opdracht "help" voor help, "visual" voor volledig scherm.
nsradmin> . type : NSR-klant; Naam : vm-lego-231
Current query set
nsradmin> update backup commando : save -D3
backup command: save -D3;
Update? y
bijgewerkte resource-id 48.0.46.11.0.0.0.0.231.177.13.90.10.60.28.121(13)
back-upopdracht: save -D3;
Update? y
bijgewerkte resource-id 45.0.185.125.0.0.0.0.126.197.192.89.10.60.28.121(34)
back-upopdracht: save -D3;
Update? y
bijgewerkte resource-id 47.0.28.24.0.0.0.0.123.60.218.88.10.60.28.121(39)
back-upopdracht: save -D3;
Update? y
bijgewerkte resource-id 64.0.28.24.0.0.0.0.123.60.218.88.10.60.28.121(35)
back-upopdracht: save -D3;
Update? y
bijgewerkte resource-id 57.0.46.11.0.0.0.0.231.177.13.90.10.60.28.121(8)
back-upopdracht: save -D3;
Update? Y
bijgewerkte resource-ID 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


SCRIPTVOORBEELDEN:

Deze scripts worden gegeven als voorbeelden van wat er met deze opdracht kan worden gescript.  Ze mogen niet worden geïmplementeerd in een productieomgeving zonder grondige tests.

LINUX:
Voorbeeld 1:  Maak een lijst van alle beleidsregels en hun workflows
Dit shellscript voert een lus uit door de lijst met beleidsregels in de NetWorker-configuratie en voert de opdracht "nsrpolicy workflow list" uit voor elk beleid, zodat een lijst met werkstroomnamen voor elk beleid wordt uitgevoerd.
cat listofworkflows.sh

#!/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

Voorbeeld 2:  Maak een lijst van alle beleidsregels en hun workflows en acties en de bestemmingspool
Dit shellscript voert drie loops uit om de lijst met beleidsregels, workflows en acties te krijgen.  De namen van elke naam worden uitgevoerd, evenals de parameter van het doelstorageknooppunt van de actie.

cat listofworkflows_actions.sh
#!/usr/bin/sh
IFS=$'\n'FullPolicyList
=('nsrPolicy Policy List')

for lp in "${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')
fora in "${alist[@]}"
do
echo "ACTION: $a"
destpool='nsrpolicy action display -p $lp -w $w -A $a | grep DestinationPool | cut -d ":" -f2'
echo "Destination Pool: $destpool"
done
done
doneVoorbeeld

3: Een back-up alleen uitvoeren als er een specifieke directory bestaat
Dit shellscript controleert of er een directory met de naam /k7app bestaat.  Als dit het geval is, wordt de workflow met de naam newt1 gestart en wordt vastgelegd dat dit is gebeurd in een speciaal logboekbestand.  Als de map niet bestaat, wordt de back-up niet uitgevoerd die wordt vastgelegd in hetzelfde logbestand.  Dezelfde scriptstructuur kan worden gebruikt voor elke omstandigheid waarin u wilt dat een werkstroom alleen wordt uitgevoerd wanneer aan een specifieke voorwaarde is voldaan.

#!/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 is aanwezig, dus het starten van newt1 workflow \n" >> $log
anders
printf $DATE $log
>>printf " $dir is niet aanwezig, dus het starten van newt1 workflow \n">>$log fi




WINDOWS POWERSHELL:

Voorbeeld 1: Lijst met workflows
Hiermee worden de beleidsregels en hun werkstromen weergegeven door de beleidslijst te doorlopen en voor elk beleid de opdracht "nsrpolicy workflow list" uit te voeren.

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

Voorbeeld 2:  Lijst met acties
Er worden drie lussen gemaakt.  Een lus om de beleidsregels weer te geven en vervolgens een lus om alle werkstromen voor elk beleid weer te geven en vervolgens een lus om alle acties voor elke werkstroom weer te geven.

$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"
}
}
}

Voorbeeld 3 Voer alleen een back-up uit als er een specifieke directory bestaat
Dit script controleert of er een directory met de naam C:\basicdata bestaat.  Als dit het geval is, wordt de workflow met de naam Star gestart en wordt dit geregistreerd in een speciaal logboekbestand.  Als de map niet bestaat, wordt de back-up niet uitgevoerd die wordt vastgelegd in hetzelfde logbestand.  Dezelfde scriptstructuur kan worden gebruikt voor elke omstandigheid waarin u wilt dat een werkstroom alleen wordt uitgevoerd wanneer aan een specifieke voorwaarde is voldaan.

$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 -Append -Force
$LogTime | Out-File $log -Append -Force
"Started Star" | Out-File $log -Append -Force
}
else
{
"------------------" | Out-File $log -Append -Force
$LogTime | Out-File $log -Append -Force
"Ster niet gestart omdat $dir niet bestaat" | Out-file $log -append -force
}