跳轉到主要內容
本主題適用於 Linux 和 Windows 版 FRE。
LicensingSettings.xml 檔案包含 ABBYY FineReader Engine 的保護設定。當您使用具任何類型保護的網路授權,或使用具線上保護的單機授權時,Licensing Service (必要) 需要此檔案。 在自動模式下進行 Developer 安裝或執行階段安裝時,系統會自動產生此檔案。無論是網路安裝還是單機安裝,此檔案都會產生於以下兩個位置: 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 的設定包含兩個主要部分:
  1. 安裝在目前電腦上的 Licensing Service 設定,這些設定是在 <LocalLicenseServer> 標籤中指定。
  2. 與安裝了 Licensing Service 的網路伺服器之連線參數。這些參數是在 <LicensingServers><MainNetworkLicenseServer> 標籤中指定。
如果 ABBYY FineReader Engine 安裝在本機電腦上,則只需在必要時於 <LocalLicenseServer> 中指定設定。若 ABBYY FineReader Engine 在網路中運作,則 <LocalLicenseServer> 參數需在伺服器上指定,而 <LicensingServers><MainNetworkLicenseServer> 參數則需在工作站上指定。如果一台電腦同時作為伺服器和工作站使用,則應同時指定 <LocalLicenseServer> 和 <LicensingServers><MainNetworkLicenseServer> 參數。詳情請參閱下方的標籤說明。
在 Linux 中,ProtocolType 為 Sockets;在 Windows 中則為 TCP/IP。
| Licensing Service 預設使用 3022 連接埠。如果安裝 Licensing Service 的電腦上此連接埠已關閉,Licensing Service 將無法運作。在這種情況下,請在 <LocalLicenseServer> 或 <LicensingServers>&lt;MainNetworkLicenseServer> 標籤的 EndPointName 屬性中指定一個開放的連接埠,例如: &lt;LocalLicenseServer&gt; &lt;ConnectionProtocol ProtocolType="TCP/IP" EndPointName="1025"/&gt; &lt;/LocalLicenseServer&gt;&lt;LicensingServers&gt; &lt;MainNetworkLicenseServer ServerAddress="computername" ProtocolType="TCP/IP" EndPointName="1025"/&gt; &lt;/LicensingServers&gt; |

透過代理伺服器啟用授權 - 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。
| 工作站: &lt;LicensingServers&gt; ... &lt;/LicensingServers&gt; &lt;LicensesFolder Path="path_to_workstation_logs_folder"/&gt; 授權伺服器: &lt;LocalLicenseServer&gt; ... &lt;/LocalLicenseServer&gt; &lt;LicensesFolder Path="path_to_server_logs_folder"/&gt; |

設定備援授權伺服器組態

對於透過網路分配的授權,您可以設定雙伺服器組態,讓其中一台伺服器在另一台離線時作為備援。若要這麼做,您需要一個已啟用備援支援的特殊類型 Network 執行階段 授權。
  • 在伺服器上:
    • 主伺服器和備援伺服器都必須啟用相同的授權。
    • 每台伺服器都必須在 <LocalLicenseServer><RedundancyNetworkLicenseServer> 標籤中指定另一台伺服器的位址。
  • 在工作站上:
    • 所有工作站都必須在 <LicensingServers><MainNetworkLicenseServer> 和 <LicensingServers><BackupNetworkLicenseServer> 標籤中指定這兩台伺服器的位址。
在使用授權期間,工作站會與主要授權伺服器通訊,並將授權參數和使用統計資料傳送給它。主要授權伺服器會定期將這些資料與備援伺服器同步。如果主要授權伺服器發生故障,備援伺服器就會接手授權管理,並繼續儲存來自工作站的資訊。 請注意,備援伺服器會在經過一定的逾時時間後停止提供授權。此逾時值是在內部授權設定中指定,可介於 4 到 5000 小時之間。當主要授權伺服器重新上線後,若要重新連線至該伺服器,請使用 Engine 重新啟動處理程序 (先解除初始化,再重新初始化) 。 如果備援授權伺服器故障,而主伺服器仍正常運作,系統會繼續運作,如同僅有一台授權伺服器。當備援伺服器恢復後,它會與主伺服器同步,並重新作為備援伺服器運作。 若要在兩台伺服器上的授權到期後更新授權:
  1. 關閉其中一台伺服器。
  2. 在仍可使用的伺服器上更新授權。
  3. 關閉已更新授權的伺服器。
  4. 開啟先前關閉的伺服器。
  5. 在仍可使用的伺服器上更新授權。
  6. 啟動兩台伺服器,以恢復它們之間的連線。
  7. 在兩台伺服器上重新啟動 Licensing Service,以重新整理授權設定。
請參閱下方的工作站與伺服器備援設定範例。
在 Windows 中,伺服器與工作站之間的通訊會使用 TCP/IP 通訊協定。
| 工作站: &lt;LicensingServers&gt; &lt;MainNetworkLicenseServer ServerAddress="mainserver" ProtocolType="TCP/IP" EndPointName="1025"/&gt; &lt;BackupNetworkLicenseServer ServerAddress="backupserver" ProtocolType="TCP/IP" EndPointName="1025"/&gt; &lt;/LicensingServers&gt; 主授權伺服器: &lt;LocalLicenseServer&gt; &lt;ConnectionProtocol ProtocolType="TCP/IP" EndPointName="1025"/&gt; &lt;RedundancyNetworkLicenseServer ServerAddress="backupserver" ProtocolType="TCP/IP" EndPointName="1025"/&gt; &lt;/LocalLicenseServer&gt; 備援授權伺服器: &lt;LocalLicenseServer&gt; &lt;ConnectionProtocol ProtocolType="TCP/IP" EndPointName="1025"/&gt; &lt;RedundancyNetworkLicenseServer ServerAddress="mainserver" ProtocolType="TCP/IP" EndPointName="1025"/&gt; &lt;/LocalLicenseServer&gt; |
如果您需要使用此組態,請先確認您的授權支援此功能。詳情請聯絡您的業務經理。

標籤說明

LicensingSettings

LicensingSettings。

元素:

  • LocalLicenseServer
  • LicensingServers
  • LicensesFolder
  • ProxyServer (僅限 Linux)

1

保護設定。

LocalLicenseServer

LocalLicenseServerSettings。

元素:

  • ConnectionProtocol
  • EnableCodeMeterLicenses
  • OnlineLicensing
  • RedundancyNetworkLicenseServer

0…1

LicensingSettings

位於同一台電腦上的 Licensing Service 的參數。

ConnectionProtocol

複合型別。

屬性:

  • ProtocolType — 通訊協定型別。對於 Linux,請一律指定 Sockets 通訊協定。對於 Windows:LocalInterprocessCommunication、NamedPipes、TCP/IP 或 Sockets。
在 Windows 中,這是本機 Licensing Service 的附加通訊協定型別。獨立安裝時無需指定此屬性,因為獨立授權一律使用 LocalInterprocessCommunication 通訊協定型別。
  • EndPointName — (選填) 連接埠號碼。預設值為 “3022”。

0…1

LocalLicenseServer

連線通訊協定的參數。

OnlineLicensing

複合型別。

屬性:

  • Timeout — (選填) 指定重新連線的週期

目前透過 Proxy 伺服器連線時,唯一支援的通訊協定為 HTTP,您可以為其指定以下屬性:

  • ProxyServer — (選填) Proxy 伺服器的位址及連線設定,格式為字串 ” protocol://server:port”,各子字串的含義如下:
  • protocol — 用於連線至 Proxy 伺服器的通訊協定。目前唯一支援的值為 HTTP。
  • server — Proxy 伺服器的名稱或 IP 位址。
  • port — 連線連接埠。
  • ProxyAuth — (選填) 向 Proxy 伺服器進行驗證,格式為字串 “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

為在備援雙伺服器設定中協同運作的每台網路授權伺服器,指定與另一台伺服器的連線及同步設定。

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

The parameters of the connection with the main network server where the Licensing Service is installed.

BackupNetwork
LicenseServer

NetworkServerAddress。

屬性:

  • ServerAddress — 安裝授權服務之電腦的 DNS 名稱或 IP 位址。
  • ProtocolType — 通訊協定類型。對於 Linux,請一律指定 Sockets 通訊協定。對於 Windows:LocalInterprocessCommunication、 NamedPipes、TCP/IP 或 Sockets。
  • EndPointName — (選填) 連接埠號碼。預設值為 “3022”。

0…1

LicensingServers

與備份網路授權伺服器連線的參數。

LicensesFolder

複合類型。

屬性:

  • Path - 含授權資訊之資料夾的路徑。 預設值為 “%ProgramData%\ABBYY\SDK\12\Licenses”。
    授權資料資料夾的完全控制權限:
    • 位於授權伺服器上的資料夾為必要項目
    • 位於工作站上的資料夾為選填項目

0…1

LicensingSettings

指定應儲存含授權輔助資訊之資料夾的位置。

ProxyServer

ProxyServer。

屬性:

  • Server — Proxy 伺服器的位址及連線設定,格式為字串 “protocol://server:port”, 其中各子字串的意義如下:
    • protocol 連線至 Proxy 伺服器所使用的通訊協定:SOCKS5 或 HTTP。
    • server — Proxy 伺服器的名稱或 IP 位址。
    • port — 連線連接埠。
  • Login — (選填) 授權用的使用者名稱。
  • Password — (選填) 授權用的密碼。

0…1

LicensingSettings

透過 Proxy 伺服器進行網際網路連線的設定,授權啟用時需要此設定。

此標籤僅在 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 檔案:一個供工作站使用,另一個供伺服器使用。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>

另請參閱

發行 Distribution Kit 安裝 Licensing Service