Q:
HALCONライセンスエラーへの対処方法を教えてください。


A:
HALCONライセンスエラーが発生した場合、
表示されているHALCONエラーコードを確認して 下記項目をご確認ください。

1.
#21010:HALCON license error
#2036:could not find license file
#2003:No license found
上記エラーが発生している場合、ライセンスファイルの位置を確認してください(※1, 8)。


2.
#21011:HALCON startup error
上記エラーが発生している場合、環境変数の設定（HALCONROOT）が適切か確認してください(※2)。


3.
#2005:No modules in license (invalid VENDOR_STRING
#2006:No license for this operator
#2015:library version mismatch, 
#2022:Version argument is invalid floating point format
#2033:License file does not support a version this new
#2384: License file does not support a version this old
#2076:Message checksum failure
上記エラーが発生している場合、以下内容ををご確認ください。
- HALCONのバージョン（Progress/Steady, 開発/ランタイムか, DL有無）を確認してください(※3)。
- ライセンスファイルの内容を確認してください(※5)。


4.
#2004:Lost connection to license server
#2012:Vendor keys have expired
#2014:Vendor key data not supplied
#2031:Can not find feature in the license file
#2041:Invalid host
#2042:Feature has expired
#2055:Cannot find ethernet device(USBドングル認証時)
上記エラーが発生している場合、以下内容ををご確認ください。
- hhostidを実行し、ドングルキーのIDを確認してください(※4)。
- ライセンスファイルの内容を確認してください(※5)。
- 下記6の理由でこちらのエラーコードが表示される場合もあります


5.
#2055:Cannot find ethernet device(MACアドレス認証時)
上記エラーが発生している場合、以下内容をご確認ください。
- ネットワークカードのMACアドレス確認してください(※6)。
- ライセンスファイルの内容を確認してください(※5)。


6.
#2028: Maximum session limit reached
#2029:All licenses in use
上記エラーが発生している場合、管理者権限と一般ユーザの複数アカウントでHALCONを同時に動かしていないか確認してください(※7)。


7.
#2056:Cannot read license file
上記エラーが発生している場合、以下内容ををご確認ください。
- ライセンスファイルの位置を確認してください(※1)。
- ライセンスファイルの内容を確認してください(※5)。


【確認項目詳細】
※1:ライセンスファイルが以下のフォルダ(%HALCONROOT%\license\)にあることを確認してください。
C:\Program Files\MVTec\HALCON-(バージョン)-(Edition)\license　

※2:環境変数(HALCONROOT)の設定が適切か確認してください。環境変数HALCON_LICENSE_FILEが設定されている場合はそれを削除してください。
HALCONROOT：C:\Program Files\MVTec\HALCON-(バージョン)-(Edition)

※3:使用するHALCONのバージョン（Progress/Steady, 開発/ランタイム）を確認してください。
異なるエディション間でのライセンス認証(ProgressのライセンスでSteadyを動かすなど)はできません。
また、ランタイムライセンスで開発ライセンスの機能(HDevelopの起動など)を利用することはできません。

※4:コマンドプロンプト上でhhostidを実行しドングルIDが表示されるかを確認してください。
- IDが表示されない場合、ドングルキーを挿し直して動作をご確認ください。
- それでもIDガ表示されない場合、CodeMeterの最新版をインストールして、動作をご確認ください。

※5:ライセンスファイルの内容を確認してください(テキストエディタなどで内容を確認可能です)。
- インストールされたHALCONバージョンと配置したライセンスが合致しているかをご確認ください。
  - 評価ライセンスの場合、最新版以外のHALCONを動作させることはできません。
- ライセンス期限が過ぎていないことをご確認ください。
- ドングルIDまたはMACアドレスがあっているかをご確認ください。

※6:ネットワークカードのMACアドレスを確認してください。
コマンドプロンプトにて以下を実行し、#0：のMACアドレスをご確認ください。
　hhostid -i

※7:管理者権限と一般ユーザの複数アカウントでHALCONを同時に動かしていないか確認してください。
HALCONの1ライセンスを使用できるのは1アカウントのみとなります。
1台のPC上で、以下のように2アカウント以上で起動をしようとした際に#2029が発生します。
　手順1. 1つ目のアプリを管理権限で起動
　手順2. 2つ目のアプリを一般アカウントで起動
Visual StudioのVariable Inspect機能もHALCONアプリにカウントされます。

※8.HDevelopのライセンスファイル確認は、HALCONROOTで登録されているディレクトリにあるlicenseフォルダを参照します。
ユーザー環境変数側とシステム環境変数２つでHALCONROOTが登録されている場合（添付画像参照）ユーザー環境変数側が優先されます。
ユーザー環境変数にもHALCONROOTがあればそちらを削除していただけますでしょうか。

---
上記項目を確認して改善されない場合、お手数ですが弊社サポートまでご連絡ください。
その際以下のような情報をご提供いただけますとよりスムーズな回答が可能です。

・HALCONのバージョン、エディション(21.11.x.xなど詳細なバージョンもご記載ください)
・ライセンス種別(開発ライセンス or ランタイムライセンス)
・ライセンスID(可能であればライセンスファイル)
・エラーメッセージ
・エラー発生手順
・エラー発生頻度(上記手順にて毎回発生するか、XX回に一回発生するか)
・上記確認事項のご確認結、