diff --git a/doc/deployment_guide.md b/doc/deployment_guide.md index 9edfd103625fa429b94a44077a27a85415647055..abe689f963d9cd304f20e02b7ba71dbd5b9bc2ca 100644 --- a/doc/deployment_guide.md +++ b/doc/deployment_guide.md @@ -135,53 +135,56 @@ __Note__: IP address 10.0.2.10 is the one that will be assigned to the VM. <h3><u>Create VM in VirtualBox:</u></h3> -- Name: TFS-VM -- Type/Version: Linux / Ubuntu (64-bit) -- CPU (*): 4 vCPUs @ 100% execution capacity -- RAM: 8 GB -- Disk: 60 GB, Virtual Disk Image (VDI), Dynamically allocated -- Optical Drive ISO Image: "ubuntu-22.04.X-live-server-amd64.iso" - - Download the latest Long Term Support (LTS) version of the *Ubuntu Server* image from [Ubuntu 22.04 LTS](https://releases.ubuntu.com/22.04/), e.g., "ubuntu-22.04.X-live-server-amd64.iso". - - __Note__: use Ubuntu Server image instead of Ubuntu Desktop to create a lightweight VM. -- Network Adapter 1 (*): enabled, attached to NAT Network "TFS-NAT-Net" -- Minor adjustments (*): - - Audio: disabled - - Boot order: disable "Floppy" + - Name: TFS-VM + - Type/Version: Linux / Ubuntu (64-bit) + - CPU (*): 4 vCPUs @ 100% execution capacity + - RAM: 8 GB + - Disk: 60 GB, Virtual Disk Image (VDI), Dynamically allocated + - Optical Drive ISO Image: "ubuntu-22.04.X-live-server-amd64.iso" + - Download the latest Long Term Support (LTS) version of the *Ubuntu Server* image from [Ubuntu 22.04 LTS](https://releases.ubuntu.com/22.04/), e.g., "ubuntu-22.04.X-live-server-amd64.iso". + - __Note__: use Ubuntu Server image instead of Ubuntu Desktop to create a lightweight VM. + - Network Adapter 1 (*): enabled, attached to NAT Network "TFS-NAT-Net" + - Minor adjustments (*): + - Audio: disabled + - Boot order: disable "Floppy" __Note__: (*) settings to be editing after the VM is created. <h3><u>Install Ubuntu 22.04 LTS Operating System</u></h3> + In "Oracle VM VirtualBox Manager", start the VM in normal mode, and follow the installation procedure. Below we provide some installation guidelines: -- Installation Language: English -- Autodetect your keyboard -- If asked, select "Ubuntu Server" (do not select "Ubuntu Server (minimized)"). -- Configure static network specifications: - -|Interface|IPv4 Method|Subnet |Address |Gateway |Name servers |Search domains| -|---------|-----------|-----------|---------|--------|---------------|--------------| -|enp0s3 |Manual |10.0.2.0/24|10.0.2.10|10.0.2.1|8.8.8.8,8.8.4.4|<empty> | - -- Leave proxy and mirror addresses as they are -- Let the installer self-upgrade (if asked). -- Use an entire disk for the installation - - Disable setup of the disk as LVM group - - Double check that NO swap space is allocated in the partition table. Kubernetes does not work properly with SWAP. -- Configure your user and system names: - - User name: TeraFlowSDN - - Server's name: tfs-vm - - Username: tfs - - Password: tfs123 -- Install Open SSH Server - - Import SSH keys, if any. -- Featured Server Snaps - - Do not install featured server snaps. It will be done manually later to illustrate how to uninstall and reinstall them in case of trouble with. -- Let the system install and upgrade the packages. - - This operation might take some minutes depending on how old is the Optical Drive ISO image you use and your Internet connection speed. -- Restart the VM when the installation is completed. + + - Installation Language: English + - Autodetect your keyboard + - If asked, select "Ubuntu Server" (do not select "Ubuntu Server (minimized)"). + - Configure static network specifications: + + |Interface|IPv4 Method|Subnet |Address |Gateway |Name servers |Search domains| + |---------|-----------|-----------|---------|--------|---------------|--------------| + |enp0s3 |Manual |10.0.2.0/24|10.0.2.10|10.0.2.1|8.8.8.8,8.8.4.4|<empty> | + + - Leave proxy and mirror addresses as they are + - Let the installer self-upgrade (if asked). + - Use an entire disk for the installation + - Disable setup of the disk as LVM group + - Double check that NO swap space is allocated in the partition table. Kubernetes does not work properly with SWAP. + - Configure your user and system names: + - User name: TeraFlowSDN + - Server's name: tfs-vm + - Username: tfs + - Password: tfs123 + - Install Open SSH Server + - Import SSH keys, if any. + - Featured Server Snaps + - Do not install featured server snaps. It will be done manually later to illustrate how to uninstall and reinstall them in case of trouble with. + - Let the system install and upgrade the packages. + - This operation might take some minutes depending on how old is the Optical Drive ISO image you use and your Internet connection speed. + - Restart the VM when the installation is completed. **Upgrade the Ubuntu distribution** + ```bash sudo apt-get update -y sudo apt-get dist-upgrade -y @@ -191,6 +194,7 @@ sudo apt-get dist-upgrade -y **Install VirtualBox Guest Additions** + On VirtualBox Manager, open the VM main screen. If you are running the VM in headless mode, right click over the VM in the VirtualBox Manager window and click "Show". If a dialog informing about how to leave the interface of the VM is shown, confirm