Use Indexing tool to migrate from SQLite to SQL Server

Use these steps to use the EzeScan WebApps Indexing tool to successfully migrate all indexing items from one EWA install to another.

Prerequisites

Please ensure the following:

  • Server running the tool has .NET Core 3.1 Runtime installed.
  • Source EWA installation is running 3.0.0 or above using SQLite.
  • Target EWA installation is running version 3.3.2 or above and has been configured to use SQL Server.




Step-by-step guide

Export the items from the source EWA installation.


The export verb supports the following options:

OptionDescription
--ewa-dirRequired. Root directory of EWA installation to run export on
--out-dir(Default: C:\Temp\EWA-Export) Directory to export to
--ewa-versionOverride detected version with specified version
--helpDisplay this help screen.
--versionDisplay version information.
  1. Download and extract the EzeScan.WebApps.Indexing.Tool.1.x.x.zip file.
  2. Open Powershell and navigate to the directory where the extracted EzeScan.WebApps.Indexing.Tool.exe is located.
  3. Run the following command to export the indexing items in the source installation.

    Code
    .\EzeScan.WebApps.Indexing.Tool.exe export --ewa-dir "C:\EzeScanWebApps"
  4. Confirm you see a success message at the end of the export. "Export runner successfully exported xxx items"

Warning

The export process can take a long time if you have a large number of items in the source EWA installation.

Import the items into the target EWA installation.


The import verb supports the following options:

OptionDescription
--urlRequired. Url of EWA instance to upload items into
--api-keyRequired. API Key of target EWA instance
--in-dir

(Default: C:\Temp\EWA-Export) Location of the exported items you wish to import

--force(Default: false) Upload all items regardless of their Status value
--helpDisplay this help screen.
--versionDisplay version information.

  1. Before you start ensure you have copied your settings.xml and license.xml files from the source EWA installation.
  2. Log into the target EzeScan WebApps installation and navigate to the admin panel.
  3. Select Authentication on the left menu and then note the configured Service Key value which can be found on the Service Key tab.
  4. Download and extract the EzeScan.WebApps.Indexing.Tool.1.x.x.zip file.
  5. Open Powershell and navigate to the directory where the extracted EzeScan.WebApps.Indexing.Tool.exe is located.
  6. Run the following command to import the indexing items into the target installation.

    Code
    .\EzeScan.WebApps.Indexing.Tool.exe import --url "http://ewa-server.domain.com/" --api-key "38832c83-16fd-47a0-b017-93ac433abe69"	
  7. Confirm you see a success message at the end of the import. "Import runner successfully imported xxx items"
  8. Confirm you see no errors at the end of the import. "Import runner encountered errors on 0 items."