License Manager

注: 特定のデバイスに存在する機能のみを表示するには、下の SmartDocs バーから 1 つまたは複数のフィルタを選択します。

言語に関する注: 入力フィールドには、英語のみを入力できます。

StageNow - 5.3

概要

License Manager (LicenseMgr) CSP は、デバイス上のソフトウェア ライセンスを管理し、これにより、管理者またはデバイス上で実行されているアプリが、ライセンスを必要とするソフトウェア機能の操作性を制御できます。ソフトウェア コンポーネントは、ライセンスに基づいて、使用可能、使用不可にすること、または機能制限することができます。コンポーネントにライセンスが必要な場合、有効なライセンスがないと、その機能が制限されるか、機能が使用できなくなります。ライセンスを必要としないソフトウェア コンポーネントは、この CSP の影響を受けません。

主な機能

Zebra ライセンス

  • Zebra または (レガシー) Symbol メソッドを使用して、ライセンス アクションを実行します
  • アクティベーション ID によりソフトウェア ライセンスを有効化/返却/すべて返却/更新します
  • "機能" 名やバージョンでライセンス アプリを有効化/返品/更新します
  • ライセンス ソースを選択します
    • クラウド
    • クラウド プロキシ
    • ローカル ライセンス サーバー
    • 事前にアクティブ化されたライセンス
  • ライセンス ソースを削除します
  • オンプレミス ライセンス AID サーバーの URL とフレンドリ名を入力します
  • プロキシ経由でクラウドベース AID サーバーの URL とフレンドリ名を入力します
  • オンプレミス機能ライセンス サーバーの URL とオプションのポート番号を入力します
  • クラウドベースの機能ライセンス サーバーの URL とオプションのポート番号を入力します

Symbol ライセンス

  • デバイスにソフトウェア ライセンスを適用します
  • デバイスからソフトウェア ライセンスを取り消します
  • 標準およびカスタム機能に対してライセンス アクションを実行します
  • ライセンスを埋め込むか、参照するかを選択します
  • デバイスでライセンスを確認します

License Manager アプリ

一部の Zebra デバイスは、License Manager と呼ばれる組み込みのアプリを搭載しています。これにより、デバイス ユーザーや管理者は、デバイス上でライセンス関連のタスクを手動で実行できます。

img License Manager アイコン (左) と、複数の有効化されたライセンスを示すアプリのホーム画面。

License Manager ユーザー ガイド (PDF)

ライセンスの取得

ソフトウェア ライセンスは、Zebra ソフトウェア ライセンス サーバーから取得されます。これらはソフトウェア ライセンス ファイルとして発行され、ライセンス機能名を使用して特定のソフトウェア コンポーネントに関連付けられます。ソフトウェア ライセンス ファイルは、関連するライセンス機能名の使用を有効にするためにのみ使用できます。1 台のコンポーネントは複数の機能を持つことができ、それぞれがライセンス機能名を個別に使用して制御されます。また、1 台のコンポーネントは、単一のライセンス機能名で制御されるすべての機能を持つことができます。

Zebra ソフトウェア ライセンス サーバーから取得したソフトウェア ライセンスは、個々のデバイス ライセンスである可能性があり、各ソフトウェア ライセンス ファイルは特定のデバイスのシリアル番号に関連付けられています。このような場合、適切なソフトウェア ライセンス ファイルを一致する各デバイスに適用する必要があります。Zebra ソフトウェア ライセンス サーバーは、エンタープライズが所有するすべてのデバイスに発行されるエンタープライズ ライセンスも提供します。このような場合、同じソフトウェア ライセンス ファイルを、そのエンタープライズが所有する各デバイスに適用できます。

ライセンスの検証

ソフトウェア ライセンス ファイルは、Zebra ソフトウェア ライセンス サーバーから取得され、ローカルまたはオンラインで保存され、LicenseMgr を通じて参照されます。ただし、サーバーは、そのようなファイルが特定のライセンス機能に一致しているかどうかを検証しません。有効なソフトウェア ライセンス ファイルが、意図した機能以外のライセンス機能に誤って適用されている場合、その機能は有効になり、エラーは発生しません。

これを防止するため、Zebra では、検証メソッド パラメータ (以下) を使用して、ライセンス機能名がソフトウェア ライセンス ファイルに含まれているものと一致していることを確認することをお勧めしています。これにより、不一致が発生した場合に結果の XML にエラーが返されます。

事前にアクティブ化されたライセンスの制限

  • 事前にアクティブ化されたライセンスは、生成された日にのみ有効です。
  • 複数の事前にアクティブ化されたライセンスが生成された場合は、生成されたものと同じ順序で適用する必要があります。
  • 事前にアクティブ化されたライセンスは、他のすべてのライセンス アクションの前に適用する必要があります。
  • 同じ構成プロファイルでアクティベーション ID と事前にアクティブ化されたライセンスのアプリケーションを組み合わせる場合は、事前にアクティブ化されたライセンスを最初に適用する必要があります。

ライセンスの選択

デバイスでライセンス アクションを実行する方法を入力するために使用されます。"レガシー" Symbol アクションは、デバイスに保存されているライセンス ファイルに対して実行されます。Zebra のアクションは、サーバーベースのライセンス ストアに関連しています。

パラメータ名: LicenseChoice

オプション 名前 説明注記 要件
0 do_nothing この値 (または XML からのこのパラメータがない場合) により、デバイス設定に変更は加えられません。以前の設定が保持されます。

MX: 7.1+
1 シンボル (レガシー) Symbol ライセンス アクションを実行します。

MX: 7.1+
2 Zebra Zebra ライセンス アクションを実行します。

MX: 7.1+

Zebra ライセンス アクション

デバイスのアクティベーション ID (AID) または機能名とバージョンに対して実行するアクションを選択するために使用されます。Zebra ブランドのデバイスのみ。Symbol ブランドのデバイスの場合は、ライセンス アクション パラメータを使用します。オプション 6 を使用するには、アクティベーション ID 更新パラメータを使用して 39 文字のアクティベーション ID を入力します。注: オプション 4、5、8、9、10 は、デバイス上でプログラムによって使用されるものであり、人間とのやり取りを目的としたものではありません。

事前にアクティブ化されたライセンスに関する重要な制限事項:

  • 事前にアクティブ化されたライセンスは、生成された日にのみ有効です。
  • 複数の事前にアクティブ化されたライセンスが生成された場合は、生成されたものと同じ順序で適用する必要があります。
  • 事前にアクティブ化されたライセンスは、他のすべてのライセンス アクションの前に適用する必要があります。
  • 同じ構成プロファイルでアクティベーション ID と事前にアクティブ化されたライセンスのアプリケーションを組み合わせる場合は、事前にアクティブ化されたライセンスを最初に適用する必要があります。

次の場合に表示: ライセンス ソースが [Zebra Cloud]、ライセンス アクション Zebra が [AID の有効化]、ライセンス選択が [Zebra ライセンス アクションの実行] およびライセンス選択が [ローカル ライセンス サーバー オプションの使用] の場合

パラメータ名: LicenseActionZebra

オプション 名前 説明注記 要件
1 アクティブ化 Zebra デバイスの AID をアクティブにします。

MX: 7.1+
2 リターン Zebra デバイスの AID を非アクティブにして、一般的な使用に戻します。

MX: 9.2+
3 リセット Zebra デバイスのすべての AID を非アクティブにして、一般的な使用に戻します。

MX: 9.2+
4 acquirefeature デバイス上でプログラム的に使用されます。人間とのやり取りはありません。

MX: 7.1+
5 returnallfeatures 将来使用するために予約されています。デバイス上でプログラム的に使用されます。人間とのやり取りはありません。

MX: 7.1+
6 refreshAID ライセンス更新の購入後に、デバイスがライセンス サーバーに接続してデバイス ライセンスを更新するようにします。

MX: 7.2+
7 deleteLicenseSource 指定したライセンス ソースをデバイスから削除します。

MX: 8.1+
8 activatefeature デバイスでプログラムによって使用され、デバイス上の機能名とバージョンに基づいてライセンスをアクティブにします。人間とのやり取りはありません。

MX: 10.2+
9 returnfeature 指定された機能のライセンスをデバイスから再要求し、ライセンス サーバーに戻して別の場所に割り当てます。

MX: 10.2+
10 refreshfeature ライセンス更新購入後に、デバイスがライセンス サーバーに接続して、指定された機能のライセンスを更新するようにします。

MX: 10.2+

ライセンス ソース

クラウドベースまたはローカルの Zebra ライセンス サーバーを使用するか、デバイス上の事前にアクティブ化されたファイルを使用するかを制御します。Zebra Cloud を選択した場合 (オプション 1)、ライセンス クラウド URL パラメータを使用してサーバーの場所を入力します。

次の場合に表示: ライセンス アクション Zebra が [有効化] であり、ライセンスの選択が [Zebra] の場合

パラメータ名: LicenseSource

オプション 名前 説明注記 要件
1 Zebra Cloud Zebra ライセンス クラウド オプションのいずれかが使用されていることを示します。

MX: 7.2+
2 LLS ローカル ライセンス サーバーが使用されていることを示します。

MX: 7.2+
3 事前にアクティブ化 事前にアクティブ化されたライセンス ファイルがデバイスに存在することを示します。

MX: 8.1+

ライセンス クラウド URL

デバイスで Zebra クラウドベース ライセンスのソースを入力するために使用されます。

次の場合に表示: ライセンス ソースが [Zebra Cloud]、ライセンス アクション Zebra が [有効化]、ライセンスの選択が [Zebra] の場合

パラメータ名: LicenseCloudURL

オプション 名前 説明注記 要件
1 Zebra UAT クラウド クラウドベースの Zebra ライセンス テスト サーバーを選択します。

MX: 8.0+
2 Zebra Production Cloud クラウドベースの Zebra ライセンス運用サーバーを選択します。

MX: 8.0+
3 プロキシ経由の Zebra Production Cloud Zebra 本番クラウドベースのライセンス サーバーにプロキシまたはリレー サーバー経由でアクセスする場合に使用されます。

MX: 8.1+
4 プロキシ経由の Zebra Test Cloud Zebra テスト クラウドベース ライセンス サーバーにプロキシまたはリレー サーバー経由でアクセスする場合に使用されます。

MX: 8.1+
5 Zebra カスタム クラウド オンプレミス ライセンス サーバーまたはリレー サーバーのカスタム URL を指定できます。

MX: 8.1+

機能名

Zebra ライセンス アクション パラメータで選択したアクションを実行する機能名 (アクティベーション ID の代わりに) を入力するために使用します。

パラメータ値入力ルール:

  • 1 ～ 30 文字の文字列

次の場合に表示: ライセンス アクション Zebra が [機能の有効化] または [機能の返却] または [機能の更新] の場合

パラメータ名: FeatName

要件:

  • MX: 10.2+

機能ベースのライセンス ソース URL

Zebra の機能を含むクラウドベースまたはローカル ライセンス サーバーの URL (およびオプションのポート番号) を入力するために使用されます。

パラメータ値入力ルール:

  • 有効な URL (およびオプションのポート番号) を含む文字列
  • 少なくとも 1 文字含める必要があります

例:

  • http://InternalLicenseServer.lan:8080
  • http://external.licenseServer.com:8081

次の場合に表示: ライセンス アクション Zebra が [機能の有効化] の場合

パラメータ名: FeatureBasedLicenseSourceUrl

要件:

  • MX: 10.2+

ライセンス サーバーの URL

Zebra ライセンス アクティベーション ID を含むオンプレミス サーバーの URL (およびオプションのポート番号)、または外部ライセンス サーバーを指すリレー サーバーを入力するために使用されます。このパラメータは、管理対象の組織の壁の外側にあるネットワークにアクセスできないデバイスにのみ必要です。

パラメータ値入力ルール:

  • 有効な URL (およびオプションのポート番号) を含む文字列
  • 少なくとも 1 文字含める必要があります

例: http://InternalLicenseServer.lan:8080

次の場合に表示: ライセンス ソースが [クラウド ライセンス サービスにカスタム URL を入力] で、ライセンスの選択が [Zebra] の場合

パラメータ名: URL

要件:

  • MX: 7.1+

機能ベースのソース URL フレンドリ名

識別しやすいように、クラウドベースまたはローカル ライセンス サーバーの "フレンドリ" 名を入力するために使用されます。

パラメータ値入力ルール:

  • 少なくとも 1 文字を含む文字列

次の場合に表示: ライセンス アクション Zebra が [機能の有効化] または [機能の返却] または [機能の更新] の場合

パラメータ名: FeatureBasedLicenseSourceUrlFriendlyName

要件:

  • MX: 10.2+

サーバー フレンドリ名

識別しやすいように、ローカル ライセンス サーバーの "フレンドリ" 名を入力するために使用されます。

パラメータ値入力ルール:

  • 1 文字以上の文字列

次の場合に表示: ライセンス アクション Zebra が [有効化]、ライセンス選択が [Zebra]、ライセンス ソースが [LLS]、ライセンス ソースが [Zebra Cloud]、ライセンス選択 URL が [プロキシ経由の Zebra Production Cloud、プロキシ経由の Zebra Test Cloud または Zebra カスタム クラウド] の場合

パラメータ名: ServerFriendlyName

要件:

  • MX: 7.2+

アクティベーション ID

デバイスでライセンスをアクティブ化するために Zebra ライセンス システムによって提供される 39 文字のコードを手動で入力するために使用されます。

パラメータ値入力ルール:

  • 39 文字のライセンス コードを含む文字列
  • 少なくとも 1 文字含める必要があります

次の場合に表示: ライセンス アクション Zebra が [有効化] であり、ライセンスの選択が [Zebra]およびライセンス ソースが [Zebra Cloud または LLS] の場合

パラメータ名: ActivationID

要件:

  • MX: 7.1+

アクティベーション数量

デバイスでアクティブ化するライセンス コピーの数を入力するために使用されます。

パラメータ値入力ルール:

  • 1 文字以上を含む文字列

次の場合に表示: ライセンス アクション Zebra が [有効化] であり、ライセンスの選択が [Zebra]およびライセンス ソースが [Zebra Cloud または LLS] の場合

パラメータ名: ActivationQuantity

要件:

  • MX: 7.1+

事前にアクティブ化されたライセンス ソース

デバイス上で事前にアクティブ化されたライセンス ファイルのソースを入力するために使用されます。

次の場合に表示: ライセンス アクション Zebra が [有効化] であり、ライセンスの選択が [Zebra]、およびライセンス ソースが [事前にアクティブ化] の場合

パラメータ名: PreactivatedLicenseSource

オプション 名前 説明注記 要件
1 Zebra UAT Zebra テスト クラウドから事前にアクティブ化されたライセンスの使用を示します。

MX: 8.1+
2 Zebra Production Zebra 本番クラウドから事前にアクティブ化されたライセンスの使用を示します。

MX: 8.1+

事前にアクティブ化されたライセンス方式

デバイスで事前にアクティブ化されたライセンス ファイルの配信方法を入力するために使用されます。[参照] (オプション 2) を選択した場合、[事前にアクティブ化されたライセンス パスおよびファイル名] パラメータを使用して、デバイスでライセンス ファイルのパスとファイル名を入力します。

次の場合に表示: ライセンス アクション Zebra が [有効化] であり、ライセンスの選択が [Zebra]、およびライセンス ソースが [事前にアクティブ化] の場合

パラメータ名: PreactivatedLicenseMethod

オプション 名前 説明注記 要件
1 組み込み 事前にアクティブ化されたライセンス ファイルをプロファイル XML に埋め込みます。

MX: 8.1+
2 参照 すでにデバイスにある事前にアクティブ化されたライセンス ファイルを参照します。

MX: 8.1+

事前にアクティブ化された「Blob」

XML に埋め込むライセンス ファイルを入力するために使用されます。

パラメータ値入力ルール:

  • 1 文字以上を含む文字列

次の場合に表示: ライセンス アクション Zebra が [有効化] であり、ライセンスの選択が [Zebra]、ライセンス ソースが [事前にアクティブ化]、および事前にアクティブ化されたライセンス メソッドが [参照] の場合

パラメータ名: PreactivatedBlob

要件:

  • MX: 8.1+

事前にアクティブ化されたファイルとパス

デバイスで事前にアクティブ化されたライセンス ファイルのパスとファイル名を入力するために使用されます。

パラメータ値入力ルール:

  • 1 文字以上を含む文字列

次の場合に表示: ライセンス アクション Zebra が [有効化] であり、ライセンスの選択が [Zebra]、ライセンス ソースが [事前にアクティブ化]、および事前にアクティブ化されたライセンス メソッドが [組み込み] の場合

パラメータ名: PreactivatedLicensePathAndFileName

要件:

  • MX: 8.1+

ライセンス ソースを返す

Zebra ライセンスを返却する方法を選択するために使用されます。

次の場合に表示: ライセンス アクション Zebra が [返却] であり、ライセンスの選択が [Zebra] の場合

パラメータ名: ReturnLicenseSource

オプション 名前 説明注記 要件
1 Zebra Production Cloud ライセンスを Zebra ライセンス クラウドに返却します。

MX: 8.1+
2 Zebra UAT クラウド Zebra テスト クラウドにライセンスを返却します。

MX: 8.1+
3 サーバー フレンドリ名 サーバーのフレンドリ名を使用してライセンスを返却します。

MX: 8.1+

すべてのライセンス ソースを返す

デバイスから回収されたライセンスを返却するサーバーを選択するために使用されます。ローカル サーバーにライセンスを返却する場合は、AID 返却ライセンス ソース名パラメータを使用してサーバー名を入力します。

次の場合に表示: ライセンス アクション Zebra が [リセット] であり、ライセンスの選択が [Zebra] の場合

パラメータ名: ReturnAllLicenseSource

オプション 名前 説明注記 要件
1 Zebra Production Cloud 回収されたライセンスを Zebra ライセンス クラウドに返却します。

MX: 9.2+
2 Zebra UAT クラウド 回収されたライセンスをテスト ライセンス サーバーに返却します。

MX: 9.2+
3 サーバー フレンドリ名 AID 返却ライセンス ソース名パラメータで、サーバーに回収されたライセンスを返却します。

MX: 9.2+

アクティベーション ID を返す

デバイスからライセンスを回収するために Zebra ライセンス システムによって提供される 39 文字のコードを手動で入力するために使用されます。回収されたライセンスは、他の場所に割り当てるために組織に返却されます。

パラメータ値入力ルール:

  • 39 文字のライセンス コードを含む文字列
  • 少なくとも 1 文字含める必要があります

次の場合に表示: ライセンス アクション Zebra が [返却] であり、ライセンスの選択が [Zebra] の場合

パラメータ名: ActivationIDReturn

要件:

  • MX: 7.1+

AID サーバー フレンドリ名を返す

回収されたライセンス アクティベーション ID を返却するローカル ライセンス サーバーの "フレンドリ" 名を入力するために使用されます。

パラメータ値入力ルール:

  • 1 文字以上の文字列

次の場合に表示: ライセンス アクション Zebra が [返却] であり、ライセンスの選択が [Zebra]、およびライセンス ソースの返却が [サーバー フレンドリ名] の場合

パラメータ名: ReturnAIDLicenseSourceName

要件:

  • MX: 9.2+

アクティベーション数量を返す

デバイスから回収するライセンス コピーの数を入力するために使用されます。

次の場合に表示: ライセンス アクション Zebra が [返却] であり、ライセンスの選択が [Zebra] の場合

パラメータ名: ActivationQuantityReturn

要件:

  • MX: 7.1+

ライセンス ソース名を削除

ライセンス ソースとして削除するローカル ライセンス サーバーの "フレンドリ" 名を入力するために使用されます。

パラメータ値入力ルール:

  • 1 文字以上の文字列

次の場合に表示: ライセンス アクション Zebra が [ライセンス ソースの削除] であり、ライセンスの選択が [リセット] の場合

パラメータ名: DeleteLicenseSourceName

要件:

  • MX: 9.2+

アクティベーション ID をリフレッシュ

デバイスで更新するためのライセンス コードを入力するために使用されます。このパラメータは、RefreshID Zebra ライセンス アクションと連携して動作し、これにより、ライセンスの更新後にデバイスがライセンス サーバーに接続し、デバイス ライセンスを更新します。

パラメータ値入力ルール:

  • 有効なアクティベーション ID コードを含む 39 文字の文字列である必要があります

次の場合に表示: ライセンス アクション Zebra が [AID の更新] であり、ライセンスの選択が [Zebra] の場合

パラメータ名: ActivationIDRefresh

要件:

  • MX: 7.2+

取得する機能

このパラメータは、ユーザーによる操作を目的としたものではありません。

有効にする機能の名前をプログラム的に入力するために使用されます。

パラメータ値入力ルール:

  • 取得する機能と完全に一致する 1 ～ 40 文字の文字列

次の場合に表示: ライセンス アクション Zebra が [機能の取得] であり、ライセンスの選択が [Zebra ライセンス アクションの実行] の場合

パラメータ名: FeatureToAcquire

要件:

  • MX: 7.1+

機能バージョンを取得

このパラメータは、ユーザーによる操作を目的としたものではありません。

取得する機能パラメータを使用して、取得する機能のバージョン番号をプログラム的に入力するために使用されます。

パラメータ値入力ルール:

  • 1 ～ 10 桁の整数または 10 進数値

次の場合に表示: ライセンス アクション Zebra が [機能の取得] であり、ライセンスの選択が [Zebra ライセンス アクションの実行] の場合

パラメータ名: AcquireFeatureVersion

要件:

  • MX: 7.1+

機能数を取得

機能を使用できる回数を取得するためにデバイス上でライセンスがあるアプリにより使用されます。この機能はプログラム的に使用され、人間とのやり取りを目的としたものではありません。

パラメータ値入力ルール:

  • 正の整数である必要があります (デフォルト = 1)

次の場合に表示: ライセンス アクション Zebra が [機能の取得] であり、ライセンスの選択が [Zebra] の場合

パラメータ名: AcquireFeatureCount

要件:

  • MX: 7.2+

ライセンス動作

レガシー Symbol デバイスでソフトウェア ライセンスを適用または削除するために使用されます。Zebra 製デバイスの場合は、ライセンス アクション Zebra パラメータを使用します。

デバイスでソフトウェア ライセンスを適用すると、そのソフトウェア コンポーネントの特定の機能がそのデバイスで使用可能になります。ライセンスを削除すると、制御された機能が使用不能になるか、その機能が制限されます。注: ライセンスの削除アクションは、プライベート ライセンス ストアからのみライセンスを削除します。ライセンス ファイルはデバイス上にまだ存在しているため、別途削除する必要があります。

次の場合に表示: ライセンスの選択が [Symbol] に設定されています

パラメータ名: LicenseAction

オプション 名前 説明注記 要件
1 適用 Symbol デバイスにソフトウェア ライセンスを適用します。

MX: 4.3+
2 削除 Symbol デバイスからソフトウェア ライセンスを失効させます。

MX: 4.3+

検証メソッド

標準またはカスタム機能名パラメータで指定されたライセンス機能名が、ソフトウェア ライセンス ファイルの内容と一致することを確認するかどうかを制御します。Zebra では、ライセンス機能の不一致を防ぐために、このパラメータを使用することをお勧めします。

ソフトウェア ライセンス ファイルは、Zebra ソフトウェア ライセンス サーバーから取得され、ローカルまたはオンラインで保存され、LicenseMgr を通じて参照されます。サーバーは、そのようなファイルが特定のライセンス機能に一致しているかどうかを検証しません。有効なソフトウェア ライセンス ファイルが、意図した機能以外のライセンス機能に誤って適用されている場合、その機能は有効にならず、エラーは発生しません。検証メソッド パラメータは、ライセンス機能名がソフトウェア ライセンス ファイルに含まれる名前と一致していることを確認し、それ以外の場合は結果の XML にエラーを生成することで、このシナリオを防止します。

次の場合に表示: ライセンス アクションが [Symbol]、ライセンスの選択が [Symbol] の場合

パラメータ名: VerifyMethod

オプション 名前 説明注記 要件
0 機能名は確認しない この値 (または XML からのこのパラメータがない場合) により、検証メソッドに変更は加えられません。以前に選択した設定が保持されます。

MX: 4.3+
1 標準の機能名と照合して確認 指定されたソフトウェア ライセンス ファイルに含まれるライセンス機能名が、指定された標準ライセンス機能名と一致することを確認します。

MX: 4.3+
2 カスタム機能名と照合して確認 指定されたソフトウェア ライセンス ファイルに含まれるライセンス機能名が、指定されたカスタム ライセンス機能名と一致することを確認します。

MX: 4.3+

標準機能名

ソフトウェア ライセンス ファイルを検証するための標準ライセンス機能名を入力するために使用されます。

注: 現在、SimulScan OCR/OMR 機能の定義済みの 1 つの標準ライセンス機能名が存在します。これを選択すると、ライセンス機能名の正確な (カスタム) 値を入力する必要がなくなります。その他の機能を確認するには、[カスタム名の確認] を使用し、使用されているソフトウェア ライセンス ファイルと一致するライセンス機能名を入力します。

次の場合に表示: ライセンス アクションが [Symbol]、ライセンスの選択が [Symbol] の場合

パラメータ名: VerifyStandardFeatureName

オプション 名前 説明注記 要件
1 SIMULDC1_0_0 ソフトウェア ライセンス ファイルに含まれる SimulScan OCR/OMR ライセンス機能名が、SimulScan ソフトウェア コンポーネントの標準ライセンス機能名と一致していることを確認します。

MX: 4.3+

カスタム機能名

カスタム ライセンス機能名の入力に使用されます。これは、Zebra ソフトウェア ライセンス サーバーから取得したソフトウェア ライセンス ファイルに含まれるライセンス機能名と正確に一致する必要があります。

注: このオプションは、標準ライセンス機能名のリストに含まれているもの以外のライセンス機能名を確認するために使用する必要があります。ライセンス機能名は、大文字と小文字も一致させ、空白文字やその他の文字は使用せずに、Zebra ソフトウェア ライセンス サーバーから取得したものとまったく同じように入力する必要があります。

パラメータ値入力ルール:

  • Zebra ソフトウェア ライセンス サーバーから取得したソフトウェア ライセンス ファイルに含まれる有効なカスタム ライセンス機能名を持つ文字列

次の場合に表示: 検証メソッドが [カスタム機能名と照合して確認] で、ライセンス選択が [Symbol] の場合

パラメータ名: VerifyCustomFeatureName

要件:

  • MX: 4.3+

ライセンス方式

ソフトウェア ライセンスの提供方法を入力するために使用されます。

組み込み値 (オプション 1) は、ソフトウェア ライセンス ファイルの内容がリクエスト XML に埋め込まれていることを示します。このオプションを使用するには、Zebra ソフトウェア ライセンス サーバーから取得したソフトウェア ライセンス ファイルの Base64 エンコードされた内容が、このリクエスト XML ドキュメントに埋め込まれる前に MDM エージェントによって Base64 エンコードされている必要があります。注: データ サイズは大きくなりますが、このオプションでは自己完結型のリクエスト XML の利点が得られます。

参照値 (オプション 2) は、デバイス ファイル システムに存在する必要があるソフトウェア ライセンス ファイルが、パスとファイル名で参照されていることを示します。注: このオプションでは、リクエスト XML が送信される前にソフトウェア ライセンス ファイルをデバイス ファイル システムに転送する必要があり、デバイスでのソフトウェア ライセンス ファイルの正確なパスとファイル名を指定する必要があります。エンタープライズ リセットの後にライセンスを適用する必要がある場合は、ライセンス ファイルを /enterprise ディレクトリなどの永続的な場所に保存する必要があります。

注: ソフトウェア ライセンス ファイル (埋め込みまたは参照) の提供方法にかかわらず、提供されたソフトウェア ライセンス ファイルには、Zebra ソフトウェア ライセンス サーバーから取得した有効なコンテンツが含まれている必要があります。無効なコンテンツを含むソフトウェア ライセンス ファイルを適用しようとすると、結果の XML にエラーが発生します。また、ソフトウェア ライセンス ファイルが個々のデバイス ライセンスである場合、ソフトウェア ライセンス ファイルに埋め込まれているデバイスのシリアル番号は、そのソフトウェア ライセンス ファイルが適用されるデバイスのシリアル番号と一致する必要があります。一致しないライセンスを適用しようとすると、結果の XML にエラーが生成されます。

次の場合に表示: ライセンス アクションが [Symbol]、ライセンスの選択が [Symbol] の場合

パラメータ名: LicenseMethod

オプション 名前 説明注記 要件
1 組み込み ライセンス ファイルからライセンス BLOB を XML に埋め込みます。

MX: 4.3+
2 参照 すでにデバイスにあるライセンス ファイルを参照します。

MX: 4.3+

ライセンス ファイル「Blob」

コンテンツが XML に埋め込まれている、ソフトウェア ライセンス ファイルを入力するために使用されます。コンテンツは Base64 でエンコードされ、これにより、コンテンツ サイズが約 33% 増加します。リクエスト XML 内でエンコードされたソフトウェア ライセンスが抽出され、デバイスに適用されます。

パラメータ値入力ルール:

  • 2 文字以上の文字列 (1 バイトのコンテンツを保持するために必要な最小値)
  • データは Base64 エンコードされている必要があります (4 文字で 3 バイトのコンテンツを保持)

次の場合に表示: ライセンス アクションが [適用] で、ライセンス メソッドが [埋め込み]、ライセンスの選択が [Symbol] の場合

パラメータ名: LicenseBlob

要件:

  • MX: 4.3+

ライセンス ファイルとパス

デバイス ファイル システムに存在し、Zebra ソフトウェア ライセンス サーバーから取得した正確なコンテンツが含まれている必要がある、ソフトウェア ライセンス ファイルのパスとファイル名を入力するために使用されます。このパラメータは、ソフトウェア ライセンス ファイルで指定されたソフトウェア ライセンスをデバイスに適用します。

パラメータ値入力ルール:

  • 最小サイズが 1 文字の文字列
  • デバイス ファイル システム内の有効なソフトウェア ライセンス ファイルの有効なパスおよびファイル名である必要があります

次の場合に表示: ライセンス アクションが [適用] で、ライセンスメソッドが [参照]、ライセンスの選択が [Symbol] の場合

パラメータ名: LicensePathAndFileName

要件:

  • MX: 4.3+

削除方式の選択

デバイスから削除するソフトウェア ライセンスを識別する、ライセンス機能名を選択する方法を制御します。

次の場合に表示: ライセンス アクションが [削除] でライセンスの選択が [Symbol] の場合

パラメータ名: SelectMethod

オプション 名前 説明注記 要件
1 標準 標準ライセンス機能名によりデバイスから削除されるソフトウェア ライセンスを識別することを示します。

MX: 4.3+
2 カスタム カスタム ライセンス機能名によりデバイスから削除されるソフトウェア ライセンスを識別することを示します。

MX: 4.3+

標準機能の削除

デバイスから削除するソフトウェア ライセンスを識別する目的の標準ライセンス機能名を入力するために使用されます。

次の場合に表示: 選択メソッドが [標準]、ライセンスの選択が [Symbol] の場合

パラメータ名: SelectStandardFeatureName

オプション 名前 説明注記 要件
SIMULDC1_0_0 SimulScan OCR/OMR SimulScan ソフトウェア コンポーネントのソフトウェア ライセンスをデバイスから削除します。

MX: +

カスタム機能の削除

デバイスから削除するソフトウェア ライセンスを識別するために、カスタム ライセンス機能名を入力するために使用されます。適切に削除するには、大文字と小文字の違い、空白文字などを含め、デバイスに適用されている元のソフトウェア ライセンス ファイルに含まれている正確なライセンス機能名を入力します。

パラメータ値入力ルール:

  • Zebra ソフトウェア ライセンス サーバーから取得したソフトウェア ライセンス ファイルに含まれる有効なカスタム ライセンス機能名を持つ文字列

次の場合に表示: 選択メソッドが [カスタム]、ライセンスの選択が [Symbol] の場合

パラメータ名: SelectCustomFeatureName

要件:

  • MX: 4.3+

例

適用されたすべてのソフトウェア ライセンスを表示します

リクエスト XML

以下のクエリでは、デバイスに適用されているすべてのソフトウェア ライセンスに関する情報を要求します。

    
    <wap-provisioningdoc>
        <characteristic-query type="LicenseMgr"/>
    </wap-provisioningdoc>

成功 (1 つの SimulScan ライセンス)

    
    <wap-provisioningdoc>
        <characteristic type="LicenseMgr" version="4.3" >
            <characteristic type="ExistingLicense">
                <parm name="SelectCustomFeatureName" value="SIMULDC1_0_0"/>
                <parm name="CompanyName" value="CompanyName1"/>
                <parm name="LicenseType" value="serial"/>
            </characteristic>
        </characteristic>
    </wap-provisioningdoc>

追加のソフトウェア ライセンスが適用された場合は、追加情報が成功の結果 XML に返されます。ソフトウェア ライセンスが適用されていないデバイスに送信された同じリクエスト XML は、次のようなエラー結果の XML を返します。

エラー結果の XML

    
    <wap-provisioningdoc>
        <characteristic type="LicenseMgr" version="4.3" >
            <characteristic-error type="ExistingLicense" desc="Feature is not licensed" />
        </characteristic>
    </wap-provisioningdoc>

特定のソフトウェア ライセンス情報を表示します

以下のクエリは、SimulScan ソフトウェア コンポーネントのソフトウェア ライセンスにのみ適用されます。

リクエスト XML

    
    <wap-provisioningdoc>
        <characteristic type="LicenseMgr" >
            <characteristic-query type="ExistingLicense">
                 <parm name="SelectStandardFeatureName" value="SIMULDC1_0_0"/>
            </characteristic-query>
        </characteristic>
    </wap-provisioningdoc>

成功 (1 つの SimulScan ライセンス)

    
    <wap-provisioningdoc>
        <characteristic type="LicenseMgr" version="4.3" >
            <characteristic type="ExistingLicense">
                <parm name="SelectCustomFeatureName" value="SIMULDC1_0_0"/>
                <parm name="CompanyName" value="CompanyName1"/>
                <parm name="LicenseType" value="serial"/>
            </characteristic>
        </characteristic>
    </wap-provisioningdoc>

エラー

    
    <wap-provisioningdoc>
        <characteristic type="LicenseMgr" version="4.3" >
            <characteristic-error type="ExistingLicense" desc="Feature is not licensed" />
        </characteristic>
    </wap-provisioningdoc>

ローカル サーバーからライセンスをアクティブ化します


<wap-provisioningdoc>
    <characteristic type="LicenseMgr" version="7.3" >
        <parm name="LicenseChoice" value="zebra"/>
    <characteristic type="LicenseZebra">
        <parm name="LicenseActionZebra" value="activate"/>
    <characteristic type="NewLicenseZebra">
    <characteristic type="LicenseSourceURL">
        <parm name="LicenseSource" value="LLS"/>
        <parm name="URL" value="http://10.61.206.102:7070/request"/>
        <parm name="ServerFriendlyName" value="Local Server Name"/>
    </characteristic>
        <parm name="ActivationID" value="0e62-2e66-53ec-4619-86bb-5246-ce58-24d5"/>
        <parm name="ActivationQuantity" value="1"/>
    </characteristic>
    </characteristic>
    </characteristic>
</wap-provisioningdoc>

ライセンスをローカル サーバーに返却します


<wap-provisioningdoc>
    <characteristic type="LicenseMgr" version="7.3" >
        <parm name="LicenseChoice" value="zebra"/>
    <characteristic type="LicenseZebra">
        <parm name="LicenseActionZebra" value="return"/>
    <characteristic type="ExistingLicenseZebra">
        <parm name="ReturnLicenseSource" value="3"/>
        <parm name="ReturnAIDLicenseSourceName" value="Local Server Name"/>
        <parm name="ActivationIDReturn" value="0e62-2e66-53ec-4619-86bb-5246-ce58-24d5"/>
        <parm name="ActivationQuantityReturn" value="1"/>
    </characteristic>
    </characteristic>
    </characteristic>
</wap-provisioningdoc>

すべてのライセンスをローカル サーバーに返却します


<wap-provisioningdoc>
    <characteristic type="LicenseMgr" version="7.3" >
        <parm name="LicenseChoice" value="zebra"/>
    <characteristic type="LicenseZebra">
        <parm name="LicenseActionZebra" value="reset"/>
    <characteristic type="ExistingLicenseZebra">
        <parm name="ReturnAllLicenseSource" value="3"/>
        <parm name="ReturnAllAIDLicenseSourceName" value="Local Server Name"/>
    </characteristic>
    </characteristic>
    </characteristic>
</wap-provisioningdoc>

クラウドベースのサーバーからライセンスをアクティブ化します


<wap-provisioningdoc>
    <characteristic type="LicenseMgr" version="7.3" >
        <parm name="LicenseChoice" value="zebra"/>
    <characteristic type="LicenseZebra">
        <parm name="LicenseActionZebra" value="activate"/>
    <characteristic type="NewLicenseZebra">
    <characteristic type="LicenseSourceURL">
        <parm name="LicenseSource" value="Zebra Cloud"/>
        <parm name="LicenseCloudURL" value="2"/>
    </characteristic>
        <parm name="ActivationID" value="0e62-2e66-53ec-4619-86bb-5246-ce58-24d5"/>
        <parm name="ActivationQuantity" value="1"/>
    </characteristic>
    </characteristic>
    </characteristic>
</wap-provisioningdoc>

クラウドベースのサーバーにライセンスを返却します


<wap-provisioningdoc>
    <characteristic type="LicenseMgr" version="7.3" >
        <parm name="LicenseChoice" value="zebra"/>
    <characteristic type="LicenseZebra">
        <parm name="LicenseActionZebra" value="return"/>
    <characteristic type="ExistingLicenseZebra">
        <parm name="ReturnLicenseSource" value="1"/>
        <parm name="ActivationIDReturn" value="0e62-2e66-53ec-4619-86bb-5246-ce58-24d5"/>
        <parm name="ActivationQuantityReturn" value="1"/>
    </characteristic>
    </characteristic>
    </characteristic>
</wap-provisioningdoc>

クラウドベースのサーバーにすべてのライセンスを返却します


<wap-provisioningdoc>
<characteristic type="LicenseMgr" version="7.3" >
    <parm name="LicenseChoice" value="zebra"/>
<characteristic type="LicenseZebra">
    <parm name="LicenseActionZebra" value="reset"/>
<characteristic type="ExistingLicenseZebra">
    <parm name="ReturnAllLicenseSource" value="1"/>
</characteristic>
</characteristic>
</characteristic>
</wap-provisioningdoc>

クラウド ソース リストからローカル サーバーを削除します


<wap-provisioningdoc>
    <characteristic type="LicenseMgr" version="7.3" >
        <parm name="LicenseChoice" value="zebra"/>
    <characteristic type="LicenseZebra">
        <parm name="LicenseActionZebra" value="deleteLicenseSource"/>
    <characteristic type="ExistingLicenseZebra">
        <parm name="DeleteLicenseSourceName" value="local server name"/>
    </characteristic>
    </characteristic>
    </characteristic>
</wap-provisioningdoc>

ライセンスを更新します


<wap-provisioningdoc>
    <characteristic type="LicenseMgr" version="8.1" >
        <parm name="LicenseChoice" value="zebra"/>
    <characteristic type="LicenseZebra">
        <parm name="LicenseActionZebra" value="refreshAID"/>
    <characteristic type="ExistingLicenseZebra">
        <parm name="ActivationIDRefresh" value="c3fe-2bd5-e8c0-4058-a93a-dc82-bab6-0939"/>
    </characteristic>
    </characteristic>
    </characteristic>
</wap-provisioningdoc>