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


---

# 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-lawrence-gui.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.