Difference between revisions of "Regular and High-Availability mode for openQRM"
Line 26: | Line 26: | ||
openQRM Enterprise Appliance installer welcome screen | openQRM Enterprise Appliance installer welcome screen | ||
− | + | [[File:02-oqapp.png|none|thumb|390x390px|Welcome Screen]] | |
Accept the License agreement | Accept the License agreement | ||
− | + | [[File:03-oqapp.png|none|thumb|390x390px|Accept Licence agreement]] | |
Choose VM size | Choose VM size | ||
− | + | [[File:05-oqapp.png|none|thumb|390x390px|VM Size]] | |
Choose openQRM Enterprise Appliance VM installation directory | Choose openQRM Enterprise Appliance VM installation directory | ||
− | + | [[File:06-oqapp.png|none|thumb|390x390px|Choose VM installation directory]] | |
Provide the mac address for the VM | Provide the mac address for the VM | ||
− | + | [[File:07-oqapp.png|none|thumb|390x390px|Provide MAC address]] | |
Provide the path to the qemu-ifup tool | Provide the path to the qemu-ifup tool | ||
− | + | [[File:08-oqapp.png|none|thumb|390x390px|Directory to qemu-ifup tool]] | |
Select the VNC port to access the openQRM Enterprise Appliance VM console | Select the VNC port to access the openQRM Enterprise Appliance VM console | ||
− | + | [[File:09-oqapp.png|none|thumb|390x390px|Select VNC port]] | |
Choose the VNC keymap | Choose the VNC keymap | ||
− | + | [[File:10-oqapp.png|none|thumb|390x390px|Select VNC keymap]] | |
Confirm the installation of the openQRM Enterprise Appliance | Confirm the installation of the openQRM Enterprise Appliance | ||
− | + | [[File:11-oqapp.png|none|thumb|390x390px|Confirm Installation]] | |
The installer now sets up the openQRM Enterprise Appliance | The installer now sets up the openQRM Enterprise Appliance | ||
− | + | [[File:12-oqapp.png|none|thumb|390x390px|Installer setting up Appliance]] | |
− | |||
− | |||
− | |||
− | |||
Start the openQRM Enterprise Appliance | Start the openQRM Enterprise Appliance | ||
− | + | [[File:15-oqapp.png|none|thumb|390x390px|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" | openQRM Enterprise Appliance started and ready to use. You can now also connect to the given VNC port with "vncviewer" | ||
− | + | [[File:16-oqapp.png|none|thumb|390x390px|Appliance has started and is ready to use]] | |
− | |||
− | |||
Now open a browser to http://[ip-address-of-the-openqrm-appliance]/openqrm | Now open a browser to http://[ip-address-of-the-openqrm-appliance]/openqrm | ||
+ | [[File:19-oqapp.png|none|thumb|390x390px|Open Browser]] | ||
+ | On initial start the License manager will appear. Please select the license files and submit | ||
+ | [[File:21-oqapp.png|none|thumb|390x390px|Select licence files]] | ||
+ | Your openQRM Enterprise Appliance is up and running! | ||
− | + | === 3. openQRM Enterprise Appliance High-Availability Setup === | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | === 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. | 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 | + | Repeat the steps in section 2 on a second system. Please make sure to use the exact same MAC address for the openQRM Enterprise Appliance as for the first node. |
− | + | [[File:23-oqapp.png|none|thumb|390x390px|Use same MAC address]] | |
− | + | However, 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. | |
− | + | [[File:24-oqapp.png|none|thumb|390x390px|Select No]] | |
− | After the installation on the second system | + | After the installation on the second system, do NOT start the openQRM Enterprise Appliance |
− | + | [[File:25-oqapp.png|none|thumb|390x390px|Do not start Appliance]] | |
On the first system please run the "openQRM-Enterprise-Appliance-HA-cluster-setup" | On the first system please run the "openQRM-Enterprise-Appliance-HA-cluster-setup" | ||
− | + | [[File:26-oqapp.png|none|thumb|390x390px|Run on first system]] | |
Press ENTER on the welcome screen | Press ENTER on the welcome screen | ||
− | + | [[File:27-oqapp.png|none|thumb|390x390px|Press Enter]] | |
Accept the openQRM Enterprise License agreement | Accept the openQRM Enterprise License agreement | ||
+ | [[File:28-oqapp.png|none|thumb|390x390px|Accept Agreement]] | ||
Preparing the HA setup | Preparing the HA setup |
Revision as of 10:34, 9 November 2020
This How-To 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 (password: openqrm) and run "ifconfig -a"
1. Install a physical System with Debian as KVM Host
Install a minimal Debian on a physical Server.
2. Unpack the openQRM Enterprise Appliance and run the installer
In a console as root user please unpack the openQRM Enterprise Appliance and run the installer
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
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"
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 is up and running!
3. 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 in section 2 on a second system. Please make sure to use the exact same MAC address for the openQRM Enterprise Appliance as for the first node.
However, 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, do NOT start 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 How-To!
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