What can I use to run Enkompass?

Enkompass requires all server to run Windows Server 2008 64 bit. Standard, Web Edition, Enterprise and Data Center can be used, but Web Edition can’t be the sole machine used as Active Directory is required. The initial release of 2008, R2 and SP1 are all supported.

Where do I start?

Chose the Computer Name for your Active Directory server. The Computer Name + Active Directory name will determine your first mandatory, permanent Name Server record for every site hosted in Enkompass. If you leave the computer name as WIN-732KEJJ-2342452 and create the AD Domain as myhostingco.local then you will end up with EVERY zone having WIN-732KEJJ-2342452.myhosting.local show up as a NS record and it cannot be removed. At the same time, you cannot host a domain in Enkompass that is the same as your AD Domain name. If you need to host myhostingco.com then you should create the AD Domain as something like Enko.mynostingco.com and then the Computer Name of NS1 or similar. Your NS record will then look like: NS1.Enko.myhostingco.com.

What must I do before installing Enkompass?

Get Active Directory setup as described in FAQ #2 and then install IIS (and ALL components except for Hostable Web Core) on the server that Enkompass will be installed on and then run Windows Update until nothing is left. Make sure all of the required ports are open or get opened between all servers: http://go.cpanel.net/enkfirewall Make sure UAC is disabled on all servers that will be part of this Enkompass implementation and reboot. 2008 R2 doesn’t explicitly state a reboot is needed, but it is. Make sure there is no user account with the name of Admin that already exists (when installing into existing AD setups, Enkompass will create a user called Admin and the install will fail if one already exists.

What if I already have Active Directory setup?

Enkompass creates a cPanel OU that all accounts are stored in. So long as you are ok with the DNS work that AD will do as described in #1 and there is no admin account per #3 then you can install Enkompass into your existing setup. Enkompass will need to expand the schema to include some features necessary for operation.

Are there any other ‘gotchas’ before installing?

If using MailEnable on the same server as Enkompass it is suggested that you install it before installing Enkompass so that it will be rolled in with the IIS configuration that Enkompass manages. Enkompass doesn’t install any mail or SQL servers and those will have to be done separate of the Enkompass install.

Which mail and SQL servers are supported?

MySQL 5.1+, MailEnable, SmarterMail, MSSQL 2005 and 2008. For MSSQL Express or Enterprise can be used.

Everything is now installed but my site isn’t showing up. What is wrong?

Did you wait for the configuration push? It can take a few minutes for Enkompass to publish the site. Please wait at least 10 minutes so the site data can be fully setup within Enkompass.

I can’t connect via FTP to upload my site. Why am I getting errors?

Microsoft rewrote FTP for IIS7 and has changed the formatting of usernames. Simply, the username should be formatted to domain.tld|username but more information can be found here: http://go.cpanel.net/ftpusername

I waited, but my PHP and/or ASP code isn’t showing correctly. What is wrong?

Please review the following link regarding WSO Roles and how they control access to features in Enkompass: http://go.cpanel.net/roles

I checked and I do have Roles properly assigned but I still can’t see the pages correctly, now what?

If you log into the server and view the site locally through Internet Explorer you will often see a more detailed error message than when viewing from a remote workstation.

I can’t log into Enkompass. What went wrong?

If you are using Enkompass as a single server solution or if Enkompass is on the same server as Active Directory, the WCF service can start before Active Directory is fully ready to go. Setting the service to Delayed Start can alleviate this.

I am getting errors and I don’t understand what is going on? Where can I get more detailed information on what is going on? Where are the logs?

Logging may not be turned up as high as you need it to see specifically what is going on. To enable Verbose logging, please follow the steps detailed here: http://go.cpanel.net/enkverboselog

I created a virtual directory for hosting an application but the changes keep getting overwritten. How can I make the changes permanent?

Please see this blog entry for details on now to make these persistent: http://go.cpanel.net/createvirtdir