Cloud Explorer
Clone or download
Latest commit 7ed7738 Aug 17, 2018
Permalink
Failed to load latest commit information.
libs v12 Aug 8, 2018
src/cloudExplorer v12 Aug 8, 2018
.travis.yml v12 Aug 8, 2018
Dockerfile Updated Docker instructions Apr 23, 2018
LICENSE.txt Actually include the actual GPL Jan 6, 2015
README.md Update README.md Aug 17, 2018
build.xml updating travis ci yaml. Build now includes readme Oct 17, 2016
upgrade-sdk.sh fix Dec 1, 2016

README.md

Description

Cloud Explorer is a open-source S3 client. It works on Windows, Linux, and Mac. It has a graphical and command line interface for each supported operating system. If you have a feature suggestion or find a bug, please open an issue. License: GPL v3

Graph

Features

  • Search
  • Performance testing
  • Music player
  • Transition buckets to Amazon Glacier
  • Amazon RRS and Infrequently Accessed storage tiers
  • Migrate buckets between S3 accounts
  • Compress files prior to upload
  • Take screen shots to S3
  • Simple text editor
  • IRC client
  • Share buckets with users
  • Access shared buckets
  • View images
  • Sync folders
  • Graph CSV files and save them to a bucket
  • Record audio messages and save them to a bucket
  • Create snapshots of buckets

System Requirements

  • Java 10
  • S3 credentials

Downloading

For the latest stable release, click Download.

For the latest development release, please download cloudExplorer-dev.zip from Amazon S3. Build Status

If you need Java 8 support, please use Cloud Explorer 11

How to run the program

To run the application, most users should be able to run the program by double clicking on the CloudExplorer.jar file.

If not, you can start the program with the Java command:

java -jar CloudExplorer.jar

Video demonstratons

How to use the Scality S3 server with Cloud Explorer

Older, but complete video

How to compile from source

If you want to make changes to the GUI, here is a video demonstration on how to compile Cloud Explorer with NetBeans: http://youtu.be/54v3rIUh0h8

1. Install and Configure Java

apt-get update
apt-get -y install git ant openjdk-10-jdk-headless

2. Clone this repository and run ant to compile the project

git clone https://github.com/rusher
1572/cloudExplorer.git
cd cloudExplorer
ant

3. Run Cloud Explorer

Double click on dist/CloudExplorer.jar
or....
java -jar dist/CloudExplorer.jar help

Upgrading

To upgrade, please use the updater located in the application. Everytime Cloud Explorer is ran, it will check for the latest version. To apply the update, click "Help -> Check for updates".

How to migrate data between S3 accounts

  • Load the destination account and create or select a bucket to migrate to.
  • From the menu "Snapshots and Migration", click "Set Migration/Snapshot Account and Bucket".
  • Switch to the origin account and select the bucket to migrate.
  • Under the "Snapshots and Migration", select "Migration".
  • Click "Start Migration".

How to create a bucket snapshot

  • Load the destination account and create or select a bucket to store the snapshot.
  • From the menu "Snapshots and Migration", click "Set Migration/Snapshot Account and Bucket".
  • Switch to the origin account and select the bucket to snap.
  • Under the "Snapshots and Migration", select "Snapshots".
  • Click "Create Snapshot".

Running Cloud Explorer in Docker

The following steps will explain how to run Cloud Explorer from a Docker container. The template will install an Ubuntu container using the FVWM window manager.

Creating the container

First, clone this repo:

git clone https://github.com/rusher81572/cloudExplorer.git
cd cloudExplorer

If you want to use your existing S3 configuration file, copy s3.config from your home directory into the cloudExplorer directory. Modify DockerFile by adding the following before the CMD line:

ADD s3.config /root/

Build the container

docker build -t cloudexplorer .

Running the container - CLI

To use environment variables to store S3 account information when using the Cloud Explorer CLI instead of uploading an s3.config file:

docker run -it --net=host -e ACCESS_KEY='****' -e SECRET_KEY='***' -e ENDPOINT='https://s3.amazonaws.com:443' -e REGION='default' cloudexplorer bash
java -jar /cloudExplorer/dist/CloudExplorer.jar help

If you want to use the Cloud Explorer CLI from a VNC session, skip to "Using the CLI in VNC".

Running the container - GUI

Run the container:

docker run -d -p 6001:6001 -p 5901:5901 cloudexplorer

To access to the container, use a VNC client such as vncviewer to connect to display #1.

vncviewer docker_host_ip:1

The default password for VNC is 123456. You should see the Cloud Explorer GUI after authentication.

Using the CLI in VNC

If you want to use the Cloud Explorer CLI, start a terminal in the VNC session by right clicking on the desktop and choose "xterm". Finally, run the following command:

java -jar /cloudExplorer/dist/CloudExplorer.jar help