SOTI Connect Configuration Issues

Unable to Access SATO Printer via Hostname when Using Device Registry

IPv4 mode is static, with a specified static IP and a specified hostname. However, the printer is inaccessible by hostname.

Issue Resolution

If the hostname is a Dynamic Host Configuration Protocol (DHCP) hostname, set IPv4 mode to DHCP.

Note: Do not use static mode or static IP with a printer that uses a DHCP hostname. If you use static mode or static IP, the provided DHCP hostname cannot connect to the printer.

Unable to Connect SOTI Identity with SOTI Connect

While attempting to add SOTI Connect to a SOTI Identity tenant, the following errors occur:

Error in SOTI Connect

Error in SOTI Identity (v2024.0.1)

Affected versions: SOTI Connect 2024.0 and later.

Issue Resolution

To resolve the issue:

If SOTI Connect is already registered to an instance of SOTI Identity, and you are trying to register with another SOTI Identity tenant.
- Locate the first connection and delete it from the SOTI Identity console.
Check for certificate issues.
- For example, an expired or invalid GoDaddy certificate on the SOTI Connect MS server.
Check for the wrong Fully Qualified Domain Name (FQDN) in the SOTI Connect installation.
- For example, "SotiConnect20" instead of "SotiConnect20.soticonnect.com".
  Note: The FQDN is passed to SOTI Identity and SOTI Identity uses it to call back to SOTI Connect. If the FQDN is wrong, SOTI Identity cannot reach SOTI Connect.

Use of Custom Attribute Macros Resulting in Corrupted Certificate Templates

Before SOTI Connect 2025.0, users could delete the custom attribute macro used in the subject alternative name of a certificate template. Following deletion, a corrupted value would appear in the certificate authority template. However, if the custom attribute was not deleted, the macro displayed correctly.

Issue Resolution

Make sure to delete the corrupt certificate template before upgrading SOTI Connect form 2024.2 to 2025.0, as it prevents the macros from displaying the custom attribute name.

Note: For SOTI Connect 2024.2, do not delete a custom attribute if it is referenced in a certificate authority template.

Issue with Local Administrator Access

If a SOTI Identity user with Administrator privileges changes the local administrator's role to a non-administrator and the connection between SOTI Identity and SOTI Connect is lost, no administrator remains on the local system.

Issue Resolution

To restore access, use the silent installer to inject an administrative flow and add a new local administrator. Follow the steps below:

On the VM with the Management Server (MS) installed, open the PowerShell application in Administrator mode and navigate to the installer folder.

Run the appropriate command based on your authentication method:

For SQL authentication

.\Soti.IoT.SilentInstaller.exe -databaseHost="databaseHost" -databaseUser="databaseUser" -databasePassword="databasePassword" -newadmin "NEW_ADMIN_USERNAME" "NEW_PASSWORD"

For Windows authentication

.\Soti.IoT.SilentInstaller.exe -databaseHost="DatabaseHost" -databaseIntegratedSecurity -newadmin "NEW_ADMIN_USERNAME" "NEW_PASSWORD"

Note: In the commands, enter the appropriate details according to your environment.

REST Simulation Unable to Send Alerts to the WebHook Receiver

REST simulator devices are unable to send alerts to the WebHook receiver.

Error message:

[ERROR] [45]  ChannelService - Exception in trying to send alerts System.Net.Http.HttpRequestException: A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond.

Issue Resolution

When installing or updating the REST Protocol Adapter (PA) using the silent installer, the Webhook receiver URL defaults to the private address: https://+:5551/
For devices or simulators hosted on different machines than the REST PA installation, replace the + symbol with the REST PA machine's FQDN in the installer configuration XML before running the silent installer.