Important Update: Cohesity Products Documentation
All Cohesity product documentation are now managed via the Cohesity Docs Portal: https://docs.cohesity.com/HomePage/Content/home.htm. Some documentation available here may not reflect the latest information or may no longer be accessible.
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
- msdpimgutil
- 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
- nbhsmcmd
- nbhypervtool
- nbidpcmd
- nbimageshare
- nbinstallcmd
- nbjm
- nbkmiputil
- nbkmscmd
- nbkmsutil
- nblogparser
- nbmariadb
- nbmysql
- nbmlb
- nborair
- nboracmd
- nbpem
- nbpemreq
- nbmariadb
- nbmlb
- nbperfchk
- nbpgsql
- nbplupgrade
- nbrb
- nbrbutil
- nbreplicate
- nbrepo
- nbrestorevm
- nbseccmd
- nbserviceusercmd
- nbsetconfig
- nbshvault
- nbsmartdiag
- nbsnapimport
- nbsnapreplicate
- nbsqlcmd
- nbsqlite
- nbstl
- nbstlutil
- nbstop
- nbsu
- nbsvrgrp
- netbackup_deployment_insights
- resilient_clients
- restoretrace
- stopltid
- tiermover
- 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 [--list_by_time YYYY-MM-DD hh:mm:ss YYYY-MM-DD hh:mm:ss] [--cross_check] [--alter_client clientname] [-S servername]
--type restore --num_streams streamsnum {[--path_name pathname1] [--path_name pathname2]... [--backup_id backupid1] [--backup_id backupid2]...} [--alter_path_name newlocation] [--alter_client clientname] [-k] [--copy_num copy_num] [-S servername]
--help
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.
Note:
You must specify at least one of the following parameters: --path_name or --backup_id. Multiple instances of each option are allowed.
OPTIONS
- --alter_client
Lists or restores the backups for a specified 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. With the option -k specified, the restore does not overwrite the local files.
- --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 the specified path.
nbepicfile --type list --path_name /
Example 2: List the backups for the current client with the specified 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. The --path_name option must match the backup selections.
nbepicfile --type restore --path_name /root/epic_script/epic --num_streams 5
Example 5: Restore the backup from a backup ID. Use the nbepicfile --type list option to find the backup IDs.
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 the specified client to the current location.
nbepicfile --type restore --path_name /root/epic_script/epic --num_streams 5 --alter_client clientname
Example 9: Restore the backups for a specified client to a different location.
nbepicfile --type restore --num_streams 5 --path_name /root/epic_script/epic --alter_client clientname --alter_path_name /test_epic