KB1463 - IzoT CT (OpenLNS CT) Product Information

Owned by Michael Wytyshyn (Unlicensed)
02-Jan-2024
6 min read

IzoT Commisioning Tool (IzoT CT) is the latest LonMaker type product. OpenLNS CT was the first IzoT CT version.

We recommend that all new installations use the latest version of IzoT CT.

 Information

Links:

  1. Product Documentation (Data sheet):
    https://www.enocean.com/en/product/izot-commissioning-tool/?ts=1699877960

  2. User’s Guides and Software downloads (software version readme file)
    https://enoceanwiki.atlassian.net/wiki/spaces/LON/pages/2426433
    IzoT CT User’s Guide

  3. License Wizard - installed automatically with CT.
    Echelon License Wizard 1.00.105

    1. Do not install if using CT 4.5+, as it has this License Wizard version or a newer version.

    2. CT 4.0 - 4.4

      1. Use this version if you are using CT 4.0 - 4.4 with new CT Activation keys

      2. Use if license Wizard shows PC offline even though the PC has internet access.

  4. Tying a CT license to an email account. This allows you to see all licenses and do license recovery and returns. See link below on how to create an email account
    Echelon License Wizard Email Account used for IzoT CT and IzoT Net Server

  5. Software compatibility
    https://enoceanwiki.atlassian.net/wiki/spaces/LON/pages/2425077

  6. IzoT CT and SmartServer Videos

  7. Knowledge Base (KB) Articles

  8. LNS Errors - Examples (NS, #88), (LNS, #7) and (DS, #200)
    LNS run-time error list

Do not use the OpenLNS CT 4.0 OpenLNS Database validation tool as this may corrupt your database, upgrade to a newer CT version before using this tool.

Installation Information (details in IzoT CT User’s Guide):

  1. IzoT CT runs on 32-bit and 64-bit Windows, but can only be used with 32-bit Office (32-bit Visio)

    1. If you have 64-bit office (or 64-bit Visio) you will need to uninstall office (and Visio) and install 32-bit office, or use a Virtual Machine (VM) for CT.

      1. Why is only 32-bit office (or 32-bit Visio) supported and not 64-bit office/Visio?

        1. Almost all LNS device plug-ins are 32-bit applications. Since these 32-bit device plug-ins can not run on 64-bit office/Visio, CT only supports 32-bit Office/Visio.

  2. IzoT CT uses Visio, and you can purchase Visio when you purchase CT.

    1. If you purchase through a third-party, just run the latest CT installer.

      1. Install Visio first then CT.

      2. In this case you will have to activate Visio yourself.

    2. If you purchased CT with Visio, Visio gets activated automatically.

      1. For your first CT with Visio purchase, you will need to purchase the CT DVD with Visio

        1. For all other purchases of CT with Visio, use the CT DVD with Visio that you initially purchase and purchase a CT with Vision Activation key for each additional PC.

        2. Microsoft doesn’t allow us to provide Visio for CT as a downloadable link which is why you need to purchase a DVD.

        3. If the DVD doesn’t have the latest CT then install only Visio from the DVD and then install the latest CT from the software downloads site.

    3. Most Visio installation issues are resolved by using the latest CT version.

    4. Visio has to be installed prior to installing CT (this is automatically handled when installing the DVD).

  3. Use the latest version for all new installations

    1. If you purchased a CT with Visio DVD, if the DVD is not the latest version (in November 2023 CT 4.5 was the latest) then do the following.

      1. Install only Visio from the DVD, and then install latest CT from the EnOcean software downloads site.

  4. Installation and Visio issues

  5. Licenses

    1. You need to purchase an Activation key to use CT

      1. If you purchased the CT with visio DVD the Activation key will be on the DVD.

        1. Visio will be automatically activated during the CT install process.

      2. Otherwise an activation key will be sent to you.

    2. CT comes with an one year maintenance license.

      1. A valid maintenance license allows you to upgrade CT to a newer version.

      2. You should purchase one or more one-year maintenance license for each CT PC.

        1. You need to add maintenance licenses before the previous maintenance license expires.

      3. Before the Maintenance license expires, you will get a pop up when you open CT.

      4. If you purchased a maintenance license

        1. contact edge.support@enocean.com after you activated CT and include a copy of the Purchase Order (PO)

    3. Visio is required to use CT

      1. If you purchased the CT with visio DVD then Visio will be automatically activated during CT installation.

      2. If you purchased Visio separately then you need to activate Visio using the key you purchased.

    4. Echelon License Wizard (Start > Echelon License Wizard > License Wizard)

      1. Use to activate CT

      2. Don’t use the “validate” or “upgrade” action as they don’t do anything

      3. If you tie the CT Activation key to a Software download account then you can also do license return and recovery.

    5. Echelon License errors

      1. MachineLockRequirement

        1. If using a VM, contact support and ask for a replacement MT license.

        2. Contact support and as ask them to return the license or activation key.

      2. BioLockFailed Machine Lock Mismatch

        1. Some hardware, bios or software changed invalidating the license

        2. You tried to open a copy of a license VM instead of the VM instance that you licensed

        3. Contact support and as ask them to return the license or activation key

      3. License Knowledge Base articles

      4. Send an email to edge.support@enocean.com if you have any license issues.

        1. Please include screen shots of the error, and screen shot and text of the Activation key or license ID

  6. How to activate CT

    1. Run the Start > Echelon License Wizard > License Wizard

    2. In step 1. click “Activate product Licenses”

      1. You need to activate one CT license and one IzoT Net Server (or OpenLNS Server) license per PC

      2. If your PC has internet access you should be able to activate CT automatically.

      3. If you PC doesn’t have internet access or can’t communicate to the License server then you need to do offline activation

        1. The Echelon License Wizard will create an *.elwrq file

        2. There are two ways to process this file

          1. Do it yourself - Use another PC with the Echelon License Wizard with internet access

            1. In the Echelon License wizard step 1, click the yellow “Show Advanced Tasks”

              1. Select the first task “Process a license request file created on another computer” and complete the process

          2. Send the *.elwrq file to EnOcean at edge.support@enocean.com

            1. EnOcean will then send you an activation response file *.elwrs

        3. Activate CT PC - Once you have the *.elwrs file

          1. Go back to the original PC and in step 1 in the License Wizard, click the yellow “Show Advanced Tasks”

          2. Select the second task “Process a license response file obtained from Echelon” and complete the process

Making sure your network continues to work:

  1. Make backups before and after any changes

    1. Save this on another PC in case the PC goes down.

  2. Making sure the CT network has no issues -
    run database validation and drawing-to-database synchronisation.

    1. backup the network

    2. Use the OpenLNS Database Validation tool to check and fix LNS database issues

      1. The tool can fix many issues but not all.

    3. In CT, do drawing to database synchronisation to make sure the CT drawing is in sync with the LNS database.

    4. Backup any changes.

  3. Only create devices types in CT using a XIF file.

    1. Creating a device type by using upload from device may work initially but may stop working at a later date.

Restoring a previously created LonMaker, OpenLNS CT or IzoT CT network:

  1. Backup Restore examples:

    1. A backed up network database can be restored on a newer version

      1. Backed up LonMaker network databases can be restored on IzoT CT

      2. OpenLNS CT or IzoT CT 4.4 database can be restored on a IzoT CT 4.5 PC

    2. A backed up network database can not be downgraded to an older version

      1. IzoT CT backed up network databases can not be restored on LonMaker PCs

      2. IzoT CT 4.5 database can not be restored on LonMaker, OpenLNS CT or IzoT CT 4.4.

  2. Restore a backed up network Instructions:

    1. On the old PC, backup the older network database

    2. On the old PC with LonMaker (ignore this step if the old PC has OpenLNS CT or IzoT CT)
      Fix any database or drawing issue

      1. Run database validation tool to find and fix any database issues.

        1. fix any issues and re-run until no errors.

      2. Make a backup.

      3. In LonMaker or CT, run drawing to database synchronisation.

        1. fix any issues and re-run until no errors.

      4. Make a backup

    3. On the new PC with IzoT CT

      1. restore the backed network

      2. Run database validation tool to find and fix any database issues.
        Start > Echelon IzoT Network Services Utilites >OpenLNS Database Validation Tool

      3. Make a backup.

      4. In CT, run Add-ons > Synchronization > Resynchronization

        1. Select drawing to database synchronisation and run validation.

      5. Make a backup

 Related Products

  • IzoT CT

  • OpenLNS CT