Log in to Bianca¶
The two Bianca environments to work on Bianca. At the left is a remote desktop environment. At the the right is the console environment.
Here it is described how to log in to Bianca:
- Bianca's design: helps understand why the procedure described here is needed.
- Prerequisites describes what is needed before one can login to Bianca
- The two Bianca environments shows the two ways to use Bianca
- Get within the university networks shows how to be allowed to access Bianca
- Get inside the Bianca environment show how to get inside the Bianca environments:
- Login to the Bianca remote desktop environment
- Login to the Bianca console environment
Prerequisites for using Bianca¶
To be allowed to use Bianca, one needs all of these:
These prerequisites are discussed in detail below.
An active research project¶
One prerequisite for using Bianca
is that you need to be a member of an active SNIC SENS
or SIMPLER research project (these are called sens[number]
or simp[number]
,
where [number]
represent a number, for example sens123456
or simp123456
).
Forgot your Bianca projects?
One easy way to see your Bianca projects is to use the Bianca remote desktop login screen at https://bianca.uppmax.uu.se/.
SUPR (the 'Swedish User and Project Repository') is the website that allows one to request access to Bianca and to get an overview of the requested resources.
How does the SUPR website look like?
First SUPR page
SUPR 2FA login. Use the SUPR 2FA (i.e. not UPPMAX)
After logging in, the SUPR website will show all projects you are a member of, under the 'Projects' tab.
How does the 'Projects' tab of the SUPR website look like?
Example overview of SUPR projects
To see if a project has access to Bianca, click on the project and scroll to the 'Resources' section. In the 'Compute' subsection, there is a table. Under 'Resource' it should state 'Bianca @ UPPMAX'.
How does the 'Resources' page of an example project look like?
The 'Resources' page of an example project.
Note that the 'Accounts' tab can be useful to verify your username.
How does the 'Accounts' tab help me find my username?
An example of a SUPR 'Accounts' tab. The example user has username
richel-sens2023598
, which means his/her UPPMAX username isrichel
You can become a member of an active SNIC SENS by:
- request membership to an existing project in SUPR
- create a project. See the UPPMAX page on how to submit a project application here
An UPPMAX user account¶
Another prerequisite for using Bianca is that you must have a personal UPPMAX user account. This is separate from your SUPR account. See the user account application page if you do not have one.
Once you are set up for login, this should also be reflected in SUPR through one or several additional account(s) at UPPMAX for the specific project(s) you are a member of.
An UPPMAX password¶
Another prerequisite for using Bianca is that you need to know your UPPMAX password. If you change it, it may take up to an hour before changes are reflected in Bianca.
For advice on handling sensitive personal data correctly on Bianca, see our FAQ page.
The two Bianca environments¶
Bianca, like most HPC clusters, uses Linux. To use Bianca, there are two environments:
How does the Bianca remote desktop look like?
One can pick multiple remote desktop environments, such as GNOME and XFCE (and KDE, don't pick KDE!).
The Bianca XFCE remote desktop environment
A more populated Bianca XFCE remote desktop
- A remote desktop environment, also called 'graphical environment', 'GUI environment', 'ThinLinc environment'
How does the Bianca console environment look like?
The Bianca console environment
- A console environment, also called 'terminal environment' or 'terminal'
The remote desktop environment is considered the easier place to start for most new users, as it has most similarities with what a new user is familiar with. However, one must always use a terminal to some extent.
flowchart TD
%% Give a white background, instead of a transparent one
classDef node fill:#fff,color:#000,stroke:#000
subgraph sub_bianca_private_env[The project's private virtual project cluster]
bianca_private_console[Bianca console environment]
bianca_private_remote_desktop[Bianca remote desktop]
bianca_private_terminal[Terminal]
end
%% Shared subgraph color scheme
%% style sub_outside fill:#ccc,color:#000,stroke:#ccc
%% style sub_inside fill:#fcc,color:#000,stroke:#fcc
%% style sub_bianca_shared_env fill:#ffc,color:#000,stroke:#ffc
style sub_bianca_private_env fill:#cfc,color:#000,stroke:#cfc
%% Private Bianca
bianca_private_console---|is a|bianca_private_terminal
bianca_private_remote_desktop-->|must also use|bianca_private_terminal
The two Bianca environments and their relation to a terminal.
Get within the university networks¶
Bianca has sensitive data. To protect this data, Bianca is accessible from all Swedish university networks. To be precise, to connect to Bianca one needs to so from a SUNET Internet Protocol ('IP') address.
Due to this, the first step to access Bianca is to get an IP that is inside SUNET first.
See the 'get inside the university networks' page here
Get inside the Bianca environment¶
Want a video?
- Login to the Bianca remote desktop and Bianca console environment, physically inside SUNET
- Login to the Bianca remote desktop and Bianca console environment, outside of SUNET, use VPN
- Install VPN client, then login to the Bianca remote desktop using that VPN client
- Login to the Bianca remote desktop and Bianca console environment, outside of SUNET, no VPN
When inside SUNET, one can access the Bianca environments.
- For a remote desktop environment, go to login to the Bianca remote desktop environment
- For a console environment, go to login to the Bianca console environment
Below, the ways to access these Bianca environments are discussed
flowchart TD
%% Give a white background, instead of a transparent one
classDef node fill:#fff,color:#000,stroke:#000
subgraph sub_inside[IP inside SUNET]
user(User)
subgraph sub_bianca_shared_env[Bianca shared network]
subgraph sub_bianca_private_env[The project's private virtual project cluster]
bianca_private_console[Bianca console environment]
bianca_private_remote_desktop[Bianca remote desktop]
end
end
end
%% Shared subgraph color scheme
%% style sub_outside fill:#ccc,color:#000,stroke:#ccc
style sub_inside fill:#fcc,color:#000,stroke:#fcc
style sub_bianca_shared_env fill:#ffc,color:#000,stroke:#ffc
style sub_bianca_private_env fill:#cfc,color:#000,stroke:#cfc
%% Inside SUNET
user --> bianca_private_console
user --> bianca_private_remote_desktop
Login to the Bianca remote desktop environment¶
There are multiple ways to do so:
- Login to the Bianca remote desktop environment website.
- Login to the Bianca remote desktop environment using a local ThinLinc client
Login to the Bianca console environment¶
When inside SUNET, one can access a Bianca console environment using a terminal and the Secure Shell Protocol (SSH).
Forgot how to get within SUNET?
See the 'get inside the university networks' page here
You can use your favorite terminal to login (see https://uppmax.github.io/uppmax_intro/login2.html#terminals for an overview of many) to the Bianca command-line environment. You can also have multiple log-ins active at once.
There are multiple ways to set this up:
- Login to the Bianca console environment with a password.
- Login to the Bianca console environment with an SSH key.
Using an SSH password is considered easiest, where using an SSH key is considered more elegant.
In a Bianca console environment:
- Text display is limited to 50kBit/s. This means that if you create a lot of text output, you will have to wait some time before you get your prompt back.
- Cut, copy and paste work as usual. Be careful to not copy-paste sensitive data!
flowchart TD
%% Give a white background, instead of a transparent one
classDef node fill:#fff,color:#000,stroke:#000
subgraph sub_inside[IP inside SUNET]
user(User)
subgraph sub_bianca_shared_env[Bianca shared network]
bianca_shared_console[Bianca console environment login]
subgraph sub_bianca_private_env[The project's private virtual project cluster]
bianca_private_console[Bianca console environment]
%% Ensure the innermost square gets big enough
END:::hidden
end
end
end
%% Shared subgraph color scheme
%% style sub_outside fill:#ccc,color:#000,stroke:#ccc
style sub_inside fill:#fcc,color:#000,stroke:#fcc
style sub_bianca_shared_env fill:#ffc,color:#000,stroke:#ffc
style sub_bianca_private_env fill:#cfc,color:#000,stroke:#cfc
%% Inside SUNET
user-->|SSH, UPPMAX password and 2FA|bianca_shared_console
bianca_shared_console --> |UPPMAX password or SSH key|bianca_private_console
Extra material¶
Overview¶
flowchart TD
%% Give a white background, instead of a transparent one
classDef node fill:#fff,color:#000,stroke:#000
classDef focus_node fill:#fff,color:#000,stroke:#000,stroke-width:4px
subgraph sub_outside[IP outside SUNET]
outside(Physically outside SUNET)
end
subgraph sub_inside[IP inside SUNET]
physically_inside(Physically inside SUNET)
inside_using_vpn(Inside SUNET using VPN)
inside_using_rackham(Inside SUNET using Rackham)
subgraph sub_bianca_shared_env[Bianca shared network]
bianca_shared_console[Bianca console environment login]
bianca_shared_remote_desktop[Bianca remote desktop login]
subgraph sub_bianca_private_env[The project's private virtual project cluster]
bianca_private_console[Bianca console environment]
bianca_private_remote_desktop[Bianca remote desktop]
bianca_private_terminal[Terminal]
end
end
end
%% Shared subgraph color scheme
style sub_outside fill:#ccc,color:#000,stroke:#ccc
style sub_inside fill:#fcc,color:#000,stroke:#fcc
style sub_bianca_shared_env fill:#ffc,color:#000,stroke:#ffc
style sub_bianca_private_env fill:#cfc,color:#000,stroke:#cfc
%% Outside SUNET
outside-->|Move physically|physically_inside
outside-->|Use a VPN|inside_using_vpn
outside-->|Login to Rackham|inside_using_rackham
%% Inside SUNET
physically_inside-->|SSH|bianca_shared_console
physically_inside-->|UPPMAX website|bianca_shared_remote_desktop
physically_inside-.->inside_using_rackham
physically_inside-.->inside_using_vpn
inside_using_vpn-->|SSH|bianca_shared_console
inside_using_vpn-->|UPPMAX website|bianca_shared_remote_desktop
inside_using_rackham-->|SSH|bianca_shared_console
%% Shared Bianca
bianca_shared_console --> |UPPMAX password|bianca_private_console
bianca_shared_remote_desktop-->|UPPMAX password|bianca_private_remote_desktop
%% Private Bianca
bianca_private_console---|is a|bianca_private_terminal
bianca_private_remote_desktop-->|must also use|bianca_private_terminal
Using default coloring:
flowchart TD
subgraph sub_outside[IP outside SUNET]
outside(Physically outside SUNET)
end
subgraph sub_inside[IP inside SUNET]
physically_inside(Physically inside SUNET)
inside_using_vpn(Inside SUNET using VPN)
inside_using_rackham(Inside SUNET using Rackham)
subgraph sub_bianca_shared_env[Bianca shared network]
bianca_shared_console[Bianca console environment login]
bianca_shared_remote_desktop[Bianca remote desktop login]
subgraph sub_bianca_private_env[The project's private virtual project cluster]
bianca_private_console[Bianca console environment]
bianca_private_remote_desktop[Bianca remote desktop]
bianca_private_terminal[Terminal]
end
end
end
%% Outside SUNET
outside-->|Move physically|physically_inside
outside-->|Use a VPN|inside_using_vpn
outside-->|Login to Rackham|inside_using_rackham
%% Inside SUNET
physically_inside-->|SSH|bianca_shared_console
physically_inside-->|UPPMAX website|bianca_shared_remote_desktop
physically_inside-.->inside_using_rackham
physically_inside-.->inside_using_vpn
inside_using_vpn-->|SSH|bianca_shared_console
inside_using_vpn-->|UPPMAX website|bianca_shared_remote_desktop
inside_using_rackham-->|SSH|bianca_shared_console
%% Shared Bianca
bianca_shared_console --> |UPPMAX password|bianca_private_console
bianca_shared_remote_desktop-->|UPPMAX password|bianca_private_remote_desktop
%% Private Bianca
bianca_private_console---|is a|bianca_private_terminal
bianca_private_remote_desktop-->|must also use|bianca_private_terminal