Troubleshoot issues you might encounter when using the TS Agent.
On-Prem Firewall Management Center test connection fails
If you are logged in to the TS Agent server as a local user (as opposed to a domain user), the TS Agent test connection with the On-Prem Firewall Management Center test fails. This happens because, by default, the TS Agent does not allow System processes to communicate on the network.
To work around the issue, do any of the following:
-
Check Unknown Traffic Communication on the Configure tab page to allow the traffic, as discussed in TS Agent Configuration Fields.
-
Log in to the TS Agent computer as a domain user rather than as a local user.
TS Agent reports users as Unknown and rules not matched
If other vendors' Terminal Services agents are running on the same server as the Cisco Terminal Services (TS) Agent, port numbers for user connections might not be in the assigned User Ports range. As a result, users can be identified as Unknown and therefore identity rules do not match for users.
To resolve this issue, disable or uninstall the other Terminal Services agents running on the same server as the Cisco TS Agent.
TS Agent prompts to reboot on upgrade
Sometimes, even if the machine's IP address does not change, TS Agent reports an IP address change after upgrade and prompts you to reboot the server. This happens because the TS Agent detects a difference between the IP address and the value of the following registry key:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\TSAgent\{IPv4 | IPv6}
If the key value is different from the configured primary adapter IP address, TS Agent reports the change and instructs you to save the configuration and reboot the computer.
This can happen, for example, if the computer was reimaged or restored from backup and DHCP assigns a new IP address.
You can ignore the error but you must reboot the computer after upgrading anyway.
Citrix Provisioniong clients fail to boot
You must configure the TS Agent to ignore the UDP port(s) you configured for the Citrix Provisioning server.
The value you specify in the TS Agent Reserve Port(s) field must match one of the Citrix Provisioning First and Last UDP port numbers ports.
Failure to specify the correct port will cause clients to fail to boot.
Exceptions when saving the TS Agent IP address
In rare circumstances, exceptions are displayed when you attempt to save the TS Agent configuration with an invalid IP address. An invalid IP address can be any of the following:
-
The same IP address as another device on the network.
-
Changing the static IP address in Windows while the TS Agent application is open.
Exceptions include the following:
-
System.ArgumentException: An item with the same key has already been added.
-
System.NullReferenceException: Object reference not set to an instance of an object.
Workaround: Set the TS Agent server's IP address to a valid IP address, save the TS Agent configuration, and reboot the server.