miqbox's Introduction

miqbox

Spin ManageIQ/CFME Appliance locally with Virtualization.

Under progress...

Prerequisite:

Virtualization:

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
```

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

Recommend Projects