HUBzero - Create Your Own Hub

What’s the HUBbub?

HUBzero® is an open source software platform used to build web sites for scientific research and educational activities. Some refer to such web sites as “collaboratories” supporting “team science.” We call them “hubs” because they become a focal point for user communities. Today, hubs support users in a variety of fields, including nanotechnology, microelectromechanical systems, pharmaceutical engineering, healthcare, volcanology, and biofuels. See examples online...

Create Your Own Hub

This disk contains a 64-bit Virtual Machine (VM) image of a HUBzero server, built on Debian GNU/Linux 6.0, configured and ready to run. This virtual machine image has been prepared for VMware, so in order to run it, you must download and install the following software:


  1. Download and install the VMware Player software.
  2. Copy the folder hubzerovm-1.1.3 from the distribution media to your computer's hard drive.
  3. Start VMware and open the HUBzero virtual machine (hubzerovm-1.1.3.vmx). If VMware asks whether the image was copied, say "yes".
  4. Find the network control panel for VMware and select "host only". The HUBzero virtual machine uses published passwords so it should not be on the internet until those passwords are changed.
  5. Start the HUBzero virtual machine and log into it using the name "root" and the password "hubzero2012". You will find various passwords for the site in /etc/hubzero.secrets. (NOTE: Changing the data in this file will not alter the real passwords.)
  6. Run the command "ifconfig eth0". The second line should report something like "inet addr:" -- record that number. It is the IP address given to the HUBzero virtual machine by the VMware software.
  7. Run the command "nano /etc/hosts" to edit the /etc/hosts file. Replace the IP number for example.com with the IP number recorded in the previous step. Save the changes in the nano editor by pressing Ctrl-O, and then exit by pressing Ctr-X.
  8. Run the command "reboot". Log back into the VM and double check the IP.
  9. Start your web browser and point it at "http://XXX.XXX.XXX.XXX" using the IP number you recorded above in place of the XXX.XXX.XXX.XXX part.
  10. Congratulations! Your new hub is up and running!

Register as a User

  1. On the home page of your hub (http://XXX.XXX.XXX.XXX), press the "Register" button in the upper-right corner. Fill in the information required and press the "Create Account" button.
  2. Normally, an email would be sent to you to confirm your registration, but since this VM is local-only, the confirmation must be done by the administrator. Do this by pointing your web browser at "http://XXX.XXX.XXX.XXX/administrator/" (again replacing XXX... with your IP address). Log in by entering "admin" for the username and "t2W83eITc5" for the password.
  3. Pull down the "Users" menu and select the "Members" menu item. Find the new user and click on it. Scroll down the page and find the "Details" box and press the "Confirm" button in the "Email" section. Then, press the large "Save" button in the upper-right part of the page. Then, click the small "logout" text in the upper-right part of the page.

Using Your New Hub

You have now created and enabled a new user for your hub. Follow the steps below to launch a tool as that user:

  1. Point the web browser back at the hub's home page (http://XXX.XXX.XXX.XXX) and click on "Login". Enter the same username and password that you registered. This will bring up your dashboard page.
  2. Run the workspace tool: Under "My Tools", select the "All Tools" tab and look for the "Workspace" entry. Click on the icon to the right of "Workspace" to launch the tool. Or instead, click directly on the "Workspace" link to visit the workspace tool page, then press the "Launch Tool" button on that page.
  3. As the tool page comes up, you may see a security warning. This is normal since this test machine does not have a security certificate installed, and we're accessing the site directly via its IP address. In this case, it is safe to continue.
  4. You should see the workspace come up with a "Color xterm" window on it. Click on the window and type some commands. Your new user account now has a space to develop tools for your hub. To see how, check out the Guide for Tool Developers
  5. You can customize and configure your hub through the administrative web interface at http://XXX.XXX.XXX.XXX/administrator/. To see how, check out the Guide for Hub Managers. If you need to access the underlying system directly, use sftp to transfer files and ssh to log into the web server machine. These commands are included on Linux and MacOSX systems. If you're running on a Windows machine, use the psftp.exe and putty.exe programs in the "utilities" directory instead.

You are up and running! There's lots more to learn and explore.
Continue at http://hubzero.org/documentation.

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