Risks, Limitations and Assumptions

  • The integration can handle Critical/Recovery failure notifications for the following two cases when user enables App Failure Notifications in configuration
    • Connectivity Exception
    • Authentication Exception
  • The integration will send any duplicate/repeat failure alert notification for every 6 hours.
  • The integration cannot control monitoring pause/resume actions based on above alerts Metrics can be used to monitor resources and can generate alerts based on the threshold values.
  • The minimum supported version for the option to get the latest snapshot metric is nextgen-14.0.0.
  • Full discovery support requires gateway version 15.0.0 or above.
  • The integration is not compatible with Cluster Gateway

Troubleshooting

When the Microsoft SCVMM integration fails to discover or monitor, perform the following troubleshooting steps:

  • Check if any alerts are generated on the cluster or gateway.
  • Review error logs in vprobe for any indications of failures.

To rule out PowerShell connection issues or failures like end device connectivity or authentication, establish a connection with the end device from the gateway using the following steps:

For NextGen Gateway

Use the command kubectl exec -it nextgen-gw-0 -c nativebridge -- /bin/bash to connect to the native bridge container. Once connected, proceed to run the following commands.

For Classic Gateway

Directly run the following commands.

  1. Launch PowerShell using pwsh
  2. Run the following commands to establish connection:

$pw = convertto-securestring -AsPlainText -Force -String "<password>"
Here, password should be replaced with the actual password of the end device.

$cred = new-object -typename System.Management.Automation.PSCredential -argumentlist "<username>", $pw
Here, username should be replaced with the actual username for the end device.

$session = new-pssession -computername "<ipAddress>" -credential $cred -Authentication Negotiate -ErrorAction Stop
Here, ipAddress should be replaced with the IP address of the target end device.

$session.state - Session state should be open.

  1. If the session does not establish, ensure all prerequisites are met.

To validate New powershell scripts, follow below steps:

  • Use the command kubectl exec -it nextgen-gw-0 -c nativebridge -- /bin/bash to connect to the native bridge container. Once connected, proceed to run the following commands.

  • For classsic gateway, directly run the following commands.

  1. Execute the command - cat > <new script file name>
    It will expect the script content to be pasted. Copy the content of the script with required changes and paste here.
  2. Exit the cat command using Ctrl + Z
  3. Execute the script using: pwsh -File <script file name> <host ip> <username> <base64 encoded password> 0

To validate script changes for existing script files , follow below steps:

  • For NextGen Gateway, use the command kubectl exec -it nextgen-gw-0 -c nativebridge -- /bin/bash to connect to the native bridge container. Once connected, proceed to run the following commands.

  • For Classic Gateway, run the following commands:

  1. Navigate to the path: cd /opt/gateway/content/scripts/windows-hyperv-cluster
  2. Take a backup of the file cp <script file name to be modified> <backup file name>
  3. Execute the command cat > <script file name> It will expect the script content to be pasted. Copy the content of the script with required changes and paste here.
  4. Exit the cat command using Ctrl + Z
  5. Check the last modified time using ll. Ensure the last modified time matches the current time.
  6. Execute the script using: pwsh -File <script file name> <host ip> <username> <base64 encoded password> 0 If the script responds correctly, restart the pod:
  • For NextGen Gateway: kubectl delete pod nextgen-gw-0
  • For Classic Gateway: service vprobe restart

If connectivity or authentication issues persists, refer to the SDK App Debugging process and contact the Support Team.