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

![](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)

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

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMxcW8l8a9ogs7-hqgF%2F-L_io0ALUJZtIMK75cKw%2F-L_mJLwwXZkrNwB1y1VQ%2FScreenshot%20\(187\).png?alt=media\&token=24f3084f-de20-45a9-877f-d106d86a3765)

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

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMxcW8l8a9ogs7-hqgF%2F-LaLmt90Y-D8JXbVNR4S%2F-LaRIdtVDfBkL6zqtI2d%2FFDTD%20error.png?alt=media\&token=c94050b8-e98d-47cc-bb99-3d847f20df4f)

Click "yes" to open your license settings.

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMxcW8l8a9ogs7-hqgF%2F-L_io0ALUJZtIMK75cKw%2F-L_m7OhbATGaOV1Ur9qN%2FFDTD%20error.B.png?alt=media\&token=2821f35c-0d42-4fb0-ac38-1c076d70d3d8)

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

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMxcW8l8a9ogs7-hqgF%2F-L_io0ALUJZtIMK75cKw%2F-L_m7TrVDxjqX0_hv3CF%2FFDTDerror2.png?alt=media\&token=2df1f784-f350-413b-89f9-7013751d1783)

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:

![](https://57295520-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMxcW8l8a9ogs7-hqgF%2F-LaLmt90Y-D8JXbVNR4S%2F-LaRJpntGrayGWvs4S2s%2FScreenshot%20\(208\).png?alt=media\&token=7ba1e23e-23d7-4fac-9847-4ab50ad995fc)

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