Gyst For Microsoft

This guide provides step by step instructions on how to install and configure the Gyst User Interface (Gyst UI) and a single Gyst Server Instance (GSI) on a local Windows Server Machine or virtualized Windows Server Instance (WSI).

While a GSI will run under various Microsoft Windows Server versions, Windows Server 2016 and 2019 are recommended. Additionally, a GSI can run privately on a client’s physical, firewall protected WSI machine, a client’s virtualized WSI, including those running under VMWare, Amazon’s AWS EC2 Services, Microsoft Azure or an equivalent cloud service provider.

Figure 1 below shows the minimum requirements for running a GSI in small capacity Gyst Service Environments (1 - 10 simultaneous conversations).

Figure 1.
GSI - Minimum Server Processor Requirements

Figure 2 below shows the minimum disk or permanent storage requirements for running a GSI in small capacity Gyst Service Environments.

Figure 2.
GSI - Minimum Disk Storage Requirements

This document assumes the user has remote or local access privileges to the WSI and has some familiarity with using Windows Administrative Tools, Microsoft Remote Desktop, Server Manager, and Microsoft IIS configuration tools.

What follows is a step by step guide on the entire installation and configuration process.


Step 1. Use the local terminal or Microsoft Remote Desktop to log in to the WSI and copy the Gyst.zip, GystWebAPI.zip, and VC_redist.x64.zip Gyst Installation files over to the WSI Desktop as follows…

Step 2. Start the Server Manager and select the Server Roles as follows…

Step 3. Select the Features to include .NET support as follows…

Step 4. Select the IIS Role Services as follows…

Step 5. Check the Roles and Features options look as follows and click Next to install…

Step 6. When the installation completes, verify the IIS service status is as follows…

Step 7. Click on the Gyst.zip file as shown on the Desktop in Step 1 to start installation of the Gyst UI and Service Support Files…

Step 8. When the installation process completes, the C:\Gyst folder should be set up as follows…

...and the Desktop should have a shortcut to the Gyst UI as follows…

Step 9. Open and extract the GystWebAPI.zip file contents to the C:\inetpub\wwwroot folder as follows…

Step 10. When this process completes, the C:\inetpub\wwwroot folder should look as follows…

Step 11. Click on the VC_redist.x64.zip redistributable file to install on the WSI...

Step 12. From the Server Manager Tools Tab, open the IIS Manager…

This displays the IIS Manager Panel…

You may want to pin the Server Manager and IIS Manager Panels to the Taskbar for future access, as shown above in Step 8.


Step 13. From the IIS Manager Panel, select the Configuration editor…

Step 14. Select system.webServer/modules in the Section drop down and click Unlock Section, if it is not already Unlocked.


Step 15. Repeat the Step 14 for the system.webServer/handlers section.



The GSI installation process is now complete and you should be able to make http calls to the Gyst API. To do this, you will need to know the dedicated IP address for this GSI on the local or remote network.

Additionally, Gyst API Test Scripts are available that will allow you to test the functionality of the GSI prior to adding API calls to your voice application.

Note: Steps 7 and 8 above should also be performed on the WSI or Media Server used to maintain and store the voice application’s audio file libraries.