Overview of Services
The Syniti Knowledge Platform Connector and Associated Services is a set of capabilities that allow for connectivity and targeted processing for key capabilities provided by the Syniti Knowledge Platform (SKP). The services deployed with the Syniti Connector are:
SYNITI-CONNECTOR
The Synti Connector service is the main service that provides connectivity from the remote Syniti Knowledge Platform Connector machine and SKP. This service provides the software-managed secure connectivity by polling out from the Syniti Knowledge Platform Connector machine back to SKP on a regular basis ensuring a live and healthy connection between the Syniti Connector machine and SKP.
Service Troubleshooting
The syniti-connector service that run on the Syniti Knowledge Platform Connector machine is developed so as to use standard operating system level logging for its actions.
If issues are thought to be with the service themselves, it is best to check the status of the services directly on the Syniti Knowledge Platform Connector machine:
Check to see if the service is running.
If the status of the service is not “active (running)” then try the following:
Restart the service using the restart commands in the below section. After restarting the service, check the status of the service.
Check the recent logs for the service to check for error message that can further the troubleshooting.
Key Commands
Key Commands for Linux
This command provides a status of the SYNITI-CONNECTOR service and whether it is actively running or not.
sudo systemctl status syniti-connector
Figure 1: Running Service
This command restarts the SYNITI-CONNECTOR service:
sudo systemctl restart syniti-connector
Additional commands can be made to the web service itself to check for the health of the service. There is a defined Health endpoint that can be called with the following command:
curl http://localhost:9200/health -i
If this commands returns a 200 or “OK” message then the service is running correctly:
If the service is running, you can find the service logs on the SKT-UI SKP Connector Details page, enabling the Show SKP Connector Logs switch:
If the service is not running or you would like more details about the service, you can check the full logs of the service using the following command:
sudo journalctl -u syniti-connector
This command gives you the full logs of the service. Some helpful flags to send this command are described here.
This command shows you all of the logs for the past 30 minutes. Notice the text in the quotes below can be changed to extend or shorten the timeframe of the logging.
sudo journalctl -u syniti-connector --since "30 minutes ago"
The Syniti Support team may request the copy and pasting of these log messages from your terminal session into a ticket.
The -f in the command below follows the log live on the screen so that you can watch in real time the status and state of the service:
sudo journalctl -u syniti-connector --since "30 minutes ago" -f
Logging of all packets over the connector using the Wireshark format can be enabled on the machine running the syniti-connector service. In order to view the logs, it is recommended that Wireshark is installed on the machine running the service.
To enable the Wireshark logging use the following command:
sudo systemctl enable --now syniti-packet-capture@wg0.service.
Running this command runs tcpdump and stores a cyclic buffer of packets transferred over the Wireguard interface in the following folder:
/var/log/syniti-pcap
With Whireshark installed, the resulting logs can be viewed using the following command:
tshark -r <log_file_name>.pcap -V
Key Commands for Windows
In Windows, to check if a service is running, you need to open services.msc:
Press Win + R;
Type services.msc;
Click OK.
Now you can search the Syniti Connector service in the list and check its status:
More details on Syniti Connector service are available if you right click on it and then click on Properties:
From the Properties window, the service can be started and stopped using the provided buttons.
Additional commands can be made to the web service itself to check the health of the service. There is a defined Health endpoint that can be called with the following command using the Command Prompt:
curl http://localhost:9200/health -i
If this command returns a 200 or “OK” message, the service is running correctly:
If the service is running, you can find the service logs on the SKT-UI SKP Connector Details page, enabling the Show SKP Connector Logs switch:
If the service is not running or you would like more details about the service, you can find the full logs of the service in this folder:
C:\ProgramData\Syniti Connector\logs
The current log file is called syniti-connector.log and it is archived when it reaches the maximum size of 512 MB. Archived files are always in the same folder and are identified by the archive date (e.g., syniti-connector-2026-02-04.log).
Reconfigure SKP Connector
Rotate the key
The secret key can be rotated any time the key needs to be refreshed. This does not cause disruption in service.
To rotate the secret key:
From the SKP Connector Details page, click the More Actions icon.
Select Rotate Key menu item.
Click Confirm on the SKP Connecter Rotate Key dialog box. The key is rotated.
Click Copy secret key in the SKP Connector Key Rotated dialog that displays.
Note
Key rotation does not cause interruption in service. The key must be added to the service, which must be restarted before the new key will be used.
Apply the rotated key using the command below for the appropriate server:
Linux:
sudo /usr/bin/syniti-connector --config /etc/syniti-connector/config.yaml --update-keyWindows PowerShell with Administrator privileges:
& "C:\Program Files\Syniti\Syniti Connector\syniti-connector.exe" --config "C:\Program Files\Syniti\Syniti Connector\config.yaml" --update-keyWindows Command Prompt (CMD) with Administrator privileges:
"c:/Program Files/Syniti/Syniti Connector/syniti-connector" --config "C:\Program Files\Syniti\Syniti Connector\config.yaml" --update-key
Restart the service:
Linux:
sudo systemctl restart syniti-connectorWindows:
Open the Services software and restart the SKP Connector service.