Digits Install

From Wiki

Jump to: navigation, search

This article will guide you through the 1H Digits software installation process for your server. It includes all steps you need to accomplish in order to have a fully functional system.

Important note: Before proceeding to Digits installation, please make sure to review its hardware, OS and software requirements.

Contents

Installation script download

All 1H software is installed with the help of a simple script. You need to download the script on your server by pasting the command in your server console:

wget http://sw.1h.com/1h_install.sh && chmod 755 1h_install.sh 

When installing the 1H software you have selected this installation script will make an automatic check of your server software for compatibility reasons. If your server needs to have software installed or upgraded in order to have the 1H product functional on that machine, the script will ask for your agreement to automatically complete the required updates. In case critical software is missing or does not correspond to 1H requirements, the installation process will be completely stopped and you will need to install or update the software yourself. An example of critical software for all 1H products is the operation system being older than CentOS 5.x. You may read here the Guardian technical requirements.

Portal Installation

IMPORTANT: You need the 1H Admin Portal to be installed for one and only one of your servers. Generally it is recommended to use a separate server for the 1H Portal only. The Portal itself is a necessary requirement to use all other 1H Software due to several reasons:

The Portal installation can be accomplished by running the following command:

./1h_install.sh portal 

All dependencies will be automatically downloaded also.

Once you have the 1H Admin Portal installed for one server you can proceed with the package installation on all other servers without going through this step.

Digits Installation

The Digits installation can be accomplished by running the command below. Note that first you need to have the 1H installation script downloaded on the server.

./1h_install.sh digits

All dependencies are automatically downloaded and installed.

Digits Post-Installation

DNS Settings

All 1H Software use specific URLs. For this purpose you need to adjust the DNS settings for the server hostname accordingly. You need the specific sub-domain - 1h.$servername.

Example

1h.serverdemo.com

If the DNS zone for the server (i.e. serverdemo.com) is not managed by the server itself, but from an outside DNS server - You will need to create an A record for the 1h.$servername sub-domain name pointing to the primary IP address of the server.

Example:

serverdemo.com has IP address 10.101.10.101

You will need to create 1h.serverdemo.com which resolves to 10.101.10.101:

1h.serverdemo.com IN A 10.101.10.101

Digits Local Interface

In the given example the local interface for Digits will be accessible at:

1h.serverdemo.com/digits

The Digits local interface by default is not password protected. However, if you would like to password-protect it, we have generated a sample .htaccess file for you. The default file is located under the following path:

/home/1h/public_html/htaccess.default

If you would like to password protect your software, please use the following command:

mv /home/1h/public_html/htaccess.default /home/1h/public_html/.htaccess

You will be assigned login details for your local interface. The username is admin and you can recover the password we have assigned by using the following command:

grep access_pass /usr/local/1h/etc/web.conf | cut -d = -f 2

The Digits Web Interface is designed to provide you with detailed Bandwidth and Quota usage statistics. The local web interface will provide you detailed data per client as well as many additional information about the server.

Digits-local-interface.jpg

Detailed information you can find in the Digits Local Web Interface section.

Portal Centralized Interface

The 1H Portal interface provides you with general information for all your servers with 1H Software installed on them. The 1H Portal interface is available via the following URL:

1h.serverdemo.com/portal

The Portal interface is also password protected. The username for the login is always admin and the password can be withdrawn running the following command on the server:

grep access_pass /usr/local/1h/etc/web.conf

You will get:

access_pass=<passwordhere>

NB: You should have received an email with the needed login details for the 1H Portal at the administrative email for WHM upon finalizing the portal installation. In any case you can use the procedure described above to reclaim the password.

IMPORTANT: In order to have a server included in the Portal Centralized interface it should be added to an existing Server Group in the 1H Admin Portal. Server Groups and Servers management are explained in details in the Server Groups section. Generally all you need to do is follow these steps:

NB: Note that it will take up to 24 hours for the data in the centralized interface to be updated after you have added a new server.

The Admin Portal Web Interface for Digits will provide summarized Quota and Bandwidth information for all servers added in the portal Server Groups.

Digits-portal-interface.jpg

More detailed information you can find in the Digits Admin Portal Web Interface section.

Digits Articles

Here you can find other relevant articles regarding the 1H Digits Software.

Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox