Remote Hotfolder

For the most up-to-date documentation, please visit docs.brix.ch

Remote Hotfolder is a console application that allows to upload all files of a local directory to a node of a remote CELUM server

1. Requirements

  • api-endpoint
  • api-remote
  • Java 11

2. Options

cmd

--help -h

argument: -, required: no, default: -

Displays helping information.

--url -u

argument: String, required: yes default: -

URL of the celum server.

--clientId -i

argument: String, required: yes default: -

CELUM client id (defined in the remote.yml file in the CELUM config folder).

--clientSecret -c

argument: String, required: yes default: -

CELUM client secret (defined in the remote.yml file in the CELUM config folder).

--serverSecret -s

argument: String, required: yes default: -

CELUM server secret (defined in the remote.yml file in the CELUM config folder).

--targetNode -t

argument: Number, required: yes default: -

Celum Target node where the files will be uploaded.

--sourceFolder -f

argument: Number, required: yes default: -

Source folder on the local system from where the files will be uploaded.

--locale -l

argument: Number, required: required: no default: 'en'

Locale for creation of CELUM Nodes, used in Nodefinders.

--nodeFinder -n

argument: String, required: no default: -

Name of the Nodefinder, if empty the assets will be uploaded directly to the target node.

Known implementations:

  • pluginVersionNodeFinder - expects filenames to follow semantic versioning, e.g. my-plugin-1.0.0, and creates two levels of subfolders, e.g. my-plugin on the first level and 1.0 on the second. Yes this is oddly specific, but this powers our plugin delivery pipeline: pluginVersionNodeFinder
--deleteFiles -d

argument: -, required: no default: -

With this argument the files will be deleted after the upload on the local system.

--preventDuplicates -p

argument: -, required: no default: -

With this argument if an asset with the same name as an uploading file exists already, it will be uploaded as a new version of the existing asset instead creating a second asset. Note that as of 1.1, every matching asset will be updated (instead of just the first one we find).

--searchGlobally -g

argument: -, required: no default: -, since: 1.1

When using preventDuplicates, search globally(!) instead of just in the target node. Be carefull with this one ;-)

--dryRun -y

argument: -, required: required: no default: -, since: 1.1

Don't actually do anything, but log what should have happened.

3. Compatibility Matrix

Remote Hotflolder CELUM api-endpoint api-remote
1.0.0 5.13.4 1.4.1 1.4.2
1.1.0 6.5.x 3.1.1 3.1.1

4. Usage

java -jar remote-file-uploader-1.0.0-jar-with-dependencies.jar -u "https://[my celum url]/remoteapi" -i "[my client id]" -c "[my client secrete]" -s "[my server secret]" -t 26621 -f "[path to my local directory]" -l "en" -n "pluginVersionNodeFinder" -d -p

Release Notes

1.0.0

Released 2020-02-18

  • Initial version

1.1.0

Released 2020-07-03

  • Added -g and -y options, updated api-endpoint to 3.0.0