The createnewbase option
creates a
base snapshot and uses it as a source to run a full incremental backup.
Some files might
not be backed up when the snapshot difference
incremental backup command is run. If the files are skipped, you can
run a snapshot difference incremental backup with the createnewbase option
to back up these files. See Snapdiff for
a list of reasons why a file might not be backed up when the snapshot
difference command is run.
One reason that a file can be skipped
during backup processing is because the file name is not supported
by NetApp Data ONTAP. NetApp Data ONTAP Versions 8.0 and versions
lower than 7.3.3 only support file names that are within the 7 bit
ASCII character set. NetApp Data ONTAP Version 7.3.3 and versions
greater than 8.0.0 support Unicode file names. If you upgraded NetApp
Data ONTAP from a version that does not support Unicode file names
to a version that does support Unicode files names, run a full incremental
backup with the createnewbase=migrate option.
Supported Clients
This
option is valid for the following clients:
- All Windows clients
except IA 64 bit
- AIX® 64-bit
clients
- Linux x86_64
clients
Enter the
createnewbase option on
the command
line. Specify this option with the
snapdiff option.
Syntax
.-No------.
>>-Createnewbase--+---------+----------------------------------><
+-Yes-----+
+-IGNore--+
'-MIGRate-'
Parameters
- no
- Specifies that a
snapshot difference incremental is run. If Tivoli® Storage
Manager detects
that the NetApp Data ONTAP file server has been migrated from a version
that does not support Unicode file names to a file server that does,
a warning message is recorded to the error log and the Tivoli Storage
Manager server activity
log. The warning message indicates that you must run a full incremental
backup and logs a return code of 8 even if the operation completed
successfully.
- This parameter is the default value.
- yes
- Specifies
that a full incremental is run by creating a new base
snapshot and is using it to run a scan-based incremental backup. Use
this option to back up any file changes that might not have been detected
by the snapshot difference API.
- If the operation finished
successfully, the command ends with
a return code of 0.
- Do not set createnewbase=yes for
any schedule that runs a daily snapshot difference backup. Instead,
create a separate, monthly schedule that has the createnewbase=yes option.
- IGNore
- Specifies
that a snapshot difference incremental backup is run
when Tivoli Storage
Manager detects
that the NetApp Data ONTAP file server was upgraded to support Unicode
file names.
- The ignore option is different
from the no parameter
because the ignore option suppresses the warning
message. Instead, an informational message is recorded in the error
log and the Tivoli Storage
Manager activity
log that informs you to run a full incremental backup.
- If
the command finishes successfully, it returns a code of 0.
- Use
the ignore option if you have upgraded
the NetApp Data ONTAP file server to support Unicode but you have
not yet run a full incremental backup. This option is used only when
the Tivoli Storage
Manager client
has detected that the file server was migrated and a full incremental
has not yet been run. The option is ignored for all other times.
- MIGRate
- Specifies
that if the NetApp Data ONTAP file server was upgraded
to a version that supports Unicode file names, a base snapshot is
taken and a scan-based incremental backup is run. The migrate option
is different from the yes option because the migrate option
creates a base snapshot only when Tivoli Storage
Manager detects
that the NetApp Data ONTAP file server version was updated. The yes option
creates a base snapshot every time the command is run.
- After
the incremental backup finishes, no additional migration-related
messages are recorded to the error log or the Tivoli Storage
Manager server activity
log. When the operation finishes, the command ends with a return code
of 0.
- Use the migrate option if you have
upgraded
the NetApp Data ONTAP file server to support Unicode but you have
not yet run a full incremental backup. The migrate option
is ignored if the NetApp Data ONTAP file server has not been upgraded.
Examples
- Command line:
- dsmc incremental -snapdiff
-createnewbase=yes /net/home1