License

Configure how FastTransfer retrieves and uses its license file.

License Parameter

Use the --license parameter to specify the location or content of your FastTransfer license.

By default, FastTransfer will try to use the license file named FastTransfer.lic in the same directory as the FastTransfer executable. You can specify a custom license file using the --license parameter.

License Sources

FastTransfer supports multiple ways to provide a license:

1. File Path

Specify a custom license file path:

Windows

.\FastTransfer.exe `
...
 --license "C:\licenses\FastTransfer.lic" `
...

Linux

./FastTransfer \
...
 --license "/path/to/licenses/FastTransfer.lic" \
...

2. HTTP(S) Endpoint

Retrieve the license from a remote URL where you put the license content and distribute it using https :

Windows

.\FastTransfer.exe `
...
 --license "https://licenseserve.yourdomain.lan/FastTransfer.lic" `
...

Linux

./FastTransfer \
...
 --license "https://licenseserve.yourdomain.lan/FastTransfer.lic" \
...

3. License Content (Inline)

Provide the license content directly. Using a variable or environment variable is recommended. Usefull for Docker or Lambda deployment:

Windows

# Using environment variable
$env:FastTransfer_LICENSE = "LICENSE_CONTENT_HERE"
.\FastTransfer.exe `
...
 --license $env:FastTransfer_LICENSE `
...

# Using variable
$license = Get-Content "C:\licenses\FastTransfer.lic" -Raw
.\FastTransfer.exe `
...
 --license $license `
...

Linux

# Using environment variable
export FastTransfer_LICENSE="LICENSE_CONTENT_HERE"
./FastTransfer \
...
 --license "$FastTransfer_LICENSE" \
...

# Using variable
license=$(cat /path/to/licenses/FastTransfer.lic)
./FastTransfer \
...
 --license "$license" \
...

Syntax:

• Long form only: --license "<path_or_content>"

Complete Example

Here's a complete example using a license from a remote server with a database transfer:

Windows

.\FastTransfer.exe `
  --sourceconnectiontype "pgsql" `
  --sourceserver "localhost" `
  --sourcedatabase "production" `
  --sourceuser "FastUser" `
  --sourcepassword "FastPassword" `
  --targetconnectiontype "msbulk" `
  --targetserver "localhost" `
  --targetdatabase "warehouse" `
  --targettrusted `
  --targetschema "dbo" `
  --targettable "orders" `
  --query "SELECT * FROM orders WHERE order_date >= '2024-01-01'" `
  --parallelmethod DataDriven `
  --degree 4 `
  --license "//SharedUnc/licenses/FastTransfer/FastTransfer.lic"

Linux

./FastTransfer \
  --sourceconnectiontype "pgsql" \
  --sourceserver "localhost" \
  --sourcedatabase "production" \
  --sourceuser "FastUser" \
  --sourcepassword "FastPassword" \
  --targetconnectiontype "msbulk" \
  --targetserver "localhost" \
  --targetdatabase "warehouse" \
  --targettrusted \
  --targetschema "dbo" \
  --targettable "orders" \
  --query "SELECT * FROM orders WHERE order_date >= '2024-01-01'" \
  --parallelmethod DataDriven \
  --degree 4 \
  --license "//SharedUnc/licenses/FastTransfer/FastTransfer.lic"

This example:

• Retrieves the license from a remote UNC path
• Connects to a PostgreSQL source database
• Transfers data to a SQL Server target using bulk insert
• Uses DataDriven parallel method with 4 threads
• Filters orders from 2024 onwards