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. --- 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. --- 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"} --- diff --git a/ops-setup/4-git.md b/ops-setup/4-git.md index 1cbf780..31461ed 100644 --- a/ops-setup/4-git.md +++ b/ops-setup/4-git.md @@ -1,15 +1,13 @@ # Ops Setup -## 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. +You'll use the `git` command for managing the Ops scripts you write. Let's set it up now. -## Download file to be used later +## Git Installation -- Run `wget https://raw.githubusercontent.com/codefellows/setup-guide/main/configs/ops/gnome-terminal-profiles.dconf` +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. --- diff --git a/ops-setup/5-virtualbox.md b/ops-setup/5-virtualbox.md index ebe0ea3..daba9c2 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 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']"``` --- 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) 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']"``` --- 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 <