connector-mariadb (uplink v1.0.5)

Overview

The MariaDB Connector connects to an MariaDB database, takes a backup of the specified database and uploads the backup data on Storj network.

Usage:
  connector-mariadb [command] <flags>

Available Commands:
  help        Help about any command
  store       Command to upload data to a Storj V3 network.
  version     Prints the version of the tool

store - Connect to the specified database (default: db_property.json). Back-up of the database is generated using tooling provided by MariaDB and then uploaded to the Storj network. Connect to a Storj v3 network using the access specified in the Storj configuration file (default: storj_config.json).

Back-up data is iterated through and upload in 32KB chunks to the Storj network.

The following flags can be used with the store command:

• accesskey - Connects to the Storj network using a serialized access key instead of an API key, satellite url and encryption passphrase .
• shared - Generates a restricted shareable serialized access with the restrictions specified in the Storj configuration file.

Sample configuration files are provided in the ./config folder.

Requirements and Install

To build from scratch, install the latest Go.

Note: Ensure go modules are enabled (GO111MODULE=on)

Option #1: clone this repo (most common)

To clone the repo

git clone https://github.com/storj-thirdparty/connector-mariadb.git

Then, build the project using the following:

cd connector-mariadb
go build

Option #2: go get into your gopath

To download the project inside your GOPATH use the following command:

go get github.com/storj-thirdparty/connector-mariadb

Run (short version)

Once you have built the project run the following commands as per your requirement:

Get help

$ ./connector-mariadb --help

Check version

$ ./connector-mariadb --version

Create backup from MariaDB and upload to Storj

$ ./connector-mariadb store 

Documentation

• Access documentation on local system :
  1. Install docsify
  2. Run the following command at the root directory of the cloned project.

  $ docsify serve docs
  

• For more information on runtime flags, configuration, testing, and diagrams, check out the Detail or jump to:
  • Config Files
  • Run (long version)
  • Testing
  • Flow Diagram
  • Video