JarCasting
JarCasting JarCasting

bucket-wipe

The purpose of the bucket-wipe tool is to enumerate a bucket and delete its contents in parallel threads. At the end the bucket is optionally deleted.

License

License
GroupId

GroupId

com.emc.ecs
ArtifactId

ArtifactId

bucket-wipe
Last Version

Last Version

2.0.1
Release Date

Release Date
Type

Type

jar
Description

Description

bucket-wipe
The purpose of the bucket-wipe tool is to enumerate a bucket and delete its contents in parallel threads. At the end the bucket is optionally deleted.
Project URL

Project URL

https://github.com/EMCECS/bucket-wipe
Source Code Management

Source Code Management

https://github.com/EMCECS/bucket-wipe

Download bucket-wipe

Filename Size
bucket-wipe-2.0.1.pom
bucket-wipe-2.0.1.jar 17 KB
bucket-wipe-2.0.1-sources.jar 9 KB
bucket-wipe-2.0.1-javadoc.jar 36 KB
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/com.emc.ecs/bucket-wipe/ -->
<dependency>
    <groupId>com.emc.ecs</groupId>
    <artifactId>bucket-wipe</artifactId>
    <version>2.0.1</version>
</dependency>
// https://jarcasting.com/artifacts/com.emc.ecs/bucket-wipe/
implementation 'com.emc.ecs:bucket-wipe:2.0.1'
// https://jarcasting.com/artifacts/com.emc.ecs/bucket-wipe/
implementation ("com.emc.ecs:bucket-wipe:2.0.1")
'com.emc.ecs:bucket-wipe:jar:2.0.1'
<dependency org="com.emc.ecs" name="bucket-wipe" rev="2.0.1">
  <artifact name="bucket-wipe" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.emc.ecs', module='bucket-wipe', version='2.0.1')
)
libraryDependencies += "com.emc.ecs" % "bucket-wipe" % "2.0.1"
[com.emc.ecs/bucket-wipe "2.0.1"]

Dependencies

runtime (3)

Group / Artifact Type Version
com.emc.ecs : object-client jar 3.1.3
org.apache.logging.log4j : log4j-slf4j-impl jar 2.14.0
commons-cli : commons-cli jar 1.4

test (1)

Group / Artifact Type Version
junit : junit jar 4.12

Project Modules

There are no modules declared in this project.

Bucket Wipe

The purpose of the bucket-wipe tool is to enumerate a bucket and delete its contents in parallel threads. At the end the bucket is optionally deleted. This tool is required because you cannot (for safety reasons) delete a non-empty bucket.

Current Version: 1.10

Disclaimer about deleting data

WARNING: THIS TOOL PERMANENTLY DELETES ALL DATA IN A BUCKET, INCLUDING ALL VERSIONS!! Even if you have versioning enabled, the tool will destroy all data in the bucket and (by default) the bucket itself. If this is not what you want, use a different tool.

How to Build

  1. Clone bucket-wipe tool from githib
$ git clone https://github.com/EMCECS/bucket-wipe.git
  1. cd to the bucket-wipe directory
$ cd bucket-wipe
  1. Build jar file
$ ./gradlew shadowJar
  1. The build will be located in <path_to_bucket_wipe>/bucket_wipe/build/libs/bucket-wipe-1.10.jar

Usage

Bucket Wipe is a Java application and can be run using the java -jar command followed by the location of the JAR file. Running without any other arguments will produce command-line help.

C:\Users\cwikj\Downloads>java -jar bucket-wipe-1.10.jar

Error: Missing required options: e, a, s

usage:  java -jar bucket-wipe.jar [options] <bucket-name> 

 -a,--access-key <access-key>   the S3 access key

 -e,--endpoint <URI>            the endpoint to connect to, including
                                protocol, host, and port
                                
 -h,--help                      displays this help text

 -hier,--hierarchical           Enumerate the bucket hierarchically.  This
                                is recommended for ECS's
                                filesystem-enabled buckets.

    --keep-bucket               do not delete the bucket when done

 -l,--key-list <file>           instead of listing bucket, delete objects
                                matched in source file key list

    --no-smart-client           disables the ECS smart-client. use this
                                option with an external load balancer

 -p,--prefix <prefix>           deletes only objects under the specified
                                Prefix

 -s,--secret-key <secret-key>   the secret key

    --stacktrace                displays full stack trace of errors

 -t,--threads <threads>         number of threads to use

    --vhost                     enables DNS buckets and turns off load
                                balancer

Note that if you are using an endpoint that is a load balancer, you will want to use --no-smart-client to turn off the built-in software load balancer.

For more information, please see the wiki

com.emc.ecs

Dell EMC ECS

Cloud Scale Object Storage

Versions

Version
2.0.1
2.0.0