> 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-lawrence-gui.md).

# Lumerical (FDTD) on Lawrence GUI Tutorial

{% hint style="warning" %}
To use Lumerical on a Lawrence GUI, you must first have access to use the license.  Please ensure you have access before continuing.
{% endhint %}

This is a step-by-step guide for running Lumerical on a graphical user interface (GUI) on Lawrence. 

{% hint style="info" %}
If you have **done this before** on the computer you are **currently using,** you may **skip to** the section "Opening Lumerical on a Lawrence GUI".
{% endhint %}

## **Installations**

### Install MobaXterm (MobaX)

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.

![](/files/-LZ60ioRTGigLtYMelnJ)

Click on the installed file, and follow the download wizard.

## Opening Lumerical on a Lawrence GUI

Open MobaXterm (MobaX) (or the terminal on a Mac) and log into Lawrence.

```
[User.NI1111] ➤ ssh User.Name@Lawrence.usd.edu
password: 
Last login: Tue Feb 26 10:36:10 2019 from 192.236.35.187 Welcome to the Lawrence Supercomputer at the University of South Dakota!
.....
[user.name@usd.local@login ~]$
```

{% hint style="info" %}
Note: When logging in with a terminal other than MobaX, add a flag to the login (see the tab "[Login](https://usdrcg.gitbook.io/docs/lawrence-hpc/login)" for details):

Windows/Linux:

```
ssh -X User.Name@Lawrence.usd.edu
```

Mac:

```
ssh -Y User.Name@Lawrence.usd.edu
```

{% endhint %}

![](/files/-L_mJLwwXZkrNwB1y1VQ)

Load the Lumerical-FDTD module.

```
[user.name@usd.local@node44 ~]$ module load lumerical
[user.name@usd.local@node44 ~]$ module list
Currently Loaded Modulefiles:
  1) lumerical
```

Start Lumerical

```
[user.name@usd.local@node44 ~]$ fdtd-solutions
```

{% hint style="info" %}
If you receive an error message "-15" or "-4", please continue
{% endhint %}

### Error -15

![](/files/-LaRIdtVDfBkL6zqtI2d)

Click "yes" to open your license settings.

![](/files/-L_m7OhbATGaOV1Ur9qN)

Ensure that the server listed is "login".  Change this if needed, and click "ok".

![](/files/-L_m7TrVDxjqX0_hv3CF)

If it doesn't automatically pop up, try starting fdtd-solutions again. 

```
[user.name@usd.local@node44 ~]$ fdtd-solutions
```

&#x20;If a license error still comes up, it is possible that you don't have a license.  If that is not the case, please contact the Service desk (<servicedesk@usd.edu>) for assistance.  Be sure to include the name of the software, the fact that you are on Lawrence, and a description of the error in your email.

### Error -4

If the error looks like this:

![](/files/-LaRJpntGrayGWvs4S2s)

The license is already in use, and the maximum number of users has been reached.  Please try again later.