Installing EHX Server using Powershell

Owned by erik.devane@clearcom.com
Mar 04, 2022
2 min read

The EHXServerSetup.exe installer has been written to automate configuring a Windows PC as an EHX Server for EHX clients. There may be instances where a graphical installer is not available, or may not be allowed.

We will be using Powershell with Administrator permissions. Any failed components can be verified by adding -Verbose to that particular line.

To install on a headless Windows PC (such as Windows 10 embedded or Windows 2019 Server Core):

  1. Download EHXServerSetup.exe and extract the files. 7Zip and WinRar work well for this, and this step can be completed on any PC.

  2. Zip the EclipseWCFWS directory and move it across to the destination headless machine.

  3. Install IIS features by running the following commands with Powershell. Save as a .ps1 file if more convenient:
    Install-WindowsFeature Web-Server
    Install-WindowsFeature Web-Default-Doc
    Install-WindowsFeature Web-Dir-Browsing
    Install-WindowsFeature Web-Http-Errors
    Install-WindowsFeature Web-Static-Content
    Install-WindowsFeature Web-Http-Redirect
    Install-WindowsFeature Web-Http-Logging
    Install-WindowsFeature Web-Custom-Logging
    Install-WindowsFeature Web-Log-Libraries
    Install-WindowsFeature Web-Request-Monitor
    Install-WindowsFeature Web-Http-Tracing
    Install-WindowsFeature Web-Stat-Compression
    Install-WindowsFeature Web-Filtering
    Install-WindowsFeature Web-Basic-Auth
    Install-WindowsFeature Web-Digest-Auth
    Install-WindowsFeature Web-IP-Security
    Install-WindowsFeature Web-Url-Auth
    Install-WindowsFeature Web-Windows-Auth
    Install-WindowsFeature Web-Net-Ext45
    Install-WindowsFeature Web-Asp-Net45
    Install-WindowsFeature Web-WebSockets
    Install-WindowsFeature Web-Mgmt-Console
    Install-WindowsFeature Web-Scripting-Tools
    Install-WindowsFeature Web-Mgmt-Service

4. Extract the EclipseWCFWS.zip and create an IIS Application. This also sets up permissions:

Expand-Archive -Path EclipseWCFWS.zip
cd EclipseWCFWS
mv EclipseWCFWS c:\inetpub\EclipseServer
New-WebApplication -Name "EclipseServer" -Site "Default Web Site" -PhysicalPath "c:\inetpub\EclipseServer" -ApplicationPool "DefaultAppPool"
get-acl c:\inetpub\wwwroot | Set-Acl c:\inetpub\EclipseServer

5. Complete IIS installation by enabling .Net:

Install-WindowsFeature NET-Framework-Features
Install-WindowsFeature NET-WCF-TCP-Activation45
Enable-WindowsOptionalFeature -Online -FeatureName WCF-HTTP-Activation45
Enable-WindowsOptionalFeature -Online -FeatureName WCF-TCP-Activation45
Enable-WindowsOptionalFeature -Online -FeatureName IIS-ASPNET
Enable-WindowsOptionalFeature -Online -FeatureName IIS-ASPNET45

6. Test and make sure http://localhost/version.aspx and http://localhost/EclipseServer/commandservice.svc return either numbers or gray and blue:

7. Now test access from a remote PC. Use a web browser as before and then launch EHX on the client PC, and choose Log Out, then add the login credentials as below:

Default username with be Administrator, no password, and 184.72.187.47 will be replaced by the EHX server’s IP or hostname.

CAN'T FIND YOUR ANSWER? CLICK HERE TO CONTACT SUPPORT

This solution was provided to you by Clear-Com via a question submitted to us by customers like you. If your question wasn’t answered, you need help or you have a recommended solution for our database, please send us an email at support@clearcom.com

The information on this page is owned by Clear-Com and constitutes Clear-Com’s confidential and proprietary information, may be used solely for purposes related to the furtherance of Clear-Com’ business and shall not be disclosed, distributed, copied or disseminated without Clear-Com’s prior written consent. Click Here for Clear-Com's privacy statement.