• Remote DX - Client Device Metrics

    ControlUp extends our monitoring capabilities by enabling you to now monitor remote client devices when they are logged into your virtual network. ControlUp's 'last mile' digital experience monitoring gives you increased visibility and control over your employee's client devices independent of where they work, whether in the office, from home or on the road, or the type of workspace they use, which could be virtual, physical, or cloud.

    You can see metrics on how well the device's connections are performing when your end users are remotely logging into your VMware Horizon or Citrix VDI. 

    These metrics are collected per device for those devices that have the Remote DX - Client Metrics .DLL installed. You deploy the files onto devices that connect to your Citrix or VMware Horizon environments.

    For details on supporting operating systems and deployment instructions, see Deploy Remote DX - Client Metrics Monitoring onto Client Devices.

    Client Metrics in the Console and Solve

    Once the monitoring agent files are deployed onto your users' client devices and metrics are collected, these metrics appear in the Real-Time Console and in the Solve interface as described below.

    Some of the metrics that ControlUp monitors include:

    • Latency:
        • LAN Latency. Latency between the client device connected to the session and the local router.
        • Total Session Latency. Total session latency from the client device calculated from the second callback.
        • Internet Latency. Latency between the client device connected to the session and the Google DNS servers.
    • WiFi signal strength plus data such as authentication, SSID, channel, etc.
    • NIC (Network Interface Controller) speed, type, name
    • Client OS version
    • Foreground app
    • Client inactive time
    • Local router IP

    There is also a metric for Client Device Score that calculates a combination of metrics to display how well the device's connections are performing overall. The score is displayed as a colored icon HouseIcon.png in its own column and is based on the worst threshold among these metrics: WiFi Signal, Lan Latency, Total Session Latency, Internet Latency.

    Real-Time Console

    There is a new column preset that you can select when viewing these metrics for your remote users’ devices. In the Presets menu in the top ribbon, select Remote DX and you can see all the columns related to these metrics.
    ColumnPresetRemoteDX.png

     

    Solve

    In the Solve web interface, there are columns you can select to add to the Discovery page grid.

    To view Remote DX - client metrics in Solve:

    1. Click the Discovery icon Discovery.pngto access the Discovery page.  
    2. In the Topology click User Sessions. 
      TopologyUserSessions.png

    3. In the right area above the grid, click the Grid column pick icon GridColumnPicker.png.
    4. Select from the following optional columns:
      - Client Device Score
      - Client NIC Name
      - Client NIC Speed
      - Client NIC Type
      - Internet Latency
      - LAN Latency
      - Latency Avg
      - Total Latency
      - WiFi Signal
      - WiFi SSID

      You now see the columns for these metrics in your SOLVE grid.
    5. Click the Client Device Score icon HouseIcon.pngto drill down to troubleshoot connection issues. 
      SolveGrid.png
      The details of the device's connection into your virtual environment are displayed showing the different sections of the device's connection path.
      ConnectionDetail.png

     

  • Deploy Remote DX - Client Metrics Monitoring

    ControlUp extends our monitoring capabilities by enabling you to now monitor remote client devices when they are logged into your virtual network. For details about the feature, see Remote DX - Client Metrics.

    This article includes:

    The Remote DX feature can monitor HP ThinPro and IGEL devices well. For details on deployment with links to the download files, see these relevant articles:

    Deploy Remote DX - HP ThinPro (VMware)
    Deploy Remote DX - HP ThinPro (Citrix)
    Deploy Remote DX - IGEL (VMware)
    Deploy Remote DX - IGEL (Citrix)

    Prerequisites and operating systems

    To enable the feature, you must deploy the relevant files onto the client device machines you want to monitor. 

    For metrics to be monitored from the remote devices, the VMware or Citrix machine to which the device connects must have the ControlUp Agent installed.

    DeviceMachineGraphic.png

    The following operation systems are supported for these EUC environments. They include links to the various deployment instructions:

    VMware Horizon client:

    • Windows 10 and above 64 bit
    • MacOS 10.13.6 and above
    • IGEL 11.3 and above

    Citrix client: 

    • Windows 10 and above 32 & 64 bit
    • MacOS 10.13.6 and above
    • IGEL 11.3 and above

    Windows deployment

    Access the latest deployment files from the ControlUp Downloads Center. Select the one for your EUC.

    Here's a video to guide you:  

    You as the IT Admin can select to remotely perform the installation using the following parameter options:

    /SILENT
    /VERYSILENT

    If your users are installing directly, when the user opens the .exe file, the installation process begins. 

    1. Agree to the End User License Agreement.
      Install1.png
    2. Click Install to begin the installation.
      Install2.png
    3. Click Finish and the monitoring can begin once the client device is connected to your environment.
      Install3.png

     

    MacOS deployment

    Here's a video to guide you:

    Download the .pkg installer file from the ControlUp Downloads Center.

    1. In our ControlUp Downloads Center under either VMware Horizon Client or Citrix Receiver, click the MacOS link to download the .pkg file.
    2. Double-click the downloaded .pkg file to begin the deployment process.
    3. In the Introduction dialog, click Continue.

      Picture1.png
    4. In the Software License Agreement dialog, click the link to view the license and then click Continue.
      Picture2.png
    5. Click Agree to accept the ControlUp license agreement.
      Picture3.png
    6. Optionally click Change Install Location if you want to change the default. Click Install
      Picture4.png
    7. Enter the user's credentials and click Install Software.
      Picture5.png
    8. Click Close.
      Picture6.png

    Once the client device is connected to your EUC environment, you can begin getting monitored information on this device.

     

     

     

     

     

     

  • Deploy Remote DX - HP ThinPro (VMware)

    Follow these procedures to deploy Remote DX monitoring onto machines running the HP ThinPro operating system that connect into a VMware environment. You can deploy Remote DX monitoring onto:

    For details on the feature, read Remote DX - Client Device Metrics.
    For details on other deployment options, see Deploy Remote DX - Client Metrics Monitoring

    HP ThinPro online deployment for VMware environments

    If the machine with HP ThinPro has an internet connection, you do not have to download any files. You just need to follow this procedure using the provided script in step 4.

    1. In the HPDM, go to the Templates & Rules page.
    2. Select the _File and Registry template to open the Template Editor.

      mceclip1.png
    3. Select Add > Script. Click OK.

      mceclip2.png
    4. In the Script Editor, enter the following shell script and click OK.
      echo "Starting RemoteDX script"

      echo "Getting libcuepux.so from the repository"
      wget https://downloads.controlup.com/RemoteDX/vmware/hp/libcuepux.so -O /tmp/libcuepux.so
      chmod 775 /tmp/libcuepux.so

      echo "Copy libcuepux.so to rdpvcbridge"
      cp /tmp/libcuepux.so /usr/lib/vmware/rdpvcbridge/.
      mceclip7.png

    5. Select Save as, enter a name for the new template, and then select OK. The template is added to the Task Templates list.

      mceclip3.png
    6. From the Manage Devices tab, right-click a device in the device pane or a folder in the device tree, and then select Send Task to open the Template Chooser.
      mceclip6.png
    7. In the Template Chooser window, select a category and the task template, and then click Next.

      mceclip7.png

    HP ThinPro offline deployment for VMware environments

    To perform the deployment on machines that cannot access the internet, you must download the HP ThinPro .so file from https://downloads.controlup.com/RemoteDX/vmware/hp/libcuepux.so.

    1. In the HPDM, go to the Templates & Rules page.
    2. Select the _File and Registry template to open the Template Editor.

      mceclip1.png

    3. Select Add >Deploy Files. Click OK.

      mceclip3.png

    4. Click on the libcuepux.so file and select Add from local.

      mceclip1.png
    5. Edit the Path On Device to set /usr/lib/vmware/rdpvcbridge/libcuepux.so as the device path. Click OK.

      mceclip2.png
    6. Add another Script subtask.
    7. In the Script Editor, enter the following shell script and click OK.
    echo "Starting RemoteDX script"

    echo "Setting cuepux.dll file permissions"
    chmod 775 /usr/lib/vmware/rdpvcbridge/libcuepux.so

    mceclip5.png

     

    HP ThinPro deployment for Windows environments

    To perform the deployment on machines running a Windows environment, download the Windows installer file from https://downloads.controlup.com/RemoteDX/vmware/windows/curdx_windows_vmware.exe.

    1. In the HPDM, go to the Templates & Rules page.
    2. Select the _File and Registry template to open the Template Editor.

      mceclip1.png
    3. Select Add > Deploy Files. Click OK.

      mceclip3.png
    4. Select the installer file and click Add from local.
      mceclip2.png

    5. Enter the Path On Device where the file is saved on your machine. For example: C:\TEMP.

    2.jpg

    1. Create a .cmd script and name it. For example: installRemotedx.
    2. Edit the script with the following code:
      curdx_windows_vmware.exe /VERYSILENT
      mceclip3.png
    1. Click Add from local, select the script, and click Add from local again.

    3.jpg

    1. Enter the Path On Device where the file is saved on your machine. For example: C:\TEMP. Click OK.

    4.jpg

    1. Select Add > Script and then click OK.

      mceclip2.png
    2. Enter the name of the .cmd script you created in step 6-7 and click OK.5.jpg
    3. Select Save as, enter a name for the new template, and click OK. The template is added to the Task Templates list.

    mceclip4.png

    1. Click Generate.

    mceclip5.png

    1. Click _Template Sequence.

    6.jpg

    1. Click Add.

    7.jpg

    1. Select Settings > _Write Filter Settings  and click OK.

    8.jpg

    1. Select Disable and click OK.

    9.jpg

    1. Click Add.

    10.jpg

    1. Select File and Registry and the template you created, and click OK.

    11.jpg

    1. Click OK.

    13.jpg

    1. Click Add.

    14.jpg

    1. Select Settings > _Write Filter Settings  and click OK.

    15.jpg

    1. Verify Enable HPWM is checked and click OK.

    16.jpg

    1. Click Save as.

    17.jpg

     

    1. Enter a name for the sequence template and click OK.

    18.jpg

    1. Click Generate.

    19.jpg

    1. Click Manage Devices.

    20.jpg

    1. Right click the relevant device and select Send Task.

    21.jpg

    1. Select Template Sequence and the template you created, and click Next.

    22.jpg

    1. Click OK to finish and the monitoring can begin once the client device is connected to your environment.

    23.jpg

     

     

  • Deploy Remote DX - HP ThinPro (Citrix)

    You can follow these procedures to deploy Remote DX monitoring onto machines running the HP ThinPro operating system that connect into a Citrix environment. You can deploy Remote DX monitoring onto:

    For details on the feature, read Remote DX - Client Device Metrics.
    For details on other deployment options, see Deploy Remote DX - Client Metrics Monitoring

    HP ThinPro online deployment for Citrix environments

    If the machine with HP ThinPro has an internet connection, you do not have to download any files. You just need to follow this procedure using the provided scripts in step 4.

    1. In the HPDM, go to the Templates & Rules page.
    2. Select the _File and Registry template to open the Template Editor.

      mceclip1.png
    3. Select Add > Script. Click OK.

      mceclip2.png
    4. In the Script Editor, enter the following shell script:
      echo "Starting RemoteDX script"

      echo "Pre-existing RemoteDX entries in module.ini if any"
      cat /usr/lib/ICAClient/config/module.ini | grep -B 3 -A 3 cuepux

      echo "Getting cuepux.dll from the repository"
      wget https://downloads.controlup.com/RemoteDX/citrix/hp/cuepux.dll -O /tmp/cuepux.dll
      chmod 555 /tmp/cuepux.dll

      echo "Copy cuepux.dll to ICAClient"
      cp /tmp/cuepux.dll /usr/lib/ICAClient/.


      echo "Checking if cuepux is already in module.ini"
      if grep -w "cuepux.dll" /usr/lib/ICAClient/config/module.ini
      then
          echo "Found cuepux, exiting"
          exit 0
      else
          echo "cuepux not found, adding VC config"
          sed -ie 's/^VirtualDriver.*$/&, cuepux/g' /usr/lib/ICAClient/config/module.ini
          sed -ie '/^Thinwire3.*/a cuepux = On' /usr/lib/ICAClient/config/module.ini
          sed -ie '/^\[Clipboard\]/i \[cuepux\]\nDriverName = cuepux.dll\n' /usr/lib/ICAClient/config/module.ini
      fi

      echo "Checking if RemoteDX exists in module.ini"
      cat /usr/lib/ICAClient/config/module.ini | grep -B 3 -A 3 cuepux
    5. Select Save as, enter a name for the new template, and then select OK. The template is added to the Task Templates list.

      mceclip3.png
    6. From the Manage Devices tab, right-click a device in the device pane or a folder in the device tree, and then select Send Task to open the Template Chooser.
      mceclip6.png
    7. In the Template Chooser window, select a category and the task template, and then click Next.

      mceclip7.png

    HP ThinPro offline deployment for Citrix environments

    To perform the deployment on machines that cannot access the internet, you must download the ControlUp Remote DX for HP ThinPro plugin from https://downloads.controlup.com/RemoteDX/citrix/hp/cuepux.dll.

    1. In the HPDM, go to the Templates & Rules page.
    2. Select the _File and Registry template to open the Template Editor.

      mceclip1.png
    3. Select Add >Deploy Files. Click OK.
    4. Click on the cuepux.dll file and select Add from local.
    5. Edit the Path On Device to set /usr/lib/ICAClient/ as the device path. Click OK.
    6. Add another Script subtask.
    7. In the Script Editor, enter the following shell script and click OK.
      echo "Starting RemoteDX script"

      echo "Pre-existing RemoteDX entries in module.ini if any"
      cat /usr/lib/ICAClient/config/module.ini | grep -B 3 -A 3 cuepux

      echo "Getting cuepux.dll from the repository"
      wget https://downloads.controlup.com/RemoteDX/citrix/hp/cuepux.dll -O /tmp/cuepux.dll
      chmod 555 /tmp/cuepux.dll

      echo "Copy cuepux.dll to ICAClient"
      cp /tmp/cuepux.dll /usr/lib/ICAClient/.


      echo "Checking if cuepux is already in module.ini"
      if grep -w "cuepux.dll" /usr/lib/ICAClient/config/module.ini
      then
          echo "Found cuepux, exiting"
          exit 0
      else
          echo "cuepux not found, adding VC config"
          sed -ie 's/^VirtualDriver.*$/&, cuepux/g' /usr/lib/ICAClient/config/module.ini
          sed -ie '/^Thinwire3.*/a cuepux = On' /usr/lib/ICAClient/config/module.ini
          sed -ie '/^\[Clipboard\]/i \[cuepux\]\nDriverName = cuepux.dll\n' /usr/lib/ICAClient/config/module.ini
      fi

      echo "Checking if RemoteDX exists in module.ini"
      cat /usr/lib/ICAClient/config/module.ini | grep -B 3 -A 3 cuepux
    8. From the Manage Devices tab, right-click a device in the device pane or a folder in the device tree, and then select Send Task to open the Template Chooser.

      mceclip6.png
    9. In the Template Chooser windows, select a category and the task template, and then select Next.

      mceclip7.png

    HP ThinPro deployment for Windows environments

    To perform the deployment on machines running a Windows environment, download the Windows installer file from https://downloads.controlup.com/RemoteDX/citrix/windows/curdx_windows_citrix.exe.

    1. In the HPDM, go to the Templates & Rules page.
    2. Select the _File and Registry template to open the Template Editor.

      mceclip1.png
    3. Select Add > Deploy Files. Click OK.

      mceclip3.png
    4. Select the installer file and click Add from local.

    mceclip1.png

    1. Enter the Path On Device where the file is saved on your machine. For example: C:\TEMP.

    1a.jpg

    1. Create a .cmd script and name it, for example: installRemotedx.
    2. Edit the script with the following code:
      curdx_windows_citrix_exe /VERYSILENT

      mceclip0.png
    1. Click Add from local, select the script and click Add from local.

    3.jpg

    1. Enter the Path On Device where the file is saved on your machine. For example: C:\TEMP. Click OK.

    2a.jpg

    1. Select Add > Script and then click OK.

      mceclip2.png
    2. Enter the name of the .cmd script you created above and click OK.5.jpg
    3. Select Save as, enter a name for the new template and click OK. The template is added to the Task Templates list.

    mceclip4.png

    1. Click Generate.

    mceclip5.png

    1. Click _Template Sequence.

    6.jpg

    1. Click Add.

    7.jpg

    1. Select Settings > _Write Filter Settings and click OK.

    8.jpg

    1. Select Disable and click OK.

    9.jpg

    1. Click Add.

    10.jpg

    1. Select File and Registry and the template you created, and click OK.

    11.jpg

    1. Click OK.

    13.jpg

    1. Click Add.

    14.jpg

    1. Select Settings > _Write Filter Settings and click OK.

    15.jpg

    1. Verify Enable HPWM is checked and click OK.

    16.jpg

    1. Click Save as...

    17.jpg

     

    1. Enter a name for the sequence template and click OK.

    18.jpg

    1. Click Generate.

    19.jpg

    1. Click Manage Devices.

    20.jpg

    1. Right-click the relevant device and click Send Task.

    21.jpg

    1. Select Template Sequence and the template you created, and click Next.

    22.jpg

    1. Click OK to finish and the monitoring can begin once the client device is connected to your environment.

    23.jpg



     

  • Deploy Remote DX - IGEL (VMware)

    The following sections describe how to deploy Remote DX on your IGEL based on these different scenarios:

    • IGEL machine that is online and can access the internet.
    • IGEL machine that is offline and cannot access the internet.

    For details on the feature, see Remote DX - Client Device Metrics.
    For other deployment options, see Deploy Remote DX - Client Metrics Monitoring.

    Here's a video to guide you:

    IGEL online

    When deploying onto IGEL machines that can access the internet, you download the zip file from here: https://downloads.controlup.com/RemoteDX/vmware/igel/curdx-igel-vmware.zip.

    To start the deployment process:

    1. Open the UMS on your machine.
    2. Click System.
      Picture1.png
    3. Hover over Import.
      Picture2.png
    4. Click Import Profiles.
      Picture3.png
    5. Select the zip you downloaded for Horizon and click Open
      VMwareOpen.png
    6. Click OK to finish the import process. 
      IGELVMwareProfile.png
    7. Wait until the process is over and then click OK. Warning: Do not close the window until the process completes
      IGELVMwareImportingProfile.png
      IGELVMwareImportProfileResults.png
    8. Click the machine name where you want to install Remote DX monitoring.
      Picture7.png
    9. Click the Plus Capture2.PNG to assign an object to the machine.
    10. Expand the Profiles list.
      Picture9.png
    11. In the Select assignable objects dialog, select the uploaded profile and add it to the Selected objects list. Click OK.
      IGELVMwareAssignObjects1.png
    12. In the Update time dialog, select Now and click OK
      Picture11.png
    13. Click Yes to apply the changes. 
      IGELVMwareApplyChanges.png

    IGEL offline

    When deploying onto IGEL machines that are not connected to the internet, you must download both the zip file used for the IGEL online deployment plus the file for IGEL offline deployment. 

    To deploy:

    1. Perform all the steps #s 1 to 14 as described in the IGEL online deployment including downloading the zip file.
    2. Download the plugin for IGEL Offline from here: https://downloads.controlup.com/RemoteDX/vmware/igel/libcuepux.so.
    3. Right-click Files and click New File.
      1.png
    4. Add a new file by clicking Capture.PNG next to the Local file line. 
      2.png
    5. Add the VMware .so plugin file that you downloaded in step 2. 
      IGELVMwareOfflineOpen.png
    6. Copy and paste the name of the file after the /wfs/ on the Devices file location line. 
      IGELVMwareOfflineFile1.png
    7. Set the Access Rights of the Others to Read and Execute. Click Ok.
      5.png
    8. Under Devices, click the name of the machine where you want to install Remote DX monitoring. 
      IGELVMwareOfflineDevices.png

    9. Click the Plus Capture2.PNG to assign an object to the machine and expand the File list.
      IGELVMwareOfflineDevicesFile.png

    10. In the Select assignable objects dialog, add the .so file to the list of Selected objects. Click OK.
      IGELVMwareOfflineAddFile.png
    11. In the Update time dialog, select Now and click OK
      Picture11.png
    12. Click Yes to apply the changes. 
      IGELVMwareApplyChanges1.png

     

     

  • Deploy Remote DX - IGEL (Citrix)

    The following sections describe how to deploy Remote DX on your IGEL based on these different scenarios:

    • IGEL machine that is online and can access the internet.
    • IGEL machine that is offline and cannot access the internet.

    For details on the feature, read Remote DX - Client Device Metrics.
    For details on other deployment options, see Deploy Remote DX - Client Metrics Monitoring.

    Here's a video to guide you:

    IGEL online

    When deploying onto IGEL machines that can access the internet, download the zip from here: https://downloads.controlup.com/RemoteDX/citrix/igel/curdx-igel-citrix.zip.

    To deploy:

    1. Open the UMS on your machine.
    2. Click System.
      Picture1.png
    3. Hover over Import.
      Picture2.png
    4. Click Import Profiles.
      Picture3.png
    5. Select the zip and click Open
      Picture4.png
    6. Click OK to finish the import process. 
      Picture5.png
    7. Wait until the process is over and then click OK. Warning: Do not close the window until the process completes.
      Picture6.png
    8. Click the machine name where you want to install Remote DX monitoring.
      Picture7.png
    9. Click the Plus Capture2.PNG to assign an object to the machine.
    10. Expand the Profiles list.
      Picture9.png
    11. Select the uploaded profile and add it to the Selected objects list. Click OK
      Picture10.png
    12. In the Update time dialog, select Now and click OK
      Picture11.png
    13. Click Yes to apply the changes. 
      Picture12.png

    IGEL offline

    When deploying onto IGEL machines that are not connected to the internet, you must download both the zip file used for the IGEL online deployment plus the plugin for IGEL offline deployment. 

    To deploy:

    1. Perform all the steps #s 1 to 14 as described in the IGEL online deployment including downloading the zip file.
    2. Download the plugin for IGEL Offline from here: https://downloads.controlup.com/RemoteDX/citrix/igel/cuepux.dll.
    3. Right-click Files and click New File.
      1.png
    4. Add a new file by clicking Capture.PNG next to the Local file line. 
      2.png
    5. Add the Citrix .dll file that you downloaded in step 2. 
      3.png
    6. Copy and paste the name of the file after the /wfs/ on the Devices file location line. 
      IGELCitrixFilename.png
    7. Set the Access Rights of the Others to Read and Execute. Click Ok.
      5.png
    8. Click the name of the machine where you want to install Remote DX monitoring.  
      7.png
    9. Click the Plus Capture2.PNG to assign an object to the machine and expand the File list.
      9.png
    10. In the Select assignable objects dialog, add the .dll file to the list of Selected objects. Click OK.
      10.png
    11. In the Update time dialog, select Now and click OK
      Picture11.png
    12. Click Yes to apply the changes. 
      11.png