# Internal kista

Internal kistas provides controlled data transfers between two labs inside HUNT Cloud. In short, internal kistas are short-lived and hardened SFTP (opens new window)-servers dedicated to one data transaction between two labs.

Note

This page describes the practical aspects of kista transfers. Head over to our internal transfer section in the FAQ for more information on the service itself.

# Order

Lab leaders and lab coordinators can order internal kistas in our administer-science service desk.

# Roles

The kista order defines two roles that we will use in this document:

  • Uploader. This is the lab user in the lab that has ordered the Kista and that will provide (upload) data.
  • Downloader. This the lab user in the lab that will receive (download) data.

We will notify the lab user that registered as the uploader when the kista is deployed. The uploader is responsible for notifying the downloader when data is uploaded and ready to be downloaded.

# Connection details

You can view the kista transfer information directly from your home machine both as a uploader and downloader:

  1. Log into your home machine
  2. View the kista transfer information in the /opt/hunt-cloud/kista/ folder:
# -- List kista transfer information files
ls /opt/hunt-cloud/kista/

# -- Principle example to see transfer information
cat /opt/hunt-cloud/kista/*<number>*

# -- Practical example to see transfer information
cat /opt/hunt-cloud/kista/*5623*

The transfer information will look similar to this:

### SFTP account information
Protocol: sftp
Server: 10.42.132.<number>
Port: 22
Username: <username>-<role>

Note. The information above is for illustration and will not work for your connection. Your account information will contain different information for the "Server" and "Username".

# Upload

TIP

This section is aimed at the lab user that will upload data to a kista. See the download section if you plan to download data to your lab.

SFTP method allows you to connect to a remote kista through your home machine and safely transfer your data.

# SFTP

Connect

Connect to your kista using the SFTP protocol. This may seem unfamiliar at first, however its simple to use once you get going:

  1. From your home machine, connect to the kista over SFTP using the transfer information collected above.
# -- Principal example
sftp <username>-<role>@10.42.132.<number>

# -- Demo example uploader
sftp demouser-upload@10.42.132.118

When successfully connected, you should see the following message in your terminal:

Connected to 10.42.132.<number>.
sftp>

Upload

  1. Once inside your kista, move to the upload folder.
cd upload
  1. Upload a file or folder by specifying its local path on your home machine.
# -- Upload individual file
put /mnt/cargo/example-file1.txt

# -- Upload folder
put -r /mnt/cargo/example-directory/
  1. List files the current directory to verify the transfer
ls -lah
  1. Disconnect from your the SFTP-server
quit

For large uploads, terminal multiplexers can be a handy tool allowing for the transfer to continue even when you log off from your home machine.

You can resume an upload with this command:

reput /mnt/cargo/example-file1.txt

LFTP method works in similar fashion, except it offers you more reliable transfer in case you are transferring a lot of data over long period of time using mirror option, f.e it will allow you to continue upload even if connection is broken.

# LFTP

Connect and upload

  1. From your home machine, using command below you will be able to connect to remote kista and specify directories for transfer. Ideally you should run your command in terminal multiplexer.
# -- Principal example
lftp -e "mirror -cR <upload_directory> /upload; bye" sftp://<username>-upload:@<ip-address>

# -- Demo example
lftp -e "mirror --parallel=10 -cR /mnt/archive/example_archive/ /upload; bye" sftp://demouser-upload:@10.42.132.118

You can read more about LFTP here

# Download

TIP

This section is aimed at the lab user that will download data from a kista. See the upload section if you plan to download data to your lab.

# SFTP
  1. From your home machine, connect to the kista over SFTP using the transfer information collected above.
# -- Principal example
sftp <username>-<role>@10.42.132.<number>

# -- Demo example downloader
sftp demouser-download@10.42.132.118

When successfully connected, you should see the following message in your terminal:

Connected to 10.42.132.<number>.
sftp>
  1. Once inside your kista, move to the upload folder.
cd upload
  1. List files in the current directory.
ls -lah
  1. Download a file or folder by specifying the file or folder name and the local path that you want to download to.
# -- Principal example
get <sftp-file> <home-machine-folder>

# -- Download individual file
get example-filename1.txt /mnt/cargo/

# -- Download folder
get -r example-directory /mnt/cargo/
  1. Disconnect from your the SFTP-server
quit

For large downloads, terminal multiplexers can be a handy tool allowing for the transfer to continue even when you log off from your home machine.

You can resume a download with this command:

reget /mnt/cargo/example-file1.txt
# LFTP

For large downloads, terminal multiplexers can be a handy tool allowing for the transfer to continue even when you log off from your home machine.

# -- Principal example
lftp -e "mirror -c /upload <download_to_directory>; bye" sftp://<username>-<role>:@<ip-address>

# -- Demo example downloader
lftp -e "mirror --parallel=10 -c /upload /home/demouser/download-hunt; bye" sftp://demouser-download:@10.42.132.118

# Troubleshooting

# WARNING: Remote host identification has changed

You might see this warning message when you log into a kista that has been rebuild on the same IP as you have used for a previous kista transport.

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@    WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!     @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Solution

Click here to see the full message and explanation in our main troubleshooting section. You may ignore this message if you connect to a kista inside your lab.

You can remove the message and proceed with the login by running the command that is stated at the end of the screen message similar to:

ssh-keygen -f "/home/<username>/.ssh/known_hosts" -R "10.42.<number>.<number>"
Last Updated: 12/2/2024