connector-nextcloud (uplink v1.0.5)

Overview

The nextcloud Connector connects to nextcloud and transfers all the files with the file structure to Storj network.

Usage:
  connector-nextcloud [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: nextcloud_property.json). Back-up of the database is generated using tooling provided by Nextcloud 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 files are iterated through and upload one by one 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.
• share - 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-nextcloud.git

Then, build the project using the following:

cd connector-nextcloud
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-nextcloud

NOTE: The above command may show the following warnings and can be ingnored:

github.com/storj-thirdparty/connector-nextcloud/nextcloud
../../go/src/github.com/storj-thirdparty/connector-nextcloud/nextcloud/nextcloud.go:78:2: cannot use nextcloudClient (type gonextcloud.Client) as type *gonextcloud.Client in return argument:
 *gonextcloud.Client is pointer to interface, not interface
 
../../go/src/github.com/storj-thirdparty/connector-nextcloud/nextcloud/nextcloud.go:83:33: nextcloudClient.WebDav undefined (type *gonextcloud.Client is pointer to interface, not interface)

../../go/src/github.com/storj-thirdparty/connector-nextcloud/nextcloud/nextcloud.go:109:34: nextcloudClient.WebDav undefined (type *gonextcloud.Client is pointer to interface, not interface)

../../go/src/github.com/storj-thirdparty/connector-nextcloud/nextcloud/nextcloud.go:130:41: nextcloudClient.WebDav undefined (type *gonextcloud.Client is pointer to interface, not interface)

Run (short version)

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

Get help

$ ./connector-nextcloud --help

Check version

$ ./connector-nextcloud version

Transfer files from Nextcloud to Storj

$ ./connector-nextcloud 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