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
       that  is  specified  with the -f listfile option. Any file path that is
       entered can be a file name or a directory name. If the  list  of  files
       includes  a  directory, bparchive archives all files and subdirectories
       of that directory. It starts at the directory itself.

       By default, you return to the system prompt after bparchive is success-
       fully  submitted.  The  command  works  in  the background and does not
       return completion status directly to you. Use the -w option  to  change
       bparchive  to  work  in  the foreground and to return completion status
       after a specified time period.

       bparchive writes informative and error messages to a progress-log  file
       if  the  file  is created. Create the file before you run 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 direc-
       tory to use for troubleshooting.

       In addition, NetBackup sends mail on the archive completion  status  to
       mail_address if USEMAIL = mail_address . It is entered as follows: non-
       root users specify it on their $HOME/bp.conf file; root  users  specify
       it  in the /usr/openv/netbackup/bp.conf file. This message is sent when
       the archive process is complete.

       The following restrictions apply to this command:

             To archive a file with bparchive , you must be the root  or  the
              owner  and  a  member of the primary group (as owner) to delete.
              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. It
              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
                   Specifies  one of the following numbers that corresponds to
                 the policy type. The default for Windows clients is  13.  For
                 Netware clients the default is 10. The default for all others
                 is 0:

                 0 = Standard

                 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 that 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 not to use a progress log.

                 Include the -en option to generate a log in English. The name
                 of  the log contains the string _en. This option is useful to
                 support personnel in a distributed environment where  differ-
                 still completes on the server.

                 If  you  use  -w  without  specifying the wait time or if you
                 specify a value of 0, NetBackup waits  indefinitely  for  the
                 completion status.

       -help       Prints  a command line usage message when -help is the only
                 option on the command line.

       -k keyword_phrase
                  Specifies a keyword phrase that  NetBackup  associates  with
                 the  image  created  by  this archive operation. You then can
                 restore the image by specifying the keyword phrase  with  the
                 -k option on the bprestore command.

                 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) that contains 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  required  file  list format depends on whether the files
                 have spaces, newlines, or returns in the names.

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

                 filepath

                 Where  filepath  is the path to the file you want to archive.
                 For example:

                 /home

                 /etc

                 /var

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

                  filepathlen filepath

                 instead of the -f option.

                 Any files that you specify must be listed at the  end,  after
                 all other options.


NOTES

       The  required  date and time values format in NetBackup commands varies
       according to the locale setting.

       If you are uncertain of the NetBackup  command  requirements  for  your
       locale,  enter  the  command with the -help option and check the usage.
       The following is part of the  bparchive  usage  statement  output  that
       shows the -w option:

              [-w [hh:mm:ss]]

       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

       Archive a single file:

       bparchive /usr/user1/file1

       Example 2

       Archive the files that are listed in a file that is named archive_list:

       bparchive -f archive_list

       Example 3

       Associate keyword phrase "Archive My Home Directory  02/02/06"  to  the
       archive  of  directory  /home/kwc  and use a progress log that is named
       /home/kwc/arch.log:

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







                                  18 Mar 2005                     bparchive(1)