This article will show you how to install the 1H Hive software for your server and guide you through all steps you need to accomplish in order to have a fully functional system.
Important note: Before proceeding to Hive installation, please make sure to review its hardware, OS and software requirements.
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.
The Hive installation can be accomplished by running the command below. The installation script will automatically detect server Apache version and install the correct Hive instance. Note that first you need to have the 1H installation script downloaded on the server.
All dependencies are automatically downloaded and installed. This also includes WHM/cPanel plugins, which later you can use to configure Hive.
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.
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.
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
CPU-Stats Local Interface
In the given example the local CPU Stats interface for Hive will be accessible at:
The CPU Stats local interface by default is not password protected. If you want to password protect it, please check the Hive Configuration article.
The Hive/CPU Stats will provide you with system usage graphics for the server. There are several sub-categories for which you can explore the graphics and the overall resource usage for the server.
Detailed information can be found under the CPU Stats 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:
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:
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, under the CPU Stats section, 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:
- Login to the 1H Admin Portal interface and go to Server Groups
- Double click on an existing Server Group
- Click the "Add server" button in the lower right part of the page
- Enter the server name and IP address and click "Add Server"
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 Hive will provide you with system usage graphics for all servers added under Server Groups for the portal. There are several sub-categories for which you can explore the graphics and the overall resource usage for the servers and they are separated in tabs under the CPU Stats interface.
More detailed information you can find in the CPU Stats Admin Portal Web Interface
The Hive configuration file is /usr/local/apache/conf/rlimit-config. Generally it is not recommended to make changes to it manually in case you do not know what exactly you are doing. You can use the Hive WHM Plugin configuration tool instead.
You can find detailed instructions how to manage the configuration both via the WHM Plugin and directly making changes to the configuration file in the Hive Configuration section.
The Hive configuration includes several limits that are included by default in it. Some of those can be modified via WHM -> Plugins -> 1H Software -> Hive Configuration. Others you should manually change on the server should you need to do so. It is also possible to apply specific limitations for a single user only. All those settings are explained in details in the Hive Limitations section. It is advisable to review those and make sure the settings are set according to your personal preferences for the server.
Here you can find a list of relevant articles regarding the 1H Hive Software.