Installation Walkthrough

This article walks you through installing PolySync Core on a machine with supported architecutre and operating system, meeting the basic requirements.

1. Upgrading from pre-release packages

If you are upgrading to PolySync Core from a pre-release package, run the migration script on the Ubuntu 14.04 LTS installation before installing Ubuntu 16.04.1 LTS.

2. Download PolySync Core

Download PolySync Core from the download center to a machine that matches the supported architecture and operating system requirements. You will need to accept the license agreement before you can download PolySync Core.

Contact support at help@polysync.io to get access to a release package for a specific architecture.

2.1 Virtual Machines

  • Ensure all virtual machines meet the basic system requirements, particularly ensure there are 2+ cores reserved for the virtual machine
  • PolySync Core has been tested against Parallels (Mac), VirtualBox 5.1, and VMWare Player 12 virtual appliances

3. Installing PolySync Core

If you are upgrading from a pre-release version of PolySync, first follow the migrating files article.

After you have downloaded the PolySync Core release package tarball archive, open a terminal and navigate to the directory where it has been downloaded.

$ cd ~/Downloads
$ tar xf polysync-core_2.X.Xubuntu_XX_04.tar.gz
$ cd polysync-core_2.X.X
$ sudo apt-get install build-essential python3   # required for Tier 2 architectures
$ ./install         #  you will be prompted for the sudo password
$ . /etc/profile.d/polysync.sh  # source the environment 

It can take up to 15 minutes for the installation to complete.

The install location, also known as the PolySync Core Home directory, is located at /usr/local/polysync and is denoted with the bash variable $PSYNC_HOME. Configuration and logfile data is stored in the $PSYNC_USER_HOME directory.

4. Activating the license

To download an existing license from the server when upgrading or reinstalling PolySync run the license tool with the ‘-a’ flag.

$ polysync-license-tool -a


*****************************
*** PolySync License Tool ***
API Build Version: 2.0.10-1487273235

Host ID: '(Ethernet) xxxxxxxxxxxx'

[...]
License status: valid
*****************************

If you do not have a valid license or are having problems activating your license, contact support help@polysync.io. Be sure to include the Host ID: '(Ethernet) xxxxxxxxxxxx'

4.1 Known License Error

If you see this error when running the license tool:

$ polysync-license-tool -a

*****************************
*** PolySync License Tool ***
API Build Version: 2.0.10-1487273235

[...]
2017-02-13 14:41:29.02s ERROR  [polysync-license-tool-0] - adding trusted storage license source returned: 1879048255
2017-02-13 14:41:29.02s DEBUG  [polysync-license-tool-0] - trusted storage based licensing may not be available
License status: invalid
To request a license, email help@polysync.io with your machines unique Host ID: '(Ethernet) xxxxxxxxxxxx'
*****************************

You will need to run the following commands to clear your license cache then re-download the license:

$ rm ~/.local/share/polysync/license/am*
$ polysync-license-tool -a

5. PolySync manager service

Following installation the polysync-core-manager was started as a service. This will happen every time the machine boots. This is necessary to be able to start sensor nodes that connect to hardware or replay logfile data.

You can read more about the manager and how to start the runtime for connecting to hardware and replaying logfile data.