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

# Lumerical (FDTD) from Lawrence on Windows PC Tutorial

{% 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". &#x20;
{% endhint %}

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

Open the "Configure FDTD License" app on your PC

<div align="center"><img src="https://57295520-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMxcW8l8a9ogs7-hqgF%2F-LUGvD0iEoMTCQ-UUcw0%2F-LUpZiX5gYiaLUZKMTIY%2FScreenshot%20(60).png?alt=media&#x26;token=0931d473-ed2e-4108-899f-d3e426c5add9" alt=""></div>

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-legacy-files/o/assets%2F-LMxcW8l8a9ogs7-hqgF%2F-LVP6cNjtPZD69RNaaqx%2F-LVPCAOltJDyEgFFM4Pr%2FScreenshot%20\(61\).png?alt=media\&token=95f4b582-78e8-465a-a51c-653800ffd32b)

## **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-legacy-files/o/assets%2F-LMxcW8l8a9ogs7-hqgF%2F-LZ5lZSH1IvfaV92Tpna%2F-LZ60ioRTGigLtYMelnJ%2FScreenshot%20\(2-5\).png?alt=media\&token=c34aaf10-c967-4dc2-9f53-f3115b3430b8)

### Install PuTTY

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

Click the link "here" to go to the download page.&#x20;

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMxcW8l8a9ogs7-hqgF%2F-LUpcIsRrW_CUaGJ0cif%2F-LUppVdhd6e_58h2cGI4%2FPuTTYtoDownloadLink.png?alt=media\&token=cc09e10e-a491-48ca-9292-806f72d169f1)

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-legacy-files/o/assets%2F-LMxcW8l8a9ogs7-hqgF%2F-LUpvRis1PpiSLHG9wL9%2F-LUpy96HTDriaSUUFo0m%2FScreenshot%20\(73\).png?alt=media\&token=ff8783b2-91af-48b9-b9ff-9c2c61ffb5b2)

Install PuTTY with the installer

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMxcW8l8a9ogs7-hqgF%2F-LUpcIsRrW_CUaGJ0cif%2F-LUpunWZZMWS7CakhgQE%2FScreenshot%20\(79\).png?alt=media\&token=4df41978-00a9-41f1-918a-c8f9b1f14742)

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-legacy-files/o/assets%2F-LMxcW8l8a9ogs7-hqgF%2F-LUpvRis1PpiSLHG9wL9%2F-LUq-fKvXjmJz_2XU5sn%2FScreenshot%20\(85\).png?alt=media\&token=a010fc1f-a89b-49c6-ad7e-728798d80720)

## 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-legacy-files/o/assets%2F-LMxcW8l8a9ogs7-hqgF%2F-LVED2PanKkRht7K8RtM%2F-LVEDkMdh69QkG52ihaa%2FScreenshot%20\(125\).png?alt=media\&token=c1cf0083-f102-495e-86ad-8835c12db165)

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

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMxcW8l8a9ogs7-hqgF%2F-LVED2PanKkRht7K8RtM%2F-LVEHSSFO7fi77vSGCUZ%2FScreenshot%20\(126\).png?alt=media\&token=07db56b5-b983-440a-a3c7-040c187d8e89)

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-legacy-files/o/assets%2F-LMxcW8l8a9ogs7-hqgF%2F-LVED2PanKkRht7K8RtM%2F-LVEJoh_TDC3AW-QJYve%2FScreenshot%20\(123\).png?alt=media\&token=8ebf9aca-458a-45a4-9021-5204fc58b3b0)

**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-legacy-files/o/assets%2F-LMxcW8l8a9ogs7-hqgF%2F-LVERWmZ2YbMireoNQva%2F-LVEST4H3Url3ecRniN4%2FScreenshot%20\(131\).png?alt=media\&token=50cf40c9-740d-4dbb-9131-e8c66fc28cab)

### Add Key to Authorized Keys

Open MobaX and start a local terminal.

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMxcW8l8a9ogs7-hqgF%2F-LRgr61Opxducd6grtTy%2F-LRgtQC6msXtJLMYEQqI%2FMobaX-startTerminal.png?alt=media\&token=14fa5df2-a89f-48a1-8924-8c043456eb7b)

The command line prompt will appear:

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMxcW8l8a9ogs7-hqgF%2F-LRgr61Opxducd6grtTy%2F-LRgueGAQhVjtyCvQ2ar%2FMobaX-startTerminalLogin.png?alt=media\&token=7502e49d-5d3f-4b16-8c9a-6cc6b4c5b4cf)

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 %}

&#x20;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-legacy-files/o/assets%2F-LMxcW8l8a9ogs7-hqgF%2F-LVP6cNjtPZD69RNaaqx%2F-LVPUb--dW54pI-CGHt3%2FScreenshot%20\(136\).png?alt=media\&token=9365a20b-6c2d-4457-92b4-a32913dabc32)

{% 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-legacy-files/o/assets%2F-LMxcW8l8a9ogs7-hqgF%2F-LUqBVAsXm0ucad9Uy-s%2F-LUqF6n59E_Y6Gaj1xoB%2FScreenshot%20\(91\).png?alt=media\&token=14dc1e25-62dd-4413-b7f8-6da7e5c9a20f)

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-legacy-files/o/assets%2F-LMxcW8l8a9ogs7-hqgF%2F-LVERWmZ2YbMireoNQva%2F-LVEZ54hjUD4T2A5fpJ7%2FScreenshot%20\(134\).png?alt=media\&token=54442766-3e0c-4bf5-9000-a81b41326f1a)

You may now open the Lumerical software on your desktop.
