Troubleshooting IBMClient Linux

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

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
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.
  1. Private key should not be empty/null.

  2. Push failed due to Failure while importing certificate into keystore due to either wrong password or tampered keystore.

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.