Amahi Disk-Wizard

person kasunfolder_openUncategorizedlocal_offer, access_time June 11, 2014

This post will explain and guide you through how to test the Amahi Disk-Wizard plugin. Even though Amahi is an rails based platform and Disk-Wizard plugin itself is a rails application,you might need to use a virtual machine or physical PC/Laptop dedicated for testing purpose. Since disk-wizard plugin involve in manipulating hard disk drives,testing on your working desktop PC or laptop might cause in unexpected data lost. So it is highly recommended to test the plugin in virtual environment(i.e. Vmware player). In this guide i’m using VMware player for the demonstration. There are many free virtualization tools out there(i.e. VirtualBox, VMWare Player,VirtualPC,etc..) you may select any virtualization tool as you wish. Since almost all of those tools support adding virtual hard disk drive(HDD) there won’t be any issue.

 

Setting up a test environment in VMware player

First, you have to create a new virtual machine with any available Amahi releases, we prefer to use the latest release(v0.3), tutorial on installing Amahi on a virtual machine(VM) can be found in here. After the installation make sure your DNS and internet is working on the VM(Plugin installation requires working internet connection).And it is always better to keep a snapshot of your fresh Amahi installation, to avoid future installation time, if something went wrong during the test and need re-install Amahi.

Ok, if everything is ok let’s begin the testing. The following screenshot shows the default screen which you get when you click on a VM instance.

Screenshot from 2014-06-11 14:23:35

 Default screen for VM instances

 

Default configuration of a VM will have single storage device with two partitions on it(SWAP and ROOT partitions). It is difficult to test the operations of the disk-wizard with those default configuration. So in most cases you might need to add an additional hard disk drives to your virtual machine.

 

To add new virtual hard disk drive(HDD) to VM,click on Edit virtual machine settings ,and it will popup the following settings window.

Screenshot from 2014-06-11 14:23:44

Settings window

In this settings window you click on Add  button to add a new virtual hardware.

Screenshot from 2014-06-11 14:23:48

Add Hardware Wizard

Select Hard Disk and continue the wizard

Screenshot from 2014-06-11 14:23:52

 

In next step select Create a new virtual disk and continue.

Screenshot from 2014-06-11 14:24:09

 

 

Any amount of space for the HDD can be chosen in this step and we recommend to give smallest as possible since size of the disk really doesn’t matter or effects in any testing criterias. With the completion of the wizard you can see your newly added HDD on your VM settings page.

Installation Prerequisites

Disk-wizard plugin use Twitter Bootstrap UI framework to  build its UIs because of that it requires non-conflicting CSS styles to work smoothly inside Amahi platform, and also plugins itself is a new application category on Amahi  HDA, because of those reasons

  1. It’s required to have newest release of a Rails-4 branch of the platform.Here is a link to latest release of the rails-4 branch .
    (To install from .rpm  run this command on your terminal
    sudo rpm -{i/F}vh hda-platform-7.2.15-1.x86_64.rpm )
  2. To verify that the new version has installed correctly, execute the following command:
    if fedora: rpm -q hda-platform hda-ctl
    if ubuntu: apt-cache show hda-platform | grep Version
    and it will show the current platform version.
  3. You should have application testing permissions on your amahi account in amahi.org

Installing the Disk Wizard plugin

Be sure your system meets the installation prerequisites.If everything went well then you are just one-click away from installing the plugin.Go to a http://hda/tab/apps and install the DiskWizard plugin.

Testing the Disk-Wizard plugin

 

Functionalities available with the current version(v0.3) of the disk-wizard plugin has drawn in this google docs drawing file. (You can comment on the document if you have any suggestions or feedback on the functionalities). This testing matrix  show the different paths which can follow in order to test the functionalities of the disk-wizard plugin

Possibility paths matrix
Disk Wizard test and possible operations path

 

As you can see from the diagram, paths with green boxes are already implemented functionalities, which can be tested.

 

 

Debug information page with exception row
Debug information page with exception row

 

Change the UI in confirmation step, more clear placement of buttons and table alignments.
Change the UI in confirmation step, more clear placement of buttons and table alignments.

 

 

reduce options in What would you like to do? step to one option
reduce options in What would you like to do? step to one option

 

 

Remove confusing table headers in choose file system step
Remove confusing table headers in choose file system step

 

 

Navigation buttons bring to top of the page
Navigation buttons bring to top of the page

 

 

add new debug information page
add new debug information page

 

 

New exception handler page,avoid showing spinner continuously if an exception occurs
New exception handler page,avoid showing spinner continuously if an exception occurs

 

 

 

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code class="" title="" data-url=""> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong> <pre class="" title="" data-url=""> <span class="" title="" data-url="">