Initial Setup

Trinity Linux Machines

We use Github Classroom for the projects and in-class workspace. So that you can work in class, follow these steps to get Github and Haskell working on the Trinity Linux machines.

1. If you do not have one, make a Github account with your Trinity email address.

• •  I suggest your account name be or contain your NetID (i.e. tdoe). 

2. If you have not used Git before, set up your user name and email. Replace Taylor Doe with your name, and tdoe with your NetID (Trinity user name).

   • git config --global user.name "Taylor Doe"

   • git config --global user.email tdoe@trinity.edu

3. Set up a Github SSH key.

• 1. Check if you have an existing SSH key by typing  ls -al ~/.ssh  and looking for id_rsa.pub

  2. If you don't have a key, generate one:

     • ssh-keygen -t rsa -b 4096 -C "tdoe@trinity.edu"

     • When you're prompted to "Enter a file in which to save the key," press Enter.

  3. Add the key to Github.

     • cat ~/.ssh/id_rsa.pub

     • Select and copy the output (your public key)

     • Go to https://github.com/settings/ssh/new

       • Use any title, I suggest "Trinity Linux"

       • Paste the key into the second bock

       • Click "Add SSH Key."

4. Run the following commands to automatically load haskell and link to my Haskell library folders.
   echo 'command -v ghci &> /dev/null || module load haskell' >> ~/.bashrc
   echo 'export PATH=$PATH:/users/sfogarty/.cabal/bin/'
   mkdir -p  ~/.ghc/x86_64-linux-9.2.8
   ln -s ~sfogarty/.ghc/x86_64-linux-9.2.8/package.conf.d ~/.ghc/x86_64-linux-9.2.8/package.conf.d

5. We will be using a workspace repository during class

• 1. Click the Github Classroom link

  2. If necessary, authorize Github Classroom

  3. Find your NetID in the roster and link it to your Github account.

     • If your NetID isn't there, you can skip this step.

  4. Join the team for the class

  5. Clone the repository to your Linux account

     • 1. Click on the green Clone or download button. 

       2. The box should read "Clone with SSH"

       3. If the box reads "Clone with HTTPS",  click "Use SSH."

          1. If that is not available, you did not set up your SSH key correctly.

       4. Click the copy button next to the link.

• • 1. git clone <link>

    2. You can change the repository name safely (for instance: to csci3368/workspace)

On Your Home Computer

To get use your home computer, you will need to connect to Github on your home machine. You can follow the analogue to steps 1-3 above for your operating system, use Github Desktop, or possibly Github with VSCode.

These instructions are for installing Haskell on your home computer. Please do not use these on the linux machines.

Windows

1. Open a Powershell session and run the following line
   
   Set-ExecutionPolicy Bypass -Scope Process -Force;[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; try { Invoke-Command -ScriptBlock ([ScriptBlock]::Create((Invoke-WebRequest https://www.haskell.org/ghcup/sh/bootstrap-haskell.ps1 -UseBasicParsing))) -ArgumentList $true } catch { Write-Error $_ }
   
   You can install anywhere you like. I recommend you install the haskell-language-server, do not install stack, and do install the MSys2 toolchain. If you already have mingw installed, you may not need to install the MSys2 toolchain.

2. Open a terminal and execute the following commands.
   cabal update
   cabal v1-install alex
   cabal v1-install happy
   This will probably take a while time. If you get an error, use where cabal  to see where cabal was installed

3. To run the projects in Powershell, you will need to install make. The easiest way to do this is using chocolatey. Run powershell as an administrator, and then run this commands: 

Set-ExecutionPolicy AllSigned

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

choco install make

After it’s done, go into your project directory and try to make the project.

Linux or Mac

Note: Linux distributions vary in ways that should not impact these instructions. Debian and Arch derivatives, such as Ubuntu and Manjaro respectively, are most common, and both should be near identical in their installation process.

1. Run the following command in a terminal.
   curl --proto '=https' --tlsv1.2 -sSf https://get-ghcup.haskell.org | sh
   The default options are all reasonable. If this does not work on your machine, try installing any missing packages the script lists as requirements. If that fails, please contact Dr. Fogarty.

2. Open a terminal and execute the following commands.
   cabal update
   cabal v1-install alex
   cabal v1-install happy

This will take a while. After it’s done, go into your project directory and try to make the project.