To install the Liota v2 package on a Windows 10 IOT Enterprise operating system, perform the steps listed in this section.

Prerequisites

  1. Install Python 3:
    1. Download Python 3 from: https://www.python.org/ftp/python/3.8.0/python-3.8.0-amd64.exe
    2. To start the installation, double-click the .exe file.
    3. In the first screen, select the Add Python 3.8 to PATH check box.
    4. Click Customize Installation and in the next screen, click Next.
    5. In the Advanced Users screen, select the Install for all users check box and click Install.
  2. To work with the VMware Pulse IoTC Agent Default Client, perform the following steps:
    1. From VMware Pulse IoT Center, download the iotc-agent file and untar it.
    2. Go to <extracted-agent-folder>\iotc-agent\conf\iotc-agent.cfg and update the value of agentIPCMode to 1.
    3. Go to <extracted-agent-folder>\iotc-agent\conf\iotc-defclient.cfg and update the value of defClientIPCMode to 1.
    4. Open the Windows PowerShell ISE as administrator and run the Set-ExecutionPolicy RemoteSigned command. Click Yes to All.
    5. From the Windows PowerShell ISE, run the install.ps1 file.

Procedure

  1. Add the C:\Program Files\VMware\iotc-agent\bin\ path to the System Path variable.
  2. Open a command prompt as administrator.
  3. Navigate to the extracted Liota folder path and run the python setup.py install command.
  4. Copy the required packages from the <extracted-liota-folder-path>\examples\pulseV2\ folder to the C:\Program Files\VMware\liota\data\packages folder. Specifically, the reg.py and temperature_sensor.py packages. Replace some packages if needed.
  5. To access liota-cli, CD to C:\Program Files\VMware\liota\data\packages\ and run python liotad\liotapkg.py --help.

Results

You have installed Liota on Windows successfully.

What to do next

  • You can either copy the configuration files from /usr/lib/liota/config/ to /etc/liota manually and create a /var/log/liota directory, or use the helper script post-install-setup.sh to copy the configuration files.
    1. If you require Liota to be installed as a non-root user that is different from the one that exists on the system, run:
      ```bash
        $ cd /usr/lib/liota
        $ LIOTA_USER="non-root user" ./post-install-setup.sh
      ```
    2. If you require Liota to be installed as a root user (not preferred), run:
      ```bash
        $ cd /usr/lib/liota
        $ LIOTA_USER="root" ./post-install-setup.sh
      ```
  • After enrolling a gateway, run the python reg.py <packagename> command. The package name must not contain the .py extension. For example, python reg.py temperature_sensor.
  • You can view the logs from the C:\Program Files\VMware\liota\log\liota.log file.