TrueCloudLab/rclone
16
0
Fork 3
Code Issues 6 Pull requests 1 Projects Releases 1 Packages Wiki Activity Actions

jottacloud: update docs regarding cleanup, removed remains from old auth, and added warning about special mountpoints.

Browse source
This commit is contained in:
albertony 2020-05-11 01:00:43 +02:00 • committed by buengese
parent bd4b91bd57
commit 962fbc8257
2 changed files with 46 additions and 28 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

72
docs/content/jottacloud.md
View file

@ -7,15 +7,25 @@ date: "2018-08-07"
<i class="fa fa-cloud"></i> Jottacloud <i class="fa fa-cloud"></i> Jottacloud
----------------------------------------- -----------------------------------------
Jottacoud is a cloud storage service provider from a Norwegian company, using its own datacenters in Norway.
In addition to the official service at [jottacloud.com](https://www.jottacloud.com/), there are
also several whitelabel versions which should work with this backend.
Paths are specified as `remote:path` Paths are specified as `remote:path`
Paths may be as deep as required, eg `remote:directory/subdirectory`. Paths may be as deep as required, eg `remote:directory/subdirectory`.
To configure Jottacloud you will need to generate a personal security token in the Jottacloud web inteface. You will the option to do in your [account security settings](https://www.jottacloud.com/web/secure). Note that the web inteface may refer to this token as a JottaCli token. ## Setup
To configure Jottacloud you will need to generate a personal security token in the Jottacloud web interface.
You will the option to do in your [account security settings](https://www.jottacloud.com/web/secure)
(for whitelabel version you need to find this page in its web interface).
Note that the web interface may refer to this token as a JottaCli token.
Here is an example of how to make a remote called `remote`. First run: Here is an example of how to make a remote called `remote`. First run:
rclone config rclone config
This will guide you through an interactive setup process: This will guide you through an interactive setup process:
@ -59,8 +69,9 @@ Devices> 3
Please select the mountpoint to user. Normally this will be Archive Please select the mountpoint to user. Normally this will be Archive
Choose a number from below, or type in an existing value Choose a number from below, or type in an existing value
1 > Archive 1 > Archive
2 > Shared 2 > Links
3 > Sync 3 > Sync
Mountpoints> 1 Mountpoints> 1
-------------------- --------------------
[jotta] [jotta]
@ -90,12 +101,21 @@ To copy a local directory to an Jottacloud directory called backup
rclone copy /home/source remote:backup rclone copy /home/source remote:backup
### Devices and Mountpoints ### ### Devices and Mountpoints
The official Jottacloud client registers a device for each computer you install it on and then creates a mountpoint for each folder you select for Backup. The official Jottacloud client registers a device for each computer you install it on,
The web interface uses a special device called Jotta for the Archive, Sync and Shared mountpoints. In most cases you'll want to use the Jotta/Archive device/mounpoint however if you want to access files uploaded by any of the official clients rclone provides the option to select other devices and mountpoints during config. and then creates a mountpoint for each folder you select for Backup.
The web interface uses a special device called Jotta for the Archive and Sync mountpoints.
In most cases you'll want to use the Jotta/Archive device/mountpoint, however if you want to access
files uploaded by any of the official clients rclone provides the option to select other devices
and mountpoints during config.
### --fast-list ### The built-in Jotta device may also contain several other mountpoints, such as: Latest, Links, Shared and Trash.
These are special mountpoints with a different internal representation than the "regular" mountpoints.
Rclone will only to a very limited degree support them. Generally you should avoid these, unless you know what you
are doing.
### --fast-list
This remote supports `--fast-list` which allows you to use fewer This remote supports `--fast-list` which allows you to use fewer
transactions in exchange for more memory. See the [rclone transactions in exchange for more memory. See the [rclone
@ -105,10 +125,10 @@ Note that the implementation in Jottacloud always uses only a single
API request to get the entire list, so for large folders this could API request to get the entire list, so for large folders this could
lead to long wait time before the first results are shown. lead to long wait time before the first results are shown.
### Modified time and hashes ### ### Modified time and hashes
Jottacloud allows modification times to be set on objects accurate to 1 Jottacloud allows modification times to be set on objects accurate to 1
second. These will be used to detect whether objects need syncing or second. These will be used to detect whether objects need syncing or
not. not.
Jottacloud supports MD5 type hashes, so you can use the `--checksum` Jottacloud supports MD5 type hashes, so you can use the `--checksum`
@ -118,7 +138,7 @@ Note that Jottacloud requires the MD5 hash before upload so if the
source does not have an MD5 checksum then the file will be cached source does not have an MD5 checksum then the file will be cached
temporarily on disk (wherever the `TMPDIR` environment variable points temporarily on disk (wherever the `TMPDIR` environment variable points
to) before it is uploaded. Small files will be cached in memory - see to) before it is uploaded. Small files will be cached in memory - see
the `--jottacloud-md5-memory-limit` flag. the [--jottacloud-md5-memory-limit](#jottacloud-md5-memory-limit) flag.
#### Restricted filename characters #### Restricted filename characters
@ -138,28 +158,24 @@ the following characters are also replaced:
Invalid UTF-8 bytes will also be [replaced](/overview/#invalid-utf8), Invalid UTF-8 bytes will also be [replaced](/overview/#invalid-utf8),
as they can't be used in XML strings. as they can't be used in XML strings.
### Deleting files ### ### Deleting files
By default rclone will send all files to the trash when deleting files. By default rclone will send all files to the trash when deleting files. They will be permanently
Due to a lack of API documentation emptying the trash is currently deleted automatically after 30 days. You may bypass the trash and permanently delete files immeditaly
only possible via the Jottacloud website. If deleting permanently by using the [--jottacloud-hard-delete](#jottacloud-hard-delete) flag, or set the equivalent environment variable.
is required then use the `--jottacloud-hard-delete` flag, Emptying the trash is supported by the [cleanup](/commands/rclone_cleanup/) command.
or set the equivalent environment variable.
### Versions ### ### Versions
Jottacloud supports file versioning. When rclone uploads a new version of a file it creates a new version of it. Currently rclone only supports retrieving the current version but older versions can be accessed via the Jottacloud Website. Jottacloud supports file versioning. When rclone uploads a new version of a file it creates a new version of it.
Currently rclone only supports retrieving the current version but older versions can be accessed via the Jottacloud Website.
### Quota information ### ### Quota information
To view your current quota you can use the `rclone about remote:` To view your current quota you can use the `rclone about remote:`
command which will display your usage limit (unless it is unlimited) command which will display your usage limit (unless it is unlimited)
and the current usage. and the current usage.
### Device IDs ###
Jottacloud requires each 'device' to be registered. Rclone brings such a registration to easily access your account but if you want to use Jottacloud together with rclone on multiple machines you NEED to create a seperate deviceID/deviceSecrect on each machine. You will asked during setting up the remote. Please be aware that this also means that copying the rclone config from one machine to another does NOT work with Jottacloud accounts. You have to create it on each machine.
<!--- autogenerated options start - DO NOT EDIT, instead edit fs.RegInfo in backend/jottacloud/jottacloud.go then run make backenddocs --> <!--- autogenerated options start - DO NOT EDIT, instead edit fs.RegInfo in backend/jottacloud/jottacloud.go then run make backenddocs -->
### Advanced Options ### Advanced Options
@ -225,15 +241,17 @@ See: the [encoding section in the overview](/overview/#encoding) for more info.
<!--- autogenerated options stop --> <!--- autogenerated options stop -->
### Limitations ### ### Limitations
Note that Jottacloud is case insensitive so you can't have a file called Note that Jottacloud is case insensitive so you can't have a file called
"Hello.doc" and one called "hello.doc". "Hello.doc" and one called "hello.doc".
There are quite a few characters that can't be in Jottacloud file names. Rclone will map these names to and from an identical looking unicode equivalent. For example if a file has a ? in it will be mapped to ？ instead. There are quite a few characters that can't be in Jottacloud file names. Rclone will map these names to and from an identical
looking unicode equivalent. For example if a file has a ? in it will be mapped to ？ instead.
Jottacloud only supports filenames up to 255 characters in length. Jottacloud only supports filenames up to 255 characters in length.
### Troubleshooting ### ### Troubleshooting
Jottacloud exhibits some inconsistent behaviours regarding deleted files and folders which may cause Copy, Move and DirMove operations to previously deleted paths to fail. Emptying the trash should help in such cases. Jottacloud exhibits some inconsistent behaviours regarding deleted files and folders which may cause Copy, Move and DirMove
operations to previously deleted paths to fail. Emptying the trash should help in such cases.

2
docs/content/overview.md
View file

@ -331,7 +331,7 @@ operations more efficient.
| Google Photos | No | No | No | No | No | No | No | No | No | No | | Google Photos | No | No | No | No | No | No | No | No | No | No |
| HTTP | No | No | No | No | No | No | No | No [#2178](https://github.com/rclone/rclone/issues/2178) | No | Yes | | HTTP | No | No | No | No | No | No | No | No [#2178](https://github.com/rclone/rclone/issues/2178) | No | Yes |
| Hubic | Yes † | Yes | No | No | No | Yes | Yes | No [#2178](https://github.com/rclone/rclone/issues/2178) | Yes | No | | Hubic | Yes † | Yes | No | No | No | Yes | Yes | No [#2178](https://github.com/rclone/rclone/issues/2178) | Yes | No |
| Jottacloud | Yes | Yes | Yes | Yes | No | Yes | No | Yes | Yes | Yes | | Jottacloud | Yes | Yes | Yes | Yes | Yes | Yes | No | Yes | Yes | Yes |
| Mail.ru Cloud | Yes | Yes | Yes | Yes | Yes | No | No | Yes | Yes | Yes | | Mail.ru Cloud | Yes | Yes | Yes | Yes | Yes | No | No | Yes | Yes | Yes |
| Mega | Yes | No | Yes | Yes | Yes | No | No | No [#2178](https://github.com/rclone/rclone/issues/2178) | Yes | Yes | | Mega | Yes | No | Yes | Yes | Yes | No | No | No [#2178](https://github.com/rclone/rclone/issues/2178) | Yes | Yes |
| Memory | No | Yes | No | No | No | Yes | Yes | No | No | No | | Memory | No | Yes | No | No | No | Yes | Yes | No | No | No |