Troubleshooting IBMClient Windows

This document will guide you to overcome the various issues faced by you during the use of IBMClient Windows and its various functionalities.

Issues in Server Addition using AppViewX GUI

Error Message Possible Cause Possible Solution
Device Name already exists. A device with the same name already exists in inventory. Check the Device name, it should be unique.
Details incorrect Some of the mandatory fields might be missing or might be invalid. Add all the valid information in the mandatory section.

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)
  1. Respective Keystores password is not added in Password Vault to parse certs.

  2. User may not have read permission to parse certs

  1. Please enter the password of keystores in the Password Vault to parse certs.

  2. Please ensure the user has appropriate permission to read files.

Issues in CSR generation at Endpoint

Error Message Possible Cause Possible Solution
  1. Failure response obtained on consuming REST API.

  2. CSR submission failed

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
  1. Push Failed. CTGSK3026W The key file "D:/mtest/mtest.kdb" does not exist or cannot be read.

  2. Push got failed due to Windows Gateway Error Response : a693c520-940d-478a-8aed-7c06c3a707c2: No path found

User has restricted access to the path configured to push the certificate in the application connector Kindly ensure the user is configured while device addition has the read/write access to the path configured in application connector to certificate push.
Push Failed due to KDB push 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.
Private key is not available. Failing the push Trying to push certificates 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.