NetBackup™ Commands Reference Guide
- Introduction
- Appendix A. NetBackup Commands
- acsd
- backupdbtrace
- backuptrace
- bmrc
- bmrconfig
- bmrepadm
- bmrprep
- bmrs
- bmrsrtadm
- bp
- bparchive
- bpbackup
- bpbackupdb
- bpcatarc
- bpcatlist
- bpcatres
- bpcatrm
- bpcd
- bpchangeprimary
- bpcleanrestore
- bpclient
- bpclimagelist
- bpclntcmd
- bpclusterutil
- bpcompatd
- bpconfig
- bpdbjobs
- bpdbm
- bpdgclone
- bpdown
- bpduplicate
- bperror
- bpexpdate
- bpfis
- bpflist
- bpgetconfig
- bpgetdebuglog
- bpimage
- bpimagelist
- bpimmedia
- bpimport
- bpinst
- bpkeyfile
- bpkeyutil
- bplabel
- bplist
- bpmedia
- bpmedialist
- bpminlicense
- bpnbat
- bpnbaz
- bppficorr
- bpplcatdrinfo
- bpplclients
- bppldelete
- bpplinclude
- bpplinfo
- bppllist
- bpplsched
- bpplschedrep
- bpplschedwin
- bppolicynew
- bpps
- bprd
- bprecover
- bprestore
- bpretlevel
- bpschedule
- bpschedulerep
- bpsetconfig
- bpstsinfo
- bpstuadd
- bpstudel
- bpstulist
- bpsturep
- bptestbpcd
- bptestnetconn
- bpup
- bpverify
- cat_convert
- cat_export
- cat_import
- configureCerts
- configureMQ
- configureWebServerCerts
- create_nbdb
- csconfig cldinstance
- csconfig cldprovider
- csconfig meter
- csconfig reinitialize
- csconfig throttle
- duplicatetrace
- importtrace
- jbpSA
- jnbSA
- ltid
- mklogdir
- msdpcldutil
- nbauditreport
- nbcallhomeproxyconfig
- nbcatsync
- NBCC
- NBCCR
- nbcertcmd
- nbcertupdater
- nbcldutil
- nbcmdrun
- nbcomponentupdate
- nbcplogs
- nbcredkeyutil
- nbdb_admin
- nbdb_backup
- nbdb_move
- nbdb_ping
- nbdb_restore
- nbdb_unload
- nbdb2adutl
- nbdbms_start_server
- nbdbms_start_stop
- nbdc
- nbdecommission
- nbdelete
- nbdeployutil
- nbdevconfig
- nbdevquery
- nbdiscover
- nbdna
- nbemm
- nbemmcmd
- nbepicfile
- nbfindfile
- nbfirescan
- nbfp
- nbftadm
- nbftconfig
- nbgetconfig
- nbhba
- nbholdutil
- nbhostidentity
- nbhostmgmt
- nbhypervtool
- nbidpcmd
- nbimageshare
- nbinstallcmd
- nbjm
- nbkmiputil
- nbkmscmd
- nbkmsutil
- nboraadm
- nborair
- nboracmd
- nbpem
- nbpemreq
- nbmariadb
- nbmlb
- nbperfchk
- nbplupgrade
- nbrb
- nbrbutil
- nbreplicate
- nbrepo
- nbrestorevm
- nbseccmd
- nbserviceusercmd
- nbsetconfig
- nbshvault
- nbsmartdiag
- nbsnapimport
- nbsnapreplicate
- nbsqladm
- nbsqlite
- nbstl
- nbstlutil
- nbstop
- nbsu
- nbsvrgrp
- netbackup_deployment_insights
- resilient_clients
- restoretrace
- stopltid
- tldd
- tldcd
- tpautoconf
- tpclean
- tpconfig
- tpext
- tpreq
- tpunmount
- verifytrace
- vltadm
- vltcontainers
- vlteject
- vltinject
- vltoffsitemedia
- vltopmenu
- vltrun
- vmadd
- vmchange
- vmcheckxxx
- vmd
- vmdelete
- vmoprcmd
- vmphyinv
- vmpool
- vmquery
- vmrule
- vmupdate
- vnetd
- vssat
- vwcp_manage
- vxlogcfg
- vxlogmgr
- vxlogview
- W2KOption
Name
nbepicfile — used to list and restore the backups that are created using the Epic-Large-File policy on Red Hat Linux and AIX
SYNOPSIS
--type list --path_name pathname [-S servername]
--type list --path_name pathname [--list_by_time YYYY-MM-DD hh:mm:ss YYYY-MM-DD hh:mm:ss] [-S servername]
--type list --path_name pathname [--alter_client clientname] [-S servername]
--type restore --path_name pathname --num_streams streamsnum [-S servername]
--type restore --backup_id backupid --num_streams streamsnum [-S servername]
--type restore --path_name pathname1 --path_name pathname2 --num_streams streamnum [-S servername]
--type restore --path_name pathname --num_streams streamnum [--alter_path_name newlocation] [-S servername]
--type restore --path_name pathname --num_streams streamnum [--alter_client clientname] [-S servername]
On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin
DESCRIPTION
Use the nbepicfile command to list and restore the backups that are created using the Epic-Large-File policy. This command only supports Red Hat Linux and AIX. Run this command on the client to restore the backups.
OPTIONS
- --alter_client
Lists or restores the backups from a different client.
If you used the FQDN to install the NetBackup client, and you use short name in the policy client configuration, you must use --alter_client to list and to restore the backups.
For example, abcde02vm123.domain.com was used to install the NetBackup client, and abcde02vm123 is used in the policy configuration. Run the commands that are shown to list and to restore the backups:
nbepicfile --type list --path_name /epic_db --alter_client abcde02vm123
nbepicfile --type restore --path_name /epic_db --alter_client abcde02vm123 --num_streams 10
- --alter_path_name
Restores the backups to a different location.
- --backup_id
Restores the backups with the specified backup ID.
- --copy_num
Restores the backups with the specified copy number.
- --cross_check
Confirms the data integration for the current backups. This operation may take a long time to complete.
- --help
Displays the help information for the command or option.
- -k
For a restore, this option keeps the files if the local files exist.
- --list_by_time
Lists the backups within the specified time range.
- --num_streams
Restores the backups with the number of parallel streams specified.
- --path_name
Lists or restores the backup with the specified path name. The path name is the backup selection when backup is performed.
- -S
Primary server name to connect.
- --type
Specifies the type of the operation, either list or restore.
EXAMPLES
Example 1: List the backups for the current client with path.
nbepicfile --type list --path_name /
Example 2: List the backups for the current client with path within the specified period.
nbepicfile --type list --path_name / --list_by_time 2024-01-17 01:58:52 2024-01-17 02:28:28
Example 3: List the backups for another client.
nbepicfile --type list --path_name / --alter_client clientname
Example 4: Restore the latest backup from the specified path with the number of streams.
nbepicfile --type restore --path_name /root/epic_script/epic --num_streams 5
Example 5: Restore the backup from a backup ID.
nbepicfile --type restore --backup_id rmnbjgcl02vm169_1705478332 --num_streams 5
Example 6: Restore the backup from multiple backup selections or backup IDs.
nbepicfile --type restore --path_name /root/epic_script/epic --path_name /root/epic_script/script --backup_id rmnbjgcl02vm169_1705478332 --num_streams 5
Example 7: Restore the backups to a different location.
nbepicfile --type restore --path_name /root/epic_script/epic --alter_path_name /test_epic --num_streams 5
Example 8: Restore the backups for another client.
nbepicfile --type restore --path_name /root/epic_script/epic --num_streams 5 --alter_client clientname