Installing CMSysHelper on a VM

The CMSysHelper app allows the Course Manager Learning Console to interact with VMs in the lab end user’s Skytap environment. It can be installed on Windows or Linux VMs and runs as a service.

Notes

  • CMSysHelper must be installed on the target VMs in the lab end user's Skytap environment for system commands in the Manual to work correctly in the Learning Console.
  • For more information about creating a Skytap environment configured for the lab end user or preparing a template for lab environments, see Preparing a template.
  • For more information about inserting a command in a Manual, see Inserting a command.
  • For more information about installing CMHelper on a VM, see Installing CMHelper on a VM.
Contents

Step 1 – Find the latest version of CMSysHelper

To find the latest version of CMSysHelper
  1. From the Course Manager navigation bar, click Help. The Help drop-down menu displays.
  2. Right-click Download CMHelper: Sys for your desired operating system.
  3. Copy the link URL.

Step 2 – Install CMSysHelper on a VM

You can install CMSysHelper on Windows and Linux VMs.

Installing CMSysHelper on a Windows VM

The CMSysHelper Windows installer is a .msi file. The package can be installed by any Windows VM user with administrator rights and automatically runs when the VM starts.

To install CMSysHelper on a Windows VM
  1. In the Skytap environment that will be used to prepare the lab template, sign in to a Windows VM with an internet connection.
  2. Open an internet browser.
  3. Paste the CMSysHelper link URL into the browser. The Windows installer downloads.
  4. Open the installer, and complete the installation process.

Installing CMSysHelper on a Linux VM

The Linux version of CMSysHelper is distributed as a binary and supports Ubuntu and other Linux distributions that have glibc version 2.17 and newer.

To install CMSysHelper on a Linux VM
  1. In the Skytap environment that will be used to prepare the lab template, sign in to a Linux VM with an internet connection.
  2. Open a command line window.
  3. Access the CMSysHelper link URL using wget. The tarball downloads to the current directory.
  4. Extract the binary from the tarball using tar -xf to a service executable location, such as /usr/sbin/.
  5. Mark the binary as executable using chmod +x.
  6. Configure the executable to run as a service. For more information, see Linux-README.md in the tarball.

Step 3 – Confirm that CMSysHelper is running on the VM

Use your service manager to confirm that CMSysHelper is running on the VM. For more detailed information, see the CMSysHelper logs.

To access the CMSysHelper logs
  • In a Windows VM, access the directory that contains the CMSysHelper executable, and then open \logs\.
  • In a Linux VM, open /logs/.