How do I…?

This page will host tutorials and guides from the lab users and managers on specific lab activities.

If you have how-do-i questions:

  • For general topics, use the “helpline” topic in the #general stream of the Chat

  • For contextual discussions, reach out to @LabManagers in your Chat conversations

Over time, this page should be populated with the frequently asked questions.

Basics

I have received my lab login credentials. What should I do now?

The lab uses a set of inter-linked Services to provide shared working spaces. A good first step is to complete the first login to Chat, to Project Portal and the Science Desktop. This will ensure that your accounts are created, security setup works and your account will be available for other lab users to interact with. If the instructions available at the linked pages does not work, then please open a support ticket providing details of the problem.

How do I invite a new user to the lab?

This is performed by a Trusted User by using the Registration page.

How do I create new labspace?

This first step is performed by a Trusted User by using the Registration page. Subsequently, any member can add other users to the labspace themselves, as described in the Invite section.

How do I get help at the DataLab?

Please describe your issue in detail in an email to datalab@leibniz-zmt.de If you have a ZMT email account, you can also use the Support portal.

Labspace Use

How do I move files and folders into my labspace from my local machine?

We recommend the use of the rsync tool to synchronize the contents of a folder on your machine to the labspace folder. rsync is a well-estbalished and open-source tool to perform differential file transfer, i.e. it can be used to only update contents that are newer or different.

The general syntax for rsync transfers over an ssh connection is

rsync [OPTIONS]  SRC USER@HOST:DEST

A good command for synchronizing the contents from your local folder at path/to/source_folder to the labspaces/my-labspace-name/data/inbox folder on the datalab is

rsync -vhurt --chmod=ug=rwX path/to/source_folder first_name.last_name@desktop.zmt-datalab.de:labspaces/my-labspace-name/data/inbox/

The --chmod=ug=rwX is required to ensure that read-write permissions are shared for both the u ser (you) and the g roup (labspace). The -r option specifies that the folder contents are recursively copied, that is the sub-folders are traversed and copied over at the corresponding location. The -u option performs an update, meaning only files that are different in the source and destination are transferred. The -t option keeps the timestamps of file modification, -v shows a verbose listing of the transfers, -h option shows the file size numbers in human-readable format. It is also possible to add --progress to show real-time progress information.

Note that rsync allows you to control whether the source folder or only its contents are created on the destination. In the command above, the sourch path source_folder did not have a trailing slash (/) while the destination data/inbox/ had a trailing slash. This means that source_folder will be created under inbox. Including a trailing slash as source_folder/ would result in the contents of source_folder being copied under inbox but source_folder itself would not be created. If you have spaces in the path, then check the --protect-args option to provide the paths with spaces.

Running the above command (with paths set correctly) should result in prompts for your password and OTP. Entering these should commence the transfer if the paths are correct. Note that a graphical interface for rsync is available as grsync, but please check that options are correctly specified. The --chmod=ug=rwX option should be entered under Advanced Options > Additional Options.