Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Align
aligncenter




Summary

This documentation applies to both SkySync Managers and Remote Sites, as well as, clustered and non-clustered installations.

For non-clustered installations, follow the steps for the primary node only.


Panel
bgColor#FFFACD

If the install directory was changed from the default during the original install, you must follow Option 2 below



Verify Current Version Installed

In Powershell, run the following command to see what version is currently installed prior to upgrading


Code Block
titleExample | Default Install Directory
C:\Program Files\SkySync> .\skysync.exe --version



Step 1: Stop the SkySync service on secondary nodes followed by the primary node

For a Windows installation, while the installer will detect if the service is running and stop it, there may be side effects to other running nodes in a clustered environment as the primary node is upgraded. Therefore, we recommend that SkySync services on all secondary nodes followed by the primary node are stopped before proceeding with the upgrade.



Step 2: Run the installation executable on the primary node

The installer will detect if there is an existing SkySync installation and the version that is currently installed. As long as the currently installed version is older than the version being installed, the installer will continue as an upgrade. 

There are two primary options when upgrading. By default the installer will attempt to upgrade the configured database.


Panel
titleBGColor#32CD32
titleIMPORTANT POWERSHELL STEP

Ensure your command is for the LATEST/UPGRADE version of SkySync; not the currently installed version

.\skysync-windows-{{upgrade-version}}.exe --install-pgsql 0



Option 1: Default with Database Upgrade

Use this option if your original install used the default install configuration directory

  • By default the installer will attempt to upgrade the configured database. 


Code Block
.\skysync-windows-{{upgrade-version}}.exe --install-pgsql 0




Panel
bgColor#FF6347

(star) Option 2 | Important Information:

  • This option should only be used in special circumstances such as the install directory is not located on the C drive
  • Make sure ALL cluster services are stopped, including the primary node that was just upgraded, before doing the database update step

Option 2: Separate Software and Database Upgrade

Ensure the installer is located in the same directory as your original install


Code Block
.\skysync-windows-{{upgrade-version}}.exe --install-pgsql 0 --skip-dbupdate 1 


Once the installer successfully completes, make sure ALL cluster services are stopped, including the primary node that was just upgraded, before doing the database update step

Navigate to the installation directory in a command window and run the following command:


Code Block
.\skysync.exe db update



Step 3: Run the installation executable on secondary nodes

Since the database was upgraded as part of the primary node upgrade, that portion of the upgrade can be skipped for secondary nodes. Run the following command on the remaining secondary nodes.


Code Block
.\skysync-windows-{{upgrade-version}}.exe --install-pgsql 0 --skip-dbupdate 1 



Step 4: Ensure the SkySync services on the primary node has started. Then verify secondary nodes

Verify the services are running SkySync on the primary node first; start if needed. Then verify the SkySync services are running on the secondary nodes.



Verify Upgraded Version Installed

In Powershell, run the following command to see what version is currently installed prior to upgrading


Code Block
C:\Program Files\SkySync> .\skysync.exe --version
Code Block
.\skysync-windows-{{upgrade-version}}.exe --install-pgsql 0 --skip-dbupdate 1