You are here

A Virtual Virtual Library

Submitted by sverma on Mon, 2012-06-25 10:57

This is a virtual (as in digital) library, running inside a virtual machine. So, the title isn't a typo smiley

This is a joint effort between me and Alex Kleider, who helped me debug, test and document the endeavor (or endeavour, as Alex would put it). The documentation and virtual machine took shape, largely driven by our need to have the Pathagar Book Server running on a DreamPlug for Madagascar. To that end, we sat down and installed Pathagar on a virtual machine and documented the steps. We used James Simmons' instructions as a starting point. While the original Pathagar application was written by Sayamindu Dasgupta and Kushal Das, we used Manuel Quinones' version that has some more tweaks and fixes.

To get started:

  1. Grab and install a copy of your favorite virtualization platform such as VMPlayer or Virtualbox. I use VirtualBox under Ubuntu 12.04 LTS, which is where I built this VM (VM itself is a Ubuntu 12.04 LTS 32 bit server build). Your experience with other VM environments may vary.
  2. Download the OVA file from http://dev.laptop.org/~sverma/pathagar/vm-pathagar.ova.zip
  3. Check the md5sum hash of the file. md5sum of the vm-pathagar.ova.zip file is 61102e9ca59aa34008d3163aa5dde8fc. After you unzip the file, md5sum of the vm-pathagar.ova file should be ce6414f6c7b1c901211fc5f366a9e135
  4. In VirtualBox, go to File | Import Appliance and point to the OVA file. This will import the VM into your machine. Be sure to adjust the RAM etc. to your liking. I’ve set it at 1024MB.
  5. Before you start your VM, go into Machine | Settings and check the Network settings. Bridge the VM's interface to your network's interface. When testing this on my laptop, I bridge the network to wlan0, which talks to my Wi-Fi network at home. The VM is set to expect an IP address via DHCP from this interface.
  6. Start your VM. When booted up, login as pat. Password is pat::hagar
  7. As a responsible citizen, change the password to your liking.
  8. ifconfig will give you your VM's IP address. Go to a browser on your network (host machine or other computer) and plug in your IP in the browser. You should be looking at Pathagar's opening page with a few preloaded books.
  9. To administer the book server, go to <IP address>/admin and log in as bsadmin (password bs::admin). Create accounts as you see fit.
  10. To simply add books, log in using the "Login" link on the upper right of the Pathagar page, and add books using the "Add Books" link on the upper right as well.