NetWorker. Как использовать команду nsrpolicy

Переменная nsrpolicy command — это административная команда NetWorker, которая используется для управления политиками NetWorker и их мониторинга. Многие из тех же функций выполняются в NetWorker Management (NMC) и Web UI (NWUI); Однако nsrpolicy Предоставляет администраторам возможности командной строки.

 

nsrpolicy Этот параметр должен выполняться при выполнении одного из следующих условий:

• Вы запускаете команду из командной строки с повышенными привилегиями. Либо команда администратора/командная строка PowerShell в Windows, либо root/sudo shell в Linux.
• Вы выполняете команду из командной строки без повышенных прав, но выдали токен аутентификации NetWorker: nsrlogin -u USERNAME

Общий обзор использования:

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

Примеры:

Вывод списка объектов в зоне данных:

nsrpolicy [object] list

Объекты: политика, рабочий процесс, действие

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

Отобразить свойства действия:
nsrpolicy action display -p [policy] -w [workflow] -A [action]

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

Отобразить свойства группы:
nsrpolicy group display -g [group]

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

Отключение или включение действия:
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

Чтобы изменить расписание, связанное с действием, выполните следующие действия:
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

Добавьте клиента в группу с помощью входного файла (экземпляр клиента уже должен существовать):
Создайте входной файл с текстом:
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

Создайте новый рабочий процесс со значениями, отличными от значений по умолчанию для comment, start-time и group:
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"

Создайте новое действие со значениями, отличными от значений по умолчанию для целевого пула и пороговым значением для успешности:
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

Запустите рабочий процесс (таким образом нельзя запустить действие). Необходимо запустить весь рабочий процесс).
nsrpolicy start -p [policy] -w [workflow]

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

Остановка рабочего процесса:
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

Запуск одного клиента в рабочем процессе:
nsrpolicy start -p [policy] -w [workflow] -c "[client]:[saveset]

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

Отслеживайте последний запуск рабочих процессов в политике:
nsrpolicy monitor -p [policy] -dn

nsrpolicy monitor -p "Client Protection" -dn

Подробные выходные данные для конкретной недавней задачи:
nsrpolicy monitor -j [job id]

nsrpolicy monitor -j 290473

Чтобы запустить рабочий процесс в режиме отладки, nsrpolicy не так эффективен, как nsrworkflow команда, потому что 'nsrpolicy start' не регистрирует отладочные выходные данные в /nsr/logs/policy папка, которая nsrworkflow воля к .raw .
nsrworkflow -D[Debug Level] -p [policy] -w [workflow] -A "[action]"

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

Дополнительные сведения об уровнях отладки NetWorker см. в разделе: NetWorker. Уровни отладочной информации

Пример включения save -D3 Резервное копирование на клиенте NetWorker с помощью утилиты командной строки 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)

В приведенном выше примере при запуске рабочего процесса для клиента save Процесс запускается на клиенте с включенной отладкой (-D3) в данном случае.
Сведения об отладке конкретных функций резервного копирования см. в разделе: NetWorker. Как отладить операции резервного копирования

Ведение журнала:

Все резервные копии политик и рабочих процессов записываются в каталог журналов NetWorker:

Linux: /nsr/logs/policy/POLICY_NAME
Windows (по умолчанию): C:\Program Files\EMC NetWorker\nsr\logs\policy\POLICY_NAME

 

Общие сообщения сервера регистрируются в daemon.raw:

Linux: /nsr/logs/daemon.raw
Windows (по умолчанию): C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw

NetWorker. Как использовать nsr_render_log для рендеринга файлов .raw журналов

Примеры сценариев:

Linux:

Пример 1  Перечислите все политики и соответствующие рабочие процессы. Этот сценарий оболочки выполняет циклический перебор списка политик в конфигурации NetWorker и выполняет команду «nsrpolicy workflow list» для каждой из них, чтобы вывести список имен рабочих процессов для каждой политики.

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

Пример 2  Перечислите все политики, их рабочие процессы и действия, а также целевой пул. Этот сценарий оболочки выполняет три цикла для получения списка политик, рабочих процессов и действий. Будут выведены имена каждого из них, а также параметр целевого узла хранения действия.

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

Пример 1 Список рабочих процессов. Выводит список политик и их рабочих процессов путем циклического перебора списка политик и выполнения команды «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"
}

Пример 2  Перечень действий. Создаются три петли. Цикл для вывода списка политик, затем цикл для перечисления всех рабочих процессов для каждой политики, а затем цикл для перечисления всех действий для каждого рабочего процесса.

$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 — это команда администрирования политики NetWorker, начиная с NetWorker 9.  Большая часть администрирования NetWorker с помощью командной строки, которая ранее выполнялась с помощью nsradmin, теперь выполняется с помощью команды nsrpolicy.

Первым шагом является вход на сервер NetWorker в командной строке с помощью команды nsrlogin с теми же учетными данными, которые используются для входа в NetWorker Management Console.При выполнении команды nsrlogin хост NetWorker связывается со службой проверки подлинности NetWorker для проверки учетных данных пользователя для входа.

nsrlogin -u [имя пользователя] - p [пароль]

Команда nsrpolicy имеет несколько различных параметров, доступных на каждом уровне.  Нажимая клавишу Enter на каждом шаге, вы получите полный список доступных параметров для следующей части вашей команды command:

nsrpolicy
policy
policy create | delete | display | update | list
workflowcreate | delete | display | update | list
action
create | delete | display | update |list action
create | delete | display | update | list
group
create | delete | display | update
start
Необходимо иметь:                                                                                         -p [политика] -w [рабочий процесс]
           Другие варианты (NetWorker 9.2 и выше для параметра -c):  -c { client_name1 <:[save_set_path_1; save_set_path_2],client_name2...>   -s [сервер NetWorker] -D [уровень отладки] -h
       остановка
            Необходимо иметь:  Либо -j [jobid], либо -p [политика] -w [рабочий процесс]
            Другие варианты: -s [сервер NetWorker] -D [уровень отладки] -h
       монитор
            Необходимо иметь:  -p [политика]
            Другие варианты:   -w [рабочий процесс] -c [клиент] -g [группа] -d [подробности] -n [не табулярный] -j [jobid] -s [сервер NetWorker] -D [уровень отладки] -h
       Входной файл
             Необходимо иметь:  -f [имя файла]
             Другие варианты:   [--stop_on_error -S <0/1; по умолчанию:0 (Не останавливать)>] [--stop_on_error -S <0/1; по умолчанию:0 (Не останавливать)>] -D [уровень отладки] -h
      Перезапуск
             Необходимо иметь:  Либо -j [jobid], либо -p [политика] -w [рабочий процесс]
             Другие варианты: -s [сервер NetWorker] -D [уровень отладки] -h
       мигрировать
             Необходимо иметь то, что нужно перенести: group | schedule_clone | nas_device | vmware_policy
             Другие параметры:  -s [сервер NetWorker] -D [уровень отладки] -h
       Справка

ПРИМЕРЫ КОМАНДНОЙ СТРОКИ:

Список политик в зоне
   данных список политик
   nsrpolicy список политик

nsrpolicy Отобразить свойства действия:
   nsrpolicy action display -p [политика] -w [рабочий процесс] -A [действие]
   nsrpolicy action display -p Mona -w Mona_wf -A backup

Отобразить свойства группы:
   Отображение группы nsrPolicy -G [группа]
   nsrpolicy group display -g Felix

Отключите действие:
   nsrpolicy action update [тип действия резервного копирования] -p [политика] -w [рабочий процесс] -A [действие] -e нет
nsrpolicy action update backup традиционный -p FrankHoenikker -w FrankH -A backup -e no
 
Чтобы изменить расписание, связанное с действием, выполните следующие действия:
   nsrpolicy action update [подтип резервного копирования типа действия] -p [политика] -w [рабочий процесс] -A [действие] -t [расписание]
nsrpolicy action update backup традиционный -p Mona -w Mona_wf -A backup -t полный,incr,incr,incr,incr,incr,incr,incr
 
Добавьте клиента в группу с помощью входного файла (экземпляр клиента уже должен существовать):
   Создайте входной файл с текстом: 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 "[путь к входному файлу]"
nsrpolicy input-file -f "/nsr/AddAlicetoTheHook.input"
 
Создайте новый рабочий процесс со значениями, отличными от значений по умолчанию для comment, start-time и group:
   nsrpolicy workflow create -p [политика] -w [рабочий процесс] -c [комментарий] -g [группа] -S [время начала]
nsrpolicy workflow create -p Mona -w Papa -c "Workflow for RedHat 6 clients" -g PapaMgroup -S "10:00"

Создайте новое действие со значениями, отличными от значений по умолчанию для целевого пула и порога
успешности nsrpolicy action create [подтип резервного копирования типа действия] -p [политика] -w [рабочий процесс] -A [действие] -o [целевой пул] -u [порог успешности]
действие nsrpolicy создать резервную копию традиционное -p Mona -w Papa -A papabackup -o SanLorenzoDDPool -u success

Запустите рабочий процесс (Обратите внимание, что вы не можете запустить действие таким образом.  Необходимо запустить весь рабочий процесс).
   nsrpolicy start -p [политика] -w [рабочий процесс]
nsrpolicy start -p Mona -w Mona_wf

Остановите рабочий процесс (вы можете получить соответствующий jobid с помощью команды 'nsrpolicy monitor' - см. ниже):
   NSRPOLICY stop -j [jobID]
NSRPOLICY stop -J 320819

Запуск одного клиента в рабочем процессе:
   nsrpolicy start -p [политика] -w [рабочий процесс] -c "[client]:[saveset]
nsrpolicy start -p Mona -w Mona_wf -c "vm-wego-231:/felix"

Отслеживайте последний запуск рабочих процессов в политике:
   NSRPOLICY Monitor -P [политика]-dn
   nsrpolicy monitor -p Mona -dn

Подробные выходные данные для конкретной недавней задачи:
   NSRPOLICY Monitor -J [идентификатор задания]
NSRPOLICY Monitor -J 290473

Для запуска рабочего процесса в режиме отладки nsrpolicy не так эффективна, как команда nsrworkflow, поскольку команда «nsrpolicy start» не записывает выходные данные отладки в папку /nsr/logs/policy, в отличие от nsrworkflow в необработанном файле.
   nsrworkflow -p [политика] -w [рабочий процесс] -A "[действие]"
   nsrworkflow -D9 -p Newt -w newt1 -A "backup"

Где вы хотели бы разместить отладку, зависит от конкретной части процесса резервного копирования, которую вам нужно рассмотреть более подробно.  Приведенная выше команда nsrworkflow поместит операции savegrp на стороне сервера NetWorker в D9 и выведет отладочные данные в необработанный файл в /nsr/logs/policy.  Однако он не передаст флаг отладки процессу сохранения на стороне клиента NetWorker.  Для этого необходимо изменить поле «команда резервного копирования» для клиента.  Для этого можно использовать NMC или из командной строки:

Это приведет к запуску процесса сохранения в режиме отладки (D3 в приведенном ниже примере) и выводу данных журнала отладки в папку /nsr/logs/policy/[имя политики]/[имя рабочего процесса]/_logs.

NWserver121:> nsradmin
, программа администрирования NetWorker.
Используйте команду «help» для справки, «visual» для полноэкранного режима.
nsradmin> . Тип: Клиент СМП; имя : vm-lego-231
Текущий набор
запросов nsradmin> update backup command : save -D3 backup command: save -D3
;
Обновлять? y
обновлен идентификатор ресурса 48.0.46.11.0.0.0.0.231.177.13.90.10.60.28.121(13)
команда резервного копирования: save -D3;
Обновлять? y
обновлен идентификатор ресурса 45.0.185.125.0.0.0.0.126.197.192.89.10.60.28.121(34)
команда резервного копирования: save -D3;
Обновлять? y
обновлен идентификатор ресурса 47.0.28.24.0.0.0.0.123.60.218.88.10.60.28.121(39)
команда резервного копирования: save -D3;
Обновлять? y
обновлен идентификатор ресурса 64.0.28.24.0.0.0.0.123.60.218.88.10.60.28.121(35)
команда резервного копирования: save -D3;
Обновлять? y обновлен идентификатор ресурса
57.0.46.11.0.0.0.0.231.177.13.90.10.60.28.121(8)
команда резервного копирования: save -D3;
Обновлять? y
обновленный идентификатор ресурса 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


ПРИМЕРЫ СКРИПТОВ:

Эти сценарии приведены в качестве примеров того, что можно заскриптовать с помощью этой команды.  Их не следует внедрять в производственной среде без тщательного тестирования.

LINUX:
Пример 1:  Перечислите все политики и соответствующие рабочие процессы
Этот сценарий оболочки выполняет циклический перебор списка политик в конфигурации NetWorker и выполняет команду «nsrpolicy workflow list» для каждой из них, так что выводится список имен рабочих процессов для каждой политики.
cat listofworkflows.sh

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

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

Пример 2:  Перечислите все политики, их рабочие процессы и действия, а также целевой пул
Этот сценарий оболочки выполняет три цикла для получения списка политик, рабочих процессов и действий.  Будут выведены имена каждого из них, а также параметр целевого узла хранения действия.

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

для 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')
for a in "${alist[@]}"
do
echo "ACTION: $a"
destpool='nsrpolicy action display -p $lp -w $w -A $a | grep DestinationPool | cut -d ":" -f2'
echo "Пул назначения: $destpool" выполнено
,
выполнено


Пример 3 Выполнение резервного копирования, только если существует
определенный каталог Этот сценарий оболочки проверяет, существует ли каталог с именем /k7app.  Если это так, он запускает рабочий процесс с именем newt1 и записывает это в специальный файл журнала.  Если каталога не существует, резервное копирование не выполняется, этот факт регистрируется в том же файле журнала.  Одна и та же структура скрипта может быть использована в любых случаях, когда вы хотите, чтобы рабочий процесс запускался только при выполнении определенного условия.

#!/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 присутствует, поэтому запуск рабочего процесса newt1 \n">>$log
противном случае
printf $DATE >> $log
printf " $dir отсутствует, поэтому не запускает рабочий процесс newt1 \n">>$log fi




WINDOWS POWERSHELL.

Пример 1: Список рабочих процессов
Выводит список политик и их рабочих процессов путем циклического перебора списка политик и выполнения команды «nsrpolicy workflow list» для каждой политики.

$listp = список политик nsrpolicy foreach
($i в $listp)
{
write-host "-----"
write-host "POLICY: $i"
write-host" РАБОЧИЕ ПРОЦЕССЫ: "
nsrpolicy workflow list -p "$i"
}

Пример 2:  Список действий
Создаются три цикла.  Цикл для вывода списка политик, затем цикл для перечисления всех рабочих процессов для каждой политики, а затем цикл для перечисления всех действий для каждого рабочего процесса.

$listp = список политик nsrpolicy foreach
($p в $listp)
{
write-host "-----"
write-host "POLICY: $p"
write-host" РАБОЧИЕ ПРОЦЕССЫ: "
$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"
}
}
}Example

3 Выполнять резервное копирование, только если существует определенный каталог Этот
сценарий проверяет, существует ли каталог с именем C:\basicdata.  Если это так, запускается рабочий процесс с именем «Star», и запись о том, что это произошло, в специальный файл журнала.  Если каталога не существует, резервное копирование не выполняется, этот факт регистрируется в том же файле журнала.  Одна и та же структура скрипта может быть использована в любых случаях, когда вы хотите, чтобы рабочий процесс запускался только при выполнении определенного условия.

$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
"Запущенная звезда" | Out-File $log -append -force
}
else
{
"------------------" | Out-File $log -Append -Force
$LogTime | Out-File $log -Append -Force
"Звезда не запущена, потому что $dir не существует" | Out-File $log -append -force
}