Difference between revisions of "Regular and High-Availability mode for openQRM"

From openQRM
Line 1: Line 1:
 
[[Category:Tutorial]]
 
[[Category:Tutorial]]
 
[[Category:High-Availability]]
 
[[Category:High-Availability]]
 +
This HowTo is about how to easily setup the openQRM Enterprise Appliance in regular and high-availability mode.
 +
 +
=== openQRM Enterprise Appliance network configuration ===
 +
System User: root
 +
 +
Password: openqrm
 +
 +
openQRM UI User: openqrm
 +
 +
Password: openqrm
 +
 +
First network card: dhcpd
 +
 +
Virtual openQRM interface: static IP 192.168.11.2 (Class C)
 +
 +
In most cases (depending on your network infra-structure) the openQRM Enterprise Appliance will automatically get an IP address from a "dhcpd" server in your network. To check which IP address it got please use a VNC-viewer to login to the VM console, login as root (passowrd: openqrm) and run "ifconfig -a"
 +
 +
=== Install a physical System with Debian as KVM Host ===
 +
Install a minimal Debian on a physical Server.
 +
 +
=== Unpack the openQRM Enterprise Appliance and run the installer ===
 +
In a console as root user please unpack the openQRM Enterprise Appliance and run the installier
 +
 +
openQRM Enterprise Appliance installer welcome screen
 +
 +
Accept the License agreement
 +
 +
Choose VM size
 +
 +
Choose openQRM Enterprise Appliance VM installation directory
 +
 +
Provide the mac address for the VM
 +
 +
Provide the path to the qemu-ifup tool
 +
 +
Select the VNC port to access the openQRM Enterprise Appliance VM console
 +
 +
Choose the VNC keymap
 +
 +
Confirm the installation of the openQRM Enterprise Appliance
 +
 +
The installer now sets up the openQRM Enterprise Appliance
 +
 +
Preparation of the openQRM Enterprise Appliance init script
 +
 +
Successfully set the openQRM Enterprise Appliance
 +
 +
Start the openQRM Enterprise Appliance
 +
 +
openQRM Enterprise Appliance started and ready to use. You can now also connect to the given VNC port with "vncviewer"
 +
 +
To further adapt the openQRM Enterprise Appliance please check its config file at /etc/openqrm-appliance.conf
 +
 +
Now open a browser to http://[ip-address-of-the-openqrm-appliance]/openqrm
 +
 +
On initial start the License manager will appear.
 +
 +
Please select the license files and submit
 +
 +
Your openQRM Enterprise Appliance up + running!
 +
 +
=== openQRM Enterprise Appliance High-Availability Setup ===
 +
To use the openQRM Enterprise Appliance in High-Availability mode a second physical system is required. Both system must have shared (or distributed) storage location used to store the openQRM Enterprise Appliance VM. Simply install the openQRM Enterprise on both systems with the same configuration and choose the shared (or distributed) storage to store the openQRM Enterprise Appliance VM. Also make sure to use exact the same MAC address for the installation on both systems.
 +
 +
Repeat the steps above on a second system. Please make sure to use the exact same MAC address for the openQRM Enterprise Appliance as for the first node.
 +
 +
On the second system the installer will detect that the openQRM Enterprise Appliance VM is already existing on the shared storage location. Please select "No" to not overwrite it.
 +
 +
After the installation on the second system please do NOT star the openQRM Enterprise Appliance
 +
 +
On the first system please run the "openQRM-Enterprise-Appliance-HA-cluster-setup"
 +
 +
Press ENTER on the welcome screen
 +
 +
Accept the openQRM Enterprise License agreement
 +
 +
Preparing the HA setup
 +
 +
Provide the hostname of the first system
 +
 +
Provide the IP address of the first system
 +
 +
If the /etc/hosts entry are not existing yet the installer will notify about it ...
 +
 +
... and suggest a solution
 +
 +
Please confirm the /etc/hosts adaptions
 +
 +
Now provide the hostname of the second system
 +
 +
And the IP address of the second system
 +
 +
The second system is now going to be added to /etc/hosts
 +
 +
Please confirm the /etc/hosts adaptions
 +
 +
Successfully setup on the first system
 +
 +
Here the installer removes the openQRM Enterprise Appliance from regular init since it will be managed by "corosync/pacemaker" now.
 +
 +
To start a graphical High-availability Manager please run on one of the two nodes: "openQRM-Enterprise-Appliance-HA-cluster-admin"
 +
 +
Please notice that this will require either a graphical Desktop setup or X-forwarding!
 +
 +
Here the console view of "crm_mon"
 +
 +
Now please repeat those HA-setup steps on the second system.
 +
 +
Here "crm_mon" after setting up the second system.
 +
 +
Starting the graphical High-availability Manager on one of the two nodes by running: "openQRM-Enterprise-Appliance-HA-cluster-admin. Click on "connect"
 +
 +
Accept the ssh-key fingerprints
 +
 +
Login as "root" with the password "openqrm"
 +
 +
The openQRM Enterprise HA Cluster overview
 +
 +
With a right-click on the "openqrm-appliance" resource you can manage it e.g. migrate it to the other system.
 +
 +
= Congratulations! =
 +
You have successfully made it through this howto!
 +
 +
We hope you have enjoyed it!
 +
 +
Your openQRM Enterprise Team
 +
 +
 +
= Links =
 +
 +
* openQRM Community - <nowiki>http://www.openqrm.com/</nowiki>
 +
* openQRM Project at sourceforge - sourceforge.net/projects/openqrm/
 +
* openQRM Enterprise - <nowiki>http://www.openqrm-enterprise.com/</nowiki>
 +
* openQRM at Twitter - <nowiki>https://twitter.com/openQRM</nowiki>
 +
* openQRM at Facebook - <nowiki>https://www.facebook.com/openQRM</nowiki>

Revision as of 12:58, 2 November 2020

This HowTo is about how to easily setup the openQRM Enterprise Appliance in regular and high-availability mode.

openQRM Enterprise Appliance network configuration

System User: root

Password: openqrm

openQRM UI User: openqrm

Password: openqrm

First network card: dhcpd

Virtual openQRM interface: static IP 192.168.11.2 (Class C)

In most cases (depending on your network infra-structure) the openQRM Enterprise Appliance will automatically get an IP address from a "dhcpd" server in your network. To check which IP address it got please use a VNC-viewer to login to the VM console, login as root (passowrd: openqrm) and run "ifconfig -a"

Install a physical System with Debian as KVM Host

Install a minimal Debian on a physical Server.

Unpack the openQRM Enterprise Appliance and run the installer

In a console as root user please unpack the openQRM Enterprise Appliance and run the installier

openQRM Enterprise Appliance installer welcome screen

Accept the License agreement

Choose VM size

Choose openQRM Enterprise Appliance VM installation directory

Provide the mac address for the VM

Provide the path to the qemu-ifup tool

Select the VNC port to access the openQRM Enterprise Appliance VM console

Choose the VNC keymap

Confirm the installation of the openQRM Enterprise Appliance

The installer now sets up the openQRM Enterprise Appliance

Preparation of the openQRM Enterprise Appliance init script

Successfully set the openQRM Enterprise Appliance

Start the openQRM Enterprise Appliance

openQRM Enterprise Appliance started and ready to use. You can now also connect to the given VNC port with "vncviewer"

To further adapt the openQRM Enterprise Appliance please check its config file at /etc/openqrm-appliance.conf

Now open a browser to http://[ip-address-of-the-openqrm-appliance]/openqrm

On initial start the License manager will appear.

Please select the license files and submit

Your openQRM Enterprise Appliance up + running!

openQRM Enterprise Appliance High-Availability Setup

To use the openQRM Enterprise Appliance in High-Availability mode a second physical system is required. Both system must have shared (or distributed) storage location used to store the openQRM Enterprise Appliance VM. Simply install the openQRM Enterprise on both systems with the same configuration and choose the shared (or distributed) storage to store the openQRM Enterprise Appliance VM. Also make sure to use exact the same MAC address for the installation on both systems.

Repeat the steps above on a second system. Please make sure to use the exact same MAC address for the openQRM Enterprise Appliance as for the first node.

On the second system the installer will detect that the openQRM Enterprise Appliance VM is already existing on the shared storage location. Please select "No" to not overwrite it.

After the installation on the second system please do NOT star the openQRM Enterprise Appliance

On the first system please run the "openQRM-Enterprise-Appliance-HA-cluster-setup"

Press ENTER on the welcome screen

Accept the openQRM Enterprise License agreement

Preparing the HA setup

Provide the hostname of the first system

Provide the IP address of the first system

If the /etc/hosts entry are not existing yet the installer will notify about it ...

... and suggest a solution

Please confirm the /etc/hosts adaptions

Now provide the hostname of the second system

And the IP address of the second system

The second system is now going to be added to /etc/hosts

Please confirm the /etc/hosts adaptions

Successfully setup on the first system

Here the installer removes the openQRM Enterprise Appliance from regular init since it will be managed by "corosync/pacemaker" now.

To start a graphical High-availability Manager please run on one of the two nodes: "openQRM-Enterprise-Appliance-HA-cluster-admin"

Please notice that this will require either a graphical Desktop setup or X-forwarding!

Here the console view of "crm_mon"

Now please repeat those HA-setup steps on the second system.

Here "crm_mon" after setting up the second system.

Starting the graphical High-availability Manager on one of the two nodes by running: "openQRM-Enterprise-Appliance-HA-cluster-admin. Click on "connect"

Accept the ssh-key fingerprints

Login as "root" with the password "openqrm"

The openQRM Enterprise HA Cluster overview

With a right-click on the "openqrm-appliance" resource you can manage it e.g. migrate it to the other system.

Congratulations!

You have successfully made it through this howto!

We hope you have enjoyed it!

Your openQRM Enterprise Team


Links

  • openQRM Community - http://www.openqrm.com/
  • openQRM Project at sourceforge - sourceforge.net/projects/openqrm/
  • openQRM Enterprise - http://www.openqrm-enterprise.com/
  • openQRM at Twitter - https://twitter.com/openQRM
  • openQRM at Facebook - https://www.facebook.com/openQRM