Toolkit Installation Quick StartΒΆ

These instructions are for the full Toolkit installation. For other perfSONAR installation options, see perfSONAR Installation Options.

  1. Download the NetInstall ISO from here

    See also

    The NetInstall is the recommended installation type, but for more information on other installation types see Getting the Software.

  2. Using your favorite software, burn the image to a CD, DVD or USB drive and insert the chosen installation media into your host.


    Linux and Macintosh users may consider using the dd tool: sudo dd if=/PATH/TO/FILE.iso of=/dev/DISK

  3. Follow the prompts provided by the CentOS installer to install the required packages. If you have installed a Linux operating system before, these prompts should be relatively self-explanatory.

    See also

    For a complete walkthrough of these prompts see Toolkit NetInstall Guide

  4. Once the installation completes and the host reboots, login from the console using the root password you created during the previous step

  5. You will be prompted to create a user and password that can be used to administer the host through the web interface. Follow the prompts to complete this step.
  6. Open http://<hostname> in a web browser where <hostname> is the name or address of your host

  7. Click on Edit (A) in the host information section of the main page or Configuration (B) button in the right-upper corner and login as the web administrator user created in the previous step

  8. On the page that loads, enter the requested information in the provided fields. Click Save when you are done.


    See also

    For more information on updating administrative information see Updating Administrative Information

  9. You are now ready to add some regular tests. Click on Configure tests in main page.

  10. On the page that loads click on the +Test button too choose and add the test type you would like.

  11. A drop-down list shows to choose test type. Click on a selected test type you would like to add.

  12. You will now be prompted for test parameters. Enter a human-readable description of the tests and change any parameters you desire. In general the defaults will be fine for most cases.

  13. You now need to select other test members to test against. Go to section Test members in the same page.

  14. You may add test members explicitly adding a host (A) or selecting browse communities and browsing the list (B). When you are done entering host details, hit Add host to add a test member to the list of hosts.

  15. Click OK to save test definition and close test configuration window. Then click the Save button at the bottom of the screen to apply your changes.

    See also

    For more information on adding regular tests see Configuring Regular Tests

  16. After some time you may view the results of your tests in section Test Results in the main page.



    It will take time for data to be collected and display on the graphs. For throughput data this may be several hours depending on the test interval. For all other test types, you should see data within 30 minutes.

    See also

    For more information on using the graphs Test Results Graphs