Contents

Introduction. 4

About HCnix. 4

Before Installation. 4

HCnix Supported Servers. 4

HCnix Supported OS and Distributions. 5

Install HCnix. 6

Steps to Follow.. 6

For Database Server. 8

For Subsequent Server. 12

Update HCnix. 14

Remove HCnix. 17

Proprietary Notice

This document is the property of, and contains proprietary information of Hosting Controller. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying or recording, for any purpose other than consideration of the technical contents without the written acquiescence of a duly authorized representative of Hosting Controller.

Document Conventions

TERMS/ SYMBOLS	WHAT THEY MEAN?
BOLD	The ‘Bold & UPPERCASE’ text is used to highlight vital terms in the document.
	This symbol is used as a sign for NOTE. It reminds about certain noteworthy steps or takes your attention towards the significant tasks to be done or gives additional information for your ease.
	This symbol is used as a sign for WARNING. It highlights some steps that cannot be skipped or should be followed as stated to avoid errors and confusion.

Target Audience

This document is intended for all those who want to install HCnix on their systems. It describes all the prerequisites and installation steps that assure successful installation and working of HCnix on Linux platform.

Please, read this document to have absolute information and to avoid any type of ambiguity related to the installation process.

Introduction

About HCnix

It enables web hosting companies to manage all their GNU/Linux servers through centralized interface. You can expand your business with HCnix, from one server to cluster of servers. It allows you to add new clusters as per your requirements.

Before Installation

You need to know the followings to install and configure HCnix on Linux systems.

HCnix Supported Servers

Prior to install HCnix on your machines, you should separately install your required applications/software on your server before running HCnix installer i.e. Web/DNS/Mail/Database Server etc. Following is the list of all such servers that should be properly running on your system before installing HCnix.

Ø Web Server Role

o Apache2.x Web Server

o Vsftp/wu-ftp

o Quota Package

o ACL Package

o Webalizer (on your choice)

o xinetd Package

Ø DNS Role

o BIND9

Ø Database Server Role

o MySQL Database

Ø Mail Server Role

o Sendmail/Qmail with VPOPMail/Exim

o xinetd Package

o Courier-Imap(For Qmail)

Make sure that all the relevant services are running on your machine.

HCnix Supported OS and Distributions

As far as operating system is concerned, HCnix supports the following:

Ø Linux (Kernel 2.11.x or later with glibc6)

HCnix supports GUN/LINUX Distributions like:

Ø SuSE 10.x and later

Ø Debian 4.x and later

Ø Ubuntu 5.x and later

Ø CentOS: 4.6 and later

Ø Fedora Core 4 and later

Ø Redhat® Enterprise Linux 3.0 and later

The HCnix installer allows you to:

n Install HCnix

n Update HCnix

n Remove HCnix

Install HCnix

Steps to Follow

The steps should be followed as stated to avoid any type of confusion and faulty installation of HCnix.

First of all extract the HCnix installer.

Once the installer is extracted, execute the installer.

In case you are installing HCnix for the first time, following screen is shown.

Now, you need to select whether you accept the license agreement or not.

To accept the terms and conditions, select 1. In case of disagreement with any of the terms, select 2.

Once you accept the license agreement, following screen is shown:

Select your server as required. If the server where you are installing HCnix is a Database Server where you want to create HCnix database too then select 1. Otherwise, select 2 if it is a Subsequent Server.

n If the server where you are installing HCnix is the server where you want to create HCnix database then select Database Server.

n If the server where you are installing HCnix is not the server where you want to create HCnix database then select Subsequent Server.

For Database Server

Specify your database settings as required.

Specifying database settings, opens following screen:

These are HCnix database information that creates during the installation.

Now, specify user credentials for Host Administrator of HCnix.

Now, specify your selections for the HCnix Control Panel to be installed on the Linux Server.

Specify your required paths for the service being installed or proceed with the default paths as per your requirements.

Now, specify IP address for HCnix client machines

You can add more than one IP address for HCnix client machines as required. To add another IP address, select ‘y’. If you don’t want to add another IP, select ‘n’.

That’s it. HCnix is successfully installed on your system.

You can start/stop/restart HCnix services using the commands shown below:

For Subsequent Server

Selecting 2 while server selection opens following screen:

Specify your required paths for the service being installed or proceed with the default paths as per your requirements.

Now specify required information to register your server with the cluster as shown:

Once the server is registered, the required folders are created by the installer.

Specify client’s IP address. You can add more than one IP address if required.

That’s it HCnix is installed successfully. You can start/stop/restart HCnix services using the commands shown below:

Update HCnix

To update HCnix version on your system, follow the steps as stated:

Once the installer is extracted, execute the installer as shown:

Now specify your choice as required, i.e. either you want to update/remove the existing HCnix on your system.

Selecting 1 opens following screen:

Once the package is extracted, it shows following screen:

HCnix is updated successfully. You can start/stop/restart HCnix services with the commands shown in the screen shot above.

Remove HCnix

To remove HCnix from your system, follow the steps as stated:

Once the installer is extracted, execute the installer as shown:

Now specify your choice as required, i.e. either you want to update/remove the existing HCnix on your system.

Select 2 to delete HCnix from your system.

Contact Us

In case of any ambiguity/query regarding HCnix installation on your machines, please feel free to contact us at hcnixsupport@hostingcontroller.com