https://github.com/digitronik/miqbox

Spin ManageIQ/CFME Appliance locally
https://github.com/digitronik/miqbox

Last synced: 3 months ago
JSON representation

Spin ManageIQ/CFME Appliance locally

• Host: GitHub
• URL: https://github.com/digitronik/miqbox
• Owner: digitronik
• License: other
• Created: 2018-12-01T08:28:30.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2021-04-23T07:48:20.000Z (over 3 years ago)
• Last Synced: 2024-10-07T07:07:18.273Z (3 months ago)
• Language: Python
• Size: 131 KB
• Stars: 5
• Watchers: 3
• Forks: 8
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
 MiqBox 

 Spin ManageIQ/CFME Appliance locally with Virtualization. 




    

    

    

    

    

    



### Prerequisite

1. Virtualization:

    - [Fedora](https://docs.fedoraproject.org/en-US/quick-docs/getting-started-with-virtualization/)

        ```bash

        sudo dnf install @virtualization

        systemctl start libvirtd

        systemctl enable libvirtd

        ```

        If you want optional packages

        ```bash

        dnf group install --with-optional virtualization

        ```

    - [Ubuntu](https://help.ubuntu.com/community/KVM/Installation)

        ```bash

        sudo apt-get install qemu-kvm

        ```

2. Devel Packages:

    ```bash

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

    ```

### Install

- pip

    ```bash

    pip install miqbox --user

    ```

- source

    ```bash

    python setup.py install --user

    ```

### Troubleshooting

- [libvirt: Polkit error](https://fedoraproject.org/wiki/QA:Testcase_Virt_ACLs)

- To prevent `libvirt` from asking `root` password:

    - Add `libvirt` group (It may be present by default)

        ```bash

        sudo groupadd libvirt

        ```

    - Add not root `user` as member

        ```bash

        sudo usermod -a -G libvirt 

        ```

    - Add `Polkit` rule for `libvirt`:

        ```bash

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

        ```

        ```bash

        polkit.addRule(function(action, subject) {

        if (action.id == "org.libvirt.unix.manage"

            && subject.local

            && subject.active

            && subject.isInGroup("libvirt")) {

        return polkit.Result.YES;

        }

        });

        ```

### Usage

- Help available with `MiqBox`

   ```bash

    Usage: miqbox [OPTIONS] COMMAND [ARGS]...

      Spin ManageIQ/CFME Appliance locally with Virtualization.

    Options:

      --version  Show the version and exit.

      --help     Show this message and exit.

    Commands:

      config     Configure MiqBox

      create     Create Appliance

      evmserver  Restart Miq/CFME Server

      images     Check available images

      kill       Kill Appliance

      pull       Download Image

      rmi        Remove local Images

      start      Start Appliance

      status     Appliance Status

      stop       Stop Appliance

   ```

### Contribute

- Fork the [repository](https://github.com/digitronik/miqbox.git) on GitHub

and make some changes. Make sure to add yourself to [AUTHORS](AUTHORS.md).

- Install the in development mode

    ```bash

    pip install -r requirements-dev.txt

    pip install -e .

    ```

- Send pull requests and bugs.