僅當您使用 Software 或 Online protection 時,才可進行手動網路安裝。
線上保護
線上保護
在此情境中,您將手動在伺服器及透過網路連接至該伺服器的工作站上,安裝使用 ABBYY FineReader Engine 程式庫的應用程式。您將需要:若要實作此情境,您需要在授權伺服器上安裝 Licensing Service——這台電腦將負責在網路中管理並分發授權給各工作站。完成後,在各工作站上安裝程式庫、設定與授權伺服器的連線,並將授權憑證複製到每台工作站。預設使用 3022 TCP/IP 連接埠。如果此連接埠在您的伺服器上已關閉,請指定另一個開放的連接埠:如果您為伺服器設定了其他 TCP/IP 連接埠,請在此處進行相同的設定。
- 一個線上授權權杖檔案 (檔名類似 SWRTXXXXXXXXXXXXXXXXXXXX.ABBYY.ActivationToken) 。
應用程式執行時需要連線到網際網路。
為簡化建立自訂套件的流程,請在命令列中使用發行套件內 installRnt**.exe 或 installLS.exe 的 /extract 選項,將檔案解壓縮到指定資料夾,而不執行安裝。資料夾內會包含下列子資料夾:
-
若為 installRnt**.exe:
- FineReader Engine - 包含 ABBYY FineReader Engine 檔案
- Inc - 包含 FREngine.tlb (用於註冊 FREngine.dll)
- Licensing - 包含 Licensing Service 檔案
-
若為 installLS.exe:
- Licensing - 包含 Licensing Service 檔案
- License Server - 包含 License Server 檔案
在您的電腦上建立 ABBYY FineReader Engine 套件:
-
函式庫套件。這是一個資料夾,內含《開發人員說明》中「ABBYY FineReader Engine 發行套件」章節所列的 ABBYY FineReader Engine 檔案。清單包括:
- ABBYY FineReader Engine 發行套件中標示為 “mandatory” 的檔案。這些檔案屬於系統模組和主要識別資料庫。
- 如果您要識別仿印刷體文字,則需包含仿印刷體文字的識別資料庫。
- 您的應用程式會使用的介面語言資源檔案。
- 您的應用程式將支援之識別語言的字典支援檔案。若識別語言包含使用拉丁字母的語言,請務必選取 Univers.amd 和 Univers.amm 檔案。
- 如果您的應用程式會透過 ABBYY FineReader Engine 介面執行掃描,則需包含掃描模組、掃描專用資源以及 Twain 模組。
- 如果您的應用程式使用 ABBYY FineReader Engine Visual Components,則需包含 Windows Visual Components 模組及其對應的專用資源。
-
License Server 套件。包含兩個資料夾,內含 Licensing Service 和授權管理工具程式的檔案:
- Licensing Service 資料夾,內含從解壓縮後的 Licensing 資料夾複製的所有檔案。
- 授權管理員 (License Manager64) 資料夾,內含從解壓縮後的 License Server 資料夾複製的下列檔案:AbbyyZlib.dll、Awl.dll、concrt140.dll、FineFormats.dll、FineNet.dll、FineObj.dll、LicenseManager.exe、LicenseManager12.chm、LicensingSchema.xe、msvcp140.dll、ProductLicensingSchema.xe、Protection.dll、ProtectionRes0.dll、ProtectionResShared.dll、ProtectionUI.dll、vccorlib140.dll、vcruntime140.dll。
-
其他軟體元件:
- KB2999226 更新,或 Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912。若您未安裝 Windows Update 套件,則可從發行套件中的 External Components\VC_Redist 資料夾安裝 Redistributable:vc_redist.x86.exe 和 vc_redist.x64.exe。
- 若您打算使用 OfficeConverters 模組,則需要 .NET Framework 4.6.2。
在 License Server 上安裝 Licensing Service:
安裝時需要管理員權限。
- 將 License Server 套件和 Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912 複製到授權伺服器。
- 安裝 Microsoft Visual C++ 2015-2019 可轉散發套件 14.28.29912。
- 將 License Server 套件中的資料夾複製到授權伺服器上您預定安裝 Licensing Service 的目錄中。
我們建議您以易於尋找和使用的資料夾結構來整理 ABBYY FineReader Engine 檔案。請參閱以下範例:
- <YourApplicationFolder>/License Server/Licensing Service.
- <YourApplicationFolder>/License Server/授權管理員 (License Manager64).
-
建立一個用來儲存授權資料的資料夾 (預設為
%ProgramData%\ABBYY\SDK\12\Licenses資料夾) 。每位執行您應用程式的使用者都必須對此資料夾具有完全控制權限。 - 建立 LicensingSettings.xml 檔案。其必須符合的 XML 結構描述可在 LicensingSettings.xml 檔案 中找到;該檔案位於您開發人員安裝中的 Inc 資料夾,或發行套件中的 CADF\Inc 資料夾。在此檔案中,您需要設定授權伺服器將使用的連線通訊協定型別。支援的型別包括 LocalInterprocessCommunication、NamedPipes、TCP/IP 和 Sockets:
<LocalLicenseServer>
<ConnectionProtocol ProtocolType="TCP/IP" EndPointName="1025"/>
</LocalLicenseServer>
<LocalLicenseServer>
<ConnectionProtocol ProtocolType="TCP/IP" EndPointName="1025"/>
</LocalLicenseServer>
-
將設定好的 LicensingSettings.xml 檔案複製到下列資料夾中:
- Licensing Service。
- 授權管理員 (License Manager64)。
- 使用 “/install” 參數來執行 LicensingService.exe:
LicensingService.exe /install
在 License Server 上啟用授權:
線上授權無需啟用:授權資訊會在應用程式執行階段從 ABBYY Online licensing services 接收。授權時,應用程式會傳送授權 token 檔案及授權密碼。您需要將 token 檔案放置於應用程式預期的位置,該位置必須由開發人員指定 (預設為 %ProgramData%\ABBYY\SDK\12\Licenses) 。在執行階段,應用程式需要定期連線至 ABBYY Online licensing services,以接收授權資訊並傳送使用統計資料。不會與 ABBYY 伺服器交換任何私人資訊。- 請確認您已允許透過連接埠 443 (HTTPS) 連線至 *.abbyy.com。如果連線中斷,且超過一定的重新連線逾時時間,應用程式將停止運作。同步週期與重新連線逾時是各個線上授權的特定參數。
無法在同一台主機上同時使用兩個以上的線上授權。當應用程式正在執行,且與 ABBYY 授權服務的連線正常時,您可以使用 授權管理工具程式 檢視目前啟用的線上授權詳細資料。
在工作站上安裝 ABBYY FineReader Engine 程式庫:
如果授權伺服器也將作為工作站使用,也請對該伺服器執行此步驟。
- 將 Library 套件和軟體元件複製到所有工作站。
要確保程式能找到所有資源檔案,最簡單的方法是維持相同的資料夾結構,並將位於 Bin (或 Bin64) 資料夾中的 SharedFiles.ini 檔案納入您的發行套件;請依您的作業系統選擇對應的資料夾。若您不想使用此檔案,則不必維持資料夾結構,請改為執行下列操作:
- 將 Data\Resource 資料夾及其所有子資料夾複製到下列資料夾:
- Bin
- Bin64
- 將 Data\ExtendedDictionaries 資料夾中的內容直接複製到 Bin 或 Bin64 資料夾。
- 將 Data 資料夾中的其他檔案複製到 Bin 或 Bin64 資料夾。
-
安裝所需的軟體元件:
- Microsoft Visual C++ 2015-2019 可轉散發套件 14.28.29912。
- .NET Framework (如有需要) 。
- 將 Library Package 中包含 ABBYY FineReader Engine 檔案的資料夾,複製到工作站上預計存放程式庫的目錄。
-
註冊您需要的動態程式庫:
- 如果您的應用程式是透過 IEngineLoader 介面載入 Engine 物件,請使用下列命令列來註冊 FREngine.dll:
regsvr32 /s /n /i:"<path to the Inc folder>" "<path to FREngine.dll>"- 若您的應用程式使用 Visual Components,請透過下列命令列註冊 VisualComponentsX.dll:
regsvr32 /s "<path to VisualComponentsX.dll>"如果您在使用 COM 載入器或 Visual Components 時遇到問題,請檢查登錄檔中這些元件的路徑設定;如果有錯誤,請重新進行註冊程序。 -
建立 ABBYY FineReader Engine 將使用的資料夾。下列清單中會標示這些資料夾的預設值:
- 資料夾 %ProgramData%\ABBYY\SDK\12\FineReader Engine (需要完整控制權限)
- 資料夾 %ProgramData%\ABBYY\SDK\12\Licenses (授權伺服器需要完整控制權限,工作站則為選擇性)
若要在安裝期間指定授權資料存放資料夾,請參閱 Working with the LicensingSettings.xml File 中的範例。您也可以使用 InitializeEngine 函式,或 IEngineLoader 介面 的方法。
- 將授權權杖複製到每個工作站上的預設資料夾,或複製到您的應用程式在 InitializeEngine 函式中所使用路徑的資料夾。
建立 LicensingSettings.xml 檔案:
建立 LicensingSettings.xml 檔案,並設定與伺服器相同的連線通訊協定類型和伺服器位址:<LicensingServers>
<MainNetworkLicenseServer ServerAddress="[your server address]" ProtocolType="[your protocol type]"/>
</LicensingServers>
<LicensingServers>
<MainNetworkLicenseServer ServerAddress="[your server address]" ProtocolType="TCP/IP" EndPointName="1025"/>
</LicensingServers>
複製已設定的 LicensingSettings.xml 檔案:
將已設定好的 LicensingSettings.xml 檔案複製到每台工作站上存放 ABBYY FineReader Engine 檔案的資料夾中 (與 FREngine.dll 位於同一目錄) :注意:如果授權伺服器同時也作為工作站使用,則伺服器的 LicensingSettings.xml 檔案必須同時包含 LicensingServers 和 LocalLicenseServer 標籤,格式與上述相同。該檔案的內容如下所示:<?xml version="1.0" encoding="utf-8"?>
<LicensingSettings xmlns="http://www.abbyy.com/Protection/LicensingSettings">
<LicensingServers>
<MainNetworkLicenseServer ServerAddress="[your server address]" ProtocolType="[your protocol type]"/>
</LicensingServers>
<LocalLicenseServer>
<ConnectionProtocol ProtocolType="[your protocol type]"/>
</LocalLicenseServer>
</LicensingSettings>
軟體保護模式
軟體保護模式
在此情境中,您將手動在伺服器及透過網路連接至該伺服器的工作站上,安裝使用 ABBYY FineReader Engine 程式庫的應用程式。您將需要:預設使用 3022 TCP/IP 連接埠。若此連接埠在您的伺服器上已關閉,請指定另一個可用的連接埠:如果您為伺服器設定了其他 TCP/IP 連接埠,請在此處進行相同的設定。
- Network Runtime License 的序號。
為簡化建立自訂套件的流程,您可以在命令列中對發行套件內的 installRnt**.exe 或 installLS.exe 使用 /extract 選項,將檔案解壓縮到指定資料夾,而無需安裝。資料夾內會包含以下內容:
-
針對 installRnt**.exe:
- FineReader Engine - 包含 ABBYY FineReader Engine 檔案
- Inc - 包含 FREngine.tlb (用於註冊 FREngine.dll)
- Licensing - 包含 Licensing Service 檔案
-
針對 installLS.exe:
- Licensing - 包含 Licensing Service 檔案
- License Server - 包含 License Server 檔案
在您的電腦上建立 ABBYY FineReader Engine 套件:
-
程式庫套件。這是一個資料夾,內含 Developer’s Help 中「ABBYY FineReader Engine 發行套件」一節所列的 ABBYY FineReader Engine 檔案。清單包括:
- 在 ABBYY FineReader Engine 發行套件中標示為 “mandatory” 的檔案。這些檔案為系統模組和主要識別資料庫。
- 若您要識別仿印刷體文字,則需包含仿印刷體文字的識別資料庫。
- 您的應用程式將使用之介面語言的資源檔案。
- 您的應用程式將支援之識別語言的字典支援檔案。如果識別語言包含使用拉丁字母的語言,請務必選取 Univers.amd 和 Univers.amm 檔案。
- 若您的應用程式將透過 ABBYY FineReader Engine 介面執行掃描,則需包含掃描模組、掃描專用資源及 Twain 模組。
- 若您的應用程式使用 ABBYY FineReader Engine Visual Components,則需包含 Windows Visual Components 模組及其對應的專用資源。
-
License Server 套件。它包含兩個資料夾,分別存放 Licensing Service 和授權管理工具程式的檔案:
- Licensing Service 資料夾,內含從解壓縮後的 Licensing 資料夾複製的所有檔案。
- 授權管理員 (License Manager64) 資料夾,內含從解壓縮後的 License Server 資料夾複製的下列檔案:AbbyyZlib.dll, Awl.dll, concrt140.dll, FineFormats.dll, FineNet.dll, FineObj.dll, LicenseManager.exe, LicenseManager12.chm, LicensingSchema.xe, msvcp140.dll, ProductLicensingSchema.xe, Protection.dll, ProtectionRes0.dll, ProtectionResShared.dll, ProtectionUI.dll, vccorlib140.dll, vcruntime140.dll。
-
其他軟體元件:
- KB2999226 更新,或 Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912。若您未安裝 Windows Update 套件,可從發行套件中的 External Components\VC_Redist 資料夾安裝可轉散發套件:vc_redist.x86.exe 和 vc_redist.x64.exe。
- 若您打算使用 OfficeConverters 模組,則需要 .NET Framework 4.6.2。
在 License Server 上安裝 Licensing Service:
安裝需要具備系統管理員權限。
- 將授權伺服器套件和 Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912 複製到授權伺服器上。
- 安裝 Microsoft Visual C++ 2015-2019 可轉散發套件 14.28.29912。
- 將 License Server 套件中的資料夾複製到授權伺服器上您預定安裝 Licensing Service 的目錄。
我們建議您將 ABBYY FineReader Engine 檔案整理為便於尋找和使用的資料夾結構。請參閱以下範例:
- <YourApplicationFolder>/License Server/Licensing Service.
- <YourApplicationFolder>/License Server/License Manager (License Manager64).
-
建立用於儲存授權資料的資料夾 (預設為
%ProgramData%\ABBYY\SDK\12\Licenses資料夾) 。每位執行您應用程式的使用者都必須對此資料夾具有完整控制權限。請參閱 Working with the LicensingSettings.xml File 中設定授權資料夾的範例。 - 建立 LicensingSettings.xml 檔案。其必須符合的 XML 結構描述可在 LicensingSettings.xml 檔案中找到;該檔案位於您的開發人員安裝環境中的 Inc 資料夾,或發行套件中的 CADF\Inc 資料夾。在此檔案中,您需要設定授權伺服器將使用的連線通訊協定型別。支援的型別包括 LocalInterprocessCommunication、NamedPipes、TCP/IP 和 Sockets:
<LocalLicenseServer>
<ConnectionProtocol ProtocolType="[your protocol type]"/>
</LocalLicenseServer>
<LocalLicenseServer>
<ConnectionProtocol ProtocolType="TCP/IP" EndPointName="1025"/>
</LocalLicenseServer>
-
將已設定好的 LicensingSettings.xml 檔案複製到下列資料夾:
- Licensing Service。
- 授權管理員 (License Manager64)。
- 使用 “/install” 參數來執行 LicensingService.exe:
LicensingService.exe /install
您也可以選擇設定雙伺服器組態,讓其中一台授權伺服器在另一台離線時作為備援。 如需詳細資訊,請參閱 如需詳細資訊,請參閱 設定備援授權伺服器組態。
在 License Server 上啟用授權:
執行 LicenseManager.exe。按一下 Activate License… 按鈕,並依照精靈的指示啟用授權。若您的伺服器可存取網際網路,只需輸入序號並稍候片刻即可。如需有關授權管理員的詳細資訊,請參閱授權管理工具程式。您也可以透過命令列啟用授權。如需詳細資訊,請參閱從命令列使用授權管理員。在工作站上安裝 ABBYY FineReader Engine 程式庫:
如果授權伺服器也將作為工作站使用,也請對該伺服器執行此步驟。
- 將 Library 套件和軟體元件複製到您的所有工作站。
要確保程式能找到所有資源檔案,最簡單的方法是保留相同的資料夾結構,並將您可在 Bin (or Bin64) 資料夾中找到的 SharedFiles.ini 檔案納入發行套件;實際使用哪個資料夾取決於您的作業系統。若您不想使用此檔案,則無須保留資料夾結構,請改為執行下列操作:
- 將 Data\Resource 資料夾及其所有子資料夾複製到下列資料夾:
- Bin
- Bin64
- 將 Data\ExtendedDictionaries 資料夾中的內容直接複製到 Bin 或 Bin64 資料夾。
- 將 Data 資料夾中的其他檔案複製到 Bin 或 Bin64 資料夾。
-
安裝所需的軟體元件:
- Microsoft Visual C++ 2015-2019 可轉散發套件 14.28.29912。
- 如有需要,請安裝 .NET Framework。
- 將包含 ABBYY FineReader Engine 檔案的資料夾從 Library Package 複製到工作站上您預定放置程式庫的目錄。
-
註冊所需的動態連結程式庫:
- 如果您的應用程式是透過 IEngineLoader 介面載入 Engine 物件,請使用下列命令列來註冊 FREngine.dll:
regsvr32 /s /n /i:"<path to the Inc folder>" "<path to FREngine.dll>"- 如果您的應用程式使用 Visual Components,請使用下列命令列來註冊 VisualComponentsX.dll:
regsvr32 /s "<path to VisualComponentsX.dll>"如果您在使用 COM 載入器或 Visual Components 時遇到問題,請檢查登錄檔中這些元件的路徑;如果有錯誤,請重新進行註冊程序。 -
建立 ABBYY FineReader Engine 將使用的資料夾。以下清單標示了這些資料夾的預設值:
- 資料夾 %ProgramData%\ABBYY\SDK\12\FineReader Engine (需要完整控制權限)
- 資料夾 %ProgramData%\ABBYY\SDK\12\Licenses (授權伺服器需要完整控制權限,工作站則為選擇性)
若要在安裝期間指定授權資料資料夾,請參閱 Working with the LicensingSettings.xml File 中的範例。您也可以使用 InitializeEngine 函式 或 IEngineLoader 介面 的方法。
建立 LicensingSettings.xml 檔案:
建立 LicensingSettings.xml 檔案,並設定與您為伺服器所指定的相同連線通訊協定類型及伺服器位址:<LicensingServers>
<MainNetworkLicenseServer ServerAddress="[your server address]" ProtocolType="[your protocol type]"/>
</LicensingServers>
<LicensingServers>
<MainNetworkLicenseServer ServerAddress="[your server address]" ProtocolType="TCP/IP" EndPointName="1025"/>
</LicensingServers>
複製已設定的 LicensingSettings.xml 檔案:
將已設定好的 LicensingSettings.xml 檔案複製到每台工作站上存放 ABBYY FineReader Engine 檔案的資料夾中 (與 FREngine.dll 位於同一目錄) :如果授權伺服器也同時作為工作站使用,則伺服器的 LicensingSettings.xml 檔案必須同時包含 LicensingServers 和 LocalLicenseServer 標籤,與上述指定的內容類似。檔案內容如下所示:
<?xml version="1.0" encoding="utf-8"?>
<LicensingSettings xmlns="http://www.abbyy.com/Protection/LicensingSettings">
<LicensingServers>
<MainNetworkLicenseServer ServerAddress="[your server address]" ProtocolType="[your protocol type]"/>
</LicensingServers>
<LocalLicenseServer>
<ConnectionProtocol ProtocolType="[your protocol type]"/>
</LocalLicenseServer>
</LicensingSettings>
