S SISL docs
⌕ /
PL
docs  ›  SISL Optima Connector  ›  Diagnostics & errors

Diagnostics and errors

First place to look when something is broken: SISL Optima → Diagnostics in the left column of Magento admin.

Diagnostics — 14 checks

Check OK WARN FAIL → fix
License valid offline grace key not set / revoked → enter key or buy a new one
Module active enabled=Yes — enabled=No → enable in Stores → Configuration
Microservice URL http://x:5000 — empty / wrong scheme
HMAC secret 64 chars <32 chars missing → generate openssl rand -hex 32
HTTP connection microservice responds DB disconnected timeout, refused → check firewall, is the service running
Microservice backend optima mock (dev) unknown
RTT to microservice <100ms >5000ms cannot measure
Magento var/log/ writable — chown -R www-data var/log
Magento generated/ writable — same for generated
Magento DB OK — check env.php
Exclusion attribute installed — bin/magento setup:upgrade
Product sync <24h >24h cron not running
Stock sync <24h >24h as above
Last sync errors none errors present check var/log/system.log
Magento cron N jobs/h none bin/magento cron:run in system crontab

Common problems

"license is bound to X" on activation

The key is already activated for a different URL. Go to /account on sisl.pl → pick the license → Unbind from host → next sync will activate on the new URL.

connect() failed (111: Connection refused) in nginx error log

Magento can't reach PHP-FPM through the Unix socket. Check: - whether the app container (PHP-FPM) is running - whether /sock/docker.sock is in a shared volume between nginx and app - whether the nginx config has fastcgi_pass unix:/sock/docker.sock;

Stock in Magento still 0 despite a PZ in Optima

Your PZ is not confirmed (status bufor/do zatwierdzenia). Confirm the document (lock icon / Z in Optima) — only then is the entry written to CDN.TwrZasoby with TwZ_TrSIdDost > 0 and our sync will see it.

HTTP 402 Payment Required from /v1/products

The microservice returns this when its local license verification fails: 1. Check appsettings.Local.json → License.Key and License.ServerUrl 2. Verify the server has outbound to license.sisl.pl: Invoke-WebRequest https://license.sisl.pl/check -Method Post 3. Check the log: Get-Content C:\Sisl\logs\license-trace.log -Tail 5

signature mismatch (possible attack) in the microservice log

The Ed25519 public key embedded in the binary doesn't match the SISL server's private one. Causes: - you downloaded an older plugin version than the server knows - someone forged the response (serious — check the outbound HTTPS proxy)

Solution: re-download the latest Sisl.Sync.Service.zip from /account on sisl.pl.

This email is already registered. Please log in. on registration

The account exists but is unverified. Try logging in — you'll get the "Email unverified" notice and another email with a confirmation link.

Magento cron: no recent jobs (WARN in Diagnostics)

Magento cron is not running. The most common cause in a Docker setup:

# add to docker-compose.yml
cron:
  image: <same image as app>
  command: >
    sh -c "while true; do
             php /var/www/html/bin/magento cron:run --group=default >> /var/www/html/var/log/cron.log 2>&1;
             sleep 60;
           done"
  volumes: [...]  # same as app

Or in a plain system:

* * * * * /var/www/html/bin/magento cron:run --group=default >> /var/log/magento-cron.log 2>&1

Slow synchronization

Logs

Magento

tail -f /var/www/html/var/log/system.log | grep Sisl_Optima
tail -f /var/www/html/var/log/exception.log
tail -f /var/www/html/var/log/cron.log

Windows microservice

# Windows Service stdout/stderr
Get-WinEvent -FilterHashtable @{LogName='Application'; ProviderName='SislSyncService'} -MaxEvents 20

# License trace (Ed25519 verify diag)
Get-Content C:\Sisl\logs\license-trace.log -Tail 30

# .NET runtime crashes
Get-WinEvent -FilterHashtable @{LogName='Application'; ProviderName='.NET Runtime'} -MaxEvents 5

Support

Next: Changelog →