ShoreTel and Citrix / Terminal Server (KB10025)
The purpose of this document is to better explain the interaction between ShoreTel and a Virtual Desktop Session. It is also to better educate the prospective reader on the cohabitation and collaboration between the two entities.
The most important item to remember is that when working with a Thin Client Server you are actually working with many virtualized workstations and therefore it is critical that you are logged in as an administrator to the server and not to the client. It is also important that you are at the Thin Client server via Remote Desktop or locally.
In order to better understand Citrix you must first understand that Citrix and in this case Presentation 3.x and above is a piece of software that actually runs on a server and in many cases a Microsoft Terminal Server. Citrix is favored in some installations because of administration and security enhancements.
Special Note:
In this document we will refer to the server as the Citrix/Terminal server where there is a variance, we will stop and pay specific attention to that difference between Citrix and Microsoft’s Terminal Server and then explain the difference. We are also concentrating on Citrix Presentation 3.x and above.
Personal Call Manager Installation:
A normal installation can be done if this is the first installation on this server. (If this is an upgrade or other installations have been attempted, please refer to the upgrade section of this document.) Some of the following information is pulled from Appendix E: of the Planning and Installation Guide, please use it as reference.
Step 1 – Login to Thin Client Server as administrator as noted above in important item to remember.
Note: – If you are prompted to reboot, then this is not a primary installation and you should go to the Upgrade section of this document.
Step 2 – Install ShoreWare client as described in the Planning and Installation Guide.
Step 3 – Go to the Windows Control Panel open the Phone and Modem Options>Advanced tab
Step 4 – Remove all ShoreTel providers.
TAPI Service Installation:
When we do an installation on a Citrix/Terminal Server we need to use the tsp application on the ShoreTel server due to the configuration for the phone ports that are available. You cannot use the Workstation Clients TSP application because it is specific to one client only.
Copy the following file “TspInstall.exe” from the ShoreTel Server; you should be able to find it in,
(Program Files > Shoreline Communications > ShoreWare Server)
We recommend copying the file to the following location: C:
Note: – When you are ready to do the TSP install on the Citrix server, you must make sure that the Citrix Server is in DOS user install mode. This is different because the DOS mode and installation mode are separate entities in the Citrix environment
Before running TSP install at the command prompt make sure to do the following:
C:> change user /install
Navigate to the directory where the “TspInstall.exe” file was copied and run the TSPinstall utility.
Make sure you substitute the correct hostname or IP address of the Headquarters instance of ShoreWare Server. The syntax of the command is:
TSPinstall -i StServer
Testing your Installation:
- Make sure that you do not login to Personal Call Manager on the Server.
- To test a client installation, you must have a test account.
- Login with test account and attempt a directory search.
Upgrades:
When upgrading the client Call Manager software it is critical that a un-installation of the previous version be done and that the previous Call manager Client is unavailable to the virtual users that are assigned to each Thin Client Server.
When you install, you install to the registry and to the current user registry however when a Terminal Server installation is done it is not done at each Virtual Client until that client initially logs into the Server so therefore an uninstall is about the same scenario.
Where as an uninstall also cannot happen until the users are logged in so therefore you cannot do a push of the new client because to the system the old client still exists.
Uninstall of previous versions:
An uninstall and a removal of the registry keys is a must for upgrades
Cleaning up your install:
- Remove TSPInstall
- Make sure that you do not login to Personal Call Manager on the Server.
Testing the Upgrade:
- Make sure that you do not login to Personal Call Manager on the Server.
Troubleshooting:
- Make sure that you do not login to Personal Call Manager on the Server.