Skip to main content
XCP

delete

Contributors netapp-aoife
PDFs

The XCP NFS delete command deletes everything in a given path.

Syntax
xcp delete <NFS export path>
Show example 
[root@localhost ]# /xcp/linux/xcp delete <IP address of destination NFSserver>:/dest_vol

WARNING: You have selected <IP address of destination NFS server>:/dest_vol for
removing data.Data in this path /dest_vol will be deleted.
Are you sure you want to delete (yes/no): yes
Recursively removing data in <IP address of destination NFS server>:/dest_vol ...
31,996 scanned, 5,786 removes, 3 rmdirs, 8.27 MiB in (1.65 MiB/s), 1.52 MiB out (312
KiB/s), 5s
40,324 scanned, 19,829 removes, 22 rmdirs, 12.2 MiB in (799 KiB/s), 3.89 MiB out
(485 KiB/s),10s
54,281 scanned, 32,194 removes, 2,365 rmdirs, 17.0 MiB in (991 KiB/s), 6.15 MiB out
(463 KiB/s),15s
75,869 scanned, 44,903 removes, 4,420 rmdirs, 23.4 MiB in (1.29 MiB/s), 8.60
MiB out (501KiB/s), 20s
85,400 scanned, 59,728 removes, 5,178 rmdirs, 27.8 MiB in (881 KiB/s), 11.1 MiB out
(511 KiB/s),25s
106,391 scanned, 76,229 removes, 6,298 rmdirs, 34.7 MiB in (1.39 MiB/s), 14.0
MiB out (590KiB/s), 30s
122,107 scanned, 93,203 removes, 7,448 rmdirs, 40.9 MiB in (1.24 MiB/s), 16.9
MiB out (606KiB/s), 35s
134,633 scanned, 109,815 removes, 9,011 rmdirs, 46.5 MiB in (1.12 MiB/s), 20.0
MiB out (622KiB/s), 40s
134,633 scanned, 119,858 removes, 9,051 rmdirs, 47.9 MiB in (288 KiB/s), 21.4
MiB out (296KiB/s), 45s
134,633 scanned, 119,858 removes, 9,051 rmdirs, 47.9 MiB in (0/s), 21.4 MiB out (0/s), 50s
134,633 scanned, 121,524 removes, 9,307 rmdirs, 48.2 MiB in (51.7 KiB/s), 21.7
MiB out (49.5KiB/s), 55s
Xcp command : xcp delete <IP address of destination NFS
server>:/dest_vol134,633 scanned, 0 matched, 134,632 delete
items, 0 error
Speed : 48.7 MiB in (869 KiB/s), 22.2 MiB out
(396 KiB/s)Total Time : 57s.
STATUS : PASSED

The following table lists the delete parameters and their description.

Parameter Description

delete -match <filter>

Only processes the files and directories that match the filter.

delete -force

Deletes without confirmation.

delete -removetopdir

Removes the directory, including child directories.

delete -exclude <filter>

Excludes the files and directories that match the filter.

delete -parallel <n>

Specifies the maximum concurrent batch processes (default: 7).

delete -preserve-atime

Preserves access time of the file or directory (default: false).

delete -loglevel <name>

Sets the log level; available levels are INFO, DEBUG (default: INFO).

delete -s3.insecure

Provides the option to use HTTP instead of HTTPS for S3 bucket communication.

delete -s3.endpoint <s3_endpoint_url>

Overrides the default Amazon Web Services (AWS) endpoint URL with the specified URL for S3 bucket communication.

delete -s3.profile <profile_name>

Specifies a profile from the AWS credential file for S3 bucket communication.

delete -s3.noverify

Overrides the default verification of SSL certification for S3 bucket communication.

delete -match <filter>

Use the -match <filter> parameter with the delete command to only process the files and directories that match the filter.

Syntax
xcp delete -match <filter> <NFS export path>
Show example 
[root@client1 linux]# ./xcp delete -match "fnm('XCP_copy_2023-04-25_05.51.28.315997')" 10.101.10.101:/xcp_catalog

Job ID: Job_2023-04-25_06.10.29.637371_delete
WARNING: You have selected 10.101.10.101:/xcp_catalog for removing data. Data in this path
/xcp_catalog will be deleted.
Are you sure you want to delete (yes/no): yes
Recursively removing data in 10.101.10.101:/xcp_catalog ...
Xcp command : xcp delete -match fnm('XCP_copy_2023-04-25_05.51.28.315997')
10.101.10.101:/xcp_catalog
Stats : 209 scanned, 14 matched, 12 removes, 2 rmdirs
Speed : 58.9 KiB in (18.6 KiB/s), 8.25 KiB out (2.60 KiB/s)
Total Time : 3s.
Job ID : Job_2023-04-25_06.10.29.637371_delete
Log Path : /opt/NetApp/xFiles/xcp/xcplogs/Job_2023-04-25_06.10.29.637371_delete.log
STATUS : PASSED

delete -force

Use the -force parameter with the delete command to delete without confirmation.

Syntax
xcp delete -force <NFS export path>
Show example 
[root@client1 linux]# ./xcp delete -force
10.101.10.101:/xcp_catalog/catalog/indexes/XCP_copy_2023-04-25_05.53.58.273910

Job ID: Job_2023-04-25_06.11.30.584440_delete
WARNING: You have selected 10.101.10.101:/xcp_catalog/catalog/indexes/XCP_copy_2023-04-
25_05.53.58.273910 for removing data. Data in this path
/xcp_catalog/catalog/indexes/XCP_copy_2023-04-25_05.53.58.273910 will be deleted.
Recursively removing data in 10.101.10.101:/xcp_catalog/catalog/indexes/XCP_copy_2023-04-
25_05.53.58.273910 ...
Xcp command : xcp delete -force 110.101.10.101:/xcp_catalog/catalog/indexes/XCP_copy_2023-04-
25_05.53.58.273910
Stats : 14 scanned, 12 removes, 1 rmdir
Speed : 6.44 KiB in (4.73 KiB/s), 3.59 KiB out (2.64 KiB/s)
Total Time : 1s.
Job ID : Job_2023-04-25_06.11.30.584440_delete
Log Path : /opt/NetApp/xFiles/xcp/xcplogs/Job_2023-04-25_06.11.30.584440_delete.log
STATUS : PASSED
[root@client-1 linux] #

delete -removetopdir

Use the -removetopdir parameter with the delete command to remove the directory, including child directories.

Syntax
xcp delete -force -loglevel <name> -removetopdir <NFS export path>
Show example 
[root@client1 linux]# ./xcp delete -force -loglevel DEBUG -removetopdir
10.101.10.101:/temp7/user9

Job ID: Job_2023-04-25_08.03.38.218893_delete
WARNING: You have selected 10.101.10.101:/temp7/user9 for removing data. Data in this path
/temp7/user9 will be deleted.
Recursively removing data in 10.101.10.101:/temp7/user9 ...
50,500 scanned, 16,838 removes, 11.5 MiB in (2.27 MiB/s), 2.70 MiB out (547 KiB/s), 5s
85,595 scanned, 43,016 removes, 21.5 MiB in (1.97 MiB/s), 6.70 MiB out (806 KiB/s), 10s
.
.
.
1.01M scanned, 999,771 removes, 1,925 rmdirs, 324 MiB in (1.42 MiB/s), 153 MiB out (922
KiB/s), 3m6s

Xcp command : xcp delete -force -loglevel DEBUG -removetopdir 10.101.10.101:/temp7/user9
Stats : 1.01M scanned, 1.01M removes, 2,041 rmdirs
Speed : 326 MiB in (1.73 MiB/s), 155 MiB out (842 KiB/s)
Total Time : 3m8s.
Job ID : Job_2023-04-25_08.03.38.218893_delete
Log Path : /opt/NetApp/xFiles/xcp/xcplogs/Job_2023-04-25_08.03.38.218893_delete.log
STATUS : PASSED
[root@client1 linux]#

delete -exclude <filter>

Use the -exclude <filter> parameter with the delete command to exclude the files and directories that match the filter.

Syntax
xcp delete -force -exclude <filter>  <NFS export path>
Show example 
[root@client1 linux]# ./xcp delete -force -exclude "fnm('USER5')" 10.101.10.101:/temp7/user2/

Job ID: Job_2023-04-25_07.54.25.241216_delete
WARNING: You have selected 10.101.10.101:/temp7/user2 for removing data. Data in this path
/temp7/user2 will be deleted.
Recursively removing data in 10.101.10.101:/temp7/user2 ...
29,946 scanned, 1 excluded, 6,492 removes, 977 rmdirs, 7.42 MiB in (1.48 MiB/s), 1.54 MiB out
(316 KiB/s), 5s
Xcp command : xcp delete -force -exclude fnm('USER5') 10.101.10.101:/temp7/user2/
Stats : 29,946 scanned, 1 excluded, 28,160 removes, 1,785 rmdirs
Speed : 10.6 MiB in (1.18 MiB/s), 5.03 MiB out (574 KiB/s)
Total Time : 8s.
Job ID : Job_2023-04-25_07.54.25.241216_delete
Log Path : /opt/NetApp/xFiles/xcp/xcplogs/Job_2023-04-25_07.54.25.241216_delete.log
STATUS : PASSED
[root@client1 linux]#

delete -parallel <n>

Use the -parallel <n> parameter with the delete command to specify the maximum number of concurrent batch processes. The default value is 7.

Syntax
xcp delete -force -parallel <n> -match <filter> <NFS export path>
Show example 
[root@client1 linux]# ./xcp delete -force -parallel 8 -match "fnm('2023-04-25_05.49.26.733160*')" 10.101.10.101:/xcp_catalog/

Job ID: Job_2023-04-25_06.15.27.024987_delete
WARNING: You have selected 10.101.10.101:/xcp_catalog for removing data. Data in this path /xcp_catalog will be deleted.
Recursively removing data in 10.101.10.101:/xcp_catalog ...
Xcp command : xcp delete -force -parallel 8 -match fnm('2023-04-25_05.49.26.733160*')
10.101.10.101:/xcp_catalog/
Stats : 182 scanned, 1 matched, 1 remove
Speed : 50.0 KiB in (115 KiB/s), 5.45 KiB out (12.5 KiB/s)
Total Time : 0s.
Job ID : Job_2023-04-25_06.15.27.024987_delete
Log Path : /opt/NetApp/xFiles/xcp/xcplogs/Job_2023-04-25_06.15.27.024987_delete.log
STATUS : PASSED
[root@client1 linux]#

delete -preserve-atime

Use the -preserve-atime <preserve-atime> parameter with the delete command to preserve the access time of a file or directory. The default value is false.

Syntax
xcp delete -force -preserve-atime <NFS export path>
Show example 
[root@client1 linux]# ./xcp delete -force -preserve-atime <IP_address>:/temp7/user2/

Job ID: Job_2023-04-25_07.55.30.972162_delete
WARNING: You have selected <IP_address>:/temp7/user2 for removing data. Data in this path
/temp7/user2 will be deleted.
Recursively removing data in <IP_address>:/temp7/user2 ...
Xcp command : xcp delete -force -preserve-atime <IP_address>:/temp7/user2/
Stats : 256 scanned, 255 rmdirs
Speed : 199 KiB in (108 KiB/s), 75.7 KiB out (41.1 KiB/s)
Total Time : 1s.
Job ID : Job_2023-04-25_07.55.30.972162_delete
Log Path : /opt/NetApp/xFiles/xcp/xcplogs/Job_2023-04-25_07.55.30.972162_delete.log
STATUS : PASSED
[root@client-1 linux]#

delete -loglevel <name>

Use the -loglevel <name> parameter with the delete command to set the log level; available levels are INFO and DEBUG. The default level is INFO.

Syntax
xcp delete -force -loglevel DEBUG -removetopdir <NFS export path>
Show example 
[root@client1 linux]# ./xcp delete -force -loglevel DEBUG -removetopdir
10.101.10.101:/temp7/user9

Job ID: Job_2023-04-25_08.03.38.218893_delete
WARNING: You have selected 10.101.10.101:/temp7/user9 for removing data. Data in this
path /temp7/user9 will be deleted.
Recursively removing data in 10.101.10.101:/temp7/user9 ...
50,500 scanned, 16,838 removes, 11.5 MiB in (2.27 MiB/s), 2.70 MiB out (547 KiB/s), 5s
85,595 scanned, 43,016 removes, 21.5 MiB in (1.97 MiB/s), 6.70 MiB out (806 KiB/s),
10s
.
.
.
1.01M scanned, 999,771 removes, 1,925 rmdirs, 324 MiB in (1.42 MiB/s), 153 MiB out
(922 KiB/s), 3m6s
Xcp command : xcp delete -force -loglevel DEBUG -removetopdir
10.101.10.101:/temp7/user9
Stats : 1.01M scanned, 1.01M removes, 2,041 rmdirs
Speed : 326 MiB in (1.73 MiB/s), 155 MiB out (842 KiB/s)
Total Time : 3m8s.
Job ID : Job_2023-04-25_08.03.38.218893_delete
Log Path : /opt/NetApp/xFiles/xcp/xcplogs/Job_2023-04-25_08.03.38.218893_delete.log
STATUS : PASSED
[root@client-1 linux]#

delete -s3.insecure

Use the -s3.insecure parameter with the delete command to use HTTP instead of HTTPS for S3 bucket communication.

Syntax
xcp delete -s3.insecure s3://bucket1
Show example 
[root@client1 linux]# ./xcp delete -s3.insecure s3:// bucket1

Job ID: Job_2023-06-08_08.51.40.849991_delete
WARNING: You have selected s3://bucket1 for removing data. Data in this path //bucket1 will be
deleted.
Are you sure you want to delete (yes/no): yes
Recursively removing data in s3://bucket1 ...
Xcp command : xcp delete -s3.insecure s3://bucket1
Stats : 8 scanned, 6 s3.objects, 6 s3.removed
Speed : 0 in (0/s), 0 out (0/s)
Total Time : 5s.
Job ID : Job_2023-06-08_08.51.40.849991_delete
Log Path : /opt/NetApp/xFiles/xcp/xcplogs/Job_2023-06-08_08.51.40.849991_delete.log
STATUS : PASSED

delete -s3.endpoint <s3_endpoint_url>

Use the -s3.endpoint <s3_endpoint_url> parameter with the delete command to override the default AWS endpoint URL with a specified URL for S3 bucket communication.

Syntax
xcp delete -s3.endpoint https://<endpoint_url>: s3://bucket
Show example 
[root@client1 linux]# ./xcp delete -s3.endpoint https://<endpoint_url>: s3://xcp-testing

Job ID: Job_2023-06-13_11.39.33.042545_delete
WARNING: You have selected s3://xcp-testing for removing data. Data in this path //xcp-testing
will be deleted.
Are you sure you want to delete (yes/no): yes
Recursively removing data in s3://xcp-testing ...
Xcp command : xcp delete -s3.endpoint https://<endpoint_url>: s3://xcp-testing
Stats : 8 scanned, 5 s3.objects, 5 s3.removed
Speed : 0 in (0/s), 0 out (0/s)
Total Time : 4s.
Job ID : Job_2023-06-13_11.39.33.042545_delete
Log Path : /opt/NetApp/xFiles/xcp/xcplogs/Job_2023-06-13_11.39.33.042545_delete.log
STATUS : PASSED

delete -s3.profile <name>

Use the s3.profile parameter with the delete command to specify a profile from the AWS credential file for S3 bucket communication.

Syntax
xcp delete -s3.profile sg -s3.endpoint https://<endpoint_url>:
s3://bucket
Show example 
[root@client1 linux]# ./xcp delete -s3.profile sg -s3.endpoint https://<endpoint_url>: s3://bucket

Job ID: Job_2023-06-08_08.53.19.059745_delete
WARNING: You have selected s3://bucket for removing data. Data in this path //bucket will be deleted.
Are you sure you want to delete (yes/no): yes
Recursively removing data in s3://bucket ...
1 scanned, 0 in (0/s), 0 out (0/s), 5s
Xcp command : xcp delete -s3.profile sg -s3.endpoint https://<endpoint_url>: s3:/ bucket
Stats : 7 scanned, 5 s3.objects, 5 s3.removed
Speed : 0 in (0/s), 0 out (0/s)
Total Time : 9s.
Job ID : Job_2023-06-08_08.53.19.059745_delete
Log Path : /opt/NetApp/xFiles/xcp/xcplogs/Job_2023-06-08_08.53.19.059745_delete.log
STATUS : PASSED

delete -s3.noverify

Use the -s3.noverify parameter with the delete command to override the default verification of SSL certification for S3 bucket communication.

Syntax
xcp delete -s3.noverify s3://bucket
Show example 
[root@client-1 linux]# ./xcp delete -s3.noverify s3://bucket1

Job ID: Job_2023-06-13_10.56.19.319076_delete
WARNING: You have selected s3://bucket1 for removing data. Data in this path //bucket1 will be
deleted.
Are you sure you want to delete (yes/no): yes
Recursively removing data in s3://bucket1 ...
2,771 scanned, 0 in (0/s), 0 out (0/s), 5s
9,009 scanned, 9,005 s3.objects, 2,000 s3.removed, 0 in (0/s), 0 out (0/s), 10s
Xcp command : xcp delete -s3.noverify s3://bucket1
Stats : 9,009 scanned, 9,005 s3.objects, 9,005 s3.removed
Speed : 0 in (0/s), 0 out (0/s)
Total Time : 15s.
Job ID : Job_2023-06-13_10.56.19.319076_delete
Log Path : /opt/NetApp/xFiles/xcp/xcplogs/Job_2023-06-13_10.56.19.319076_delete.log
STATUS : PASSED