In this documentation, we will look at :
- What ManageIQ is
- How to install it
- How to configure it
- A CentOS machine with 8 GB RAM.
- Docker installed and configured on the machine and a basic understanding of how it works.
- A basic understanding of any Cloud Provider like OpenStack, AWS, or Azure.
What is ManageIQ?
ManageIQ is an open-source CMP (Cloud Management Platform) that was initially developed by Red Hat open-source community. It is a centralized management suite to manage your cloud providers, infrastructure providers, containers and several other technologies.
Below is a list of all the technologies you can manage using ManageIQ
|Platform Type||Supported platforms|
|Virtualization||VMware vSphere, System Center Virtual Machine Manager|
|Private Cloud||OpenStack, LenovoXClarity|
|Public Cloud||Amazon Web Services, Microsoft Azure, Google Cloud Platform|
|Software defined networking||OpenStack Neutron|
|Containers||Kubernetes, OpenShift Origin|
|Automation/configuration||Ansible Tower, Foreman|
Below is a list of all the potential use cases of ManageIQ:
Note: CloudForms is a commercial Cloud Management Platform that Red Hat makes available to its customers under a subscription model. CloudForms is extensively QE’d by Red Hat, and comes with enterprise grade support, certifications, legal indemnity, a stable life cycle of (currently) 3 years, and some certified content.
Understanding the Enterprise architecture of ManageIQ
In order to provide scaling capabilities, ManageIQ brings forth the concept of appliance.
An appliance, also known as server or my server is a virtual machine with the ManageIQ executable code. Appliances facilitate horizontal scalability as you can set up appliances to perform functions.
A group of appliances are called a zone. Some examples of zones could be possibly configured are:
- UI Zone
- Reporting Zone
- Test Zone
- Production Zone
Please note these examples are configured as per specific functionalities, it is completely up to the user how they want to configure them.
A collection of zones is a region. A region is a full installation of ManageIQ, containing one database appliance, and potentially many other appliances.
In the example, we have one region, two Zone (A & B), and 4 Appliances (App1 1, App1 2, App1 3, App1 4) with the database being configured in App1 1
Installing ManageIQ using Docker
There are several ways to install ManageIQ, however this documentation will be covering the easiest way to install it, that is, through docker.
- Ensure the the Docker service is running
- $ sudo service docker start
- Pull the Docker Image
- $ sudo docker pull manageiq/manageiq:hammer-1
- Run the container
- $ sudo docker run -d -p 8443:443 manageiq/manageiq:hammer-1
- Check if the container is successfully running
- $ sudo docker ps -a
You should get an output similar to this:
Note: It is important to pull and run the manageiq/manageiq:hammer-1 image because the other iterations are either unstable or outdated.
To access the ManageIQ console, in the URL tab, type:
The default username and password are admin and smart VM
- Ensure that the IP address of your VM is configured correctly
- The recommended browser to access the web interface is Mozilla Firefox
- It is important to use https and not http when you type the URL in the browser.
Once you have successfully installed ManageIQ and can access the browser from the interface, we have to configure it.
- Skipping this configuration will hinder all the successive steps so please make sure to follow them
- Another important aspect to note here is that we have used docker to install ManageIQ , so a database is created by default. If we use any other method, further steps have to be taken to ensure that the database is configured.
- If everything has been properly configured, you should see this screen:
- Select Administrator | EVM at the top right corner and select Configuration from the drop-down.
- You should see this screen:
- Under Server Control, enable Capacity & Utilization Coordinator, Capacity & Utilization Data Collector and Capacity & Utilization Data Processor.
- Additional configurations like Company Name and Appliance Name, etc. can be configured as per requirements.