Skip to content

INSTALL.md

Latest commit

 

History

History
82 lines (53 loc) · 2.75 KB

INSTALL.md

File metadata and controls

82 lines (53 loc) · 2.75 KB

Installing Alces Metalware

Supported platforms

Alces Metalware currently supports the following platforms/distributions:

  • Enterprise Linux 6 distributions: RHEL, CentOS, Scientific Linux (el6)
  • Enterprise Linux 7 distributions: RHEL, CentOS, Scientific Linux (el7)

Prerequisites

The install scripts handle the installation of all required packages from your distribution and will install on a minimal base. For Enterprise Linux distributions installation of the @core and @base package groups is sufficient.

Basic Installation

Metalware is a system-level package and must be installed by the root user.

  1. Become root.

    sudo -s

  2. Set the alces_OS environment variable to match the distribution on which you are installing. Currently supported options are el6 and el7:

    export alces_OS=el7

  3. Invoke installation by piping output from curl to bash:

    curl -sL http://git.io/metalware-installer | /bin/bash

    If you want to you can download the script first. You might want to do this if you want to inspect what it's going to do, or if you're nervous about it being truncated during download:

    curl -sL http://git.io/metalware-installer > /tmp/bootstrap.sh
less /tmp/bootstrap.sh
bash /tmp/bootstrap.sh

  4. After installation, you can logout and login again in order to set up the appropriate shell configuration, or you can source the shell configuration manually:

    source /etc/profile.d/alces-metalware.sh

Advanced installation parameters

Additional environment variables may be set to influence the installation process.

Build from upstream source

Set the alces_SOURCE variable to indicate that you want to build from upstream source code rather than installing prebuilt binaries for your distribution. Choose fresh to download and build components from upstream sources, or dist to use prebuilt binaries downloaded on Amazon S3.

export alces_SOURCE=fresh
curl -sL http://git.io/metalware-installer | /bin/bash

Build from existing directory

Set the alces_SRC_DIR variable to point to an existing clone of the repository. If a clone isn't available in the path you specify the path will be used to house the downloaded code rather than the default /tmp/metalware.XXXXXX temporary directory.

cd /usr/src
git clone https://github.com/alces-software/metalware
export alces_SRC_DIR=/usr/src/metalware
/usr/src/metalware/scripts/bootstrap

Build from an alternative branch

Set the alces_SOURCE_BRANCH variable with the name of the branch you wish to build. Defaults to master. e.g.:

export alces_SOURCE_BRANCH=0.1.0
curl -sL http://git.io/metalware-installer | /bin/bash