Prerequisite
you are a project user with ‘Upload’ project permission
How to initiate data upload
You can trigger your upload as follows:
Upload from intial screen when there are no uploads yet, i.e. for a newly created project
Select a folder on the left navigation bar or drill into a folder within the main area. Click the top right 'Upload' button, folders/files will be uploaded to this location.
As soon as there are (sub)folders in your project you can also right-click on a folder and choose 'Upload'
Upload Options
The following options appear:
Upload via Browser
Upload via SFTP
Upload via RSYNC
Browser Upload
Usually you can simply drag&drop folders and files to the currently open folder.
If you go via the 'Upload' button choose 'via Browser' and a drag&drop area is offered for the same purpose.
Alternatively you can choose to browse your files on e.g. your computer and select which ones should be uploaded.
SFTP Upload
SFTP upload can be used for any size and number of files, but is most useful and recommended for bigger uploads (due to technical browser restrictions for browser uploads).
Please note to have ports in the following port range open (if needed please discuss with your IT administrator): 30000-32767
Choose/click on 'via SFTP'. The status changes first to 'Preparing'. Wait until this switches to 'Running'.
Then under 'Access parameters' you will find the SFTP connection and login information to upload your data, or you can (safely!) share the credentials with external users who should upload their data.
Note: To simply close the shown dialogue (i.e. neither cancel nor finish the upload) use the top right 'X' in the dialogue box. You can go back to the dialogue any time by selecting the 'Uploads' tab in the file manager and click on the desired upload record.
Now you (or the external user) can start uploading your data via your SFTP tool of choice (one typical approach is described below).
As the application does not know when you sent all desired files via SFTP you need to explicitly state you are done and your data should be finally imported into the platform.
To do so (you are done or the external user has told you they are done) go to the file manager > Uploads and select the desired upload record.
In the upcoming dialogue click on 'Sync upload channel'.
This triggers the import and initial data preprocessing (like reading the file and creating a geo-index of georeferenced files).
The file status will appear as 'Indexing' in the phase and turns to 'Ready' when done.In case you plan to upload huge amounts of data please see this article with some suggestions to speed this up.
Upload channel has been opened but no data should be uploaded
If it turns out you don't need this upload channel anymore, i.e. you (or the external party) don't want to upload data, or the already uploaded data should not be taken to the platform simply in above step choose 'Cancel uploading' and confirm your selection in the upcoming dialogue.
Note this means even if you started uploading some data already via SFTP these data will not be imported into the platform.
RSYC Upload
See 2., just choose RSYNC
Example of uploading tool: Filezilla
Filezilla (https://filezilla-project.org/) is a free (S)FTP solution. You can download the software onto your system and connect to the SFTP server created above in the access parameter dialogue.
Fill out the fields offered as follows
Host: Enter the IP address (first part of the endpoint before the colon (':')) shown in the access parameter section: "sftp://<ipaddress>", e.g. "sftp://12.345.67.890" (note: don't forget to explicitely write sftp://.
Username: Enter the username provided in the access parameter section
Password: Enter the password provided in the access parameter section
Port: Enter the port number (second part of the endpoint after the colon (':') shown in the access parameter section
After successful connection you can upload files from the left screen to the folder opened on the right screen.
