Troubleshooting

Common deployment issues and how to resolve them.

Symptom	Resolution
SSL Handshake Error in server logs	Import the CA certificate into the Java truststore: keytool -import -alias <alias> -keystore $JAVA_HOME/lib/security/cacerts -file ca.crt. Restart the Integration Service after importing. Simply restarting services without importing the certificate will not resolve this error.
pgVector extension permission failure	Run CREATE EXTENSION vector; as a PostgreSQL superuser, not the application user. The application user does not have CREATE EXTENSION privileges by default.
Integration Service Error on startup	Check the integration service properties file — missing or incorrect Azure OpenAI credentials or ERP connection details are the most common cause.
Platform licence check fails	Verify outbound internet connectivity from the platform host to the MyWave licence server URL.
Knowledge API returns no results	Verify text-embedding-ada-002 is deployed in Azure OpenAI and the deployment name matches the Knowledge API configuration in the integration service properties file.

Upgrade Guide

1. Upgrade MyWave Platform (2.8.3 → 2.9.0) — Download the latest platform archive (mywave-ai-platform-2.9.0.zip). Stop the running platform. Replace the platform zip with the new version. Restart using the start command.
2. Upgrade Integration Service (2.0.0 → 2.3.0) — Download the latest integration service archive (sap-business-one-integration-service-2.3.0.jar). Place it in your deployment folder following the steps in the Integration Service setup section. Restart the integration service.