Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


titleDon't follow these instructions

There is a script which does all of this and more automatically:

These are the instructions for creating an end-user VM from scratch.

VM Configuration

  • Using VirtualBox:
    • 1 Core
    • 3G RAM
    • 500G System Disk
    Using VirtualBox as host
    • (VDI, Dynamically Allocated)
    • Set network to "Attached to Bridged Adapter"

Base OS Install

  • Centos 6.4 x86-64
  • English language and keyboard
  • hostname: avalon-vm.localdomainlocalhost.localdomain (the default)
    • if it is localhost it should set it to the dhcp hostname provided.
  • eth0:
    • active on boot
    • ipv4 dhcp, dchp client id = avalon-vmClear "Device MAC address"
    • Connect automatically
    • IPv4 Settings
      • Automatic (DHCP)

  • set timezone to america/indiana/indianapolis, clock uses utc
  • root password is 'changeme'
  • replace existing linux system(s), default partitioning
  • desktop install
  • yum update after install.

Avalon Install / Testing

  • TBD, but will use the 'standard' installation method

VM Image Prep

  • Enable Configuration via FirstBoot
    • Firstboot will run in system reconfiguration mode
      • root password, keyboard, non-admin user re-configuration
    • Additional screens added to firstboot by creating modules in /usr/share/firstboot/modules
      • avalon EULA screen
        • EULA text in /usr/share/avalon/EULA
      • FFMPEG build screen
        •  FFMPEG build script in /usr/share/avalon/buildFFMPEG
      • Other screens to reconfigure other passwords – maybe randomize them and write the results in /root/avalon.passwords?
        • fcrepo in mysql & /usr/local/fedora somewhere
        • rails in mysql and somewhere else (config/authentication.yml)
        • fedoraAdmin password, (fedora.yml)
      • create first avalon user
  • Image Delivery Prep
    • OS Tasks
      • rm /root/.bash_history
      • touch /etc/reconfigSys
      • rm /etc/sysconfig/firstboot
      • chkconfig firstboot on
      • rpm --erase --nodeps ffmpeg
      • shutdown
    • VM Tasks
      • Export Appliance
        • OVA 0.9 legacy for compatibility
        • manifest file for checksums

VM End-User Experience

  • VM Setup
    • User downloads VM Image
    • Imports image into VirtualBox or any OVF-compliant virtualization
  • VM Startup
    • VM Wakes up and boots into graphical mode
    • before most services start up, first boot comes up
      • User is taken through the 'standard' Centos/Redhat firstboot pages
      • Plus the Avalon ones
        • avalon EULA
           Image Removed
        • ffmpeg page actually builds ffmpeg binary
          Image Removed
          Image Removed
    • system completes boot
      • avalon services are started
      • user login gui is displayed
  • TA-DA!
  • partitioning:
    • custom layout
      • /dev/sda1:  500M ext4 mounted as /boot
      • /dev/sda2:  (remainder of disk) Physical volume
      • Volume Group:  vg_avalon
        • PVs: /dev/sda2
        • LV lv_swap 2G
        • LV lv_root (remainder of disk) ext4 mounted as /
  • Desktop install
  • Reboot / Firstboot
    • Leave all of the defaults, except...
    • Do Not create a new user
  • Log in as root
    • do not check "do not show me this again" to the "you are running as root" dialog.  Just close it.
    • yum update
    • open these ports in the firewall:
      • tcp/22
      • tcp/80
      • tcp/1935
      • tcp/18080
    • clean up eth0 configuration in /etc/sysconfig/network-scripts/ifcfg-eth0:
      • remove UUID
      • remove any DHCP_CLIENT_ID

        Code Block
        egrep -v '^(UUID|DHCP_CLIENT_ID)=' /etc/sysconfig/network-scripts/ifcfg-eth0 > /etc/sysconfig/network-scripts/ifcfg-eth0
    • shut down the VM
    • at this point the vm is at "baseOS" and can be used as a cloning point

There is a bug in VirtualBox with IPv6 handling over a bridged network.  When the bug is present the top transfer speeds for IPv6 are around 18kb/s.  Since RHEL (and derivatives) prefer IPv6 when looking up hosts, it is not uncommon to get an IPv6 host address for updates.  To disable IPv6 on the guest add these lines to /etc/sysctl.conf.  VirtualBox 4.2.12 was supposed to fix it but I'm not sure it has.

Code Block
net.ipv6.conf.all.disable_ipv6 = 1
net.ipv6.conf.default.disable_ipv6 = 1

Avalon Install

    • clone the baseOS image as puppet-YYMMDD
  • Use the installation notes from Manual Installation of Avalon Using Puppet
    • When setting FACTER_* environment variables, set
      • FACTER_avalon_dropbox_password to "changeme"
      • FACTER_avalon_public_address to "localhost.localdomain"
  • HACK: maintain permissions for dropbox
    • create script /usr/local/bin/fix_dropbox_permissions with this content:

      Code Block
      chown -R avalon:dropbox /var/avalon/dropbox
      find /var/avalon/dropbox -type f -exec chmod 664 "{}" ";"
      find /var/avalon/dropbox -type d -exec chmod 2775 "{}" ";"

      and set the mode to 755.

    • set the cronjob to run every minute by adding this line:

      Code Block
      * * * * * /usr/local/bin/fix_dropbox_permissions

Demo Content

    • clone the puppet image as democontent-YYMMDD
  • Register the user in Avalon, and log in as that user.
    • this account is removed when the system is prepared for delivery.
  • Create a 'Default Collection' collection with the user.
  • Get the demo fixtures bundle

    Code Block
    cd /tmp
    tar xvzf DemoFixturesBatch.tar.gz
    chown -R avalon:dropbox DemoFixturesBatch
    chmod -R g+w DemoFixturesBatch
    mv DemoFixturesBatch /var/avalon/dropbox

    Monitor progress in Matterhorn (at http://<whatever>:18080 using the default username/password) or within Avalon.

  • Download the demo content thumbnails

    Code Block
    cd /tmp
    tar -xzvf DemoFixturesThumbnails.tar.gz
    chown -R avalon:avalon DemoFixturesThumbnails
    mv DemoFixturesthumbnails /var/www/avalon/current/app/assets/images
  • Modify /var/www/avalon/current/app/views/catalog/_home_text.html.erb and replace sample content with something like:

    Code Block
     <ul class="thumbnails">
    	<li class="span3"><h5>Featured Video</h5><a href="<%= media_object_path('avalon:1') %>" class="thumbnail" ><%= image_tag "DemoFixturesThumbnails/organClip.jpg", alt: "Featured Video" %></a></li>
    	<li class="span3"><h5>Featured Video</h5><a href="<%= media_object_path('avalon:2') %>" class="thumbnail" ><%= image_tag "DemoFixturesThumbnails/lunchroomManners.jpg", alt: "Featured Video" %></a></li>
    	<li class="span3"><h5>Featured Audio</h5><a href="<%= media_object_path('avalon:3') %>" class="thumbnail" ><%= image_tag "DemoFixturesThumbnails/mahler.jpg", alt: "Featured Audio" %></a></li>

    The values "avalon:1" to "avalon:3" should be changed to the appropriate container IDs

  • Reload the avalon application by running

    Code Block
    touch /var/www/avalon/current/tmp/restart.txt

    and verify the changes are correct.

  • Fix access permissions on all three items:
    • edit each item
      • click on the "Access Control" tab
      • click on the "Available to the general public" radio button
      • click Save
      • Click the 'Publish" button if it is available on the item view (Lunchroom Manners).
  • Remove source data

    Code Block
    rm /tmp/DemoFixturesBatch.tar.gz
    rm -rf /var/avalon/dropbox/DemoFixturesBatch

VM Image Prep

    • clone the latest democontent image as dist-YYMMDD
  • Install avalon-vm-2.0-1.noarch.rpm to install the firstboot changes and tools
  • If IPv6 was disabled during install, re-enable it by removing the lines added to /etc/sysctl.conf during BaseOS.  If these lines are not removed, email will not work.
  • Prepare the disk for compacting
    • clean up anything that's left over from the build process

      Code Block
      rm -rf /root/Downloads/* /var/avalon/dropbox/* /home/makerpm/rpmbuild /opt/staging /root/avalon-installer-flat /root/flat.tar.gz
      yum clean all
      swapoff /dev/mapper/vg_avalon-lv_swap; dd if=/dev/zero of=/dev/mapper/vg_avalon-lv_swap bs=1M; mkswap /dev/mapper/vg_avalon-lv_swap
    • deleted files still take up space on the disk image.  The disk image (as of 4/24/13) is roughly 12G in size, with 7.8G of actual data.  Write zeros to a file until the disk is full to clear out the sectors which are unallocated but had data at one point.  Since the .VDI image is sparsely allocated, the disk image size will actually grow less that 1G even though nearly 500G has been written.

      Code Block
      dd if=/dev/zero of=/tmp/foo bs=1M oflag=direct; rm /tmp/foo
  • run /usr/share/avalon/dist-prep to prepare the machine for release
  • clear the command line history  (history -cw)
  • shutdown the VM
  • Compact the disk image
    • On the host run:

      Code Block
      VBoxManage modifyhd avalon-vm-disk-YYMMDD.vdi --compact
  • Export the appliance
    • List the VMs and find the UUID of the Avalon VM

      Code Block
      VBoxManage list vms
    • Disable USB 2.0 in the VM to avoid a warning when users don't have the VirtualBox extensions loaded.

      Code Block
      VBoxManage modifyvm <machine-id> --usb off
    • VM Settings:

      ProductAvalon Media System
      Code Block
      VBoxManage export <machine-id> --output avalon-vm.ova --product "Avalon Media System" --producturl --version R2

  • copy the OVA to the distribution point
    • Make sure to set the avalon-vm.ova symlink to the current release
    • Set the permissions to 644 (they're 600 by default)