Mounting Custom Displays via SMB Using Rancher

You can use Rancher to enable sharing and displaying custom displays in your WebHMI deployment via the SMB protocol.

To mount custom displays to the WebHMI pods via SMB using Rancher:

  1. Install the SMB CSI driver in your cluster.

  2. Add a repository to the cluster.

    1. In your cluster view, navigate to Apps > Repositories and select Create .

    2. In the new repository dialog, enter the following details, and then click Create to add the repository.

  3. Install the SMB Helm chart.

    1. In your cluster view, navigate to Apps > Charts .

    2. In Repository , select the repository you added in step 2.

    3. Select the csi-driver-smb chart to open its details, and then click Install to start the guided two-step installation process.

    4. Select the kube-system namespace, enter a descriptive name, such as smb , and then click Next .

    5. Leave the default configuration and click Install .

  4. Create a secret with the SMB credentials.

    1. In your cluster view, navigate to Storage > Secrets , click Create , and Select Opaque .

    2. Enter a name, such as smb-credentials . Leave namespace as default .

    3. In Data, complete the following settings, and then click Create.

      • Key: username , Value: <smb_username> (Use the SMB user account.)

      • Key: password , Value: <smb_password> (Use the SMB password.)

      • Key: domain , Value: <smb_domain> (Optional; required if the server uses Active Directory authentication.)

  5. Edit the WebHMI configuration.

    1. In your WebHMI cluster view, navigate to Apps > Installed Apps and select the WebHMI Helm release.

    2. Select Edit/Upgrade to start the guided two-step installation process, leave the first step as is, and click Next.

    3. On the Edit Options tab, select Storage for Displays, and enable Use SMB Storage.

  6. Enter the following details, and then click Upgrade for the changes to take effect.

    • mountDirName—Name of the directory where the share will be mounted inside the WebHMI container. This name becomes part of the display URL, for example:

      http://webhmi.example.com/displays/my-display.gdfx

    • source —The SMB share path in the //smbserver/path/to/displays form.

    • secretName —The name of the Kubernetes secret with SMB credentials that you created in step 4.

    • secretNamespace —The name of the space where the SMB secret is located, typically default .

  7. After the deployment finishes, verify that you can access your displays in the browser, for example:

    https://webhmi.example.com/displays/my-display.gdfx