本主題適用於 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 設定,這些設定是在 <LocalLicenseServer> 標籤中指定。
與安裝了 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><MainNetworkLicenseServer> 標籤的 EndPointName 屬性中指定一個開放的連接埠,例如: <LocalLicenseServer> <ConnectionProtocol ProtocolType="TCP/IP" EndPointName="1025"/> </LocalLicenseServer> 或 <LicensingServers> <MainNetworkLicenseServer ServerAddress="computername" ProtocolType="TCP/IP" EndPointName="1025"/> </LicensingServers> |
如果您的電腦是透過代理伺服器連線至網際網路,且需要啟用授權,請在 <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 屬性。授權資料夾必須具備完整控制權限:
若資料夾位於授權伺服器上,則為必要條件
若資料夾位於工作站上,則為選用
範例中顯示的 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"/> |
對於透過網路分配的授權,您可以設定雙伺服器組態,讓其中一台伺服器在另一台離線時作為備援。若要這麼做,您需要一個已啟用備援支援的特殊類型 Network 執行階段 授權。
在伺服器上:
主伺服器和備援伺服器都必須啟用相同的授權。
每台伺服器都必須在 <LocalLicenseServer><RedundancyNetworkLicenseServer> 標籤中指定另一台伺服器的位址。
在工作站上:
所有工作站都必須在 <LicensingServers><MainNetworkLicenseServer> 和 <LicensingServers><BackupNetworkLicenseServer> 標籤中指定這兩台伺服器的位址。
在使用授權期間,工作站會與主要授權伺服器通訊,並將授權參數和使用統計資料傳送給它。主要授權伺服器會定期將這些資料與備援伺服器同步。如果主要授權伺服器發生故障,備援伺服器就會接手授權管理,並繼續儲存來自工作站的資訊。
請注意,備援伺服器會在經過一定的逾時時間後停止提供授權。此逾時值是在內部授權設定中指定,可介於 4 到 5000 小時之間。當主要授權伺服器重新上線後,若要重新連線至該伺服器,請使用 Engine 重新啟動處理程序 (先解除初始化,再重新初始化) 。
如果備援授權伺服器故障,而主伺服器仍正常運作,系統會繼續運作,如同僅有一台授權伺服器。當備援伺服器恢復後,它會與主伺服器同步,並重新作為備援伺服器運作。
若要在兩台伺服器上的授權到期後更新授權:
關閉其中一台伺服器。
在仍可使用的伺服器上更新授權。
關閉已更新授權的伺服器。
開啟先前關閉的伺服器。
在仍可使用的伺服器上更新授權。
啟動兩台伺服器,以恢復它們之間的連線。
在兩台伺服器上重新啟動 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 ) 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
複合型別。
屬性:
目前透過 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 伺服器進行網際網路連線的設定,授權啟用時需要此設定。
下列範例顯示適用於獨立安裝的簡單 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