The Java Command Line Interface (CLI) is a simple but powerful Spectra S3 client for BlackPearl. As the name implies, it allows users to manage files in BlackPearl using a simple command-line interface. The Java CLI, which is both free and open source, was created by Spectra Logic using our Java Software Development Kit and works on Windows, Mac, and Linux.
We have created a Java CLI Reference and Examples page to assist you with using the Java CLI. We find that one of the most common uses of the Java CLI by our customers is moving files to BlackPearl on some periodic basis using a scheduled task or cron job. Our examples therefore show how to use the Java CLI and 7zip (7zip.org) to zip and move files to BlackPearl. The files can then be retrieved from BlackPearl if needed using the Java CLI or the Deep Storage Browser (formerly DS3 Browser) -- another free and open-source Spectra S3 client created by Spectra Logic.
The Java CLI works like many other command line interfaces. There is a base call (ds3_java_cli) with options to control behavior. There are a total of 13 different commands currently available in the CLI. Here is an example of Java CLI command to move a folder from a server to BlackPearl:
In this example, the command put_bulk is used to move server directory subdir1 to a bucket called bucket1 on the BlackPearl located at bp1.acmecorp.com. The -a is the BlackPearl user’s S3 Access ID and the -k is the user’s S3 Secret Key.
You can optionally set system environment variables for the S3 Access ID (-a), S3 Secret Key (-k), endpoint (-e) and HTTP proxy (-x, not shown).
One reason for launching the new site was to update the look and feel to match our recently updated corporate website. Besides looking great, the new sites work on all devices and have some nice interactive features.
But the main reason for the new version of the Developer site was to make our DS3 client development tools easier to download and access. DS3 is our deep storage protocol, an extension of S3, which allows users to move data to deep storage using simple HTTP commands. This protocol is made possible by our BlackPearl Deep Storage Gateway. Now anyone can access all the tools needed to create a DS3 application, including a BlackPearl Simulator, Software Development Kits, sample clients, and documentation.
Additionally, Spectra Logic has decided to make its BlackPearl DS3 software development kits (SDKs) and clients both freely downloadable and open source. This has been done for several reasons:
To make it as easy as possible for developers, a group which consists of both customers and partners, to develop DS3 clients.
To allow developers to modify the software for their particular needs, and to contribute those modifications back to the community.
Developers in the web service and cloud storage communities have an expectation that software tools will be freely available and open source. We want to be a trusted partner in that community.
Spectra Logic is in the business of selling deep storage hardware. More DS3 clients means that we can provide deep storage hardware to more customers.
We hope that you now find it easier than ever to develop DS3 clients. As always, we look forward to your feedback.
Spectra Logic will be at NAB 2015 in Las Vegas, Nevada, USA from April 11-16 in Booth SL 11816 displaying our products and meeting with customers and partners. The Developer Program team will be there in full force to help out developers and spread our message. We’ll be doing demos at our booth and showing how easy it is to get started with DS3 client development. We’ll also show some of the great client applications we have built using our own software development kits (SDKs) that allow users to easily move data to tape. Please stop by and visit us if you are in town.
Spectra Logic has entered a new phase in our company’s history. Our unique products have always required us to be both a hardware and software company. But now, for the first time, we are making it easier to store data on our hardware by providing a software interface available to everyone. This means that customers and partners can build their own applications and clients to move data to Spectra’s deep storage tape libraries. This could greatly reduce the cost and complexity of storing data in long-term archives. But it also means that Spectra must provide the tools and resources necessary for users to build these software applications.