F*EX file archive sharing
You can share versioned file archives with other users (*)
Archives and users
are bundled in a so called share:
|
access rights
| user:r (read) | • read archive versions |
| user:w (write) | • write new archive version |
| user:a (add) | • add new archive set |
| user:m (manage) | • add or remove user
• remove archive (set)
• (un)set user access rights read,write,add |
| owner | • create, clone or delete share
• add or remove user
• read, write, add, rename or remove archive (set)
• set maximum number of archive versions per user
• (un)set all user access rights |
|
(see web HOWTO)
Feature overview
- share file archives (tar, zip, 7-zip) with optional comment
- automatic versioning of archives, using UTC date+time string
- resume aborted downloads or uploads
- no expire or autodelete
- owner can add share users with read, write, add, or manage rights
- owner can add anonymous download share user
- preserve file attributes (when using F*EX clients)
- webonly usage possible
- fully scriptable
- fexpush/fexpull client with pipe support (STDOUT/STDIN)
- optional email auto notification of new uploads
- share based logging
- ip and domain based access restrictions (by fexmaster)
- transfer based bandwith restriction
- keep local files uptodate (syncing)
- copy or rename archives
- clone (foreign) shares
- attach descriptions to shares or archive sets
- set maximum number of versions per archive and user
(==> autodeleting old versions)
- quotas
Shares and owner
A share is a common storage for archive files, users and their
access rights.
You (owner) as a registered F*EX user
create a share and add users to it (via [show users]).
These share users do not have to be regular (registered)
F*EX users, you can use any email address.
You can give your share users read, write, add or manage access rights.
You or your users can upload versioned archives into the share.
You can create any number of shares.
In the diagram above you see only "One", to reduce complexity.
The shares are separated from each other.
You can attach a description to a share.
Archives
A share archive is a
tar,
ZIP or
7-Zip
container file with a unique name and an auto-generated version number
(date format YYYYMMDD_hhmmss).
Example archive name: project-videos_20170818_134521.zip
A share archive may contain any number of any kind of files (programs, documentation,
audio or video files, etc) of any size in any directory structure.
All archives with the same name build an archive set.
You can attach a description to an archive set.
You can only upload or download single archive versions (= share archive
which contains your files), not the whole archive set with all versions in one go.
For example: [Share One, Archive Set A, Version 3] is a share archive.
Typically you operate with the latest version (= highest number).
You can download and upload files with your webbrowser or
with the F*EX client fexpull/fexpush which can (un)pack archives
on-the-fly.
When you upload file(s) a new archive version is created.
Only the owner and master users can delete archives.
Users
Users are created by the owner.
A user is identified by his email address.
A share user does not have to be a regular (registered)
F*EX user.
Master users
A user with manage access right is a so called master user.
He must be a regular (registered) F*EX user,
you cannot add a foreign user as a master user.
A master user can give other users read, write or add access rights for this share.
A master user cannot create or remove other master users. This task is
reserved for you, the owner.
Share URL
A share URL comprises F*EX server address, share name, owner and user email addresses.
The user gets a share URL from the owner (email can be sent via webinterface).
He can enter this URL either in his webbrowser or F*EX client.
A list of all available share archives will be presented and the user
can see what is inside such an archive, before download.
Different owners can use the same share name, but the shares and share
URLs are different.
Share _
Every owner also has his own private share "_" where he can store archive
files only for his own usage.
It is a "non-sharable share": a storage place with the same access mechanism
like any other share, but one cannot add other users to it.
Archive files in share _ have assigned short URLs which you can use for
download anywhere with any program or give it to others.
You can access the share _ with
fexpush & fexpull.
Clone, copy, rename, remove
You can clone shares: this function copies all share objects into
a new share.
You can copy archives: this function copies all versions of an
archive into an other share.
You can rename archive sets.
You can remove shares, archives (versions) or users.
| archive sharing | document exchange |
| storage unit | share | folder |
| storage subunit | archive set | directory (nested) |
| storage object | archive | file |
| file synchronization | no | yes |
| file attributes preservation | yes | modification time only |
| annotations | yes | directory only |
| versioning level | archive | folder |
| cooperative administration | yes | no |
| expiration/autodelete | no | no |
| transfer size | unlimited | unlimited |
| resuming of interrupted transfers | yes | yes |
| users managed by owner | yes | yes |
| user upload | yes | yes |
| users may delete objects | yes | no |
| anonymous usage | optional | optional |
| web interface | yes | yes |
| CLI | yes | yes |
| notification of new uploads | optional | optional |
| object | naming | example |
| share | any combination of ASCII character, number, "-", "_" | project_worlddomination |
| owner | email address | framstag@rus.uni-stuttgart.de |
| user | email address | tux@flupp.org |
| archive set | any combination of ASCII character, number, "-", "_", "." | plan-A1 |
| archive | date_time (automatically generated) | 20170620_091901 |
(*)
To use F*EX sharing your F*EX administrator must allow it.
It is a configuration option and not activated per default.