Support

Support Options

Submit a Support Ticket

HomeDocumentation1.1.0System AdministratorsInstallation

Documentation

Installation

What is HUBzero?

HUBzero is a platform used to create dynamic web sites for scientific research and educational activities. With HUBzero, you can easily publish your research software and related educational materials on the web. Powerful middleware serves up interactive simulation and modeling tools via your web browser. These tools can connect you with rendering farms and powerful Grid computing resources.

Minimum System Requirements

HUBzero installations require one or more dedicated physical hosts running Debian GNU/Linux 6.0. In particular there are version specific requirements on mysql (5.1), python (2.6) and php (5.3).

Other distributions might theoretically work with some modification, although they would be totally unsupported.

A typical starter HUBzero installation might consist of a single physical server with dual 64-bit quad-core CPUs, 16 Gigabytes of RAM and a terabyte of disk.

It is possible to run HUBzero inside of a virtual machine such as ones created by VMware and VirtualBox. While fully functional there will would significant performance and resource limitations in such an environment. For demonstration or development purposes we often create VM images with less than a gigabyte of RAM and 5 gigabytes of disk. While fully functional, these virtual machines would only be suitable for a single user doing development or testing.

Target Audience

This document and the installation and maintenance of a HUBzero system has a target audience of experienced Linux administrators (preferably experienced with Debian GNU/Linux).

How To Get Source Code

This is optional

You'll find most of the source code within the web root of a working hub. But you can get source code for the middleware and all other parts of HUBzero by retrieving the source code packages using the debian package manager. To do so, first, update your package mechanism to pull packages from our HUBzero repository (codename 'manny' for this release). Edit your /etc/apt/sources.list and add the following line::

deb-src http://packages.hubzero.org/deb manny main contrib non-free

Then, install the hubzero archive key so that your system can verify packages from the hubzero archive. Run the following command as root:

wget http://packages.hubzero.org/deb/hubzero-signing-key.asc -q -O - | apt-key add -

Once the public key for http://packages.hubzero.org has been installed, you can request the hubzero source code for each package:

apt-get source packageName

where packageName is the desired package from the table below.

Package List

The following packages (subject to change): are available from the HUBzero repository for this release. Not all are necessarily used for any given installation.

Package Name Purpose
hubzero-appCommand line tool to manage installation/publishing of HUBzero apps
hubzero-app-workspaceHUBzero App providing a lightweigth Linux desktop, for app/tool development
hubzero-chuseHUBzero graphical front end to the user environment manager 'use'
hubzero-cliHUBzero command line interface
hubzero-cmsThe HUBzero Content Management System (based on Joomla! framework)
hubzero-expire-sessionsExpires unused app/tool sessions
hubzero-filexferTransfer files between App Sessions and user's desktop
hubzero-filexfer-xlateSupport daemon for the filexfer program
hubzero-firewallHUBzero firewall that protects app/tool sessions
hubzero-forgeCreates project areas for tool development
hubzero-icewmLinux ICE window manager configuration, used in workspaces
hubzero-icewm-captiveLinux ICE window manager specially crafted to support tools in a sessions
hubzero-icewm-themesThe HUBzero Linux ICE window manager theme, used in workspaces
hubzero-invokeappHUBzero application invoke script
hubzero-mailgatewayHUBzero mail gateway
hubzero-metricsHUBzero metrics support package
hubzero-mw-clientHUBzero middleware - client
hubzero-mw-serviceHUBzero middleware - execution host session manager
hubzero-mw-sessionHUBzero middleware - per session tools
hubzero-openldapOpenLDAP configuration package for HUBzero
hubzero-policyrcdHUBzero policy-rc.d for invoke-rc.d
hubzero-pythonHUBzero python API module
hubzero-rapptureThe Rapid APPlication infrastrucTURE toolkit for building scientific tools
hubzero-rappture-sessionSession support packages for Rappture
hubzero-ratpoison-captiveLinux window manager, used in app/tool sessions
hubzero-submit-clientHUBzero submit client
hubzero-submit-commonHUBzero submit common python library
hubzero-submit-condorHUBzero condor build for hubzero-submit
hubzero-submit-distributorHUBzero middleware submit distributor
hubzero-submit-pegasusHUBzero pegasus build for hubzero-submit
hubzero-submit-serverHUBzero job submission server
hubzero-subversionHUBzero Subversion support package
hubzero-telequotadDisk quota monitor
hubzero-textifierHUBzero textifier
hubzero-texvcHelper utility to generate math fomulas for wiki markup
hubzero-tracHUBzero Trac support package
hubzero-trac-mysqlauthzPlug-in for MySQL user auth in project development areas
hubzero-twm-captiveLinux TWM window manager, used in app/tool sessions
hubzero-useCommand for configuring the environment within a workspace
hubzero-use-appsHUBzero apps environment for 'use'
hubzero-usermapFile permission mapping FUSE filesystem used by WebDAV
hubzero-vncproxyHUBzero VNC proxy helper
hubzero-vncproxydHUBzero VNC proxyserver
hubzero-webdavHUBzero WebDAV support package
libapache2-vncproxyHUBzero vncproxy module for apache2-mpm-prefork
tightvnc-javaModified VNC Client that receives app/tool sessions within a web browser
vnc4serverModified VNC Server that sends app/tool sessions to the web browser

Copyright 2014 HUBzero Foundation, LLC. HUBzero® is a registered trademark of the HUBzero Foundation, LLC.