From 49da66d1fe6da75b651252f97c9c8fec4e5a7e31 Mon Sep 17 00:00:00 2001 From: Brook Riggio Date: Thu, 27 Oct 2022 12:02:55 -0700 Subject: [PATCH 01/13] Rewords step 1 instructions. --- ops-setup/1-network.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/ops-setup/1-network.md b/ops-setup/1-network.md index 84a0892..b86118e 100644 --- a/ops-setup/1-network.md +++ b/ops-setup/1-network.md @@ -1,11 +1,12 @@ # Ops Setup -## Network Connectivity +Your first step is ensure that your lab PC is connected to the internet, so you can update the operating system. -First, check that your lab PC is connected to your home network via ethernet or Wi-Fi. Then, use the Ubuntu desktop GUI to update the Ubuntu OS to the latest version. +## OS Updates -- On the back of the lab kit PC, on its I/O shield, you'll find the ethernet port. If you need an ethernet cable, check the packaging for your SOHO router and use the included cable. Plug the cable into the back of the PC and run it to your home router/modem. -- Alternatively, try the included wi-fi adapter (antenna with USB). +Verify that your lab PC is connected to the internet via ethernet or Wi-Fi. Opening a web browser on your PC should let you access usual web pages. + +Then, use the Ubuntu desktop GUI to update the OS to the latest version. This may take some time, depending on what updates are available. --- From 0f33e68152b8dba8d48f6485245861d18b5ba694 Mon Sep 17 00:00:00 2001 From: Brook Riggio Date: Thu, 27 Oct 2022 12:08:22 -0700 Subject: [PATCH 02/13] Update 2-update.md --- ops-setup/2-update.md | 19 +++++++++++-------- 1 file changed, 11 insertions(+), 8 deletions(-) diff --git a/ops-setup/2-update.md b/ops-setup/2-update.md index b89ee2c..890b077 100644 --- a/ops-setup/2-update.md +++ b/ops-setup/2-update.md @@ -1,15 +1,18 @@ # Ops Setup -## Update Linux +Now, let's get your system configured for remote access. -- Log in to Ubuntu Linux Desktop and open a Terminal session. -- Search for "Terminal" in the menu system and be sure to favorite this app. -- Run `sudo apt update` to update your Apt package manager. - - **NOTE: Always run this command before installing a new software package from Apt.** -- Run `sudo apt install xrdp -y`, which installs a software package that will allow you to connect to this lab kit PC remotely in subsequent classes. +## Update Packages + +1. Log in to Ubuntu Linux Desktop and open a Terminal session. + - To do this, search for "Terminal" in the menu system. + - Be sure to favorite this app for easy access in the future. +1. Run `sudo apt update` in the terminal to update your Apt package manager. + - **Always run this command before installing a new software package from Apt.** +1. Run `sudo apt install xrdp -y`, which installs a software package that will allow you to connect to this lab kit PC remotely in subsequent classes. - The `-y` option bypasses an "Are you sure?" prompt. -- Allow the RDP server to initialize on startup with `sudo systemctl enable --now xrdp`. - - You'll need this in a later class. +1. Allow the RDP server to initialize on startup. Run `sudo systemctl enable --now xrdp` in the terminal. + - This ensures when you reboot, you'll still be able to connect remotely. --- From ebea2b33d8ad1bbe87086aa3b54c4f6c78cd620f Mon Sep 17 00:00:00 2001 From: Brook Riggio Date: Thu, 27 Oct 2022 12:10:39 -0700 Subject: [PATCH 03/13] Update 4-git.md --- ops-setup/4-git.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/ops-setup/4-git.md b/ops-setup/4-git.md index 1cbf780..9f579ca 100644 --- a/ops-setup/4-git.md +++ b/ops-setup/4-git.md @@ -1,15 +1,17 @@ # Ops Setup +You'll use the `git` command for managing the Ops scripts you write. Let's set it up now. + ## Git Installation -- Run `sudo apt install git -y` to install Git. -- Run `mkdir ~/github` to create a folder to store repositories. -- Type `cd ~/github` to move there. - - This is how you can change terminal location in Linux shell. +1. Run `sudo apt install git -y` in the terminal to install Git. +1. Run `mkdir ~/github` to create a folder to store repositories. +1. Run `cd ~/github` to move there. + - This is how you can change the "current folder" you are working in, from within the Linux shell. ## Download file to be used later -- Run `wget https://raw.githubusercontent.com/codefellows/setup-guide/main/configs/ops/gnome-terminal-profiles.dconf` +1. In the terminal, run: `wget https://raw.githubusercontent.com/codefellows/setup-guide/main/configs/ops/gnome-terminal-profiles.dconf` --- From 296052cb3f5743ee992b5ea67bd27854219e6e31 Mon Sep 17 00:00:00 2001 From: Brook Riggio Date: Thu, 27 Oct 2022 12:10:58 -0700 Subject: [PATCH 04/13] Update 4-git.md --- ops-setup/4-git.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ops-setup/4-git.md b/ops-setup/4-git.md index 9f579ca..8620c05 100644 --- a/ops-setup/4-git.md +++ b/ops-setup/4-git.md @@ -7,7 +7,7 @@ You'll use the `git` command for managing the Ops scripts you write. Let's set i 1. Run `sudo apt install git -y` in the terminal to install Git. 1. Run `mkdir ~/github` to create a folder to store repositories. 1. Run `cd ~/github` to move there. - - This is how you can change the "current folder" you are working in, from within the Linux shell. + - This is how you can change the "current folder" you are working in, from within the Linux shell. ## Download file to be used later From 53c1eafb1be6feec3fca866efee55f92e18a2cd5 Mon Sep 17 00:00:00 2001 From: Brook Riggio Date: Thu, 27 Oct 2022 12:11:38 -0700 Subject: [PATCH 05/13] Update 4-git.md --- ops-setup/4-git.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/ops-setup/4-git.md b/ops-setup/4-git.md index 8620c05..60cb4de 100644 --- a/ops-setup/4-git.md +++ b/ops-setup/4-git.md @@ -11,7 +11,8 @@ You'll use the `git` command for managing the Ops scripts you write. Let's set i ## Download file to be used later -1. In the terminal, run: `wget https://raw.githubusercontent.com/codefellows/setup-guide/main/configs/ops/gnome-terminal-profiles.dconf` +1. In the terminal, run this command (all one line) to download a config file: + - `wget https://raw.githubusercontent.com/codefellows/setup-guide/main/configs/ops/gnome-terminal-profiles.dconf` --- From 976910ee7467d9cb283191db778238d54746e6f4 Mon Sep 17 00:00:00 2001 From: Brook Riggio Date: Thu, 27 Oct 2022 12:15:34 -0700 Subject: [PATCH 06/13] Update 5-virtualbox.md --- ops-setup/5-virtualbox.md | 36 +++++++++++++++++++++++------------- 1 file changed, 23 insertions(+), 13 deletions(-) diff --git a/ops-setup/5-virtualbox.md b/ops-setup/5-virtualbox.md index ebe0ea3..1891d48 100644 --- a/ops-setup/5-virtualbox.md +++ b/ops-setup/5-virtualbox.md @@ -1,27 +1,37 @@ # Ops Setup +Configure your lab PC as a host for virtual machines. + ## Virtualbox -### Download Virtalbox using latest .deb file - run these commands +### Download Virtalbox + +Run each of these commands in your terminal: + +1. ```wget -q https://www.virtualbox.org/download/oracle_vbox_2016.asc -O- | sudo apt-key add -``` +1. ```wget -q https://www.virtualbox.org/download/oracle_vbox.asc -O- | sudo apt-key add -``` +1. ```echo "deb [arch=amd64] http://download.virtualbox.org/virtualbox/debian eoan contrib" | sudo tee /etc/apt/sources.list.d/virtualbox.list``` + +### Install Virtalbox using Apt + +Run each of these commands in your terminal: - - ```wget -q https://www.virtualbox.org/download/oracle_vbox_2016.asc -O- | sudo apt-key add -``` - - ```wget -q https://www.virtualbox.org/download/oracle_vbox.asc -O- | sudo apt-key add -``` - - ```echo "deb [arch=amd64] http://download.virtualbox.org/virtualbox/debian eoan contrib" | sudo tee /etc/apt/sources.list.d/virtualbox.list``` +1. ```sudo apt update``` +1. ```sudo apt install linux-headers-$(uname -r) dkms -y``` +1. ```sudo apt-get install virtualbox -y``` -### Install Virtalbox using Apt and pointing it to the downloaded .deb file - run these commands +### Add the Virtualbox Extension Pack 6.1.16 - - ```sudo apt update``` - - ```sudo apt install linux-headers-$(uname -r) dkms -y``` - - ```sudo apt-get install virtualbox -y``` +Run each of these commands in your terminal: -### Download and install Virtualbox Extension Pack 6.1.16 - run these commands +1. ```wget https://download.virtualbox.org/virtualbox/6.1.16/Oracle_VM_VirtualBox_Extension_Pack-6.1.16-140961.vbox-extpack``` +1. ```vboxmanage extpack install Oracle_VM_VirtualBox_Extension_Pack-6.1.16-140961.vbox-extpack --accept-license=33d7284dc4a0ece381196fda3cfe2ed0e1e8e7ed7f27b9a9ebc4ee22e24bd23c``` - - ```wget https://download.virtualbox.org/virtualbox/6.1.16/Oracle_VM_VirtualBox_Extension_Pack-6.1.16-140961.vbox-extpack``` - - ```vboxmanage extpack install Oracle_VM_VirtualBox_Extension_Pack-6.1.16-140961.vbox-extpack --accept-license=33d7284dc4a0ece381196fda3cfe2ed0e1e8e7ed7f27b9a9ebc4ee22e24bd23c``` +### Create a Shortcut to Virtualbox -### Create a shortcut to Virtualbox - run this command +Run this command in your terminal to add a shortcut to your desktop: - - ```gsettings set org.gnome.shell favorite-apps "$(gsettings get org.gnome.shell favorite-apps | sed s/.$//), 'virtualbox.desktop']"``` +1. ```gsettings set org.gnome.shell favorite-apps "$(gsettings get org.gnome.shell favorite-apps | sed s/.$//), 'virtualbox.desktop']"``` --- From 3cc0c5935807584690b070227e373f6540c3960c Mon Sep 17 00:00:00 2001 From: Brook Riggio Date: Thu, 27 Oct 2022 12:17:10 -0700 Subject: [PATCH 07/13] Move the download to where we actually need it. --- ops-setup/4-git.md | 5 ----- 1 file changed, 5 deletions(-) diff --git a/ops-setup/4-git.md b/ops-setup/4-git.md index 60cb4de..31461ed 100644 --- a/ops-setup/4-git.md +++ b/ops-setup/4-git.md @@ -9,11 +9,6 @@ You'll use the `git` command for managing the Ops scripts you write. Let's set i 1. Run `cd ~/github` to move there. - This is how you can change the "current folder" you are working in, from within the Linux shell. -## Download file to be used later - -1. In the terminal, run this command (all one line) to download a config file: - - `wget https://raw.githubusercontent.com/codefellows/setup-guide/main/configs/ops/gnome-terminal-profiles.dconf` - --- ### [⇐ Previous](./3-ip.md) | [Next ⇒](./5-virtualbox.md) From 14df0db04fd52cdaa4093e66e3a76af70f074981 Mon Sep 17 00:00:00 2001 From: Brook Riggio Date: Thu, 27 Oct 2022 12:23:38 -0700 Subject: [PATCH 08/13] Update 6-display.md --- ops-setup/6-display.md | 28 ++++++++++++++++++++-------- 1 file changed, 20 insertions(+), 8 deletions(-) diff --git a/ops-setup/6-display.md b/ops-setup/6-display.md index 776db41..f3ab042 100644 --- a/ops-setup/6-display.md +++ b/ops-setup/6-display.md @@ -1,19 +1,28 @@ # Ops Setup -## Adjust some display settings -- You may adjust these to your personal preference if you know how. +Let's now configure some system settings. -### Activate default dark mode (personal preference) - run this command +### System Settings -- ```gsettings set org.gnome.desktop.interface gtk-theme "Adwaita-dark"``` +1. Deactivate screen locking, as we mostly running this as a server box via RDP: + - `gsettings set org.gnome.desktop.screensaver lock-enabled false` +1. If you prefer dark mode, activate it as the default: + - `gsettings set org.gnome.desktop.interface gtk-theme "Adwaita-dark` +1. Adjust other display settings from the Settings app. + - You may adjust these to your personal preference if you know how. -### Deactivate screen locking, as we mostly running this as a server box via RDP- run this command +### Set Gnome Terminal's Colors -- ```gsettings set org.gnome.desktop.screensaver lock-enabled false``` +You may configure your terminal colors however you like. Start with this configuration as a default. -### Set Gnome Terminal's colors (personal preference)- run these commands +Run these commands in your terminal to download and install our suggested config: -- ```dconf load /org/gnome/terminal/legacy/profiles:/ < gnome-terminal-profiles.dconf``` +1. `wget https://raw.githubusercontent.com/codefellows/setup-guide/main/configs/ops/gnome-terminal-profiles.dconf` +2. `dconf load /org/gnome/terminal/legacy/profiles:/ < gnome-terminal-profiles.dconf` + +### Update System Software + +To update other system software, run each of these commands, one at a time in the terminal: ```bash cd ~/Downloads @@ -23,6 +32,9 @@ sudo apt update sudo apt-get update sudo apt upgrade -y ``` + +Some of these steps may take some time to complete. + --- ### [⇐ Previous](./5-virtualbox.md) | [Next ⇒](./7-applications.md) From 6db1c83d93f8b3546d7f4bc444783bf9963006f7 Mon Sep 17 00:00:00 2001 From: Brook Riggio Date: Thu, 27 Oct 2022 12:27:50 -0700 Subject: [PATCH 09/13] Update 7-applications.md --- ops-setup/7-applications.md | 43 ++++++++++++++++++------------------- 1 file changed, 21 insertions(+), 22 deletions(-) diff --git a/ops-setup/7-applications.md b/ops-setup/7-applications.md index 6c0486d..9ce629b 100644 --- a/ops-setup/7-applications.md +++ b/ops-setup/7-applications.md @@ -1,42 +1,41 @@ # Ops Setup -## Install applications and tools +Now, install some applications and tools -### Install Open SSH Server, allow firewall, and launch the service on startup +### Add OpenSSH Server: -- ```sudo apt-get install openssh-server -y``` -- ```sudo systemctl start sshd``` -- ```sudo ufw allow ssh``` -- ```sudo systemctl enable ssh``` +1. `sudo apt-get install openssh-server -y` +1. `sudo systemctl start sshd` +1. `sudo ufw allow ssh` +1. `sudo systemctl enable ssh` -### Install VIM +### Install VIM: -- ```sudo apt install vim -y``` -- ```vim --version >> ~/Downloads/deployerlog.txt``` +1. `sudo apt install vim -y` +1. `vim --version >> ~/Downloads/deployerlog.txt` -### Install curl +### Install curl: -- ```sudo apt install curl -y``` -- ```curl --version >> ~/Downloads/deployerlog.txt``` +1. `sudo apt install curl -y` +1. `curl --version >> ~/Downloads/deployerlog.txt` -### Install Virtalbox +### Install Virtalbox: -- ```install-virtualbox``` +1. `install-virtualbox` -### Install VS Code +### Install VSCode: -- ```sudo apt install software-properties-common apt-transport-https wget -y``` -- ```wget -q https://packages.microsoft.com/keys/microsoft.asc -O- | sudo apt-key add -``` -- ```sudo add-apt-repository "deb [arch=amd64] https://packages.microsoft.com/repos/vscode stable main"``` -- ```sudo apt install code -y``` -- ```code --version >> ~/Downloads/deployerlog.txt``` +1. `sudo apt install software-properties-common apt-transport-https wget -y` +1. `wget -q https://packages.microsoft.com/keys/microsoft.asc -O- | sudo apt-key add ` +1. `sudo add-apt-repository "deb [arch=amd64] https://packages.microsoft.com/repos/vscode stable main` +1. `sudo apt install code -y` +1. `code --version >> ~/Downloads/deployerlog.txt` -### Set favorite apps +### Set Favorite Apps - ```gsettings set org.gnome.shell favorite-apps "$(gsettings get org.gnome.shell favorite-apps | sed s/.$//), 'terminal.desktop']"``` - ```gsettings set org.gnome.shell favorite-apps "$(gsettings get org.gnome.shell favorite-apps | sed s/.$//), 'files.desktop']"``` - ```gsettings set org.gnome.shell favorite-apps "$(gsettings get org.gnome.shell favorite-apps | sed s/.$//), 'virtualbox.desktop']"``` -- ```gsettings set org.gnome.shell favorite-apps "$(gsettings get org.gnome.shell favorite-apps | sed s/.$//), 'gns3.desktop']"``` - ```gsettings set org.gnome.shell favorite-apps "$(gsettings get org.gnome.shell favorite-apps | sed s/.$//), 'code.desktop']"``` --- From 17988b743913133b7feaf3b8b692b6260a6e0458 Mon Sep 17 00:00:00 2001 From: Brook Riggio Date: Thu, 27 Oct 2022 12:31:10 -0700 Subject: [PATCH 10/13] Update 8-rdp.md --- ops-setup/8-rdp.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/ops-setup/8-rdp.md b/ops-setup/8-rdp.md index 91ece3b..9ec3074 100644 --- a/ops-setup/8-rdp.md +++ b/ops-setup/8-rdp.md @@ -1,14 +1,15 @@ # Ops Setup -## Adjust settings for RDP (Remote Desktop Protocol) +Adjust settings for RDP (Remote Desktop Protocol). These steps will make your remote-connection sessions easier. -- These will make the RDP sessions easier +## RDP Config ### Remove "color profile authentication" popup in XRDP -- ```sudo touch /etc/polkit-1/localauthority/50-local.d/45-allow-colord.pkla``` +Copy this entire block of commands, and paste it into your terminal to run all at once: ```bash +sudo touch /etc/polkit-1/localauthority/50-local.d/45-allow-colord.pkla sudo cat >> /etc/polkit-1/localauthority/50-local.d/45-allow-colord.pkla <> /etc/polkit-1/localauthority/50-local.d/46-allow-update-repo.pkla < Date: Thu, 27 Oct 2022 12:33:04 -0700 Subject: [PATCH 11/13] Update 9-wrapup.md --- ops-setup/9-wrapup.md | 18 +++++++++++++++--- 1 file changed, 15 insertions(+), 3 deletions(-) diff --git a/ops-setup/9-wrapup.md b/ops-setup/9-wrapup.md index 599213f..6a70214 100644 --- a/ops-setup/9-wrapup.md +++ b/ops-setup/9-wrapup.md @@ -1,9 +1,21 @@ # Ops Setup -## Wrapup - run the following to see a summary of what was installed +That's about it! -- ```cat ~/Downloads/deployerlog.txt``` +## Wrapup + +We've been tracking some of progress along the way. + +Run the following to see a summary of what was installed: + +- `cat ~/Downloads/deployerlog.txt` + +Take a moment to review what's reported there. + +If it sounds about right, you are done! If you aren't sure, reach out to your instructor to get it verified. + +We can't wait to hear from you, and see you in class! --- -### That's It! [Back To the Beginning](../README.md) +### [Back To the Beginning](../README.md) From 83168767f8e5dca69c5a50b4f019565560f487eb Mon Sep 17 00:00:00 2001 From: Brook Riggio Date: Thu, 27 Oct 2022 16:59:00 -0700 Subject: [PATCH 12/13] Update 3-ip.md --- ops-setup/3-ip.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/ops-setup/3-ip.md b/ops-setup/3-ip.md index 6395998..68de3c0 100644 --- a/ops-setup/3-ip.md +++ b/ops-setup/3-ip.md @@ -1,9 +1,11 @@ # Ops Setup -## Get Internet Pprotocol (IP) Address +Keep track of your IP address. + +## Get Your Internet Protocol (IP) Address - Check your IP address with `ip a` and write it down/take note somewhere. -- For a walkthrough on how this works, click here: [How ip a works](https://itsfoss.com/check-ip-address-ubuntu/) +- Review this walkthrough on [how the ip command works](https://itsfoss.com/check-ip-address-ubuntu/){target: "_blank"} --- From ac05899a6e85c4f9a531d66f38fce59456f37372 Mon Sep 17 00:00:00 2001 From: Brook Riggio Date: Mon, 31 Oct 2022 15:01:26 -0700 Subject: [PATCH 13/13] standardizes on using `apt` Co-authored-by: Ethan Denny --- ops-setup/5-virtualbox.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ops-setup/5-virtualbox.md b/ops-setup/5-virtualbox.md index 1891d48..daba9c2 100644 --- a/ops-setup/5-virtualbox.md +++ b/ops-setup/5-virtualbox.md @@ -18,7 +18,7 @@ Run each of these commands in your terminal: 1. ```sudo apt update``` 1. ```sudo apt install linux-headers-$(uname -r) dkms -y``` -1. ```sudo apt-get install virtualbox -y``` +1. ```sudo apt install virtualbox -y``` ### Add the Virtualbox Extension Pack 6.1.16