Microsoft has just released a new Insider version of Project Honolulu (version 1802 as of writing this article) which can be downloaded from here. You will need to be a member of the Windows server insiders program. With this new version, we now have the ability to install it on a failover cluster. This will give us the high availability we have all been crying out for. Microsoft’s solution is an Active-Passive solution. This means that one node will be active and then will gracefully failover to another node when needed. Below I will go through the steps you need to take to install Honolulu on a failover cluster.
There are a few prerequisites before we can go ahead and they are:
- A Windows Server Failover Cluster comprising of at least 2 nodes.
- At least 10GB of storage on a Cluster Shared Volume (CSV) to store the persistent data used by Honolulu
- The new High-availability install scripts made by Microsoft on a cluster node. They can be downloaded from here.
- The Project Honolulu MSI downloaded from the link at the top of this article and saved into the same folder as the scripts from above.
- A signed certificate .pfx in the directory of the above scripts and password. Now this one is recommended for production, but as I am just going to do this in my lab I will not be using this. Instead, I will be going down the self-signed root.
Open PowerShell With Elevated Permissions
Navigate to the location you saved the scripts. In my lab, I have them under c:\Scripts. And then type the following command. Just make sure you change the -ClusterStorage and -ClientAccessPoint to what you need and also change the name of the MSI to match.
|.\Install-HonoluluHA.ps1 -clusterStorage C:\ClusterStorage\Volume1 -clientAccessPoint PixelRobots-Management -msiPath '.\ServerManagementGateway.msi' -generateSslCert|
If you have a certificate you would like to use then you can use the following command. Just make sure you change the -ClusterStorage, -ClientAccessPoint, CertPath and -CertPassword to what you need and also change the name of the MSI to match.
|.\Install-HonoluluHA.ps1 -clusterStorage C:\ClusterStorage\Volume1 -clientAccessPoint PixelRobots-Management -msiPath '.\ServerManagementGateway.msi' -certPath cert.pfx -certPassword certPassword|
- -clusterStorage: the local path of the Cluster Shared Volume to store Project Honolulu data
- -clientAccessPoint: choose a name that you will use to access Project Honolulu. For example, if you run the script with the parameter -clientAccessPoint PixelRobots-Management , you will access the Project Honolulu service by visiting https://PixelRobots-Management.
- -msiPath: The path for the Project Honolulu .msi file.
- -certPath: Optional. The path for a certificate .pfx file.
- -certPassword: Optional. The password for the certificate .pfx provided in -certPath
- -generateSslCert: Optional. If you do not want to provide a signed certificate, include this parameter flag to generate a self-signed certificate. Note that the self-signed certificate will expire in 90 days.
- -portNumber: Optional. If no port is specified, the gateway service will be deployed on port 443 (HTTPS). If you wish to use a different port, specify in this parameter. Note that if you use a custom port (anything besides 443).
If you navigate to C:\ClusterStorage\Volume1 you will notice a new folder called Server Management Experience.
If you have a look in failover cluster manager you will now see a new role. If you do not have a DHCP server you will need to manually set the IP address of this new role.
You can now navigate to Honolulu via your web browser. Just don’t use internet explorer.
Upgrade an Existing Installation
This bit is easy, but as of writing, there is no new MSI so I will not be able to show any pictures. I may come back and update this section when the next insider release is released.
First, we have to download the latest version of Project Honolulu and save it to the same location as the scripts from above.
In an Elevated PowerShell window navigate to the location you have the scripts from above stored and run the following PowerShell.
|.\Update-HonoluluHA.ps1 -msiPath '.\ServerManagementGateway.msi'|
Uninstall Project Honolulu from a Failover Cluster
This bit is even easier than an upgrade. Just open an Elevated PowerShell window and navigation to the location of the scripts downloaded from before and then run the following PowerShell.
This is a feature of Honolulu I have been waiting for. I am really excited about what Microsoft is doing here. If you have any questions or just want to say how much you love project Honolulu leave a comment below.
I’m Richard Hooper aka Pixel Robots. I started this blog in 2016 for a couple reasons. The first reason was basically just a place for me to store my step by step guides, troubleshooting guides and just plain ideas about being a sysadmin. The second reason was to share what I have learned and found out with other people like me. Hopefully, you can find something useful on the site.