Uniform Siphon - Installation

This guide covers how to install and configure the Uniform Siphon toolkit on your Windows machine.

Before you begin, ensure you have:

  1. Windows operating system
  2. Direct HTTP access to Sitecore instance
    • The Windows workstation needs direct HTTP(s) access to the source Sitecore instance
    • HTTP proxy is supported when configured via Windows' Settings → Proxy → Manual proxy setup
  3. Access to the Internet (required for installing Playwright)
  4. The Siphon distribution package (siphon-download-{ver}.zip or siphon-{ver}.zip)

Extract the contents of the siphon-download-{ver}.zip file to C:\siphon.

# After extraction, your directory should contain: C:\siphon\ ├── Siphon.Download.exe └── ... other files

Windows may block executable files downloaded from the internet. You need to unblock them before use:

  1. Navigate to C:\siphon in File Explorer
  2. Right-click on Siphon.Download.exe and select Properties
  3. If you see a security message at the bottom stating "This file came from another computer and might be blocked to help protect this computer", check the Unblock checkbox
  4. Click Apply, then OK

Alternatively, you can use PowerShell to unblock all files in the directory:

PS> Get-ChildItem -Path "C:\siphon" -Recurse | Unblock-File

Install Playwright to enable downloading presentation (not required for basic content-only migration):

PS> cd C:\siphon ; .\playwright.ps1 install

Review the command output in order to verify the installation was successful.

Add C:\siphon to your machine's PATH environment variable:

  1. Open System Properties (press Win + R, type sysdm.cpl, and press Enter)
  2. Click the Advanced tab
  3. Click Environment Variables
  4. Under System variables, find and select Path, then click Edit
  5. Click New and add C:\siphon
  6. Click OK to save all dialogs

Alternatively, you can use PowerShell with administrator privileges:

PS> [Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\siphon", "Machine")

After modifying the PATH, restart your terminal or command prompt for changes to take effect.

Open a new terminal window and verify the installation:

PS> siphon

or

PS> C:\siphon\siphon.ps1

If the command outputs help information, the installation was successful.

Last modified