Documentation

Linux

Install Basic Operating System

Advanced Linux system administrator skills are required, please read carefully.  Selecting all the default configurations during the operating system installation may not be correct.

The latest version of Debian GNU/Linux 8 64-bit should be downloaded and installed. Do NOT install any additional packages (especially Debian Desktop Environment) during installation. All packages required by HUBzero will be installed automatically as needed.

Hubzero packaging support is for the amd64 (64 bit) Intel architecture only.

System reboots are required to complete the installation.  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.

All hardware, filesystem partitions, RAID configurations, backup models, security models, etc. and base configurations of the host's email server, SSH server, network, etc. are the responsibility of the system administrator managing the host.

Configure Networking and DNS

Configure you host's network as desired.  A Fully Qualified Domain Name (FQDN) is required and a static IP is highly recommended (a common basic configuration for a web server).

The Hubzero middleware uses an IP addresses in the 192.168.0.0/16 subnet, do not use a conflicting host IP during network configuration.

Set hostname

Throughout this documentation you will see specific instructions for running commands, with part of the text highlighted. The highlighted text should be modified to your local configuration choices. (e.g. replace "example.com" with the fully qualified hostname of your machine).

HUBzero expects the `hostname` command to return the fully qualified hostname for the system.  This step may be skipped if previously configured.

sudo hostname example.com
To make the change permanent you must also edit the file /etc/hostname, this be done simply with:
sudo echo "example.com" > /etc/hostname

Fix hosts

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

127.0.1.1    example.com     example

Any other lines with "127.0.1.1" should be removed.

Delete local users

HUBzero reserves all user ids from 1000 up for hub accounts. As part of the HUBzero 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. On a new installation there is typically one such account that is created when you set up the hub, and this account can be removed as follows:

sudo rm -fr /home/username
sudo deluser username

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

 

Configure Advanced Package Tool

You will need to get and install the hubzero archive key to be able to verify packages from the hubzero archive:

sudo apt-key adv --keyserver keys.gnupg.net --recv-keys 143C99EF

Now configure the location of the HUBzero package repository

Add the following line to /etc/apt/sources.list

deb http://packages.hubzero.org/deb julian-deb8 main

 

With the above configured, update the local package database with information about the packages now available through the new repository:

sudo apt-get update

Install Support Packages

sudo apt-get install -y sudo dirmngr software-properties-common

Update the initial OS install

sudo apt-get upgrade -y

Last modified: