|
| 1 | +## Accessing the System { #access } |
| 2 | + |
| 3 | +Access to all TACC systems requires Multi-Factor Authentication (MFA). You can create an MFA pairing under "Manage Account" in the TACC Portal. See [Multi-Factor Authentication at TACC][TACCMFA] for further information. |
| 4 | + |
| 5 | +!!! important |
| 6 | + You will be able to log on to Vista **only if** you have an allocation on Vista, otherwise your password will be rejected. |
| 7 | + Monitor your projects & allocations the via the [TACC Portal](https://tacc.utexas.edu/portal/projects). |
| 8 | + |
| 9 | +### Secure Shell (SSH) { #access-ssh } |
| 10 | + |
| 11 | +The `ssh` command (Secure Shell, or SSH protocol) is the standard way to connect to Vista and initiate a login session. SSH also includes support for the UNIX file transfer utilities `scp` and `sftp`. These commands are available within Linux and the Terminal application within Mac OS. If you are using Windows, you will need a modern terminal application such as [Windows Terminal](https://apps.microsoft.com/detail/9N0DX20HK701?hl=en-US&gl=US), [MobaXterm](https://mobaxterm.mobatek.net/) or [Cyberduck](https://cyberduck.io/download/). |
| 12 | + |
| 13 | +Initiate an SSH session using the `ssh` command or the equivalent: |
| 14 | + |
| 15 | + localhost$ ssh taccusername@vista.tacc.utexas.edu |
| 16 | + |
| 17 | +The above command will rotate connections across all available login nodes and route your connection to the next available node. |
| 18 | + |
| 19 | +!!! important |
| 20 | + Vista's login nodes are a *shared resource*. See TACC's [Good Conduct Policy][TACCGOODCONDUCT] for more information. |
| 21 | + |
| 22 | + |
| 23 | +To connect to a specific login node, use its full domain name: |
| 24 | + |
| 25 | + localhost$ ssh taccusername@login2.vista.tacc.utexas.edu |
| 26 | + |
| 27 | +To connect with X11 support on Vista (usually required for applications with graphical user interfaces), use the `-X` or `-Y` option: |
| 28 | + |
| 29 | + localhost$ ssh -X taccusername@vista.tacc.utexas.edu |
| 30 | + |
| 31 | +Use your TACC portal password for direct logins to TACC resources. You can change or reset your TACC password via the [TACC Portal][TACCUSERPORTAL] under "Manage Account". To report a connection problem, execute the `ssh` command with the `-vvv` option and include this command's verbose output when submitting a help ticket. |
| 32 | + |
| 33 | +Do not run the `ssh-keygen` command on Vista. This command will create and configure a key pair that will interfere with the execution of job scripts in the batch system. If you do this by mistake, you can recover by renaming or deleting the `.ssh` directory located in your home directory; the system will automatically generate a new pair for you when you next log into Vista. |
| 34 | + |
| 35 | +1. execute `mv .ssh dot.ssh.old` |
| 36 | +1. log out |
| 37 | +1. log into Vista again |
| 38 | + |
| 39 | +After logging in again, the system will generate a properly configured key SSH pair. |
| 40 | + |
0 commit comments