H-Sphere Documentation Sysadmin Guide

 

Adding H-Sphere Services

 

Related Docs:   Adding Servers To H-Sphere Cluster

This document explains how to add Web, mail, and other services to a live H-Sphere server. If you need to add a new box to H-Sphere cluster, please refer to the Adding Servers document.

 

Step 1. Download Current Installer

  1. Log into the CP server as root.

  2. Check your current H-Sphere version:

    # cat ~cpanel/shiva/psoft_config/hsphere.properties | grep HS_VERSION

    Find out your current version by its build number in the list of H-Sphere versions.

    Important: It is strongly recommended to update your H-Sphere to the latest stable build of your current H-Sphere version.

  3. Important: Make sure the operating system on the server you are adding is supported in your current H-Sphere version.

  4. Download H-Sphere installer for your version of H-Sphere:
    Important: Before the download, make sure you don't have installers for older versions. If you do, delete them.

    H-Sphere 2.3.2:     wget http://www.psoft.net/shiv/HS/hsinst.tgz
    H-Sphere 2.4:     wget http://www.psoft.net/shiv/HS/hsinst24.tgz
    H-Sphere 2.4.1:     wget http://www.psoft.net/shiv/HS/hsinst241.tgz
    H-Sphere 2.4.2:     wget http://www.psoft.net/shiv/HS/hsinst242.tgz
    H-Sphere 2.4.3:     wget http://www.psoft.net/shiv/HS/hsinst243.tgz
  5. Unpack the downloaded archive and cd into the installation directory:

    tar xfz <ARCHIVE_NAME>
    cd <INSTALLATION_DIRECTORY>

 

Step 2. Configuration

At this step, you will create configuration files.

  1. Collect your current H-Sphere configuration:
    # ./import
  2. Launch the configuration wizard to enter installation data:
    ./configure
  3. Choose a physical server you want to add a service to.
  4. In the configuration menu, add a service choosing its ID from the displayed list of services.
  5. Save the ID number of the physical server where you added a service to, in the configuration menu.
  6. Save configuration and exit with '-' or 's'+'q' commands
  7. Execute:
    make add-server-ID
    where ID is the number of the server that you added the service on. This will regenerate install configuration, upload install scripts to this server and configure SSH keys to access it.
  8. Login to the server where you install the new service and execute:
    cd /hsphere/install
    make add-service S=<SERVICE>
    where <SERVICE> is be one of the following:
    dns
    mail
    weblite
    web
    mysql
    psql
    DNS Server
    Mail Server
    Webmail server (this option is not provided since H-Sphere 2.4.2)
    Web server
    MySQL server
    PostgreSQL server

 

Step 3. Enabling added services from the admin Control Panel.

On this step, please follow the instructions about how to add servers in admin Control Panel.

 

Resolving conflicts between Web and mail services

(outdated since HS 2.4.1)

  • If you have a mail server and want to add a web server:
    1. Stop Apache:
      - Linux: /etc/rc.d/init.d/httpd stop
      - FreeBSD: /usr/local/etc/rc.d/apache.sh stop
    2. Uninstall webmail apache rpm or package:
      - Linux: rpm -e hsphere-apache-lite
      - FreeBSD: pkg_delete `pkg_info | grep ^hsphere-apache-lite`
  • If you want to add a mail server and don't have a web server, after:
    make add-service S=mail
    execute:
    make add-service S=weblite

Related Docs:   Adding Servers To H-Sphere Cluster





User comments
No comments for this page.
Add comment


Home   Products   Services   Partners   Support   News   Contact   Forum
© 2020 psoft.net
All rights reserved.