Add instructions on installing WebMKS on containers

Author: agrare

_includes/installing-vmware-webmks-containers.md

@@ -0,0 +1,51 @@
+### Installing VMware WebMKS on containers
+
+VMware vSphere Virtual Machine Remote console access requires the installation of the VMware WebMKS SDK.
+Due to license restrictions this SDK cannot be built in to {{ site.data.product.title_short }}
+
+To install the WebMKS SDK on containers we can take an existing container and create another layer on top of it.  Once built, this image will need to be pushed to a registry and the CR updated to reflect that.
+
+1. Download the latest WebMKS version (e.g. `WebMKS_SDK_{version}.zip`) from the VMware website.
+
+2. Set up a temporary directory where we will build the image
+
+   ```bash
+   $ mkdir -p /tmp/webmks_container/container-assets
+   ```
+
+3. Copy the tar file into the container-assets directory.  For example,
+
+   ```bash
+   $ unzip ~/Downloads/WebMKS_SDK_*.zip -d /tmp/webmks_container/container-assets
+   ```
+
+4. Add the following Dockerfile as `/tmp/webmks_container/Dockerfile` and substitute the second `FROM` based on the image and version that you're running.
+
+   ```dockerfile
+   FROM registry.access.redhat.com/ubi8/ubi as webmks
+
+   COPY container-assets/ /webmks/
+
+   ################################################################################
+
+   ### IMPORTANT: Modify the following image and tag as necessary to reflect the version that you're running
+   FROM your_registry.example.com/namespace/manageiq-ui-worker:latest
+
+   COPY --from=webmks /webmks/ /var/www/miq/vmdb/public/webmks
+   ```
+
+5. Build the image and tag it appropriately for your registry, then push it to the registry.
+
+   ```bash
+   $ cd /tmp/webmks_container/
+   $ docker build . -t your_registry.example.com/namespace/manageiq-ui-worker:latest_webmks
+   $ docker push your_registry.example.com/namespace/manageiq-ui-worker:latest_webmks
+   ```
+
+6. Update the CR to use the UI worker image you just pushed to the registry.
+
+   ```yaml
+   uiWorkerImage: your_registry.example.com/namespace/manageiq-ui-worker:latest_webmks
+   ```
+
+The operator will now update the orchestrator and worker deployments to reflect this change.

_includes/installing-vmware-webmks.md

@@ -0,0 +1,16 @@
+## Installing VMware WebMKS on appliances
+
+VMware vSphere Virtual Machine Remote console access requires the installation of the VMware WebMKS SDK.
+Due to license restrictions this SDK cannot be built in to {{ site.data.product.title_short }}
+
+1.  Log in to the {{ site.data.product.title_short }} user interface appliance
+    console as the root user.
+
+2.  On the {{ site.data.product.title_short }} user interface appliances, create a
+    folder titled `webmks` in the `/var/www/miq/vmdb/public/` directory.
+
+        /var/www/miq/vmdb/public/webmks
+
+3.  Download and extract the contents of [VMware WebMKS
+    SDK](https://www.vmware.com/support/developer/html-console/) into
+    the `webmks` folder.

installing_on_kubernetes/index.md

@@ -31,6 +31,8 @@
 
 {% include installing-vmware-vddk-containers.md %}
 
+{% include installing-vmware-webmks-containers.md %}
+
 # Uninstalling
 
 {% include_relative _topics/uninstalling.md %}

installing_on_vmware_vsphere/_topics/additional_configuration.md

@@ -1,6 +1,7 @@
 ## Additional Configuration for Appliances on VMware vSphere
 
 {% include installing-vmware-vddk.md %}
+{% include installing-vmware-webmks.md %}
 
 ### Tuning Appliance Performance
 

managing_infrastructure_and_inventory/_topics/vnc_and_spice_consoles.md

@@ -129,22 +129,7 @@ machines that will be accessed through the HTML5 or VNC console on the
 
 7.  Click **OK**.
 
-## Configuring VMware WebMKS Support
-
-Complete the following steps to enable WebMKS support in
-{{ site.data.product.title_short }}.
-
-1.  Log in to the {{ site.data.product.title_short }} user interface appliance
-    console as the root user.
-
-2.  On the {{ site.data.product.title_short }} user interface appliances, create a
-    folder titled `webmks` in the `/var/www/miq/vmdb/public/` directory.
-
-        /var/www/miq/vmdb/public/webmks
-
-3.  Download and extract the contents of [VMware WebMKS
-    SDK](https://www.vmware.com/support/developer/html-console/) into
-    the `webmks` folder.
+{% include installing-vmware-webmks.md %}
 
 ## Opening a Console for a Virtual Machine