install_qushape.sh

Notes for my nephew’s wife Jonesy, about setting up QuShape in a Linux VM.

Install the latest version of VirtualBox VM software, from http://virtualbox.org/

Download the Ubuntu Linux 16.04 LTS install image, from http://ubuntu.com/ . I specifically recommend the LTS version because it stands for Long Term Support, meaning you won’t be forced to upgrade the OS for up to 2022.

Startup Virtualbox. Click on New. Pick Linux, Ubuntu 64 bit, name it whatever you like (perhaps QuShape). Pick the amount of memory to use for this VM (pick at least 4 GB, probably 1/2 to all of whatever your Mac has). Make the virtual disk at least 20 GB to start, but at least 10 GB larger than the amount of memory you chose to assign (so, if you are creating a 32 GB VM, pick at least 42 GB disk).

Note: Virtualbox virtual disks won’t start out using that much disk space at all. In fact, what you are really setting is the maximum amount of disk this VM can use.

After the VM is created, click on Edit Settings, and go into the Storage menu. Click on the cd drive, then find the tiny icon on the right side that looks like a compact disc. Click it, pick ‘other image’ and find the Ubuntu iso file you downloaded. Click ok.

Start the VM. Every time you start a virtualbox vm, it puts up a tiny, annoying message about the mouse pointer. Click the x and ignore the msg like everyone else. Go through the install procedure. Reboot at the end.

After the first reboot, login to the gui using the userid you setup in the install. The very first login takes longer than usual, because it has to set everything up for you.

Once you get a menu bar on the left, click on the top icon. Type “term” in the search window, and wait a second while it shows all apps that match. Click on Terminal.

Download the install_qushape.sh script by running ‘curl -O http://whistl.com/files/install_qushape.sh’ .

Run it by entering ‘sh install_qushape.sh’. It runs sudo, so you will be prompted to enter your ubuntu password again. The upgrade takes a few minutes.

When you are done, reboot again by running ‘sudo shutdown -r now’, or finding the shutdown/reboot options on the menus in the upper right corner.

When the system comes back up, login again, click on the upper left icon again, click on the terminal program, and just enter ‘qs’ anytime you want to start QuShape.