Parallels Virtualization and Automation Software

RESOLUTION

If you are going to install H-Sphere to only one computer, make sure it is at least Pentium III, 500MHz CPU and 512MB RAM. This will allow to host only a small number of customers. Adding SiteStudio will require at least 1000MHz CPU and 1GB RAM.

Other Requirements

- Full control of DNS, mail, web and other hosting servers is a must while installation and testing.
- H-Sphere can be installed only on public IPs.
- To provide domain registration services with OpenSRS, you will need a Full Access account. To get it, contact OpenSRS tech support, and tell them you will be using H-Sphere. They will waive the requirements for the full test.

Required Components and Configuration

Prior to the installation, make sure your server has
the following:

OpenSSH

1. Install OpenSSH package on each H-Sphere box.
   You can use standard RPMs under Linux or packages under FreeBSD.
   Usually, the standard Linux and FreeBSD installations contain
   the OpenSSH package, you can use it without any restrictions.
   However, we recommend to update the package to the last version.
   SSH keys need to be configured under the cpanel user.


2. To enable Permit Root Login, open file /etc/ssh/sshd_config
   and uncomment the line:
   
   
   
   PermitRootLogin yes
   
   
   
   Make sure PermitRootLogin is set to yes. Then restart SSH:
   
   
   
   
   • for Linux:
     
     
     /etc/init.d/sshd restart
     
   
   
   
   • for FreeBSD 4.x:
     
     
     kill -HUP `ps ax | grep sshd | grep -v grep | grep -v tty | awk '{print $1}'`
   
   
   • for FreeBSD 5.x:
     
     
     /etc/rc.d/sshd restart
   
   
   
   
3. Enable the OpenSSH daemon start at server startup.



4. Start the OpenSSH daemon.

 

Kernel

We strongly recommend using typical Linux/FreeBSD kernel (i.e., coming with official OS distributives or updates).
In particular, in case of FreeBSD we instist on GENERIC kernel with basic configuration.
We do not guarantee correct H-Sphere work on a server with customized kernel! Please carefully test H-Sphere functionality
on such a server before it becomes a production server!

Disk Quota

Enable the disk quota feature on each H-Sphere Web server. There is no need to enable it
on other servers.

To enable disk quota:

1. Log in as root.



2. Insert the usrquota directive (userquota for FreeBSD) into the /etc/fstab file
   for the corresponding partition.
   
   On Linux, it must look similar to this:
   
   
   
   LABEL=/hsphere   /hsphere   ext2   defaults,usrquota   1 1
   
   
   
   On FreeBSD, it must look similar to this:
   
   
   
   LABEL=/hsphere   /hsphere ufs rw,userquota 2 2
   
   


3. Execute the following commands:
   
   
   quotaoff /partition_with_userquota_enabled
   
   mount -o remount /partition_with_userquota_enabled
   (Linux only, skip this line with FreeBSD)
   
   rm -rf /partition_with_userquota_enabled/aquota.user
   /partition_with_userquota_enabled/quota.user
   
   quotacheck -mufv /partition_with_userquota_enabled(Linux)
   
   quotacheck -guv /partition_with_userquota_enabled(FreeBSD)
   
   
   quotaon /partition_with_userquota_enabled
   
   
   
   
   
   [-]
   If quotacheck returns the error: quotacheck: Cannot get quotafile name for /dev/xxx
   

   
   Do the following:
   
   1) # touch /partition_with_userquota_enabled/aquota.user
   
   
   2) # quotacheck -m /partition_with_userquota_enabled
   
   and ignore the message:
   
   "quotacheck: WARNING - Quotafile /partition_with_userquota_enabled/aquota.user was probably truncated.
   Can't save quota settings..."
   
   3) quotaon /partition_with_userquota_enabled
   
   
   
   
   
   
   


4. FreeBSD Web server installations: Enable disk quota in the kernel configuration.
   Also, in /etc/default/rc.conf set:
   
   
   
   enable_quotas="YES"
   
   
   

Root Partitions: we don't recommend enabling the disk quota feature on root partitions.
Use other partitions for this! Therefore, we advise not to place H-Sphere files on the root partition.

Quotacheck: quota versions can have some differences on different OSs.
You may need to execute the quotacheck command with some additional parameters.
Please read the command manual before performing this action.

Perl

H-Sphere installation script is written in Perl, therefore Perl is required on each box.
To check if Perl is installed, run:

perl -V

Caution: Do not update or change any configuration to your system Perl, as it will most likely
damage your H-Sphere installation.

See the list of supported Perl versions per OS.

Make

Make sure the make utility is installed on every box. To check if make is installed, run:

make -v

Command-Line URL Download Utility (wget or fetch)

H-Sphere installation script requires the command-line URL download utility,
wget for Linux, fetch for FreeBSD.

compat3x package

On FreeBSD 4.X servers, make sure to have the compat3x package installed
for compatibility with 3.x. To diagnose if your compat3x is missing, run:

/stand/sysinstall

and then go to Configure -> Distributions

 

SELinux Must Be Off

(RedHat Enterprise Linux 4, CentOS 4 and up, and White Box Enterprise Linux 4 only)

Before H-Sphere installation, make sure
SELinux is off on your Linux servers.

To check SELinux status, run:

selinuxenabled && echo $?

If as a result of this command you receive 0, SELinux is enabled. No result means that SELinux is off.

To disable SELinux,
set the following option in /etc/selinux/config:

SELINUX=disabled

This will turn off SELinux after reboot. To disable SELinux immediately, type:

setenforce 0

 

Remove Impeding Packages

Run the following command which will output the list of packages to be removed:

for Linux: rpm -qa | egrep -i '(apache|httpd|sql|java|jdk|jre|kaffe|jakarta|bind|rsync|spell)'

for FreeBSD: pkg_info | egrep -i '(apache|httpd|sql|java|jdk|jre|bind|rsync|gettext)' | awk '{print $1}'

Using your package manager uninstall the packages together with their dependencies. H-Sphere installation package will set
up replaced packages.

More info at: http://www.psoft.net/HSdocumentation/sysadmin/preparing_servers.html