Skip to content

Latest commit

 

History

History
95 lines (64 loc) · 2.94 KB

mmva-build.md

File metadata and controls

95 lines (64 loc) · 2.94 KB
Raw

Virtual Appliance Build Environment

Intro

The Medic Mobile Virtual Appliance is a 65M bootable Linux ISO that contains all the software requirements to run the Medic Mobile software stack, including Node.js, CouchDB and Gammu.

To save time building it a VMWare Virtual Machine is provided which includes all the dependencies to compile it.

You can download and boot this VM and then run make in the root account. The build takes between 30 minutes to an hour depending on your hardware and internet connection. The source code for the Linux kernel, CouchDB, Node.js, OpenSSH, etc are all downloaded and compiled.

Download

Download and untar the build VM.

curl -O https://scri.pt/get/medic-vm-builder-20130308.tar.xz
tar xvJf medic-vm-builder-20130308.tar.xz

Note: Keep the .tar.xz file around so that later you can apply patches to it.

These commands will create a directory like medic-vm-builder-20130308.vmwarevm that contains the VMWare Virtual Machine.

Build

Boot the build environment:

  • Launch VMWare
  • Drag the build VM into the Virtual Machine Library
  • Click Play to boot it
  • Choose I Copied It at the dialogue window

Once booted, login on the console as root with password vm-build and run make.

Build VM Login

When the build completes the bootable ISO is saved in /root/vm-toaster/output/image.iso. Copy this file to the host system with ssh, e.g.:

scp [email protected]:/root/vm-toaster/output/image.iso ~

Boot

Use VMWare to boot the freshly built ISO image:

  • Start VMWare
  • Click New or the plus icon and New option to create a new virtual machine
  • Click Continue Without Disc
  • Click Choose a disc image… twice
  • Navigate to location of image.iso and select it
  • Select Operating System: Linux
  • Select Version: Other Linux 2.6.x kernel
  • Choose Finish to launch the VM

Once finished booting you should see a status screen similar to this:

Medic Mobile Virtual Appliance

Setup

The final step is to set a password for the system:

  • Navigate your browser to the advertised IP address.
  • Enter a password and optionally public SSH key.
  • Click Save

This sets the password (and optionally authorized ssh key) for a vm Unix account and creates an admin user for CouchDB with username admin.

The root user login is disabled by default, but the vm account has root access via the sudo command. SSH is available on port 33696. You can ssh in similar to below:

$ ssh -p 33696 [email protected]
[email protected]'s password: 
vm@toaster:~$

CouchDB is listening on port 5984 and only accessible with authentication, the username is admin and uses the same password as the vm user. Test your access:

$ curl -u admin http://192.168.213.129:5984/
Enter host password for user 'admin':
{"couchdb":"Welcome","version":"1.2.0"}

Enjoy!