skills17/competitor-vm-ubuntu

Installation instructions to create an Ubuntu VM for competitors.

For ARM specific instructions, see README_ARM.md.

Table of contents

• Installation
• Export
• Features
• License

Installation

The following installation instructions assume that VMWare is used as the virtualization software. However, with some small adjustments, they can also be applied to other virtualization solutions, such as VirtualBox or Parallels.

1. Create the virtual machine in VMWareWorkstation (custom, default options if not specified)
   • Custom installation
   • Install OS later
   • Ubuntu 64 bit
   • Memory 8GB, 2 CPU/2 Core
   • disable "Accelerate 3D graphics"
2. Start the Ubuntu installation (default options if not specified)
   • Keyboard layout: Switzerland - German (Switzerland, no dead keys)
   • Minimal installation
   • If full disk encryption should be used:
     • Choose "Advanced features" right next to "Erase disk and install Ubuntu"
     • Use LVM with the new Ubuntu installation
     • Enable "Encrypt the new Ubuntu installation for security"
     • Choose a password in the next step
   • Any user configuration is possible. Use the following one if it is not specified otherwise:
     • Username: student
     • Password: student
     • Hostname: ICTT17
     • Auto login
3. After the installation is finished, either disable the features in the prompt (do not send help data, no cloud login, etc.) or skip them
4. Ensure the VMWare Tools are installed by executing vmware-toolbox-cmd -v
5. Run this installation script with the following command. Please note that, by default, all features will be installed. It is possible do disable some of them. See more in the features section.
   • sudo apt-get install --yes curl
   • curl -sSL https://raw.githubusercontent.com/skills17/competitor-vm-ubuntu/master/scripts/install.sh | sudo -E bash -s
   • After everything is installed, the system will reboot.
6. Open all applications once (to initialize, disable telemetry, start trial version, ...) and move them to the taskbar/favorites. Also, check if all extensions have been installed correctly.
   • Firefox
   • Gimp
   • Google Chrome
   • PhpMyAdmin
   • PhpStorm (Set PHP Language Level to 8.2)
   • Postman
   • Terminal
   • Visual Studio Code (Go to extensions -> search for @builtin php and disable PHP Language Features)
   • WebStorm
   • Zeal (Install docset for PHP, MySQL, JavaScript, CSS, HTML, NodeJS)
7. If you get asked to set a keyring password, use an empty password. Otherwise, it will always ask for this password after statup when auto-login is enabled. In case it is automatically set to student, open the "Passwords and Keys" application and change the password of the login folder to an empty one.

Export

To export the VM, follow these steps.

1. Clear the history and shutdown the machine
   • cat /dev/null > ~/.bash_history && history -c && shutdown -h now
2. Remove all CD-Roms (because of compatibility issues)
3. Defragment the disk (Settings -> Options -> Hard Disk -> Defragment Disk)
4. Reclaim unused space (Settings -> Options -> Hard Disk -> Compact Disk)
5. Go to "Export Virtual Machine to OVF"
6. Choose a file name and use .ova as the file extension

Features

The following features will be installed in the VM. Each of the features can be disabled by specifying them during the installation step. For example, the following command will skip phpmyadmin but install all other features:

curl -sSL https://raw.githubusercontent.com/skills17/competitor-vm-ubuntu/master/scripts/install.sh | sudo -E bash -s -- --phpmyadmin=false

Feature	Version	Description
apache	2	Installs apache2 with the DocumentRoot pointing to /home/$USER/ICTT17.
autostart	-	Installs autostart scripts. All .sh files in ~/.local/share/skills17/autostart/ will get executed on login. By default, it opens http://localhost in a browser.
mysql	latest	Installs mysql and sets the root password to '' (empty string).
nodejs	20	Installs nodejs and npm.
php	8.2	Installs the PHP cli and apache2 mod, as well as composer.
phpmyadmin	latest	Installs phpmyadmin with apache2 and configures an auto login.
system	-	Performs some system settings, such as disabling the lock screen & screensaver.
vmware-tools	-	Installs the VMware tools.
chrome	latest	Google Chrome.
gimp	latest	GIMP.
phpstorm	latest	PhpStorm.
postman	latest	Postman.
vim	latest	VIM.
vscode	latest	Visual Studio Code.
webstorm	latest	WebStorm.
zeal	latest	Zeal offline documentations.

License

MIT