Difference between revisions of "Installation/Live Images/USB-Stick for OFW11"

From OpenFOAMWiki
(the mount should now point to OFW11, instead of being random)
(Preface: Added link to the CFD-Online announcement)
 
(31 intermediate revisions by the same user not shown)
Line 1: Line 1:
<span style="font-size:180%">'''WARNING: These instructions are currently being written and under testing!'''</span>
+
= Preface =
 +
This section of the wiki ([[Installation/Live_Images/USB-Stick for OFW11]]) has been written as the most detailed as possible set of instructions on how to create, successfully massively-deploy USB-sticks and alter use those USB-sticks that run Lubuntu with the all of the OpenFOAM technology software that was available up to a few months from when the [http://www.cfd-online.com/Forums/openfoam-news-announcements-other/165818-11th-openfoam-workshop-26-30-june-2016-guimaraes-portugal.html 11th OpenFOAM Workshop is/was held in 2016 at Guimarães in Portugal]. Website at the time: [http://openfoamworkshop.org/ openfoamworkshop.org]
 +
: ([[User:Wyldckat|Wyldckat]] ([[User talk:Wyldckat|talk]]) 17:45, 13 February 2016 (CET): Don't forget to update when it's mirrored onto openfoam-extend's project at SourceForge.net.)
  
= Creating the development machine =
+
<br>
  
== Installation details ==
+
= Objective =
In a nutshell:
+
'''To make it 100% probable that everyone will be able to use OpenFOAM and foam-extend at the 11th OpenFOAM Workshop.''' Although this might be limited to 100% of the people that have 64-bit PCs...
# Install Lubuntu 15.10 x86_64 in a virtual machine.
+
# Install OpenFOAM 3.0.x, as instructed here: [[Installation/Linux/OpenFOAM-3.0.x/Ubuntu#Ubuntu_15.10]]
+
# Install foam-extend 3.2.x, based on the instructions from here: [[Installation/Linux/foam-extend-3.2/Ubuntu#Ubuntu_15.10]]
+
# Install swak4Foam, PyFoam and cfMesh for OpenFOAM 3.0.x, since these are already in foam-extend 3.2.x.
+
  
 +
<br>
 +
= Instructions =
  
=== Install Lubuntu 15.10 x86_64 in a virtual machine ===
+
This is aimed at providing a fully functional USB-stick or Virtual Machine Appliance that works on VirtualBox, so that [http://openfoam.org OpenFOAM] and [http://foam-extend.org foam-extend] can be accessed without going through the occasionally tough installation process. Nonetheless , keep in mind that [http://www.docker.com Docker] is the kind of technology that will probably supersede this kind of installation in future workshops.
'''TODO'''
+
  
 +
The information written for this topic are spread across the following sub-pages:
 +
; [[Installation/Live_Images/USB-Stick_for_OFW11/User_Guide|User Guide]]
 +
: This is the User Guide meant for the people who will be trying to use these images and/or virtual machines. It also lists the software versions installed with the image designed for this workshop.
  
=== Packages that need to be installed in the development VM ===
+
; [[Installation/Live_Images/USB-Stick_for_OFW11/Reminders|Reminders]]
'''TODO'''
+
: This page is needed for the next couple of pages, because this provides the main details that should be kept at all times when following the instructions on those other pages!
  
Part of the software stack:
+
; [[Installation/Live_Images/USB-Stick_for_OFW11/Deployment_Guide|Deployment Guide]]
<bash>
+
: This page is meant for the people responsible for the deployment phase, namely those who will be ''sweating'' to burn the image onto several dozens (if not a couple of hundred) USB sticks.
sudo apt-get install squashfs-tools
+
: It also includes information on how to create the virtual machine appliances, in case things don't run so well when trying to use the USB-stick as a ''bootable'' drive.
</bash>
+
  
=== Install OpenFOAM 3.0.x ===
+
; [[Installation/Live_Images/USB-Stick_for_OFW11/Creation_Guide|Creation Guide]]
'''TODO'''
+
: This is where the complete instructions for the creation of the USB-stick are written and provide as many details as possible.
  
 +
; [[Installation/Live_Images/USB-Stick_for_OFW11/Download|Download]]
 +
: This is where is listed the current locations for the (virtual) disk images.
  
==== Install additional contributions for OpenFOAM 3.0.x ====
+
; [[Installation/Live_Images/USB-Stick_for_OFW11/FAQ|Frequently Asked Questions]]
 
+
: This page is for the Frequently Asked Questions about this particular effort for the OFW11.
'''TODO''' swak4Foam, PyFoam and cfMesh
+
 
+
 
+
=== Install foam-extend 3.2.x ===
+
'''TODO'''
+
 
+
 
+
== Preparations before copying to final image ==
+
This is a cheat sheet on the commands needed for cleaning up each installation before copying to the USB-Stick:
+
 
+
=== Clean up OpenFOAM 3.0.x ''et al'' ===
+
<bash>of30x
+
foam3rdParty
+
rm -r build
+
rm log.*
+
rm *.log
+
cd ..
+
wclean all swak4Foam
+
wclean all cfMesh
+
rm -r PyFoam/build/
+
</bash>
+
 
+
 
+
=== Clean up foam-extend 3.2.x ''et al'' ===
+
<bash>fe32
+
rm log.make
+
</bash>
+
 
+
 
+
== Cheat sheet for copying installation to USB-Stick ==
+
'''Notes''':
+
* This is meant to be used mid-way of the instructions from sub-section [[#Transferring the local installation to the persistent partition file in the drive|Transferring the local installation to the persistent partition file in the drive]].
+
 
+
First of all, create our sandbox folder:
+
<bash>mkdir ~/sandbox</bash>
+
 
+
=== Copying OpenFOAM 3.0.x ''et al'' ===
+
In a new terminal, run:
+
<bash>of30x
+
cd ~/OpenFOAM
+
TARGET=~/sandbox/OpenFOAM
+
mkdir $TARGET/
+
rsync -a swak4Foam cfMesh PyFoam lubuntu-3.0.x $TARGET/
+
 
+
rsync -a OpenFOAM-3.0.x/  $TARGET/OpenFOAM-3.0.x/
+
rsync -a ThirdParty-3.0.x/ $TARGET/ThirdParty-3.0.x/
+
 
+
cd $TARGET/OpenFOAM-3.0.x/
+
rm -r platforms/linux64GccDPInt32OptSYSTEMOPENMPI/
+
rm -r platforms/linux64GccDPInt32Opt/{src,applications}
+
 
+
cd $TARGET/ThirdParty-3.0.x/
+
rm -r CGAL-4.7/ ParaView-4.4.0/ scotch_6.0.3/
+
</bash>
+
 
+
 
+
=== Copying foam-extend 3.2.x ''et al'' ===
+
In a new terminal, run:
+
<bash>fe32
+
cd ~/foam
+
TARGET=~/sandbox/foam
+
mkdir $TARGET/
+
rsync -a site $TARGET/
+
 
+
mkdir $TARGET/foam-extend-3.2
+
cd foam-extend-3.2/
+
rsync -a ./ $TARGET/foam-extend-3.2/
+
 
+
cd $TARGET/foam-extend-3.2/
+
find applications src -name "$WM_OPTIONS" | xargs rm -r
+
rm -r ThirdParty/rpmBuild/{BUILD*,TGZS,RPMS,rpmDB}/*
+
find applications src -name "*.dep" | xargs rm
+
</bash>
+
 
+
 
+
=== Packing the ''sandbox'' to a compressed image ===
+
Given that the final installation is over 2 GiB, therefore we need to save up space by relying on {{tt|squashfs}} to get the whole thing trimmed down to something more manageable. To do so, run:
+
<bash>mksquashfs ~/sandbox/OpenFOAM/OpenFOAM-3.0.x ~/sandbox/OpenFOAM-3.0.x.sqfs
+
mksquashfs ~/sandbox/OpenFOAM/ThirdParty-3.0.x ~/sandbox/ThirdParty-3.0.x.sqfs
+
mksquashfs ~/sandbox/foam/foam-extend-3.2 ~/sandbox/foam-extend-3.2.x.sqfs</bash>
+
 
+
Check the final size of the files, just in case:
+
<bash>ls -l -h ~/sandbox/*.sqfs</bash>
+
 
+
 
+
=== Copying the compressed images to the USB-stick ===
+
It's simply this:
+
<bash>rsync -a -v --progress ~/sandbox/*.sqfs /media/$USER/OFW11/</bash>
+
 
+
 
+
=== Making sure the compressed images are properly used ===
+
 
+
In a new terminal, run:
+
<bash>cd /mnt/casper/upper/home/lubuntu/</bash>
+
 
+
Create the place-holder folders and symbolic links which will link into the original folders:
+
<bash>mkdir -p OpenFOAM/OpenFOAM-3.0.x
+
mkdir -p OpenFOAM/ThirdParty-3.0.x
+
mkdir -p foam/foam-extend-3.2
+
</bash>
+
 
+
 
+
=== Copying the folders that were not compressed ===
+
Simply run:
+
<bash>cd ~/sandbox/OpenFOAM/
+
rsync -a swak4Foam cfMesh PyFoam lubuntu-3.0.x /mnt/casper/upper/home/lubuntu/OpenFOAM/
+
 
+
cd ~/sandbox/foam/
+
rsync -a site lubuntu-3.2 /mnt/casper/upper/home/lubuntu/foam/
+
</bash>
+
 
+
Now you can continue where you left off at section [[#Transferring the local installation to the persistent partition file in the drive|Transferring the local installation to the persistent partition file in the drive]].
+
 
+
= Creating the USB-Stick =
+
 
+
== Reminders ==
+
<ul {{NoIndentStyle}}>
+
<li>{{tt|sdX}} refers to the device itself for the USB drive.
+
</li>
+
<li>{{tt|sdX1}} refers to the first partition.
+
</li>
+
<li>You can find the actual device identification if you use the auto-mount feature that Linux Distributions provide to explore the drive's contents. Then run:
+
<bash>mount</bash>
+
and the last entry is likely the one related to the USB drive, assuming it's the latest one mounted in the system. For example, it may show this:
+
<bash>/dev/sdf1 on /media/ofuser/F361-E869 type vfat (rw,nosuid,nodev,relatime,uid=1000,gid=1000,fmask=0022,dmask=0022,codepage=437,iocharset=iso8859-1,shortname=mixed,showexec,utf8,flush,errors=remount-ro,uhelper=udisks2)
+
</bash>
+
which means that:
+
<ul>
+
<li>{{tt|/dev/sdf}} is the drive's device identification path;
+
</li>
+
<li>{{tt|/dev/sdf1}} is the drive's first partition path.
+
</li>
+
</ul>
+
</li>
+
</ul>
+
 
+
 
+
== Commands for formatting USB-Stick drive ==
+
 
+
These steps are dedicated for creating a stick drive with a partition size that should fit all 8GB USB drives, including those that ''lie'' about their total size, such as those that really only have around 7,750,000,000 bytes. The following instructions aim for a primary partition of 7,654,604,800 bytes.
+
 
+
'''Steps''':
+
<ol {{NoIndentStyle}}>
+
<li>Switch to root or keep in mind to do the command with {{tt|sudo}}.
+
</li>
+
<li>First of all, unmount the partition that it probably auto-mounted:
+
<bash>umount /dev/sdX1</bash>
+
</li>
+
<li>For creating the partition:
+
<bash>fdisk /dev/sdX
+
d  #delete
+
o  #create DOC partition table
+
c  #toggle DOS compatibility
+
 
+
#should show:
+
#  DOS Compatibility flag is set (DEPRECATED!)
+
 
+
n  #new partition
+
p  #new partition
+
1  #partition 1
+
62    #first sector
+
+7300M  #end sector, as size in MB
+
 
+
t  #change type
+
c  #change to W95 FAT32 (LBA)
+
 
+
a  #make it bootable
+
 
+
p  #prints current table on screen make a note of the shown values, because you're going to need the End sector number
+
 
+
w  #write partition table
+
</bash>
+
;Note: Make sure you have the units in sectors:
+
<bash>u  # use as many times as possible until it shows
+
 
+
#Changing display/entry units to sectors
+
</bash>
+
</li>
+
<li>'''Optional''' - Full clean up of partition:
+
<bash>dd if=/dev/zero of=/dev/sdX1 bs=512</bash>
+
<ol>
+
<li>In another terminal (also as root), tun:
+
<bash>while killall -USR1 dd; do sleep 30; done</bash>
+
</li>
+
<li>Then look at the previous terminal window and every 30 seconds it should update on the current write status. Given how this command works, if you have more than one {{tt|dd}} running, it will update for all running {{tt|dd}} applications.
+
</li>
+
<li>It will probably end with the message:
+
<bash>dd: error writing '/dev/sdX1': No space left on device</bash>
+
because we didn't define the total number of bytes/blocks to write.
+
</li>
+
<li>Once completed, make sure it's fully written by running:
+
<bash>sync</bash>
+
wait until it returns control back to you.
+
</li>
+
</ol>
+
</li>
+
<li>Once complete, then for formatting the partition properly:
+
<bash>mkfs -t vfat -n OFW11 /dev/sdX1</bash>
+
</li>
+
</ol>
+
 
+
== Creating the live USB ==
+
'''Tested with Lubuntu 15.10 x86_64.'''
+
 
+
Need to have {{tt|usb-creator-gtk}} installed and we will be using Lubuntu 64-bit as the basis for our stick drives. In addition, it's advisable to do these steps from a working installation of the desired Lubuntu version, even if it's within a virtual machine.
+
 
+
'''Steps''':
+
<ol>
+
<li>As root (or with {{tt|sudo}}), run:
+
<bash>usb-creator-gtk</bash>
+
</li>
+
<li>Select the ISO for the Lubuntu Live CD/DVD.</li>
+
<li>Select the stick drive you want as the target for the Live USB.
+
* '''Note''': Do not use the erase function, otherwise you will loose the correct booting mechanism that was created with {{tt|fdisk}} and {{tt|mkfs}}.
+
</li>
+
<li>Select the largest possible "Stored in reserved extra space", at least taking into account how much will be left over for the ''read-anywhere'' files, such as presentations and VM installers.
+
* For example:
+
** 690 MiB for the cloned Live CD
+
** 1.0 GiB for the ''read-anywhere'' data.
+
** 7.1 GiB - 1.0 GiB - 690 MiB = 5.42 GiB = 5556.4 MiB... which is larger than 4GiB, the file size limit for FAT32 partitions.
+
</li>
+
</li>Finally, click on the "Make Startup Disk" button and wait a while for it to run...
+
</li>
+
</ol>
+
 
+
 
+
=== First boot up of the new USB-Stick ===
+
 
+
After booting up the USB-Stick in a real machine or virtual machine, install the necessary packages, with the following commands:
+
<bash>sudo apt-get update
+
sudo apt-get install virtualbox-guest-utils virtualbox-guest-dkms</bash>
+
which will install the necessary guest additions for Virtualbox to be usable in case the USB-stick doesn't boot directly in the real machine.
+
 
+
Then continue to install the necessary packages for OpenFOAM 3.0.x and foam-extend 3.2.x:
+
<bash>sudo apt-get install git-core build-essential cmake flex bison zlib1g-dev qt4-dev-tools libqt4-dev libqtwebkit-dev gnuplot gnuplot-x11 \
+
libreadline-dev libncurses-dev libxt-dev libopenmpi-dev openmpi-bin libboost-system-dev libboost-thread-dev libgmp-dev \
+
libmpfr-dev python python-dev binutils-dev libiberty-dev rpm mercurial graphviz
+
</bash>
+
 
+
Then change the desktop image, by right clicking on the desktop and choosing {{tt|Desktop Preferences}}. Make sure you download the image from the Workshop website and place it in the folder {{tt|/home/lubuntu/Images}}.
+
 
+
 
+
=== Transferring the local installation to the persistent partition file in the drive ===
+
 
+
'''Steps''':
+
<ol>
+
<li>Mount the stick with the interactive mount that Lubuntu has got from the file manager.</li>
+
<li>Copy the image file to the home folder. This file will contain the persistent installation on the USB-stick, which is why it's best to first copy to your system, so that's quicker in storing several thousands of files inside it:
+
<bash>rsync -a -v --progress /media/$USER/OFW11/casper-rw ~/casper-rw</bash>
+
</li>
+
<li>As root (or with {{tt|sudo}}), run:
+
<bash>mkdir /mnt/casper
+
mount -t auto ~/casper-rw /mnt/casper/ -o loop
+
</bash>
+
</li>
+
<li>The ''persistent'' home folder will now be located at {{tt|/mnt/casper/upper/home/lubuntu/}}:
+
<bash>cd /mnt/casper/upper/home/lubuntu/</bash>
+
If it doesn't exist, then create it and change ownership:
+
<bash>mkdir -p /mnt/casper/upper/home/lubuntu/
+
chown -R $USER:$USER /mnt/casper/upper/home/lubuntu/</bash>
+
</li>
+
<li>Copy the files you have on the sandbox folder into the designated folder, as explained in section [[#Cheat sheet for copying installation to USB-Stick|Cheat sheet for copying installation to USB-Stick]].</li>
+
<li>When you're done copying files to the image, make sure the ''persistent'' home folder has the correct owner permissions:
+
<bash>chown -R 999:999 /mnt/casper/upper/home/lubuntu/</bash>
+
</li>
+
<li>Then unmount it:
+
<bash>umount /mnt/casper</bash>
+
</li>
+
<li>Then copy the {{tt|casper-rw}} file back to the USB-stick:
+
<bash>rsync -a -v --progress ~/casper-rw /media/$USER/OFW11/</bash>
+
</li>
+
<li>Finally, unmount the stick:
+
<bash>umount /dev/sdX1</bash>
+
</li>
+
</ol>
+
 
+
=== Creating the bootable ISO for the virtual machine ===
+
 
+
References:
+
* http://www.syslinux.org/wiki/index.php/ISOLINUX
+
 
+
<ol>
+
<li>Install the package {{tt|genisoimage}} in your Lubuntu development system:
+
<bash>sudo apt-get install genisoimage</bash>
+
<li>Mount the USB-stick.
+
</li>
+
<li>Create a folder where you will place all files that will go into the ISO file. For example:
+
<bash>mkdir ISOroot</bash>
+
</li>
+
<li>Copy the folders {{tt|syslinux}} and {{tt|install}} from the USB-stick, into the folder {{tt|ISOroot}}, so that you get this folder structure:
+
<bash>ISOroot
+
|-- install
+
|-- syslinux
+
</bash>
+
</li>
+
<li>Copy the boot files into the folder {{tt|syslinux}}, for example:
+
<bash>cp /media/$USER/OFW11/casper/{vmlinuz.efi,initrd.lz} ISOroot/syslinux/</bash>
+
</li>
+
<li>Edit the file {{tt|ISOroot/syslinux/txt.cfg}} and change it to this:
+
<bash>default live
+
label live
+
menu label ^Try Lubuntu without installing
+
kernel /syslinux/vmlinuz.efi
+
append noprompt cdrom-detect/try-usb=true persistent file=/cdrom/preseed/lubuntu.seed boot=casper initrd=/syslinux/initrd.lz quiet splash ---
+
label live-install
+
menu label ^Install Lubuntu
+
kernel /syslinux/vmlinuz.efi
+
append noprompt cdrom-detect/try-usb=true persistent file=/cdrom/preseed/lubuntu.seed boot=casper only-ubiquity initrd=/syslinux/initrd.lz quiet splash ---
+
label check
+
menu label ^Check disc for defects
+
kernel /syslinux/vmlinuz.efi
+
append noprompt boot=casper integrity-check initrd=/syslinux/initrd.lz quiet splash ---
+
label memtest
+
menu label Test ^memory
+
kernel /install/mt86plus
+
label hd
+
menu label ^Boot from first hard disk
+
localboot 0x80
+
</bash>
+
Essentially you will be changing the paths that state {{tt|/casper/}} to {{tt|/syslinux/}}.
+
</li>
+
<li>Create the ISO file by running the following command from the parent folder where {{tt|ISOroot}} is located:
+
<bash>mkisofs -o VMbootUSB.iso    -b syslinux/isolinux.bin -c syslinux/boot.cat    -no-emul-boot -boot-load-size 4 -boot-info-table    ISOroot</bash>
+
</li>
+
<li>The final image file {{tt|VMbootUSB.iso}} is what we will need to boot the USB-stick inside the virtual machine.</li>
+
</ol>
+
 
+
 
+
=== Creating the virtual machine in Virtualbox ===
+
 
+
Keep in mind that these steps are only needed for creating the virtual machine to be placed inside the USB-stick. Nonetheless, it might be useful in case the exported OVA file is incompatible.
+
 
+
'''References''':
+
* http://askubuntu.com/a/25600
+
 
+
'''Side notes''':
+
<ul {{NoIndentStyle}}>
+
<li>On Ubuntu, had to install the necessary packages for getting the USB2/3 drivers for Virtualbox on the host side (the real machine):
+
<bash>sudo apt-get install virtualbox-ext-pack</bash>
+
And then run the following command for adding my user to the group {{tt|vboxusers}}:
+
<bash>sudo usermod -aG vboxusers $USER</bash>
+
Then I had to log out and then log back in, otherwise it's not possible to use a real USB drive in a virtual machine within Virtualbox.
+
</li>
+
</ul>
+
 
+
'''Steps''':
+
<ol>
+
<li>Simply create a new Virtual Machine in Virtualbox, meant for a Ubuntu 64-bit machine and without any disks, because we will boot straight from the USB drive.
+
</li>
+
<li>After the virtual machine is created, edit its settings and:
+
<ol>
+
<li>increase the RAM to at least 2048MB;</li>
+
<li>change from 1 to 2 virtual cores;</li>
+
<li>choose for the optical drive to use the {{tt|VMbootUSB.iso}};</li>
+
<li>probably best to turn off audio capabilities;</li>
+
<li>in the USB section, choose USB 3.0 or 2.0 controller, depending on what kind of USB-stick you're using;</li>
+
<li>still in the USB section, click on the button that adds a new USB device and choose your USB-stick.</li>
+
</li>
+
</ol>
+
<li>Boot up the VM and test it.
+
</li>
+
<li>If it works fine, do a standard shutdown within the virtual machine.
+
</li>
+
<li>Then use on the main menu for the Virtualbox the item {{tt|File -> Export Appliance...}} to export the virtual machine to a settings file to be placed inside the USB-stick, preferably with the file name  {{tt|OFW11USBVM.ova}}.
+
</li>
+
<li>Best to place both the {{tt|OFW11USBVM.ova}} and {{tt|VMbootUSB.iso}} files inside the folder {{tt|VM}} in the real USB-stick partition (i.e. not inside the booted up Live Lubuntu).
+
</li>
+
</ol>
+
 
+
 
+
 
+
== Cloning the original stick to a new image ==
+
 
+
'''Steps''':
+
<ol>
+
<li>Make sure you don't have the stick mounted! Example to umount:
+
<bash>umount /dev/sdX1</bash>
+
</li>
+
<li>As root (or with {{tt|sudo}}), run:
+
<bash>dd if=/dev/sdX of=OFW11-2016_v2.img bs=512 count=14950463</bash>
+
* The value "14950463" is the End sector count 14950462 plus 1.
+
* 14950463 sector * 512 B/sector = 7654636544 B = 7654636544 ~= 7300 MiB
+
 
+
# In another terminal (also as root), tun:
+
<bash>while killall -USR1 dd; do sleep 30; done</bash>
+
# Then look at the previous terminal window and every 30 seconds it should update on the current write status. Given how this command works, if you have more than one {{tt|dd}} running, it will update for all running {{tt|dd}} applications.
+
</li>
+
<li>When it's done cloning, make sure the file system is synced:
+
<bash>sync</bash>
+
wait until it returns control back to you.
+
</li>
+
<li>Now you can mount the stick again, if you want. Or simply eject it.</li>
+
</ol>
+
 
+
 
+
== Cloning the image to a new stick ==
+
 
+
It's almost the reverse of the previous steps:
+
<ol>
+
<li>Make sure you don't have the stick mounted! Example to umount:
+
<bash>umount /dev/sdX1</bash>
+
</li>
+
<li>As root (or with {{tt|sudo}}), run:
+
<bash>dd if=OFW11-2016_v2.img of=/dev/sdX bs=512</bash>
+
# In another terminal (also as root):
+
<bash>ps -a</bash>
+
# In another terminal (also as root), tun:
+
<bash>while killall -USR1 dd; do sleep 30; done</bash>
+
# Then look at the previous terminal window and every 30 seconds it should update on the current write status. Given how this command works, if you have more than one {{tt|dd}} running, it will update for all running {{tt|dd}} applications.
+
</li>
+
<li>When it's done cloning, make sure the file system is synced:
+
<bash>sync</bash>
+
wait until it returns control back to you.
+
</li>
+
<li>Now you can mount the stick, if you want. Or simply eject it.</li>
+
</ol>
+
  
 +
<br>
  
 +
= Full list of  sub-pages =
 +
Here is the complete  list of sub-pages for this current page, just in case something is missing when reading the manually compiled reading structure given in the chapter(s) above: {{subpages|Installation/Live Images/USB-Stick for OFW11}}
  
 
[[Category:Live OS Images]]
 
[[Category:Live OS Images]]

Latest revision as of 21:24, 13 February 2016

1 Preface

This section of the wiki (Installation/Live_Images/USB-Stick for OFW11) has been written as the most detailed as possible set of instructions on how to create, successfully massively-deploy USB-sticks and alter use those USB-sticks that run Lubuntu with the all of the OpenFOAM technology software that was available up to a few months from when the 11th OpenFOAM Workshop is/was held in 2016 at Guimarães in Portugal. Website at the time: openfoamworkshop.org

(Wyldckat (talk) 17:45, 13 February 2016 (CET): Don't forget to update when it's mirrored onto openfoam-extend's project at SourceForge.net.)


2 Objective

To make it 100% probable that everyone will be able to use OpenFOAM and foam-extend at the 11th OpenFOAM Workshop. Although this might be limited to 100% of the people that have 64-bit PCs...


3 Instructions

This is aimed at providing a fully functional USB-stick or Virtual Machine Appliance that works on VirtualBox, so that OpenFOAM and foam-extend can be accessed without going through the occasionally tough installation process. Nonetheless , keep in mind that Docker is the kind of technology that will probably supersede this kind of installation in future workshops.

The information written for this topic are spread across the following sub-pages:

User Guide
This is the User Guide meant for the people who will be trying to use these images and/or virtual machines. It also lists the software versions installed with the image designed for this workshop.
Reminders
This page is needed for the next couple of pages, because this provides the main details that should be kept at all times when following the instructions on those other pages!
Deployment Guide
This page is meant for the people responsible for the deployment phase, namely those who will be sweating to burn the image onto several dozens (if not a couple of hundred) USB sticks.
It also includes information on how to create the virtual machine appliances, in case things don't run so well when trying to use the USB-stick as a bootable drive.
Creation Guide
This is where the complete instructions for the creation of the USB-stick are written and provide as many details as possible.
Download
This is where is listed the current locations for the (virtual) disk images.
Frequently Asked Questions
This page is for the Frequently Asked Questions about this particular effort for the OFW11.


4 Full list of sub-pages

Here is the complete list of sub-pages for this current page, just in case something is missing when reading the manually compiled reading structure given in the chapter(s) above:

Installation/Live Images/USB-Stick for OFW11Installation/Live Images/USB-Stick for OFW11/Creation GuideInstallation/Live Images/USB-Stick for OFW11/Deployment Guide
Installation/Live Images/USB-Stick for OFW11/DownloadInstallation/Live Images/USB-Stick for OFW11/FAQInstallation/Live Images/USB-Stick for OFW11/Reminders
Installation/Live Images/USB-Stick for OFW11/User Guide