CODESYS licenses missing after installing firmware

Applies To:

Firmware for the following groov EPICs:

GRV-EPIC-PR1
GRV-EPIC-PR2

Firmware for the following groov RIOs:

GRV-R7-MM1001-10
GRV-R7-MM2001-10
GRV-R7-I1VAPM-3

Versions Affected:

3.6.0 to current

Symptoms:

This KB article describes an issue that affects CODESYS users. It occurs when your groov EPIC or RIO has firmware 3.6.x, and then you install any firmware version.

If your groov EPIC or RIO already has firmware version 3.6.x and then you install any firmware version (including the same version), when you start CODESYS and check License Manager, you’ll see that the licenses are gone. The firmware update should have preserved the licenses.

Workaround:

Running 3.6.x and Have NOT Installed or Updated Firmware or Performed a Reset to Factory Defaults

If your EPIC or RIO already has firmware version 3.6.x with CODESYS licenses installed, back up the licenses before you install any firmware version (including the same version) or perform a Reset to Factory Defaults:

In CODESYS Development System, open the project that runs on your device (EPIC or RIO), connect to the device, and copy the license files stored in the device to a safe location on your computer. The license files are located in the cmact_licenses folder. For instructions on copying license files stored in your device, refer to "Backing up and Restoring CODESYS Licenses" topic in CODESYS online documentation.
Install your desired version of groov EPIC or RIO firmware. For instructions, refer to the appropriate form:
- “Updating Firmware on a groov EPIC” section of the groov EPIC User’s Guide (form 2267).
- “Updating Firmware on a groov RIO” section of the groov RIO UIO User’s Guide (form 2324).
- “Updating Firmware on a groov RIO EMU” section of the groov RIO EMU User’s Guide (form 2372).
In groov Manage, enable the CODESYS controller:
1. From the groov Manage Home page, click Controller > CODESYS Controller (groov EPIC) or Controller (groov RIO).
2. Click Enable. Click OK on the warning message.
In CODESYS Development System, copy the license files you saved in step 1 back to the groov EPIC or groov RIO. For instructions on copying license files to your device, refer to "Backing up and Restoring CODESYS Licenses" topic in CODESYS online documentation.
Using groov Manage, do one of the following:
- Disable then enable the CODESYS controller:
  1. From the groov Manage Home page, click Controller > CODESYS Controller (groov EPIC) or Controller (groov RIO).
  2. Click Disable. Click OK on the warning message.
  3. When the Status field shows Disabled, click Enable. Click OK on the warning message.
- Restart your groov EPIC:
  1. From the groov Manage Home page, click System > Restart.
  2. Click Restart on the prompt.
  3. Click Close on the success prompt. Wait for approximately five minutes (groov EPIC) or 10 minutes (groov RIO) for the restart to complete. If the page does not refresh on its own, manually refresh the browser.
In CODESYS Development System, use the License Manager to confirm that the license has been restored. For instructions on using the License Manager, refer to the “Licensing the Controller” topic in the CODESYS online documentation.

Running 3.6.x and Already Updated or Installed Firmware or Performed a Reset to Factory Defaults

If your groov EPIC or RIO had firmware version 3.6.x with CODESYS licenses installed, and then you installed any firmware version (including the same version) or performed a Reset to Factory Defaults, the CODESYS licenses were not restored to your EPIC or RIO. You will need to restore the licenses, but the procedure depends on the firmware version running on your EPIC or RIO when you first installed the licenses:

If you first installed the CODESYS license in firmware version 3.4.5 or lower and have already installed version 4.0.x (or reinstalled 3.6.x) or higher:

Install firmware version 3.4.5 (or lower). For instructions, refer to the appropriate form:
- “Updating Firmware on a groov EPIC” section of the groov EPIC User’s Guide (form 2267).
- “Updating Firmware on a groov RIO” section of the groov RIO UIO User’s Guide (form 2324).
- “Updating Firmware on a groov RIO EMU” section of the groov RIO EMU User’s Guide (form 2372).
In groov Manage, enable the CODESYS controller:
1. From the groov Manage Home page, click Controller > CODESYS Controller (groov EPIC) or Controller (groov RIO).
2. Click Enable. Click OK on the warning message.
In CODESYS Development System, restore the CODESYS licenses using the License Manager. For instructions on using the License Manager, refer to the “Licensing the Controller” topic in the CODESYS online documentation.
Install firmware version 4.0.x or higher. Do not install version 3.6.x. For instructions, refer to the appropriate form:
- “Updating Firmware on a groov EPIC” section of the groov EPIC User’s Guide (form 2267).
- “Updating Firmware on a groov RIO” section of the groov RIO UIO User’s Guide (form 2324).
- “Updating Firmware on a groov RIO EMU” section of the groov RIO EMU User’s Guide (form 2372).
In groov Manage, enable the CODESYS controller:
1. From the groov Manage Home page, click Controller > CODESYS Controller (groov EPIC) or Controller (groov RIO).
2. Click Enable. Click OK on the warning message.
In CODESYS Development System, use the License Manager to confirm that the licenses have been restored.

If you first installed the CODESYS license in firmware version 3.5.x or 3.6.x, and have already installed version 4.0.x (or reinstalled 3.6.x) or higher:

In CODESYS Development System, restore the CODESYS license using the License Manager. For instructions on using the License Manager, refer to the “Licensing the Controller” topic in the CODESYS online documentation.
Use the License Manager to confirm that the license has been restored.

Resolution:

Follow the instructions in the Workaround.

Questions?

Contact: Opto 22 Product Support.
Phone: 800-835-6786 or 951-695-3080
Email: support@opto22.com

DISCLAIMER

This Opto 22 Knowledge Base ('OptoKB') article is intended to provide general technical information on a particular subject or subjects and is not an exhaustive treatment of such subjects. Accordingly, the information in this OptoKB article is not intended to constitute application, design, software, or other professional engineering advice or services. Opto 22 may modify the OptoKB articles at any time. Before making any decision or taking any action which might affect your equipment, you should consult a qualified professional.

OPTO 22 DOES NOT WARRANT THE COMPLETENESS, TIMELINESS, OR ACCURACY OF THE DATA CONTAINED IN THIS OPTOKB ARTICLE AND MAY MAKE CHANGES THERETO AT ANY TIME AT ITS SOLE DISCRETION WITHOUT NOTICE. FURTHER, ALL INFORMATION CONVEYED HEREBY IS PROVIDED TO USERS 'AS IS.' IN NO EVENT SHALL OPTO 22 BE LIABLE FOR ANY DAMAGES OF ANY KIND INCLUDING DIRECT, INDIRECT INCIDENTAL, CONSEQUENTIAL, LOSS PROFIT, OR DAMAGE, EVEN IF OPTO 22 HAS BEEN ADVISED ON THE POSSIBILITY OF SUCH DAMAGES.

OPTO 22 DISCLAIMS ALL WARRANTIES WHETHER EXPRESSED OR IMPLIED WITH RESPECT TO THE INFORMATION (INCLUDING HARDWARE, SOFTWARE, AND/OR FIRMWARE) PROVIDED HEREBY, INCLUDING THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTIBILITY, AND NON-INFRINGEMENT. Note that certain jurisdictions do not sanction the exclusion of implied warranties: thus, this disclaimer may not apply to you.