Portal Install

From Wiki

Jump to: navigation, search

This article will show you how to install the 1H Portal software for your server and guide you through all steps you need to accomplish in order to have a fully functional system.

IMPORTANT: Note that the Portal itself should be the first 1H Software you need to install for the first server where you are installing 1H Software. You will have the 1H Admin Portal installed for a single server only and it will be gathering information from all other servers where you have 1H Software installed. Generally it is recommended to use a separate server for the Portal installation only.

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

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

./1h_install.sh portal 

All dependencies will be automatically downloaded and installed also.

Portal Post-Installation

DNS Settings

Generally the 1H Central Portal Software uses specific URL. 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

NB: This is an optional setup and you can still use the 1H Central Portal via servers IP address and mod_userdir. In this case the portal will be accessible via an URL of type:

http://<IP ADDRESS>/~1h/portal/

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.

Generally at this point you should have a fresh portal installation for your server. It is now time to proceed with the installation of the other 1H Software. You can find specific instructions how to perform the installations in the following articles. Note that as you have just installed the 1H Portal you do not need to go through this step again:

Portal Articles

Here you can find a list of relevant articles regarding the 1H Admin Portal Software.

Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox