SYNOPSIS

       /usr/openv/netbackup/bin/bparchive  [-p  policy]  [-s  schedule][-L progress_log
              [-en]]  [-S  master_server[,master_server,...]]  [-t   policy_type]   [-w
              [hh:mm:ss]] [-help] [-k "keyword_phrase"] -f listfile | filenames


DESCRIPTION

       bparchive  processes  files  listed on the command line or in the file specified
       with the -f listfile option. Any file path entered can be a  file  or  directory
       name.  If  the  list of files includes a directory, bparchive archives all files
       and subdirectories of that directory starting at the directory itself.

       By default, you are returned to the system prompt after  bparchive  is  success-
       fully submitted. The command works in the background and does not return comple-
       tion status directly to you. Use the  -w  option  to  change  this  behavior  so
       bparchive  works  in the foreground and returns completion status after a speci-
       fied time period.

       bparchive writes informative and error messages to a progress-log  file  if  the
       file  is  created.  Create  the  file prior to running the bparchive command and
       specify it with the -L progress_log option. If bparchive cannot archive  any  of
       the requested files or directories, use the progress log to determine the reason
       for the failure.

       If you create a /usr/openv/netbackup/logs/bparchive/ directory with public-write
       access,  bparchive  creates  a debug log file in this directory to use for trou-
       bleshooting.

       In addition, if a  nonroot  user  specifies  USEMAIL  =  mail_address  in  their
       $HOME/bp.conf   file  or  a  root  user  specifies  it  in  the  /usr/openv/net-
       backup/bp.conf file, NetBackup sends mail on the archive  completion  status  to
       mail_address. This message is sent when the archive process is complete.

       The following restrictions apply to this command:

             To  archive a file with the bparchive command, you must be either root or
              the owner and a member of the primary group  (as  owner)  to  delete  the
              file.  Also,  the  file must not be read-only. Otherwise, NetBackup saves
              the files but cannot reset their access time (utime) and does not  delete
              them from the disk.

             If  you  specify  a UNIX file that is a link, bparchive archives only the
              link itself, not the file to which it links.

             bparchive does not archive the "." or ".." directory  entries,  and  also
              does not archive disk-image backups.


OPTIONS

       -p policy Names  the policy to use for the user archive. If it is not specified,
                 the NetBackup server uses the first policy it finds that includes  the
                 client and a user archive schedule.

       -s schedule

                 4 = Oracle

                 6 = Informix-On-BAR

                 7 = Sybase

                 10 = NetWare

                 13 = MS-Windows

                 14 = OS/2

                 15 = MS-SQL-Server

                 16 = MS-Exchange-Server

                 19 = NDMP

       Note:     The following policy types apply only to NetBackup Enterprise  Server.

                 11 = DataTools-SQL-BackTrack

                 17 = SAP

                 18 = DB2

                 20 = FlashBackup

                 21 = Split-Mirror

                 22 = AFS

       -L progress_log [-en]
                 Specifies  the  name  of  an  existing file in which to write progress
                 information. The file name must begin with /.

                 For example: /home/tlc/proglog.

                 The default is to not use a progress log.

                 Include the -en option to generate a log in English. The name  of  the
                 log will contain the string _en. This option is useful to support per-
                 sonnel assisting in a distributed environment where differing  locales
                 may create logs of various languages.

       -w [hh:mm:ss]
                 Causes  NetBackup  to  wait  for  a  completion status from the server
                 before returning you to the system prompt.

                 The  date and time format depend on the user's locale. See NOTES.

                 specifying the keyword phrase with the -k option on the bprestore com-
                 mand.

                 The keyword phrase is a textual description of the archive that  is  a
                 maximum  of  128  characters  in length.  All printable characters are
                 permitted including space (" ") and period ("."). Enclose  the  phrase
                 in  double  quotes  ("...") or single quotes (`...') to avoid conflict
                 with the UNIX shell.

                 The default keyword phrase is the null (empty) string.

       -f listfile
                 Specifies a file (listfile) containing a list of files to be  archived
                 and  can  be  used instead of the filenames option. In listfile, place
                 each file path on a separate line.

                 The format required for the file list depends  on  whether  the  files
                 have spaces or newlines in the names.

                 To archive files that do not have spaces or newlines in the names, use
                 this format:

                 filepath

                 Where filepath is the path to the file you are archiving. For example:

                 /home

                 /etc

                 /var

                 To  archive  files that have spaces or newlines in the names, use this
                 format:

                  filepathlen filepath

                 Where filepath  is  the  path  to  the  file  you  are  archiving  and
                 filepathlen is the number of characters in the file path.

                  For example:

                 5 /home

                 4 /etc

                 4 /var

                 19 /home/abc/test file

       filenames Names  one or more files to be archived and can be used instead of the
                 -f option.

       Notice the hours:minutes:seconds requirements. These are for a locale setting of
       C and can be different for other locales.

       For more information on locale, see the locale(1) man page for your system.


EXAMPLES

       Example 1

       To archive a single file, enter:

       bparchive /usr/user1/file1

       Example 2

       To archive files listed in a file named archive_list, enter:

       bparchive -f archive_list

       Example 3

       To  associate  the  keyword  phrase  "Archive My Home Directory 02/02/02" to the
       archive  of  the  directory   /home/kwc   and   use   a   progress   log   named
       /home/kwc/arch.log  enter  the following (the backslash continues the command as
       if it were on one line):

       bparchive  -k  "Archive  My  Home  Directory  02/02/02"  \-L  /home/kwc/arch.log
       /home/kwc


FILES

       $HOME/bp.conf

       /usr/openv/netbackup/logs/bparchive/log.mmddyy


SEE ALSO

       bp(1), bpbackup(1), bplist(1), bprestore(1)


COPYRIGHT

       Copyright (c) 2002-2005 VERITAS Software Corporation. All rights reserved.






                           18 Mar 2005               bparchive(1)