CentreStack is comprised of several Internet Information Services (IIS) web applications that must work in harmony. Each web application runs in a separate application pool, and all applications must communicate with each other locally through hard-coded ports. CentreStack and its internal WCF (Windows Communication Foundation) components endpoints need ports 80, 443, 88, 8080, 8081, and 8732 exclusively. This means that if these ports are being used by other applications on the same server, the CentreStack installer or upgrade package will fail.
For this reason, we recommend that our users install CentreStack on a dedicated server with a clean installation of Windows OS (Server 2012 R2 preferred). Installations on non-clean servers are not supported, but you may refer to this article to "try" to make it work if you don't have other alternatives. In such cases, you will have to make a few manual adjustments in order to prevent conflicts and to ensure that the CentreStack installation can complete without errors.
The first adjustment is that if you already have an application in IIS named "Default Web Site," CentreStack will likely break that existing application (as well as itself) when it replaces files in the same directory with its own default.aspx, web.config, etc. Therefore, to protect your existing applications against overwrites, please ensure that none of your websites in IIS are named "Default Web Site."
The second adjustment is that no other web application in IIS may use ports 80, 88, 8080, 8081, 8732. Port 443 is the ubiquitous SSL port, and it can be shared with multiple web applications as long as you add a valid certificate for each site and enable the "Require Server Name Indication" checkbox under the Site's Binding dialog box. The name "localhost" is also necessary for CentreStack's internal components communications, so if your current web applications depend on the name "localhost," you will have to change those applications to use a local IP instead of it. If this is not possible, then it will not be possible to install CentreStack on your server.
If you already have an old installation of CentreStack on the server, but want to install CentreStack from scratch because the installer keeps failing, you should first uninstall CentreStack from the Windows Control Panel, and then manually delete the following sites and their corresponding children from IIS:
- Default Web Site,
Next, you should delete the above site's corresponding application pools:
- and every other application pools whose names start with "glad," such as gladatmos2, gladazure, gladfilesvr, and so on.
Another issue that you may come across is that some existing applications on the server might be using port 80 during CentreStack's installation/upgrade process. You will know if this is an issue if the installer complains that IIS is not ready and when you manually try to "start" any of the CentreStack's sites, you receive the following Windows Exception:
The process cannot access the file because it is being used by another process. (Exception from HRESULT: 0x080070020)
To get around this error, you will need to find out what programs are using the CentreStack's ports, and then terminate those processes (at least while the CentreStack installation is running). Start with port 80, which is the most likely to be used by other programs and then proceed to test other ports until you can finish the installation process without errors. To find out what is using a certain port, open a DOS command prompt and type:
netstat -aon | find ":80"
(where 80 is the port that you are querying)
The output will include an integer PID (Process ID) on the last column. Once you know the PID, open a Windows Task Manager (Windows Key + R, then taskmgr.msc) window and terminate the appropriate process from the Details tab. Then, retry the CentreStack installation/upgrade.
Please report any other errors or installation problems to firstname.lastname@example.org.