• Table of contents
• Linux Build Virtual Machine
  • Installed tools
  • Virtual Box and VM OS Details
  • Downloading and Installing the Virtual Machine
    • File Verification
  • VM Build Steps
  • Linux VM Operating System Updates Fail
    • Windows Blue Screen of Death (BSoD) when Starting Appliance (VM)
  • Quartus 14.1 Unexpectedly Quits Randomly

Linux Build Virtual Machine¶

In order to ease software configuration setup for Linux developers, Critical Link has developed a Virtual Machine using the Sun VirtualBox virtual machine product (Version 4.3 or higher). The Linux virtual machine is configured to include the necessary tools and projects in order to start developing applications for the MitySOM-5CSX products.

Installed tools¶

The VM has Altera DS-5 pre-installed however no license is provided. Users may chose to utilize a free 30-day trial, purchase a new license or utilize an existing license. The tool-chains are installed to allow for manual ARM application compilation and GDB debugging without a DS-5 license (performed through a terminal).

Quartus II 14.X is also pre-installed as the "Web Edition" which does not require a license. Please reference this Altera document (http://www.altera.com/literature/po/ss_quartussevswe.pdf) that outlines the difference between the web and subscription editions.

A readme.html on the desktop provides further details concerning where files are located within the VM and other helpful information.

Virtual Box and VM OS Details¶

Users of the virtual image should consult the VirtualBox licensing restrictions and determine if they need to purchase a license from Sun/Oracle.

The Virtual machine is configured to provide a Ubuntu 14.04 LTS (Long Term Support) environment using a 64 bit architecture.

For the Virtual Machine, the default user is "user" and the password is also "user" (this is necessary for sudo operations).

Downloading and Installing the Virtual Machine¶

The Virtual Machine image is available by download via the link below or you may request a copy that will be delivered on a USB Thumb drive (one is included with each development kit). The image is approximately 12 GBytes, so users electing the download image should expect a lengthy transfer time.

Virtual Machine Download link: https://support.criticallink.com/files/mitysom-5csx/xubuntu64_1404_MitySOM_5CSx_dev_vm_11122015.ova

File Verification¶

After downloading the OVA file we recommend you perform an md5sum check on the file before you attempt to import the appliance.

MD5SUM for xubuntu64_1404_MitySOM_5CSx_dev_vm_11122015.ova: 385f6956c9fa3456eea96cb90ff13c08

You can verify the hash on Linux systems using the md5sum command:

Example:
(cd to USB drive directory)
$ md5sum xubuntu64_1404_MitySOM_5CSx_dev_vm_11122015.ova

(Due to the large size of the file, it may take a few minutes to compute the hash).

• IF THE HASHES DIFFER PLEASE CONTACT CRITICAL LINK

VM Build Steps¶

Please reference the following document on how to setup the Virtual Machine on your Windows PC: http://support.criticallink.com/redmine/documents/247

Linux VM Operating System Updates Fail¶

Currently in the VM updates are available for the OS. If you want to apply those updates please note that it is likely you will encounter an error in finding an IP address (the IP address: 91.189.91.14 80 not found). To resolve this:

1. Open the "Updates Manager" within the OS and select the "Settings..." button, the password is "user"
2. Select the "Other Software" tab and
3. You will likely see check boxes for the "Independent" and "Independent (Source Code)" options, if you do "de-select" them.
4. Close out of the Settings dialog and you should be prompted to rescan for updates
5. Try and "Install Updates" again and the process should proceed without error.

Windows Blue Screen of Death (BSoD) when Starting Appliance (VM)¶

We have had a customer report a BSoD when starting the MitySOM-5CSx Virtual Machine on their Windows 7 64-bit host PC. The cause was determined to be a conflict between Virtual Box (4.3.24) and their antivirus software, McAfee. They resolved the issue by downgrading Virtual box to 4.3.8. We don't know at which version the issue occurs but this may be something to consider if you are experiencing similar problems.

Quartus 14.1 Unexpectedly Quits Randomly¶

Sometimes, even when sitting idle, Quartus 14.1 will quit. When clicking on the Preview Report in the message, the stack trace will mention curl as the library causing the issue. If this is occurring in the MitySOM VM, it has been reported that the following command helps resolve the situation:

sudo mv /home/user/altera/14.1/quartus/linux64/libcurl.so.4 /home/user/altera/14.1/quartus/linux64/libcurl.so.4.bak