LicensingSettings.xml ファイルの使用

ABBYY FineReader Engine の LicensingSettings.xml ファイルを設定します。保護設定、Licensing Service への接続、ネットワークライセンスまたはオンライン ライセンスの設定について説明します。

このトピックは、Linux 版および Windows 版の FRE に適用されます。

LicensingSettings.xml ファイルには、ABBYY FineReader Engine の保護設定が含まれています。任意の保護タイプのネットワークライセンス、またはオンライン保護付きのスタンドアロンライセンスを使用する場合、このファイルは Licensing Service に必要です。

このファイルは、自動モードでの Developer または Runtime installation 時に自動的に生成されます。ネットワークインストールでもスタンドアロンインストールでも、このファイルは次の 2 か所に生成されます。

Linux:

• インストールフォルダー内の Bin
• インストールフォルダー内の CommonBin/Licensing フォルダー

Windows:

• %CommonProgramFiles(x86)%\ABBYY\SDK\12\Licensing\
• <Installation Folder>\Bin64\ (使用可能な場合)
• <Installation Folder>\Bin\ (使用可能な場合)

手動でインストールする場合は、このファイルを作成し、正しい設定を指定する必要があります。Linux では、上記の両方のフォルダーにこのファイルを作成します。Windows では、Bin (Bin64) フォルダーにこのファイルを作成します。

Licensing Service の設定用 XML スキーマは、LicensingSettings.xsd ファイルに記載されています。このファイルは Inc フォルダーにあります。

​

Licensing Service の設定の変更

Licensing Service の設定は、大きく次の 2 つに分かれます。

1. 現在のコンピューターにインストールされている Licensing Service の設定。これは <LocalLicenseServer> タグで指定します。
2. Licensing Service がインストールされているネットワークサーバーへの接続パラメーター。これらのパラメーターは <LicensingServers><MainNetworkLicenseServer> タグで指定します。

ABBYY FineReader Engine がローカルコンピューターにインストールされている場合は、必要に応じて <LocalLicenseServer> でのみ設定を指定してください。一方、ABBYY FineReader Engine をネットワークで使用する場合は、<LocalLicenseServer> のパラメーターはサーバー上で、<LicensingServers><MainNetworkLicenseServer> のパラメーターはワークステーション上で指定します。1 台のコンピューターをサーバーとワークステーションの両方として使用する場合は、<LocalLicenseServer> と <LicensingServers><MainNetworkLicenseServer> の両方のパラメーターを指定する必要があります。詳しくは、以下のタグの説明を参照してください。

ポート番号を変更するには

Linux では ProtocolType は Sockets、Windows では TCP/IP です。

Licensing Service は既定でポート 3022 を使用します。Licensing Service がインストールされているコンピューターでこのポートが閉じていると、Licensing Service は動作しません。この場合は、<LocalLicenseServer> または <LicensingServers>\<MainNetworkLicenseServer> タグの EndPointName 属性に、開いているポートを指定してください。例:

<LocalLicenseServer><ConnectionProtocol ProtocolType="TCP/IP" EndPointName="1025"/> </LocalLicenseServer>

または

<LicensingServers>
  {" "}
  <MainNetworkLicenseServer ServerAddress="computername" ProtocolType="TCP/IP" EndPointName="1025" />{" "}
</LicensingServers>

​

プロキシサーバー経由でのライセンスのアクティベーション - Linux

マシンがプロキシサーバー経由でインターネットに接続されている環境でライセンスをアクティベートする必要がある場合は、<ProxyServer> タグに接続パラメーターを指定します。

サポートされるプロトコルは SOCKS5 と HTTP です。HTTP ではベーシック認証または認証なしを使用でき、SOCKS ではユーザー名/パスワード認証または認証なしを使用できます。

以下は、プロキシサーバー経由でアクティベーションを行うためのサンプルファイルです。

  <LocalLicenseServer>
    <ConnectionProtocol ProtocolType="Sockets" />
  </LocalLicenseServer>
  <ProxyServer Server="protocol://server_name:port_number" Login="login" Password="password" />

​

プロキシサーバー経由でオンライン ライセンスを使用する

オンライン ライセンスでは特別な設定は不要ですが、プロキシサーバー経由で接続する場合は、<OnlineLicensing> タグでそのパラメーターを指定する必要があります。

サポートされるプロトコルは HTTP で、認証方式として Anonymous、Basic、または Digest を使用できます。

以下は、オンライン ライセンスのプロキシサーバー設定を含むサンプル ファイルです。

  <LocalLicenseServer>
    <OnlineLicensing Timeout="timeout_time" ProxyServer="http://server_name:port_number" ProxyAuth="login:password" />
    <ConnectionProtocol ProtocolType="protocol_type" />
  </LocalLicenseServer>

​

ライセンスデータのパスの設定

既定では、ABBYY FineReader Engine は、ライセンスに関する補助情報を %ProgramData%\ABBYY\SDK\12\Licenses に保存します。別のフォルダーを指定するには、<LicensesFolder> タグの Path 属性を指定します。ライセンスデータフォルダーに対するフルコントロール権限は、次のとおりです。

• ライセンスサーバー上のフォルダーでは必須
• ワークステーション上のフォルダーでは任意

InitializeEngine 関数を使用して、ライセンスデータフォルダーを再設定することもできます。

ライセンスデータフォルダーの指定例

サンプルに示されている LicenseFolder の Path は Windows 用です。Linux のパスは、それぞれ /home/user/workstation_logs_folder と /home/user/server_logs_folder です。

ワークステーションの場合:

<LicensingServers>
...
</LicensingServers>
<LicensesFolder Path="path_to_workstation_logs_folder">

ライセンスサーバーの場合:

<LocalLicenseServer>
...
</LocalLicenseServer>
<LicensesFolder Path="path_to_server_logs_folder">

​

冗長ライセンスサーバー構成の設定

ネットワーク経由で配布されるライセンスでは、2 台のサーバーで構成することで、一方のサーバーがオフラインになった場合に、もう一方のサーバーをバックアップとして機能させることができます。これを行うには、冗長化サポートが有効になっている特別な種類の Network Runtime License が 1 つ必要です。

• サーバー側:
  • メインサーバーとバックアップサーバーの両方で、同じライセンスをアクティブ化する必要があります。
  • 各サーバーでは、<LocalLicenseServer><RedundancyNetworkLicenseServer> タグで相手側サーバーのアドレスを指定する必要があります。
• ワークステーション側:
  • すべてのワークステーションで、<LicensingServers><MainNetworkLicenseServer> タグおよび <LicensingServers><BackupNetworkLicenseServer> タグに両方のサーバーのアドレスを指定する必要があります。

ライセンスの使用中、ワークステーションはメインライセンスサーバーと通信し、ライセンスパラメーターと使用統計を送信します。メインライセンスサーバーは、このデータを定期的にバックアップサーバーと同期します。メインライセンスサーバーに障害が発生した場合は、バックアップサーバーがライセンス管理を引き継ぎ、ワークステーションから送られてくる情報の保存を継続します。

なお、バックアップサーバーは一定時間が経過するとライセンスの提供を停止します。このタイムアウトは内部ライセンス設定で指定され、4 ～ 5000 時間の範囲で設定できます。メインライセンスサーバーがオンラインに戻った後に再接続するには、Engine を使用した処理を再起動してください (いったん解放してから再度初期化します) 。

メインサーバーが正常に動作している間にバックアップライセンスサーバーに障害が発生した場合、システムはライセンスサーバーが 1 台しかない場合と同様に動作し続けます。バックアップサーバーが復旧すると、メインサーバーと同期され、再びバックアップとして動作を開始します。

両方のサーバーで有効期限切れ後にライセンスを更新するには:

1. いずれか一方のサーバーを停止します。
2. 稼働しているサーバーでライセンスを更新します。
3. 更新したライセンスがあるサーバーを停止します。
4. 先ほど停止したサーバーを起動します。
5. 稼働しているサーバーでライセンスを更新します。
6. 両方のサーバーを起動して、サーバー間の接続を復旧します。
7. 両方のサーバーで Licensing Service を再起動し、ライセンス設定を更新します。

以下に、ワークステーションおよびサーバーで冗長化を設定するサンプルを示します。

冗長構成のサンプル

Windows では、サーバーとワークステーション間の通信に TCP/IP プロトコルが使用されます。

ワークステーションの場合:

<LicensingServers>
<MainNetworkLicenseServer ServerAddress="mainserver" ProtocolType="TCP/IP" EndPointName="1025"/>
<BackupNetworkLicenseServer ServerAddress="backupserver" ProtocolType="TCP/IP" EndPointName="1025"/>
</LicensingServers>

メインライセンスサーバーの場合:

<LocalLicenseServer>
<ConnectionProtocol ProtocolType="TCP/IP" EndPointName="1025"/>
<RedundancyNetworkLicenseServer ServerAddress="backupserver" ProtocolType="TCP/IP" EndPointName="1025"/>
</LocalLicenseServer>

バックアップライセンスサーバーの場合:

<LocalLicenseServer>
<ConnectionProtocol ProtocolType="TCP/IP" EndPointName="1025"/>
<RedundancyNetworkLicenseServer ServerAddress="mainserver" ProtocolType="TCP/IP" EndPointName="1025"/>
</LocalLicenseServer>

この構成を使用する必要がある場合は、お使いのライセンスが対応していることを確認してください。詳細については、営業担当者にお問い合わせください。

​

タグの説明

LicensingSettings	LicensingSettings. 要素： LocalLicenseServer LicensingServers LicensesFolder ProxyServer (Linux Only)	1	no	保護設定。
LocalLicenseServer	LocalLicenseServerSettings. 要素： ConnectionProtocol EnableCodeMeterLicenses OnlineLicensing RedundancyNetworkLicenseServer	0…1	LicensingSettings	同一コンピューター上の Licensing Service のパラメーター。
ConnectionProtocol	複合型。 属性： ProtocolType — プロトコルの型。Linux の場合は、常に Sockets プロトコルを指定してください。Windows の場合：LocalInterprocessCommunication、NamedPipes、TCP/IP、または Sockets。 Windows では、これはローカル Licensing Service の追加プロトコル型です。スタンドアロン インストールの場合、Standalone ライセンスは常に LocalInterprocessCommunication プロトコル型で使用されるため、この属性を指定する必要はありません。 EndPointName — (省略可能) ポート番号。デフォルト値は “3022”。	0…1	LocalLicenseServer	接続プロトコルのパラメーター。
OnlineLicensing	複合型。 属性： Timeout — (省略可能) 再接続の間隔を指定します。 現在、プロキシ サーバー経由の接続でサポートされているプロトコルは HTTP のみです。HTTP を使用する場合、以下の属性を指定できます： ProxyServer — (省略可能) プロキシ サーバーのアドレスと接続設定を、文字列 ” protocol://server:port” の形式で指定します。各部分の意味は次のとおりです： protocol — プロキシ サーバーへの接続に使用するプロトコル。現在サポートされている値は HTTP のみです。 server — プロキシ サーバーの名前または IP アドレス。 port — 接続ポート。 ProxyAuth — (省略可能) プロキシ サーバーへの認証情報を、文字列 “login:password” の形式で指定します。各部分の意味は次のとおりです： login — 認証に使用するユーザー名。 password — 認証に使用するパスワード。	0…1	LocalLicenseServer	コンピューターでオンライン ライセンスを使用できるかどうかを指定します。
RedundancyNetwork LicenseServer	NetworkServerAddress. 属性： ServerAddress — 冗長構成における別サーバーの DNS 名または IP アドレス。 ProtocolType — プロトコルの型。Linux の場合：常に Sockets プロトコルを指定してください。Windows の場合：LocalInterprocessCommunication、NamedPipes、TCP/IP、または Sockets。 EndPointName — (省略可能) ポート番号。デフォルト値は “3022”。	0…1	LocalLicenseServer	冗長な 2 サーバー構成で連携して動作する各ネットワーク ライセンス サーバーについて、別サーバーへの接続と同期の設定を指定します。
LicensingServers	複合型。 要素： MainNetworkLicenseServer BackupNetworkLicenseServer	0…1	LicensingSettings	Licensing Service がインストールされているネットワーク サーバーの一覧。
MainNetworkLicense Server	NetworkServerAddress. 属性： ServerAddress — Licensing Service がインストールされているコンピューターの DNS 名または IP アドレス。 ProtocolType — プロトコルの型。Linux の場合：常に Sockets プロトコルを指定してください。 Windows: LocalInterprocessCommunication, NamedPipes, TCP/IP, or Sockets. EndPointName — (optional) port number. By default, “3022”.	1	LicensingServers	メインネットワークサーバー (ライセンスサービスがインストールされているサーバー) との接続パラメーター。
BackupNetwork LicenseServer	NetworkServerAddress. Attributes: ServerAddress — ライセンスサービスがインストールされているコンピューターの DNS 名または IP アドレス。 ProtocolType — the protocol type. For Linux, always specify Sockets protocol. For Windows: LocalInterprocessCommunication, NamedPipes, TCP/IP, or Sockets. EndPointName — (optional) port number. By default, “3022”.	0…1	LicensingServers	バックアップネットワークライセンスサーバーとの接続パラメーター。
LicensesFolder	Complex Type. Attributes: Path - ライセンス情報を含むフォルダーへのパス。 デフォルトは “%ProgramData%\ABBYY\SDK\12\Licenses” です。 ライセンスデータフォルダーへのフルコントロール権限: ライセンスサーバー上のフォルダーには必須 ワークステーション上のフォルダーには任意	0…1	LicensingSettings	ライセンスに関する補助情報を含むフォルダーの保存場所を指定します。
ProxyServer	ProxyServer。 属性: Server — プロキシサーバーのアドレスと接続設定。文字列 “protocol://server:port” の形式で指定します。各部分の意味は次のとおりです: protocol — プロキシサーバーへの接続に使用するプロトコル: SOCKS5 または HTTP。 server — プロキシサーバーの名前または IP アドレス。 port — 接続ポート。 Login — (省略可能) 認証用のユーザー名。 Password — (省略可能) 認証用のパスワード。	0…1	LicensingSettings	ライセンスのアクティベーションに必要な、プロキシサーバー経由のインターネット接続設定。 このタグは Linux のみで実装されています。

​

サンプル

次のサンプルは、スタンドアロンインストール向けのシンプルな LicensingSettings.xml ファイルを示しています。Windows では、ローカルのプロセス間通信を使用します。

<?xml version="1.0" encoding="utf-8"?>
<LicensingSettings xmlns="http://www.abbyy.com/Protection/LicensingSettings">
  <LocalLicenseServer>
    <ConnectionProtocol ProtocolType="LocalInterprocessCommunication" />
  </LocalLicenseServer>
</LicensingSettings>

以下のサンプルは、ネットワーク インストール向けのシンプルな LicensingSettings.xml ファイルです。1 つはワークステーション用、もう 1 つはサーバー用です。Licensing Service は、“computername” という名前のコンピューターにあります。Windows では、サーバーとワークステーション間の通信に TCP/IP プロトコルが使用されます。

ワークステーションの場合:

<?xml version="1.0" encoding="utf-8"?>
<LicensingSettings xmlns="http://www.abbyy.com/Protection/LicensingSettings">
  <LicensingServers>
    <MainNetworkLicenseServer ServerAddress="computername" ProtocolType="TCP/IP" />
  </LicensingServers>
</LicensingSettings>

サーバー向け:

<?xml version="1.0" encoding="utf-8"?>
<LicensingSettings xmlns="http://www.abbyy.com/Protection/LicensingSettings">
  <LocalLicenseServer>
    <ConnectionProtocol ProtocolType="TCP/IP" />
  </LocalLicenseServer>
</LicensingSettings>

​

関連項目

配布

配布キット

Licensing Serviceのインストール