> For the complete documentation index, see [llms.txt](https://usdrcg.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://usdrcg.gitbook.io/docs/lawrence-hpc/lumerical-fdtd-on-windows-pc.md).

# Lumerical (FDTD) from Lawrence on Windows PC Tutorial

This is a step-by-step guide for running Lumerical on Windows using the license available for Lawrence.

{% hint style="info" %}
If you have **done this before** on the computer \*\*\*\* you are **currently using,** and **haven't (re)activated** a Lumerical licence on it since, you may **skip to** the section "Open a PuTTY Session to Tunnel Lumerical from Lawrence".
{% endhint %}

## Disable any local node-locked license on your PC

Open the "Configure FDTD License" app on your PC

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMxcW8l8a9ogs7-hqgF%2Fuploads%2Fgit-blob-8b427192418188dc5c311829a59102c869c56aca%2FScreenshot%20\(60\).png?alt=media)

Click on the "Node Locked" tab, then the "Licenses" subtab. Highlight your license, and select "Deactivate". Note that your license will likely have a **limit** on the number of times you may deactivate and reactivate it. Click "Yes", then "Ok".

{% hint style="warning" %}
Note: if this **causes you concern**, you may also use Lumerical on Lawrence directly, **without deactivating** the license on your computer. See the next page: "Lumerical (FDTD) on Lawrence GUI".
{% endhint %}

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMxcW8l8a9ogs7-hqgF%2Fuploads%2Fgit-blob-612b6e8934f57fa92d7f589ab914672841d3d9b0%2Fscreenshot-61%20\(3\)%20\(3\)%20\(3\)%20\(3\).png?alt=media)

## **Installations**

### **Install MobaXterm**

Go to the MobaXterm website [here](https://mobaxterm.mobatek.net/download-home-edition.html). Click on the "MobaXterm Home Edition v11.1 (Home Installer Edition)" button.

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMxcW8l8a9ogs7-hqgF%2Fuploads%2Fgit-blob-ecf7f70c45e7aef3efa9ad15e7a81a9aec0e7252%2Fscreenshot-2-5%20\(3\)%20\(1\).png?alt=media)

### Install PuTTY

Go to [https://www.putty.org/](https://www.putty.org)

Click the link "here" to go to the download page.

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMxcW8l8a9ogs7-hqgF%2Fuploads%2Fgit-blob-47555d650849c8427304f214a730ce4f1a2938cc%2FPuTTYtoDownloadLink.png?alt=media)

Select the 32-bit installer link to download the PuTTY installer. When the download is complete, click on the button in the bottom left corner of the browser to open the installer.

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMxcW8l8a9ogs7-hqgF%2Fuploads%2Fgit-blob-2d87f7c1c721216ded9932dbdc90c7c086fc7b9c%2Fscreenshot-73%20\(3\)%20\(2\)%20\(2\)%20\(2\).png?alt=media)

Install PuTTY with the installer

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMxcW8l8a9ogs7-hqgF%2Fuploads%2Fgit-blob-df22cdfcaf8f8d165b9533b25c7c39e125dd0ce9%2FScreenshot%20\(79\).png?alt=media)

A README file will pop up. You may ignore it for now while following this tutorial, but you may find the information useful when using PuTTY on your own.

Open a PuTTY window

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMxcW8l8a9ogs7-hqgF%2Fuploads%2Fgit-blob-079c4e3c7f97466f5ef5d7a054e6b2c32bd8268c%2FScreenshot%20\(85\).png?alt=media)

## First Time Set-up

### Make Private & Public Keys

Open PuTTYgen (not PuTTY from the last section).

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMxcW8l8a9ogs7-hqgF%2Fuploads%2Fgit-blob-7fe593afdc75fdc5792aa433284b6ace2d58a273%2FScreenshot%20\(125\).png?alt=media)

Select "Generate", then wave your mouse around in a haphazard fashion.

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMxcW8l8a9ogs7-hqgF%2Fuploads%2Fgit-blob-23d6097808ee09f4c3e02fb9f900ba1ed67e4fbb%2Fscreenshot-126%20\(4\)%20\(4\)%20\(4\)%20\(4\).png?alt=media)

Save the private key. (If asked whether you are sure about saving without passphrase protection, click "yes". **Remember** where you save it. **Save** the key as **id\_rsa.ppk**.

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMxcW8l8a9ogs7-hqgF%2Fuploads%2Fgit-blob-7008a661dcb10df8931d14bef656681297b9f0ea%2FScreenshot%20\(123\).png?alt=media)

**Copy** the public key (make sure you get **all of it**-there will likely be **more lines than fit in the text area** at once).

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMxcW8l8a9ogs7-hqgF%2Fuploads%2Fgit-blob-e186ffcb9c2d05bd4b52c9e0d090d8c03d7b303b%2FScreenshot%20\(131\).png?alt=media)

### Add Key to Authorized Keys

Open MobaX and start a local terminal.

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMxcW8l8a9ogs7-hqgF%2Fuploads%2Fgit-blob-e3bc2a90d06d9c922c0ca9f346c22948d806f77e%2Fmobax-startterminal.png?alt=media)

The command line prompt will appear:

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMxcW8l8a9ogs7-hqgF%2Fuploads%2Fgit-blob-a2d15d245940f765cd28a8162768b46fff7eda7b%2FMobaX-startTerminalLogin.png?alt=media)

You can then \*\*\*\* ssh onto the Lawrence cluster. You will be prompted for a password, which is based on your USD credentials. As a security feature, three incorrect logins will result in your account being locked until the lockout expires or an administrator overrides it.

```
[2018-11-19 10:55.23]  ~
[User.Name.NI11018] ➤ ssh User.Name@Lawrence.usd.edu
User.Name@lawrence.usd.edu's password:
Last login: Mon Dec 25 19:37:34 2017 from ni11018.usd.local
[user.name@usd.local@login ~]$
```

{% hint style="info" %}
Note: the password will not show when typing.
{% endhint %}

Then open your authorized\_keys file

```
[user.name@usd.local@login ~]$ cd
[user.name@usd.local@login ~]$ cd .ssh/
[user.name@usd.local@login .ssh]$ nano authorized_keys
```

A text editor (nano) will open, showing your keys. Press your **down-arrow key** once to go to the next line. **Paste** (right click, select paste) your **public key** into the file. (Ctrl-v won't work in MobaX for pasting.)

Click **Ctrl-o**, then **Enter** to save, and then **Ctrl-x** to exit.

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMxcW8l8a9ogs7-hqgF%2Fuploads%2Fgit-blob-6a580de257b99364bcb7296cb7415a64da02c288%2FScreenshot%20\(136\).png?alt=media)

{% hint style="info" %}
If the pasted line looks **shorter than the other line(s)**, but you are **certain you copied all of the public key**, don't worry- use the left arrow key to move past the left end of the pasted line, and the line will scroll, showing the rest of it.
{% endhint %}

## Tunnel Lumerical from Lawrence

Open a Windows Command Line

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMxcW8l8a9ogs7-hqgF%2Fuploads%2Fgit-blob-c4ef6ed08c386e20de2b345967e93d3c98aefc3c%2Fscreenshot-91%20\(1\).png?alt=media)

Connect to the Lawrence license, replacing "user.name" with your username on Lawrence, and path\to\your\file with the path to the id\_rsa.ppk file:

```
C:\Users\User.name>putty -ssh user.name@lawrence.usd.edu -L 27011:10.1.1.250:27011 -L 42128:10.1.1.250:42128 -i "C:\Users\user.name\path\to\your\file\id_rsa.ppk"
```

A new window will appear. It may ask for a password to log into Lawrence.

{% hint style="info" %}
Note: your password will not appear as you type -- nothing will -- just keep typing as if it did.
{% endhint %}

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMxcW8l8a9ogs7-hqgF%2Fuploads%2Fgit-blob-5c9d0cb0f583f22aa15356442b53204c243170bf%2Fscreenshot-134%20\(2\)%20\(2\)%20\(2\)%20\(2\).png?alt=media)

You may now open the Lumerical software on your desktop.