After installation of Enkompass while configuring the server at “Initial Setup Wizard” when you press Next on Second Step it throws following Error

Problem Code: Unknown Type: WebAppAPIException
Exception of type ‘cPanel.Web.Exceptions.WebAppAPIException’ was thrown.
Method ‘GetServerSmtp Could not connect to net.tcp://127.0.0.1:2098/ServerAdministratorInterface. The connection attempt lasted for a time span of 00:00:01.0153305. TCP error code 10061: No connection could be made because the target machine actively refused it 127.0.0.1:2098. ‘ from contract ‘IServerAdministratorService’ failed.

OR you get following error:

Problem Code: Unknown Type: WebAppAPIException
Exception of type ‘cPanel.Web.Exceptions.WebAppAPIException’ was thrown.
Method ‘GetServerSmtp Could not connect to net.tcp://127.0.0.1:2098/ServerAdministratorInterface. The connection attempt lasted for a time span of 00:00:01.0153305. TCP error code 10061: No connection could be made because the target machine actively refused it 127.0.0.1:2098. ‘ from contract ‘IServerAdministratorService’ failed.

The problem can be with EnkompassWcfService. To fix this issue you can by restarting EnkompassWcfService from Enkompass Panel or from Remote Desktop.

Restarting EnkompassWcfService from Enkompass Panel

1) Login to WHM using Admin Details.

2) Navigate to WHM > Server Configuration > Service Manager

3) Select the Server ID from Drop down.

4) Select “Restart” next to that EnkompassWcfService option.

Restarting EnkompassWcfService from Remote Desktop

1) Login into the server using RDP

2) Start > run > type “services.msc” > enter or Start > Control Panel > Administrative tools >> Services

3) Search “EnkompassWcfService”

4) Right Click on it and “Restart”

Try to run “Initial Setup Wizard” now.

Enkompass is a Windows Control Panel provided and support by cPanel which is the leading Control Panel provider for Linux. Enkompass can be installed on a Single Server or on a Distributed System. In Single Server every component i.e. IIS, Mail Server, MSSQL, MySQL will be installed on single System where the distributed system is a combination or network of few servers on which Mails, MySQL, MSSQL, IIS are running on different Servers. In this Post I will explain how you can install Enkompass on a stand alone server (HyperV VM) without cluster.

I have configured Standalone System on a HyperV VM having Following Configuration
1) CPU: 1 CPU (Intel Xeon e5520 on host server)
2) RAM: 2 GB
3) HDD: 30 GB
4) OS: Microsoft Windows Server 2008 (x64)

Installation of Enkompass includes two parts which are:

1) Configuration of Microsoft Windows 2008
2) Installation and Configuration of Enkompass.

Configuration of Microsoft Windows 2008

Before we proceed with the installation of Enkompass we need to install and configure some softwares and Windows components. Following is the list of components which need to be installed or configured (I will explain steps)
a) Install Active Directory
b) Install IIS
c) SmarterMail Server
d) MySQL Server
e) Microsoft SQL Server

a) Install Active Directory.
On Microsoft Windows Server 2008 you can install Active Directory using command “dcpromo” and follow the steps. You can refer the article “Step-By-Step Guide for Windows Server 2008 Domain Controller” () where I have explained the steps to install Active Directory on a Windows Server 2008.

b) Install IIS.
IIS (Internet Information Services) is the default Web-server which comes with Microsoft Windows Platform. Following are the steps to install IIS on Windows Server 2008

1) Open/Expand Server Manager, click on Roles.
2) Click on “Add Roles” which will open Roles installation wizard. Press next to continue.
3) Now Select Web Server (IIS) from the list as shown in below Image

4) On next step it will ask for Role Services just like below image.

Select the following Services for Enkompass
1. All Common HTTP Features
2. Application Development

• ASP.Net
• .Net Extensibility
• ISAPI Filters
• ISAPI Extensions
• Server Side Includes

3. Health and Diagnostics

• HTTP Logging
• Request Monitor

4. Security

• Basic Authentication
• Windows Authentication
• URL Authorization
• Request Filtering
• IP and Domain Restrictions

5. Performance

• Static Content Compression

6. Management Tools

• IIS Management Console
• IIS Management Scripts and Tools
• Management Service
• ALL IIS 6 Management Compatibility (If using MailEnable)

5) Press Next start the installation.

c) Installation SmarterMail Server
SmarterMail is a Email Server product from smartertools.com, SmarterMail strives to revolutionize the way you host e-mail. With an intuitive interface, flexible spam options that include Bayesian Filtering, and live server diagnostics, SmarterMail becomes the best mail server solution you will find. Features include a web mail and administration interface, an active sidebar that allows for easy navigation, live server diagnostics that show you real time health and activity for your server, easy spam administration, smart hosting to allow easy setup of a backup server, multi-language support for the Web interface and spell check, folder auto-clean to keep junk Email and deleted items under control, advanced content filtering etc. Following are the installation steps of SmarterMail.

1) Download the free edition of SmarterMail from Smartertools website i.e. https://www.smartertools.com/
2) Run the downloaded executable and follow the steps (which is quite similar to any software installation in Windows).
3) Once the installation gets complete SmarterMail will pop-up for it’s configuration like License, Admin login Details, Spam Options etc. Select the options as per your requirements, Also if you want to use free edition press next when Screen ask for License.
4) Open Port 9998 in Windows Firewall so you can access the SmarterMail admin Panel on Internet as well.

d) Installation MySQL Server
1) Download MySQL 5.1 or greater from http://dev.mysql.com/downloads/
2) Run the downloaded executable and follow the steps
3) Open Port 3306 in Windows Firewall.

e) MSSQL Server Installation
1) Download MSSQL 2005 or 2008 Express Edition from Microsoft or install License copy.
2) If you install MSSQL Express Edition don’t use a named version.
3) Install it using Mixed Mode.

f) Turn off User Account Control
1) Go to Control Panel >> User Accounts
2) Click on “Turn User Account Control on or off”

3) Press OK to disable User Account Control

4) Reboot the System to apply the changes.

Please check Installation and Configuration of Enkompass (Part-II) of this Article here.

In my previous Article “Configuration of Microsoft Windows Server 2008” I have explain the components which are requires by Enkompass. Once you done all the configuration you are ready to install Enkompass on your Server.

Installation and Configuration of Enkompass

1) Download the latest version i.e. Enkompass 1 from http://layer1.cpanel.net/

2) Run the installer, and follow the instructions to complete the installation. Enkompass will install its prerequisites.

3) Following is the very first screen of Enkompass installer which will tell you about the information components which need to be installed before Enkompass installation. Press next to continue

4) Enkompass will now start installing Third Party Components like Enkompass Prerequisite files and ASP.NET 2.0 AJAX Extension. Accept the EULA to install these Components.

5) Once the Third Party installation gets complete Main Enkompass Setup Wizard will start. Press Next to continue

6) Accept the EULA and Press Next.

7) Destination folder:- Select the Folder where you want to install Enkompass.

8) User Information:- Enkompass need a Domain Administrator Account and if the user you mentioned doesn’t exists Enkompass will create it. Make sure to note down the password.

9) Admin Contact Information:- Insert Admin Contact Email Address and Pager (optional) and press Next

10) Server IP:- Insert the Main IP of the Server and press Next to continue

11) DNS Server:- Enter the Primary DNS for Enkompass; Next to continue

12) Website Share Path:- Here you will have to mention the path where data of the website will be saved. Just like /home in Linux Cpanel

13) Folder for Website Data:- Website Data folder stores the data of all the website. I have kept it to default and press next.

14) Backup Location:- Mention the path where Enkompass will save the backups of all the accounts

15) IIS Share Configuration:- Enkompass setup IIS to use shared configuration. I have created and shared one folder (named iis) on the same server and mentioned \\[IP ADDRESS]\iis in the field.

16) IIS Encryption Password:- Enkompass creates a password to protect the IIS Shared Configuration file. Make sure to note down the password.

17) PHP on IIS:- If you want IIS to be configured to host PHP select the option “Configure IIS to host PHP” and Enkompass will configure it for you.

18) Ready to Install:- Press Next to install

19) Finish:- Enkompass has been installed successfully but make sure to open Server Administrator Interface so you can configure Enkompass.

20) Once you press finish Enkompass will open on local browser of the server and you will get following Screen

Here, you will have to mention details of server, Database, Mail Server etc. Once you finished, Enkompass is installed. You can access it using http://[IPaddress]:2086 and after login you will get following screen
final

Thats All…