This article will guide you through the manual installation of any version of PolySync using a command line interface.
PolySync provides the bash scripts to perform the installation process. You are encouraged to view these scripts and understand the required configurations for each PolySync host. Following all steps detailed will ensure your system runs as smooth as possible.
Remove the Previous Installation
For those who already have PolySync installed, it's important that any previous version of PolySync is removed before continuing. Create a backup of the existing install, and remove the existing instance of PSYNC_HOME.
$ echo $PSYC_HOME /usr/local/polysync $ tar cfz /opt/polysync-date-backup.tar.gz /usr/local/polysync $ rm -rf /usr/local/polysync
After obtaining a PolySync release package from the Support Center, download and extract the archive.
$ cd ~/Downloads/ $ tar xf polysync-release-2.0.0-x86_64.tar.gz
Next copy (or move) the polysync/ directory to the desired location. The default location is /usr/local. Next you need to export the PSYNC_HOME environment variable.
$ mv polysync/ /usr/local $ export PSYNC_HOME=/usr/local/polysync
You will need to install a handful of software dependencies before PolySync can be installed and run properly.
$ cd $PSYNC_HOME $ sudo ./utils/polysync_install_deps.sh
You can find the full list of PolySync dependencies in the polysync/README.txt file.
The following steps are performed by the polysync_post_install.sh script.
- Update shared library file with PolySync includes and libraries for developing and running PolySync applications
- Append the PolySync environment script to the global bashrc file to place binaries within the shell's path
- Update udev rules specifically for the Xsens MTi-G USB interface
- Change permissions for PolySync home directory (/usr/local/polysync/)
- Install Kvaser linuxcan drivers for current kernel to enable CAN communication with USB and PCI hardware
- Install Flycapture package required for PointGrey GigE cameras
- Set up PolySync Studio Ubuntu Icon for quick start
You can start the script by passing in two arguments. Call the license tool after the post-installation script to download an existing license from the server.
- Installation directory
- This must match the directory 'polysync/' was moved to in the Install PolySync step above
- Must provide username for the account who will own the polysync directory and have permissions to access
$ cd $PSYNC_HOME/
$ sudo ./utils/polysync_post_install.sh /usr/local/polysync dev
Downloading the License
For a new installation of PolySync, you will need an activation ID which represents your PolySync license. You can activate the license with the following:
$ polysync-license-tool -a xxxx-xxxx-xxxx-xxxx-xxxx
For machines with an existing license, you can use the license tool without an activation ID:
$ polysync-license-tool -a