Prerequisite
- Sync for Personal Collaboration uses the same URIs used in Sync for Spaces. For the full list of network ports: https://prosupport.logi.com/hc/articles/360044122654
- Having a device connected prior to installation is not a requirement.
- Tune is not required. This will be installed during setup.
- Only Logitech Enterprise and Logi Dock devices will register with Sync. Keyboards, Mice, and consumer devices are not supported.
Files
There are three files part of the package
- LogiSyncPersonalCollab.pkg: The Installer
- ProvisioningToken.json: Sync Cloud Token, do not edit
- LogiAppsBundle.json: Tune install configuration settings. Leave default values.
How Sync for Personal Collaboration is installed
- Install the Sync for Personal Collaboration Agent (LogiSyncPersonalCollab.pkg). Installs a service so must be executed with elevated permissions.
- If the two JSON files are not in the same location as the installer, copy the two JSON files to "/Library/Application Support/LogiSyncPersonalCollab/Data/" When using deployment tools (like JAMF), the two JSON files must be copied AFTER the installer is completed.
- The installer will look for the two JSON files and make the required configurations.
- The log file "/Library/Application Support/LogiSyncPersonalCollab/Data/setup.txt" will return the connection status. There are 3 basic steps: setup, running and finish. An install should never stop at setup or running.
-
The script used for deployment generates a log file /var/log/logisyncpersonalcollab/LogiScriptInstaller.log. This can be used to track the status of the installation process.
Name
State
Exit Code
Description
PKG Install Failed
finished
1
The files used by the PKG where not created
setup.txt file not found
finished
2
the setup.txt file was not created (required for exit codes)
Other error
finished
4
unknown reason for failed install
ProvisionFileNotFound
setup
110
The installer could not find the provisioning file ProvisioningToken.json
ProvisionStarted
running
120
Transient State, should not exit here
ProvisionCompleted
running
130
Transient State, device connected to sync cloud
ProvisionFailed
finished
140
Could not connect to Sync Cloud
BundleFileNotFound
setup
150
The installer could not find the provisioning file LogiAppsBundle.json
BundleInstallStarted
running
160
Transient State, should not exit here
BundleInstallCompleted
running
170
Transient State, Tune app installed
BundleInstallFailed
finished
180
Could not install Tune application
Success
finished
0
msiexec.exe could not find LogiSyncPersonalCollab.msi
- The computer will register with Sync
- If Tune is not installed, it will be pulled down from Logitech and installed
Note: During the install of Tune, a window will show that Tune is being installed. -
Once the user runs Logi Tune for the first time, the connected B2B devices will be registered
File Locations
Application Install
- "/Library/Application Support/LogiSyncPersonalCollab/"
- "/Library/LogiSyncPersonalCollab/"
Log Files (this is what Logitech customer support will ask for)
- "/var/log/logisyncpersonalcollab"
- "/var/log/logisyncpersonalcollab/LogiScriptInstaller.log"
Download the required files
Login to Sync |
|
On the left at the bottom click on System |
|
Scroll Down to the Personal Devices on the main window and Click on Download |
|
Choose the Platform |
Setting up JAMF
Go Settings/Computer Management and Click on Scripts |
|
Add a new Script |
|
On General Tab Display Name: Logi Sync for Personal Collaboration Category: Logitech Software Information: Creating JSON files, Connecting to Sync, Installing Tune |
|
On Script Tab Copy and paste the following Shell Script In the Section #ProvisioningToken.json on a new line after the EOF paste the context of the ProvisioningToken.json where it says PUT_CONTENTS_OF_ ProvisioningToken.json_HERE. The text may be a single or multiple lines. Make sure the last EOF is on a line by itself In the Section #LogiAppsBundle.json on a new line after the EOF paste the context of the LogiAppsBundle.json where it says PUT_CONTENTS_OF_ LogiAppsBundle.json _HERE. The text may be a single or multiple lines. Make sure the last EOF is on a line by itself These tokens are unique to each Sync tenant, do not share the contents of your token files. |
#!/bin/bash |
On Options Tab Ensure Priority is set to After |
|
Save the Script |
|
Go to Computer Management and choose Packages |
|
Add a new Package |
|
On General Tab Category: Logitech Firmware Filename: Browse to the PKG you downloaded |
|
Save the Package |
|
Under Computers go to Policies |
|
Create a new Policy |
|
On General: Display Name: Install Logi Sync for Personal Collaboration Category: Logitech Software Trigger: If your Recurring Check-in is longer than 10 minutes you can use that. Any less than 10 minutes installation issues could arise. Frequency: The package should be installed once per computer. |
|
Go to Packages and Configure a new Package |
|
Add the LogiSyncPersonalCollab.pkg you created earlier
|
|
Action should be Install |
|
Go to Scripts and Configure a new Script |
|
Add the Logi Sync for Personal Collaboration you created earlier |
|
Make sure the Priority is set for After |
|
Set your Scope and Self Service Options specific to your needs. |
|
Save the Policy |
To Uninstall Sync
run the command |
sudo /Library/LogiSyncPersonalCoolab/uninstall.sh
|
A Window will show saying Terminal.app would like Administrative Control |
|
run the command |
sudo rm -rf /var/log/logisyncpersonalcollab
|
Uninstall Tune
From Spotlight Search, run logituneuninstaller.pkg