MiqBox

Spin ManageIQ/CFME Appliance locally with Virtualization.

Prerequisite:

1. Virtualization:

   • Fedora

     sudo dnf install @virtualization
     systemctl start libvirtd
     systemctl enable libvirtd

     If you want optional packages

     dnf group install --with-optional virtualization

   • Ubuntu

     sudo apt-get install qemu-kvm

2. Devel Packages:

   sudo dnf install libvirt-devel python-devel python3-devel

Install:

• pip

  pip install miqbox --user

• source

  python setup.py install --user

Note: For Development install in editable mode.

Troubleshooting:

• libvirt: Polkit error
• To prevent libvirt from asking root password:
  • Add libvirt group (It may be present by default)

    sudo groupadd libvirt
    

  • Add not root user as member

    sudo usermod -a -G libvirt <username>
    

  • Add Polkit rule for libvirt:

    vim /etc/polkit-1/rules.d/80-libvirt.rules
    

    polkit.addRule(function(action, subject) {
    if (action.id == "org.libvirt.unix.manage"
        && subject.local
        && subject.active
        && subject.isInGroup("libvirt")) {
    return polkit.Result.YES;
    }
    });
    

Usage:

 Usage: miqbox [OPTIONS] COMMAND [ARGS]...
 
   Command line application entry point
 
 Options:
   --help  Show this message and exit.
 
 Commands:
   config     Configure miqbox
   create     Create Appliance
   evmserver  Restart Miq/CFME Server
   images     Get local or remote available image Args: local: default, will...
   kill       Kill Appliance
   pull       Download Image
   rmi        Remove local Image
   start      Start Appliance
   status     Appliance Status
   stop       Stop Appliance