Skip to content

PowerOn Pro uses SFTP by default to synchronize Remote Syms and Reports. This guide is only needed if you choose the optional Rsync sync method. Choose the setup instructions for Windows, macOS, or Linux.

Rsync transfers files over SSH. Selecting it changes the file synchronization method; your Symitar connection still uses SSH.

Getting started

You will need:

  • A working Symitar connection in PowerOn Pro.
  • rsync, sshpass, and an SSH client available to PowerOn Pro. sshpass handles password authentication for Rsync transfers.
  • On Windows, WSL with these tools in the default distribution, plus Bash and setsid. The Windows instructions below use Ubuntu.
  • rsync available on the Symitar host for your AIX account. Ask your host administrator to confirm this prerequisite.

Windows

If WSL is already installed, check the default distribution before verifying the dependencies.

Installing WSL

Follow Microsoft's Install WSL guide for Windows requirements and installation options. For a new installation, open PowerShell as administrator and run:

powershell
wsl --install -d Ubuntu

Restart if prompted, then launch Ubuntu and finish creating its Linux username and password. These are local WSL credentials, separate from your AIX and Symitar accounts.

In PowerShell, list your installed distributions:

powershell
wsl --list --verbose

The asterisk marks the default distribution. PowerOn Pro invokes WSL without selecting a distribution, so install the tools in that default. If you want to use Ubuntu as the default, run:

powershell
wsl --set-default Ubuntu

Use the exact distribution name from the list if it differs from Ubuntu. This changes the default for other WSL commands too.

Installing the sync tools

Open the default distribution from PowerShell:

powershell
wsl

At the Linux prompt, update the package index and install the tools using Ubuntu's APT package manager:

Bash
sudo apt update
sudo apt install rsync sshpass openssh-client bash util-linux

Enter your WSL Linux password when sudo asks for it. sshpass lets PowerOn Pro authenticate Rsync's SSH transfer using your connection credentials without prompting for each transfer.

These commands are for Ubuntu. Other distributions may use a different package manager or package names.

macOS

Use Homebrew to install Rsync and sshpass. If Homebrew is not installed, follow its installation instructions first, including its shell setup steps. Then run in Terminal:

Bash
brew install rsync sshpass

Make sure Homebrew's binaries are on the PATH available to VS Code. Fully quit and reopen VS Code after installation or changes to your shell environment, then run the verification commands. WSL is not needed on macOS.

Linux

Install the tools using your distribution's package manager. On Ubuntu or Debian, run:

Bash
sudo apt update
sudo apt install rsync sshpass openssh-client

For other distributions, install the equivalent packages for rsync, sshpass, and an OpenSSH client using the distribution's package manager. Run the verification commands before selecting Rsync in PowerOn Pro. WSL is not needed on Linux.

Verifying the Remote Sym dependencies

Windows checks

Run these checks from PowerShell so they use the same default WSL distribution as PowerOn Pro:

powershell
wsl --exec bash -c 'command -v rsync; command -v sshpass; command -v ssh; command -v bash; command -v setsid'
wsl --exec rsync --version
wsl --exec sshpass -V

The first command should print a path for each of the five tools; the remaining commands should print version information. The tools need to be on PATH, not in a particular directory such as /bin.

macOS and Linux checks

In a local VS Code terminal, run:

Bash
command -v rsync
command -v sshpass
command -v ssh
rsync --version
sshpass -V

Each command -v check should print a path, and the version commands should report the installed tools. If the tools work in your terminal but PowerOn Pro cannot find them, check the environment used to launch VS Code and fully quit and reopen it after changing PATH.

Is Rsync installed?

If the Rsync check produces no path or reports that the command is missing, install rsync using the instructions for your platform. On Windows, it must be installed in the default WSL distribution. A working local installation does not confirm the host prerequisite: your AIX account must also be able to run rsync on the Symitar host.

Is SSHPass installed?

If the sshpass check fails, install sshpass using the instructions for your platform and confirm it is on PATH. On Windows, installing it in a different WSL distribution will not make it available to PowerOn Pro's default WSL invocation.

Select Rsync in PowerOn Pro

In VS Code Settings, search for poweronPro.syncMethod and select rsync, or set it in your settings JSON:

JSON
{
  "poweronPro.syncMethod": "rsync"
}

The selection takes effect on the next synchronization and applies to Remote Syms and Reports. Return to your Remote Sym and synchronize to confirm that files download successfully.

If a synchronization fails, check the PowerOn Pro output for details. Recheck the local tools, host Rsync availability, and network access to the host. On Windows, also check the default WSL distribution and access to the host from WSL. To return to the default transfer method, set poweronPro.syncMethod to sftp; the local Rsync tools are then unnecessary for synchronization.