Veritas NetBackup™ Commands Reference Guide

DESCRIPTION

bpplinclude maintains the policy file list for a NetBackup policy. The policy file list is the list of files that are backed up when NetBackup runs an automatic backup for the policy. The policy file list does not apply to user backups or archives since users select the files when they start those operations.

For most policies, the -add, -delete, and -modify options include a list of pathnames. The list of pathnames must be the final part of the bpplinclude command line. The pathname must be the entire path from the root of the file system to the desired location.

For the pathname syntax for your client type, see the NetBackup Administrator's Guide, Volume I.

The last part of the path can be a file name, a directory name, or a wildcard specification. You can enclose pathnames in quotes. Use enclosing quotes if the pathname contains special characters or a wildcard specification.

Filepath rules do not verify the existence of the input directories or files. NetBackup backs up only the files it finds and does not require that all entries in the list be present on every client.

For most database agents, the input entries are scripts or a directive. See the NetBackup guide that comes with the database agent product for additional information. Also see the -add pathname option.

The added entries to the policy file list can be directives, rather than pathnames for the following: certain policy attributes (such as Allow multiple data streams) and add-on products (such as NetBackup for NDMP).

See the NetBackup Administrator's Guide, Volume I or the NetBackup guide for the extension product.

The options -l and -L produce nearly identical displays of the policy file list.

bpplinclude sends its error messages to stderr. bpplinclude sends a log of its activities to the NetBackup admin log file for the current day.

Authorized users can initiate this command.

For more about NetBackup authorization, see the NetBackup Security and Encryption Guide.

OPTIONS

EXAMPLES

Example 1 - While the backup runs on another master server kiwi, display the policy file list for policy oprdoc_policy on the master server plim:

# bpplinclude oprdoc_policy -L -M plim

Include:    /oprdoc   (UNIX systems)

Include:    c:\oprdoc (Windows systems)

Example 2 - Add and delete the pathnames that include one wildcard entry to illustrate bpplinclude interpretation of wildcards:

UNIX systems:

# bpplinclude mkbpolicy -add /yap /y*
# bpplinclude mkbpolicy -L
     Include: yap
     Include: /y*
# bpplinclude mkbpolicy -delete /y*
# bpplinclude mkbpolicy -L
     Include: /yap

Windows systems:

# bpplinclude mkbpolicy -add C:\yap C:\y*
# bpplinclude mkbpolicy -L
     Include: C:\yap
     Include: C:\y*/y*
# bpplinclude mkbpolicy -delete C:\y*
# bpplinclude mkbpolicy -L
     Include: C:\yap

Example 3 - Add two entries to the policy file list for a policy, then modify them:

UNIX systems:

# bpplinclude mkbpolicy -add "/ima file" "/ura file"
# bpplinclude mkbpolicy -L
     Include: /ima file
     Include: /ura file
bpplinclude mkbpolicy -modify "/ima file" "/ima file 2" "/ura file" 
"/ura file 2"
bpplinclude mkbpolicy -L
  Include: /ima file 2
  Include: /ura file 2

Windows systems:

# bpplinclude mkbpolicy -add "C:\ima file" "C:\ura file"
# bpplinclude mkbpolicy -L
     Include: C:\ima file
     Include: C:\ura file
# bpplinclude mkbpolicy -modify "C:\ima file" "C:\ima file 2" 
"C:\ura file" "C:\ura file 2"
# bpplinclude mkbpolicy -L
  Include: C:\ima file 2
  Include: C:\ura file 2

Example 4 - Add a raw partition to the policy file list for the policy rc (UNIX clients). The full path name for the device is used (the command is all on one line):

bpplinclude rc -add /devices/sbus@2,0/dma@2,81000/esp@2,80000/ 
sd@6,0:h,raw

For more about UNIX raw partitions, see the NetBackup Administrator's Guide, Volume I.

Example 5 - Display the policy file list for the policy mkb_policy:

# bpplinclude mkb_policy -l

UNIX systems:

INCLUDE /etc/services
    INCLUDE /etc/aliases
    INCLUDE /usr/bin

Windows systems:

INCLUDE C:\services
    INCLUDE C:\aliases
    INCLUDE C:\Programs

Example 6 - Add vm17 to the list of values in the query rules of policy1.

# bpplinclude policy1 -addtoquery ,\"vm17\"

Example 7 - Delete a query from a policy.

# bpplinclude policy1 -deletefromquery -f qfile1

Example 8 - Add a SQL Server filegroup to the policy file list.

# bpplinclude sql_policy -add FG1

FILES

UNIX systems:

/usr/openv/netbackup/logs/admin/*
/usr/openv/netbackup/db/policy/policy_name/includes

Windows systems:

install_path\NetBackup\logs\admin\*
install_path\NetBackup\dv\policy\policy_name\includes

SEE ALSO

See bpplclients.

See bpplinfo.

See bpschedule.

See bppldelete.

See bppllist.