Troubleshooting IBMClient Linux
Issues in Device communication
| Error Message | Possible Cause | Possible Solution |
|---|---|---|
| Communication to <hostname> failed |
Gateway agent not reachable. Device not reachable from the gateway agent GSKit is not installed on any given device. |
Ensure gateway is configured properly and the APIs are accessible from AppViewX. Ensure device and gateway agent are in the same domain and device is accessible from gateway agent. Please ensure GSKit is installed properly. |
|
Communication to <hostname> failed Device version fetch has failed. |
Hostname or Credentials configured is wrong | Ensure hostname and the device credentials configured while device addition is valid. |
Issues in Certificate Discovery
| Error Message | Possible Cause | Possible Solution |
|---|---|---|
| Received failed response from batch | No valid KDB/keystore files available in the given path. | Ensure the given certificate location has a valid KDB/keystore and KDB/keystore has certs. |
| Discovery completed successfully. (with 0 certs even if valid certs exist in given path) |
|
|
Issues in CSR Generation at Endpoint
| Error Message | Possible Cause | Possible Solution |
|---|---|---|
| CSR generation got failed/User has no permission for the given location to perform the operation. | User has restricted access to the path configured for the “CSR FileName” and “Key File name” | Kindly ensure the user configured for device addition has read/write access to the path configured. |
Issues in Certificate Push
| Error Message | Possible Cause | Possible Solution |
|---|---|---|
| Certificate Push failed. Or Push got failed due to User has no permission for the given location to perform the operation | User has restricted access to the path configured to push the certificate in the application connector | Please ensure the user is configured while device addition has the read/write access to the path configured in application connector to certificate push. |
| PrivateKey in device push invalid | “Private key in Device” is enabled in application connector, but key is not available on device. | Ensure to enable “Private key in Device” attribute in application connector, if the certificate does not have the key and the certificate is generated using CSR gen option from Device. |
| Push Failed due to KDB push got failed. | Target KDB file does not exist in the device. | Ensure the target KDB file, for which certificate push configured is available and has read/write access. |
|
Trying to push certs without a keyfile. | Please ensure the certificate to be pushed has a private key file. Or if key file exists in device please select privateKeyInDevice option. |
