Editing Installing Maple

== Connecting to DFS ==
In order to install Maple you must download the installer from the Rose-Hulman DFS (which stands for Distributed File System), which is like connecting to a virtual hard drive over the network. Rose-Hulman uses this virtual drive to store software.

1. To access the Rose-Hulman DFS, you will need to be on campus. If you are off campus, you will need to use the '''GlobalProtect VPN'''. '''Please see [[Accessing the Off-Campus VPN]] for more details.'''

2. '''For instructions on how to connect to DFS, please follow the tutorial in [[Accessing DFS]].'''

== Once You See Software in the dfs Folder ==

To get to the folder to install Maple, type the following command into SMBClient and press enter.

<code> cd Software/Linux_MacOSX_Apps/Maple </code>

Use ls to see the versions in the directory

<code> ls </code>

Now, as you can see, you will have two options of which version to install -- Maple 2018 or Maple 2019. (Maple 2017 is no longer on DFS as of July 12, 2020.)

== Selecting a Version ==

It's best to select just one version to install at a time. Multiple installations may cause confusion if you run into errors (and probably won't work).

So, this tutorial will guide you through selecting one version to install.

If you want to install Maple 2018, type

<code> cd "Maple 2018" </code>

Otherwise, if you want to install Maple 2019, type

<code> cd "Maple 2019" </code>.

This will bring you to the directory that has the Maple install.

=== Troubleshooting ===
After you type <code>cd</code>, if you receive this error message:

<code>cd \Software\Linux_MacOSX_Apps\Maple\Maple\: NT_STATUS_OBJECT_NAME_NOT_FOUND</code>

then that means you typed in the folder name wrong.

Note that using <code>\ </code> to escape space characters will not work with SMBClient. So, for example, <code> cd Maple\ 2019 </code> will not work.

Instead, you will need to use quotes in the full name, like this: <code>"Maple 2019"</code>. So, for example, <code> cd "Maple 2019" </code> will work.

== I changed my mind and I want a different version (Optional, only follow this if you actually changed your mind) ==

Simple. Just type <code> cd .. </code> to go up a folder (essentially undoing <code> cd "Maple 2018" </code> or <code> cd "Maple 2019" </code>), so you can now type either <code> cd "Maple 2018" </code> or <code> cd "Maple 2019" </code>.

== Getting the Installer ==

Use ls to see the files in the directory:

<code> ls </code>

Use the get command to download the Maple installer onto your computer into the /tmp directory. The command will change depending on which version you selected.

See the sections below for what command you will need to type depending on which version you selected.

'''WARNING: THIS WILL TAKE around 20-25 minutes (sometimes more!) depending on the speed of your Internet connection or how congested the SMB server is. Don't disconnect while this happens.'''

=== Maple 2018 version ===

<code> get Maple2018.0LinuxX64Installer.run /tmp/Maple2018.0LinuxX64Installer.run </code>

=== Maple 2019 version ===

<code> get Maple2019.0LinuxX64Installer.run /tmp/Maple2019.0LinuxX64Installer.run </code>

== What happens when downloading? ==

Nothing will show up on SMBClient while the installer is downloading. (Just a blank new line.) This is expected.

Once the download has completed, <code>smb: \Software\Linux_MacOSX_Apps\Maple\Maple 201V\> </code> (where V is either 8 or 9, depending on which version you selected) should show up again.

'''However, if you see something like'''

 <nowiki>smb: \Software\Linux_MacOSX_Apps\Maple\Maple 2019\> getting file \Software\Linux_MacOSX_Apps\Maple\Maple 2019\Maple2019.0LinuxX64Installer.run of size 1875465688 as /tmp/Maple2019.0LinuxX64Installer.run SMBecho failed (NT_STATUS_CONNECTION_RESET). The connection is disconnected now</nowiki>

'''then you have an unreliable connection. Please follow the troubleshooting steps at [[Accessing DFS#NT_STATUS_CONNECTION_RESET_when_downloading_files]].'''

== Installing Maple ==

You can now exit from SMB by typing <code>exit</code> and pressing ENTER.

Now you will find the Maple installer in the /tmp directory.

By default the installer file will have read and write privileges but not execute privileges. You can verify this by running <code>ls -l</code> on the file itself:

Maple 2018: <code> ls -l /tmp/Maple2018.0LinuxX64Installer.run </code>

Maple 2019: <code> ls -l /tmp/Maple2019.0LinuxX64Installer.run </code>

which will show

<code> -rw-rw-r--. 1 USERNAME USERNAME FILE_SIZE DATE /tmp/Maple201V.0LinuxX64Installer.run </code> (where V is either 8 or 9, depending on which version you selected).

the <code>-rw-rw-r--.</code> indicates that there are read and write privileges for the user and the group and read privilages for all other users.

We will use the "chmod" command to change this file permission to be executable. We use "+x" to indicate to add executable permissions. 

Maple 2018: <code> chmod +x /tmp/Maple2018.0LinuxX64Installer.run </code>

Maple 2019: <code> chmod +x /tmp/Maple2019.0LinuxX64Installer.run </code>

Now to run the installer you can type in the command line

Maple 2018: <code> /tmp/Maple2018.0LinuxX64Installer.run </code>

Maple 2019: <code> /tmp/Maple2019.0LinuxX64Installer.run </code>

From here a graphical UI will appear and you can follow those instructions to install Maple.

You have to use the network install rather than the stand alone. The license server is <code>maplelm-hv.rose-hulman.edu</code> (tested in 7/2020) and use the default port (usually 27000). (Source: https://www.maplesoft.com/documentation_center/maple2017/Maple2017.pdf, https://www.reddit.com/r/rosehulman/comments/4hm1vb/maple_on_linux/).

This means that you have to be on the campus network to access the Maple license server on Linux (to use Rose-Hulman's license of Maple). You can do this by connecting to the eduroam network on campus or by using the '''GlobalProtect VPN''' when off campus (please see [[Accessing the Off-Campus VPN]] for how to do that).

(This is not the case for Windows on your Rose-Hulman laptop, you are given a license key pre-installed on your Windows install from EIT.)

Sources:

https://www.tldp.org/HOWTO/SMB-HOWTO-8.html

https://help.lafayette.edu/accessing-file-shares-from-linux/ (method 1)