Difference between revisions of "HPRC:MobaXterm"
| Line 47: | Line 47: | ||
| − | ==== | + | ==== Running MobaXterm on Open Access Lab workstations ==== |
| − | ''' | + | '''Verify MobaXterm is installed''' |
| + | |||
| + | After logging in to Open Access Labs (OAL) workstation, click on the magnifying glass to search for an installed program. As you start typing "MobaXterm", matching programs will be displayed on the left-hand side of the screen, above the search field. | ||
| + | |||
| + | [[Image:OAL_Find_MobaXterm.png | 600px | center | find MobaXterm on Open Access Lab workstation]] | ||
| + | |||
| + | Once you have started MobaXterm, click "Start local terminal" (as pictured above in '''Local Terminal''' section). You may encounter an error such as the following: | ||
| + | |||
| + | [[Image:Moba_roothome_error.png | 600px | center | MobaXterm permission error message]] | ||
| + | |||
| + | To solve this problem, you will need to change the location of the virtual "root" and "home" directories. At the top of the MobaXterm window in the row of buttons, click "Settings" (the second to last on the right-hand side): | ||
| + | |||
| + | [[Image:Moba_settings.png | 600px | center | MobaXterm settings button]] | ||
| + | |||
| + | A settings dialog will open. By default, the virtual root and home directories will be set to "'''''_MyDocuments_\MobaXterm\'''''" which lacks proper write permissions for the OAL workstations: | ||
| + | |||
| + | [[Image:Moba_default_root_home.png | 600px | center | MobaXterm default root and home]] | ||
| + | |||
| + | Change both of these by clicking on the current values (with the little yellow folder on the right-hand side). Scroll up to find the "'''''Temp'''''" folder, which is under the "'''''C:'''''" drive: | ||
| + | |||
| + | [[Image:Moba_choose_temp.png | 600px | center | MobaXterm choose C:\Temp]] | ||
| + | |||
| + | Once both have been changed, they should look like this: | ||
| + | |||
| + | [[Image:Moba_temp_selected.png | 600px | center | MobaXterm root and home set to C:\Temp]] | ||
| − | + | Once you click "OK", MobaXterm will need to restart to commit these changes: | |
| − | + | [[Image:Moba_restart.png | 600px | center | MobaXterm restart]] | |
| − | |||
| + | ==== Installing on Temp Drive of Open Access Lab workstation ==== | ||
| − | + | '''Special Instructions''' | |
| − | + | Note: This only applies to an unusual circumstance. In most cases, MobaXterm will already be installed on the OAL workstations. You will not need to do this on your personal computer or any computer for which you have privileges to install the software. | |
| − | [ | + | If MobaXterm is not installed on an [http://oal.tamu.edu/ Open Access Lab] workstation, download the portable version and copy the programs to a folder in the '''C:\Temp''' folder, i.e., '''C:\Temp\Moba''' (you will need to create this folder first). From that folder, run the program '''MobaXterm_Portable_''version''.exe''' to start MobaXterm. Select "Settings" in the top menu and choose "global settings". In the "General" tab of the settings window, specify '''C:\Temp''' as the Persistent home directory and Persistent root ('''/''') directory: |
| − | + | [[Image:Moba_choose_temp.png | 600px | center | MobaXterm choose C:\Temp]] | |
| − | + | Once you have completed this, you should be able to run the portable version from your home drive without error. | |
[[Category:Ada]] | [[Category:Ada]] | ||
Revision as of 14:53, 19 January 2018
Contents
Remote Access Using MobaXterm for Windows
MobaXterm Software
MobaXterm is an enhanced terminal for Windows with a built-in X11 server, tabbed SSH client, built-in file editor, SFTP functionality, and other useful features. You may download MobaXterm from: http://mobaxterm.mobatek.net/download.html
You will need to choose which license (free Home edition, or professional) and then select the Portable or Installer edition. The Installer edition works best on your personal machine, when you have the privileges to install software. The portable version may be necessary when using a lab workstation, for example. (Be sure to check if MobaXterm is already installed in the Windows Start menu.)
Configuration
You may create saved sessions for connecting to ada.tamu.edu or other HPRC clusters, for your convenience. See http://mobaxterm.mobatek.net/documentation.html#1_2 for instructions. For example:
IMPORTANT: When asked if you would like to save your password, choose "No" to avoid potential security exploits.
Local Terminal
The easiest way to connect is to start a local terminal:
From the local terminal, you may then issue the ssh command:
File Transfers
On the left-hand side of the MobaXterm window, different tabs are available. The labels are written vertically. Choosing the "Sftp" tab will display a file tree of the remote machine to which you are connected, such as:
You may choose files to edit with the built-in editor. You may also transfer files from your Windows machine to the remote cluster, and vice versa. Just drag a local file (from a Windows File Explorer window or similar program) to the SFTP file tree on the left side of the MobaXterm window.
Remote Display of Programs with Graphical Interfaces
By default, MobaXterm connections have X11 forwarding available. So, when you connect to ada.tamu.edu or other machine, you should be able to run an X-Windows program by simply typing the command. That will open the program in a new window behind the MobaXterm main window.
Running MobaXterm on Open Access Lab workstations
Verify MobaXterm is installed
After logging in to Open Access Labs (OAL) workstation, click on the magnifying glass to search for an installed program. As you start typing "MobaXterm", matching programs will be displayed on the left-hand side of the screen, above the search field.
Once you have started MobaXterm, click "Start local terminal" (as pictured above in Local Terminal section). You may encounter an error such as the following:
To solve this problem, you will need to change the location of the virtual "root" and "home" directories. At the top of the MobaXterm window in the row of buttons, click "Settings" (the second to last on the right-hand side):
A settings dialog will open. By default, the virtual root and home directories will be set to "_MyDocuments_\MobaXterm\" which lacks proper write permissions for the OAL workstations:
Change both of these by clicking on the current values (with the little yellow folder on the right-hand side). Scroll up to find the "Temp" folder, which is under the "C:" drive:
Once both have been changed, they should look like this:
Once you click "OK", MobaXterm will need to restart to commit these changes:
Installing on Temp Drive of Open Access Lab workstation
Special Instructions
Note: This only applies to an unusual circumstance. In most cases, MobaXterm will already be installed on the OAL workstations. You will not need to do this on your personal computer or any computer for which you have privileges to install the software.
If MobaXterm is not installed on an Open Access Lab workstation, download the portable version and copy the programs to a folder in the C:\Temp folder, i.e., C:\Temp\Moba (you will need to create this folder first). From that folder, run the program MobaXterm_Portable_version.exe to start MobaXterm. Select "Settings" in the top menu and choose "global settings". In the "General" tab of the settings window, specify C:\Temp as the Persistent home directory and Persistent root (/) directory:
Once you have completed this, you should be able to run the portable version from your home drive without error.
