Blame ndmp-src/ThingsToTry

Packit Service 392537
THINGS TO TRY
Packit Service 392537
=============
Packit Service 392537
Packit Service 392537
Check the build:
Packit Service 392537
Packit Service 392537
	% ndmjob -help
Packit Service 392537
	% ndmjob -v
Packit Service 392537
Packit Service 392537
The Query tests are about like the Connectathon
Packit Service 392537
NDMPvX-COMMON tests.
Packit Service 392537
Packit Service 392537
Query your DATA agent:
Packit Service 392537
Packit Service 392537
	% ndmjob -q -Dmyhost,logon,passwd
Packit Service 392537
Packit Service 392537
Query your DATA agent, force NDMPv2
Packit Service 392537
Packit Service 392537
	% ndmjob -q -Dmyhost/2,logon,passwd
Packit Service 392537
Packit Service 392537
Query your DATA agent, force NDMPv3
Packit Service 392537
Packit Service 392537
	% ndmjob -q -Dmyhost/3,logon,passwd
Packit Service 392537
Packit Service 392537
Query resident DATA agent. Force NDMPv2 and NDMPv3.
Packit Service 392537
Packit Service 392537
	% ndmjob -q -D./2
Packit Service 392537
	% ndmjob -q -D./3
Packit Service 392537
Packit Service 392537
Query your TAPE agent:
Packit Service 392537
Packit Service 392537
	% ndmjob -q -Tmyhost,logon,passwd
Packit Service 392537
Packit Service 392537
Query your ROBOT (see -help for DEV,CTRL,SID,LUN)
Packit Service 392537
Packit Service 392537
	% ndmjob -q -Rmyhost,logon,passwd -r DEV,CTRL,SID,LUN
Packit Service 392537
Packit Service 392537
Query your DATA agent, produce a log file
Packit Service 392537
Packit Service 392537
	% ndmjob -q -Dmyhost,logon,passwd -L log-file
Packit Service 392537
Packit Service 392537
Query your DATA agent, produce a detailed log file
Packit Service 392537
Packit Service 392537
	% ndmjob -q -Dmyhost,logon,passwd -L log-file -d5
Packit Service 392537
Packit Service 392537
Query your DATA agent, produce a very detailed log file,
Packit Service 392537
verbose to stdout
Packit Service 392537
Packit Service 392537
	% ndmjob -q -Dmyhost,logon,passwd -L log-file -d6 -v
Packit Service 392537
Packit Service 392537
Packit Service 392537
From here down, combinations of forcing NDMPv2/v3 on
Packit Service 392537
each the DATA and TAPE agent are possible. These
Packit Service 392537
tests correspond to the Connectathon NDMPvX-TAPE
Packit Service 392537
and NDMPvX-DATA tests.
Packit Service 392537
Packit Service 392537
Packit Service 392537
Run a test series on your TAPE agent. If things get
Packit Service 392537
dicey, produce a log and check it
Packit Service 392537
Packit Service 392537
	% ndmjob -o test-tape -T myhost,logon,passwd -f /dev/whatever
Packit Service 392537
	% ndmjob -o test-mover -T myhost,logon,passwd -f /dev/whatever
Packit Service 392537
Packit Service 392537
Resident TAPE agent test
Packit Service 392537
Packit Service 392537
	% rm -f FakeTape
Packit Service 392537
	% touch FakeTape
Packit Service 392537
Packit Service 392537
	% ndmjob -o test-tape -T./2 -f FakeTape
Packit Service 392537
	% ndmjob -o test-mover -T./2 -f FakeTape
Packit Service 392537
Packit Service 392537
	% ndmjob -o test-tape -T./3 -f FakeTape
Packit Service 392537
	% ndmjob -o test-mover -T./3 -f FakeTape
Packit Service 392537
Packit Service 392537
Packit Service 392537
Packit Service 392537
Create a small directory system, like /tmp/test-data.
Packit Service 392537
About 100 files amounting to about 5mb should be good.
Packit Service 392537
A couple of big files in there would be good.
Packit Service 392537
Packit Service 392537
	cd /tmp
Packit Service 392537
	tar xzvf tough.tgz.bin
Packit Service 392537
Packit Service 392537
Create a backup to your TAPE agent. Create an index
Packit Service 392537
in file c-index.
Packit Service 392537
Packit Service 392537
	% ndmjob -c \
Packit Service 392537
		-D. -C /tmp -F tough -I c-index \
Packit Service 392537
		-Tmyhost,logon,passwd -f /dev/whatever
Packit Service 392537
Packit Service 392537
Recover the file index. Your DATA agent might not implement
Packit Service 392537
NDMPx_DATA_START_RECOVER_FILEHIST, but that doesn't matter.
Packit Service 392537
This is using the NDMJOB resident DATA agent, and it does.
Packit Service 392537
This first test will read the entire tape.
Packit Service 392537
Packit Service 392537
	% ndmjob -t \
Packit Service 392537
		-D. -I t-seq-index \
Packit Service 392537
		-Tmyhost,logon,passwd -f /dev/whatever
Packit Service 392537
Packit Service 392537
	% diff c-index t-seq-index
Packit Service 392537
Packit Service 392537
Now, do the same thing, but enable direct access. The
Packit Service 392537
NDMJOB DATA agent will issue DATA_READ requests and
Packit Service 392537
pick through the image stream to get to just the tar
Packit Service 392537
headers.
Packit Service 392537
Packit Service 392537
	% ndmjob -t \
Packit Service 392537
		-D. -I t-dir-index -E RECOVER_DIRECT=yes \
Packit Service 392537
		-Tmyhost,logon,passwd -f /dev/whatever
Packit Service 392537
Packit Service 392537
	% diff c-index t-dir-index
Packit Service 392537
Packit Service 392537
Packit Service 392537
Same series using only resident agents
Packit Service 392537
Packit Service 392537
	% ndmjob -cvv \
Packit Service 392537
		-D. -C /tmp -F tough -I c-index \
Packit Service 392537
		-f FakeTape
Packit Service 392537
Packit Service 392537
	% ndmjob -tvv \
Packit Service 392537
		-D. -I t-seq-index -E RECOVER_DIRECT=no \
Packit Service 392537
		-f FakeTape
Packit Service 392537
Packit Service 392537
	% diff c-index t-seq-index
Packit Service 392537
Packit Service 392537
	% ndmjob -tvv \
Packit Service 392537
		-D. -I t-dir-index -E RECOVER_DIRECT=yes \
Packit Service 392537
		-f FakeTape
Packit Service 392537
Packit Service 392537
	% diff c-index t-dir-index
Packit Service 392537
Packit Service 392537
Packit Service 392537
Same series using only resident DATA and TAPE on local host
Packit Service 392537
Packit Service 392537
	% ndmjob -o daemon &
Packit Service 392537
Packit Service 392537
	% ndmjob -cvv \
Packit Service 392537
		-D. -C /tmp -F tough -I c-index \
Packit Service 392537
		-Tlocalhost,ndmp,ndmp -f FakeTape
Packit Service 392537
Packit Service 392537
	% ndmjob -tvv \
Packit Service 392537
		-D. -I t-seq-index -E RECOVER_DIRECT=no \
Packit Service 392537
		-Tlocalhost,ndmp,ndmp -f FakeTape
Packit Service 392537
Packit Service 392537
	% diff c-index t-seq-index
Packit Service 392537
Packit Service 392537
	% ndmjob -tvv \
Packit Service 392537
		-D. -I t-dir-index -E RECOVER_DIRECT=yes \
Packit Service 392537
		-Tlocalhost,ndmp,ndmp -f FakeTape
Packit Service 392537
Packit Service 392537
	% diff c-index t-dir-index
Packit Service 392537
Packit Service 392537
Packit Service 392537
Same series using DATA and TAPE on local host. This is
Packit Service 392537
like the Connectathon NDMPvX-LOCAL tests:
Packit Service 392537
Packit Service 392537
	% ndmjob -o daemon &
Packit Service 392537
Packit Service 392537
	% ndmjob -cvv \
Packit Service 392537
		-Dlocalhost,, -C /tmp -F tough -I c-index \
Packit Service 392537
		-f FakeTape
Packit Service 392537
Packit Service 392537
	% ndmjob -tvv \
Packit Service 392537
		-Dlocalhost,, -I t-seq-index -E RECOVER_DIRECT=no \
Packit Service 392537
		-f FakeTape
Packit Service 392537
Packit Service 392537
	% diff c-index t-seq-index
Packit Service 392537
Packit Service 392537
	% ndmjob -tvv \
Packit Service 392537
		-Dlocalhost,, -I t-dir-index -E RECOVER_DIRECT=yes \
Packit Service 392537
		-Tlocalhost,, -f FakeTape
Packit Service 392537
Packit Service 392537
	% diff c-index t-dir-index
Packit Service 392537
Packit Service 392537
Packit Service 392537
Packit Service 392537
If you have a tape robot, you MUST specify -m MEDIA options.
Packit Service 392537
The next set of tests verifies NDMP_MOVER window handling
Packit Service 392537
and discovery.
Packit Service 392537
Packit Service 392537
Create a backup that crosses two tapes. This assumes
Packit Service 392537
a tape in each address 100 and 101. Your addresses
Packit Service 392537
will probably be different. The -m@100/2m says to put
Packit Service 392537
at most 2mb on the first tape. This is a NDMP_MOVER_SET_WINDOW
Packit Service 392537
during create, which is convention but not part of the spec.
Packit Service 392537
Packit Service 392537
	% ndmjob -c \
Packit Service 392537
		-D. -C /tmp -F test-data -I c-index \
Packit Service 392537
		-Tmyhost,logon,passwd -f /dev/whatever \
Packit Service 392537
		-r DEV,CTRL,SID,LUN \
Packit Service 392537
		-m@100/2m -m@101
Packit Service 392537
Packit Service 392537
Now, read it back. If your NDMP_MOVER is returning the
Packit Service 392537
proper error codes, this will automatically discover
Packit Service 392537
the window sizes as it proceeds. Notice that the -m
Packit Service 392537
options do not give window size.
Packit Service 392537
Packit Service 392537
	% ndmjob -t \
Packit Service 392537
		-D. -I t-index \
Packit Service 392537
		-Tmyhost,logon,passwd -f /dev/whatever \
Packit Service 392537
		-r DEV,CTRL,SID,LUN \
Packit Service 392537
		-m@100 -m@101
Packit Service 392537
Packit Service 392537
That'll get you started.