This article will show you how to install the 1H Guardian 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 Guardian 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 Guardian installation can be accomplished by running the command below. Note that first you need to have the 1H installation script downloaded on the server.
Guardian Local Interface
Once Guardian is successfully installed on your server you will be able to access the data it generates section of your Local Interface at:
where yourservername.com is the domain for the corresponding server and <IP ADDRESS> is the primary IP address for the server.
In the Downtime Stats section of your Local interface you will find real time information your server status and historical availability report, that can be generated for a period of your choice.
Guardian Central Portal
When using Guardian on multiple servers you need a centralized interface where you can monitor all servers simultaneously. For this purpose we have created the 1H Central Portal. Its main purpose is to provide you with information about all servers where you have 1H Software installed in a single centralized interface.
Here are the base actions you need to accomplish in order to have Central Portal working for you:
- Install Central Poral
- Access the Portal
- Add the server with the Guardian to the interface through server groups
Install Central Portal
1H portal is the central interface that collects the date from all 1H tools and all your servers. You only need to install it once on one server and we highly recommend that it is the first 1H software that you install. However, if you already have a 1H portal installed please proceed directly with the Guardian installation instructions.
The Portal installation can be accomplished by running the following command:
To see more details visit Portal Installation section.
Access 1H Portal
Once you have set the correct DNS settings on the server where the portal is installed the 1H Portal interface will be available via the following URL:
Alternatively (if you have mod_userdir enabled for the server and the 1h username) the 1H Central Portal can be accessed via:
Where servername.com is the actual hostname for your server and <IP ADDRESS> is the primary IP address for the server.
The Portal interface is 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.
Add server to portal
The last step before seeing the Guardian data in the Portal is to add the server with the guardian in an existing Server Group in the Portal. 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"
Server Groups and Servers management are explained in details in the Server Groups section.
Here you can find a list of relevant articles regarding the 1H Guardian Software.
- Guardian Introduction
- Guardian Requirements
- Guardian Installation
- Guardian Post Installation
- Guardian Configuration
- Email Notifications
- Guardian System Daemon
- Guardian kill logic
- Real Time Status
- Downtime Stats
- Availability Reports
- Enable or disable service monitoring
- Server Groups management and How to add a new Server to an existing Server Group