The packaging of HUBzero for RedHat Enterprise Linux 6.5 is currently in BETA status, please report any issues you find.

RHEL 6.5 64-bit should be downloaded and installed. To obtain a copy, login to the RHN and follow the install directions. Do not worry at this point of tyring to install a basic LAMP environment or other server packages, those will be taken care of in later steps of the HUBzero install. Generally, default selections are satisfactory unless otherwise noted. Select a "Basic Server" setup when prompted during the installation.

Note: Hubzero has packaging support for amd64 (64 bit) Intel architectures, support for i386 (32 bit) is limited and is not currently recommended at this time.

When the installation is complete, your system will reboot. Be sure to remove the install disk or reset your server's boot media before rebooting.

The precise server configuration (such as disk partitioning, networking, etc) is dependent on how the hub is to be used and what hardware is being used, all the possible configuration options are not specifically outlined here. This installation guide outlines a very basic configuration but may not be suitable for larger sites. For larger sites, it is generally expected that the hub will be managed by an experienced Linux administrator who can help setup your site to meet your specific requirements.

Hubzero does not currently support SELinux. Since the default install of RHEL turns it on, we have to turn it off.

edit /etc/selinux/config and change the line that reads

SELINUX=enforcing 
to 
SELINUX=disabled

Reboot the system for this change to take effect

Optional. This step is only required if you didn't specify the fully qualified domain name during setup.

HUBzero expects the `hostname` command to return the fully qualified hostname for the system.

# hostname example.com

In order to make the change permanent, edit the /etc/sysconfig/network file's HOSTNAME entry similar to the following:

HOSTNAME=example.com

Now edit /etc/hosts by making sure that a line exists that looks like

127.0.0.1    example.com     example

Any other lines with "127.0.0.1" should be removed.

Any lines for 64 bit IP address "::1" may be left

HUBzero reserves all user ids from 1000 up for hub accounts. As part of the app middleware every account must map to a corresponding system account. Therefore when starting up a hub it is required to remove all accounts that have user ids 1000 or greater. New RHEL installations typically do not new setup a non root account during setup, but if you have any accounts added to the system, those accounts can be removed as follows:

# deluser username
# rm -fr /home/username

If you require additional system accounts, they can be numbered between 500-999 without interfering with hub operations.

Optional.This step is required only if you didn't configure networking during installation.

For help with RHEL networking setup, refer to the Red Hat guide on Network Interfaces

A typical scenario to setup networking is covered below. This general setup assumes you have a static IP address and basic network configuration available from a system administrator.

/etc/sysconfig/network-scripts/ifcfg-X

On most systems, X will be eth0, but if you have multiple network interfaces you'll notice additional entries. A typical ifcfg-eth0 file for a static IP address looks something like this:

DEVICE=eth0
BOOTPROTO=static
HWADDR=xx:xx:xx:xx:xx:xx
IPADDR=192.168.1.128
NETMASK=255.255.255.0
GATEWAY=192.168.1.1
ONBOOT=yes

Even though we used a private address range (192.168.0.0) which is usually used for dynamic IP setups, it is still a valid static IP setup. If you need an internet accessible hub, you'll ask your network administrator for the necessary IP addresses.

The file used to setup DNS for your hub, or any linux machine for that matter is: /etc/resolv.conf

nameserver 8.8.8.8
nameserver 192.168.1.1

If you are setting up a static IP address for your hub, you should be able to get DNS server settings from your network administrator. If you are using DHCP for your server, this file has likely already been setup with your network DHCP server.

Create a file /etc/yum.repos.d/hubzero.repo and put the following text inside:

[hubzero]
name=Hubzero RHEL$releasever - $basearch
baseurl=http://packages.hubzero.org/rpm/rhel6/hz-2.0.0
enabled=1
gpgcheck=0

In addition to the hubzero RPM repositories, you'll need several other repositories added to download other software later in this guide. Add the following file and content:

/etc/yum.repos.d/epel.repo

[epel]
name=Extra Packages for Enterprise Linux 6 - $basearch
#baseurl=http://download.fedoraproject.org/pub/epel/6/$basearch
mirrorlist=https://mirrors.fedoraproject.org/metalink?repo=epel-6&arch=$basearch
failovermethod=priority
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-6

Run the following commands to import the public PGP keys for the above repositories

% rpm --import https://fedoraproject.org/static/0608B895.txt
% rpm --import http://packages.hubzero.org/rpm/hubzero-rpm-key-pub

Additional repo setup for OpenVZ kernel installation

% yum install -y wget
% wget -P /etc/yum.repos.d/ http://ftp.openvz.org/openvz.repo

Red Hat Repository Subscriptions

Depending on whether you use the Red Hat Subscription Management or the RHN Classic, you will need to configure your server to use the optional channel by picking the appropriate command from below. You might also need your Red Hat Network username and password to complete this step.

Red Hat Subscription Management

yum-config-manager --enable rhel-6-server-optional-rpms

RHN Network

rhn-channel --add --channel rhel-x86_64-server-optional-6