diff --git a/docs/cluster_guides/bianca_file_transfer_using_filezilla.md b/docs/cluster_guides/bianca_file_transfer_using_filezilla.md index e838b221f..596197c06 100644 --- a/docs/cluster_guides/bianca_file_transfer_using_filezilla.md +++ b/docs/cluster_guides/bianca_file_transfer_using_filezilla.md @@ -1,8 +1,8 @@ # File transfer to/from Bianca using FileZilla -![FileZilla logo, from https://en.wikipedia.org/wiki/FileZilla#/media/File:FileZilla_logo.svg](./img/filezilla_logo_240_x_240.png) +![FileZilla connected to Bianca](./img/filezilla_login_to_bianca_236_x_266.png) -> The FileZilla logo +> FileZilla connected to Bianca ???- question "Would you like a video?" diff --git a/docs/cluster_guides/bianca_file_transfer_using_gui.md b/docs/cluster_guides/bianca_file_transfer_using_gui.md index 97e68eefa..26fbe2ce9 100644 --- a/docs/cluster_guides/bianca_file_transfer_using_gui.md +++ b/docs/cluster_guides/bianca_file_transfer_using_gui.md @@ -1,6 +1,6 @@ # File transfer to/from Bianca using a graphical tool -![](./img/filezilla_login_to_bianca_236_x_266.png) +![FileZilla connected to Bianca](./img/filezilla_login_to_bianca_236_x_266.png) > FileZilla connected to Bianca diff --git a/docs/cluster_guides/sftp_with_bianca.md b/docs/cluster_guides/sftp_with_bianca.md new file mode 100644 index 000000000..3f14bb69d --- /dev/null +++ b/docs/cluster_guides/sftp_with_bianca.md @@ -0,0 +1,78 @@ +# Using `sftp` with Bianca + +[`sftp`](../software/sftp) is a command-line program +to [transfer files to/from Bianca](tranfer_bianca.md). + +## Usage + +[When inside of SUNET](../getting_started/get_inside_sunet.md) +(which can be on a local computer or on [Rackham](rackham.md)) do: + +``` +sftp [user_name]-[project_id]@bianca-sftp.uppmax.uu.se:/[user_name]-[project_id] +``` + +For example: + +``` +sftp sven-sens2016001@bianca-sftp.uppmax.uu.se:/sven-sens2016001 +``` + +`sftp` will ask for a password: + +``` +sven-sens2016001@bianca-sftp.uppmax.uu.se's password: +``` + +The password is your normal UPPMAX password directly followed by +the six digits from the [the `UPPMAX` 2-factor authentication](https://www.uu.se/en/centre/uppmax/get-started/2-factor). +For example, if your password is `VerySecret` and the second factor code is `123456` +you would type `VerySecret123456` as the password in this step. + +After typing in the password and 2FA one sees a welcome message +and the `sftp` prompt. + +???- question "How does that look like?" + + This is the welcome message: + + ``` + Hi! + + You are connected to the bianca wharf (sftp service) at + bianca-sftp.uppmax.uu.se. + + Note that we only support SFTP, which is not exactly the + same as SSH (rsync and scp will not work). + + Please see our homepage and the Bianca User Guide + for more information: + + https://www.uppmax.uu.se/support/user-guides/bianca-user-guide/ + + If you have any questions not covered by the User Guide, you are + welcome to contact us at support@uppmax.uu.se. + + Best regards, + UPPMAX + + richel-sens2016001@bianca-sftp.uppmax.uu.se's password: + Connected to bianca-sftp.uppmax.uu.se. + sftp> + ``` + +???- question "How do I get rid of the welcome message?" + + Use `sftp`'s `-q` (which is short for 'quiet') flag: + + ``` + sftp -q sven-sens2016001@bianca-sftp.uppmax.uu.se + ``` + +The last line, `sftp> ` is the `sftp` prompt. + + +Once connected you will have to type the `sftp` commands to upload/download files. +See [the UPPMAX page on `sftp`](../software/sftp.md) how to do so. + +With `sftp` you only have access to [your wharf folder](wharf.md). diff --git a/docs/cluster_guides/transfer_bianca.md b/docs/cluster_guides/transfer_bianca.md index 51a536ad5..9f566aa21 100644 --- a/docs/cluster_guides/transfer_bianca.md +++ b/docs/cluster_guides/transfer_bianca.md @@ -40,6 +40,10 @@ Transit server from/to Rackham, see below |Terminal, can be ## Using a graphical program +![FileZilla connected to Bianca](./img/filezilla_login_to_bianca_236_x_266.png) + +> FileZilla connected to Bianca + To transfer files to/from [Bianca](bianca.md) one can use a graphical tool, such as FileZilla and WinSCP. See [File transfer using a graphical program](bianca_file_transfer_using_gui.md) @@ -47,52 +51,8 @@ for details. ## Using `sftp` ---- -<../software/sftp.md> - -```bash -$ sftp -q -@bianca-sftp.uppmax.uu.se -``` - Ex. -```bash -$ sftp -q myuser-sens2023598@bianca-sftp.uppmax.uu.se -``` - -The `-q` flag is to be quiet (not showing the banner intended to help someone trying to ``ssh`` to the host), if your client does not support it, you can just skip it. - -Use your normal UPPMAX password directly followed by -the six digits from the second factor application. - -Ex. if your password is "VerySecret" and the second factor code is 123 456 you would type VerySecret123456 as the password in this step. - -Once connected you will have to type the sftp commands to upload/download files. Have a look at the Basic SFTP commands guide to get started with it. - -Please note that in the wharf you only have access to upload your files to the directory that is named: - -`-` e.g. `myuser-sens2023598` - -Example: -```bash -$ sftp -q pmitev-sens2023598@bianca-sftp.uppmax.uu.se -pmitev-sens2023598@bianca-sftp.uppmax.uu.se's password: - -sftp> ls -pmitev-sens2023598 - -sftp> cd pmitev-sens2023598 -sftp> -``` - -Alternatively, you can specify this at the end of the sftp command, so that you will always end up in the correct folder directly. - -```bash -$ sftp -q -@bianca-sftp.uppmax.uu.se:- -``` -E.g. -```bash -`$ sftp -q myuser-sens2023598@bianca-sftp.uppmax.uu.se:myuser-sens2023598 -``` -- `sftp` supports a recursive flag `-r` to upload (`put -r folder_name`) or download (`get -r folder_name`) entire folders and subfolders. +`sftp` is a terminal SFTP client to transfer files to/from Bianca. +See [using `sftp` with Bianca](sftp_with_bianca.md). ## Using `lftp`