# 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/>

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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://usdrcg.gitbook.io/docs/lawrence-hpc/lumerical-fdtd-on-windows-pc.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
