:orphan:

Installing a Terminal Window for Windows Users
==============================================

|

The following notes are specific modifications that were tested and worked for the WRF User Support group. There is no guarantee they will work for every Windows system, but following these steps may help with problems Windows users may encounter.

|

|

Installing a Terminal Window
----------------------------

MobaXterm is a linux terminal emulator that offers a standard linux command environment and can support the display of images on local Windows machines. It may also provide a linux terminal environment that is easier to use and with a more standard version of linux than those from the Windows applications PowerShell or Command Prompt. 

#. `Download MobaXterm`_: https://mobaxterm.mobatek.net/
#. Choose: Home Edition (free version)
#. Install MobaXterm: Unzip MobaXterm downloaded file (Example filename: *MobaXterm_Portable_<version>.zip*)

|

|

Using MobaXterm
---------------

#. Double click on file *MobaXterm_Personal_<version>.exe*.
#. Click *Run* if Windows queries *Do you want to run this file?*
#. Click *Start local terminal* on the MobaXterm window that appears.

|

|

Notes
-----

*   With MobaXterm's version of linux, the linux "forward slash" (/) convention and character in pathnames is used to specify directories instead of the Windows backslash (\) convention/character. Thus, when changing to a different Windows directory via a MobaXterm command line, specify the target directory as C:/home/user instead of C:\home\user. For e.g., 

    |

    .. code-block::

        cd C:/home/user

    |

*   If using AWS cloud computing - Key pair setup: If using Windows PowerShell for the linux environment, to change permissions on your *keypair.pem* file, use the command ``Icacls`` to grant the user full permissions on *.pem* file as follows:

    |
    
    .. code-block::

        Icacls filename.pem /Grant user:F

    |

.. note::
   Using: */G* instead of */Grant* may result in a message of *Invalid parameter "/G"*.


.. _`Download MobaXterm`: https://mobaxterm.mobatek.net/