Skip to content

Latest commit

 

History

History
103 lines (76 loc) · 4.55 KB

EnvironmentSetup.md

File metadata and controls

103 lines (76 loc) · 4.55 KB

Environment Setup

This guide is for new users who need to set up their environment.

Setup for Windows Users

Install WSL 2

  1. Open Powershell as Administrator

  2. Enter the following command: wsl --install

  3. Reboot your machine

  4. This should have also downloaded and installed a program called "Ubuntu", which you can find in your apps.

    • If this is not true, perform the following steps:
    • Go to Microsoft Store
    • Search for "Ubuntu"
    • Select "Get"
    • Done
    • Untested alternative to Windows Store:
      • Open Powershell as Administrator
      • Enter the following command: wsl --install -d Ubuntu

  5. When you first open WSL2, you will be greeted with something similar to the following: Ubuntu Install

    • Create a username - do not use spaces or special characters
    • Create a password - yes, it is taking your input. Press backspace a lot if you think you made a typo

Terminal Manager

In later labs, you will need two terminals open. It is absolutely alright to open multiple instances of WSL2 Ubuntu, but it can be convenient to have a "tab" based setup. I recommend Windows Terminal (can be found in the Windows Store) or MobaXTerm (installation instructions below)

Install MobaXTerm

Download MobaXterm Home Edition: Installer Edition

  • Extract the contents to your Desktop.
  • Double-click to run the installer
  • Once installed, run the program one time - this finishes the installation
  • You can now delete the installation files
  • Open Moba. You can now choose to run WSL Ubuntu
    • To change terminals, go to Settings -> Configuration. Select the Terminal tab. In the dropdown at the bottom, change from bash to WSL Ubuntu
  • Keep your SSH session "alive" - prevent timeouts from not interacting
    • Settings -> Configuration. In SSH tab, checkmark the box corresponding to SSH keepalive

If you do not have administrative privileges on your Windows system (or have a much older system), you will need to install MobaXTerm (step 3) and install Cygutils (instructions below) in order to perform the labs.

  • In Moba, select the Packages icon at the top.
  • Wait for the package menu to appear.
  • In the search bar, type "cygutils". Select the package from the result listings
  • Select Install / Update.
  • Restart Moba. Start Local Terminal should work
  • In the toolbar for Moba, go to Settings -> Configuration
  • In the General tab, check the following two fields are populated with the following values:
    • Persistent home directory: _MyDocuments_\MobaXterm\home
    • Persistent root directory: _MyDocuments_\MobaXterm\slash

Text Editors:

I recommend Visual Studio Code as a cross platform solution (plus dark mode looks cool). You can also use any default text editor on your system (Notepad, Notepad++, or whatever Mac's have).

Mac & Linux Users

  • You should have a terminal already installed. Hunt it down ;)

Chromebook Users

This guide here refers to a Chrome Extension for SSH connections

  • To use your AWS Educate Private Key, you'll need to select "Import..." and browse to your
    key file - you can then select your key from the dropdown.
  • You may need to make a "failed" connection in order to get the permission to access files
    questions to pop up.

WSL 2 Install Errors

  • Error message:
The requested operation could not be completed due to a virtual disk system limitation.
Virtual hard disk files must be uncompressed and unencrypted and must not be sparse.