Skip to content

Commit

Permalink
on Bianca in good shape
Browse files Browse the repository at this point in the history
  • Loading branch information
richelbilderbeek committed May 13, 2024
1 parent 5ac31d0 commit fc12a25
Show file tree
Hide file tree
Showing 4 changed files with 87 additions and 49 deletions.
4 changes: 2 additions & 2 deletions docs/cluster_guides/bianca_file_transfer_using_filezilla.md
Original file line number Diff line number Diff line change
@@ -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?"

Expand Down
2 changes: 1 addition & 1 deletion docs/cluster_guides/bianca_file_transfer_using_gui.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
78 changes: 78 additions & 0 deletions docs/cluster_guides/sftp_with_bianca.md
Original file line number Diff line number Diff line change
@@ -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 [email protected]:/sven-sens2016001
```

`sftp` will ask for a password:

```
[email protected]'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 [email protected].

Best regards,
UPPMAX

[email protected]'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 [email protected]
```

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).
52 changes: 6 additions & 46 deletions docs/cluster_guides/transfer_bianca.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,59 +40,19 @@ 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)
for details.

## Using `sftp`

---
<../software/sftp.md>

```bash
$ sftp -q <username>-<projid>@bianca-sftp.uppmax.uu.se
```
Ex.
```bash
$ sftp -q [email protected]
```

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:

`<username>-<projid>` e.g. `myuser-sens2023598`

Example:
```bash
$ sftp -q [email protected]
[email protected]'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 <username>-<projid>@bianca-sftp.uppmax.uu.se:<username>-<projid>
```
E.g.
```bash
`$ sftp -q [email protected]: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`

Expand Down

0 comments on commit fc12a25

Please sign in to comment.