Configuring the Toolkit for the First Time

After installing the perfSONAR Toolkit, there are a few additional steps to be taken before you can begin using your new measurement host. Follow the sections on this page in order to complete the initial configuration and being performing network measurements with your perfSONAR Toolkit.

Your First Login

The first time you login to your Toolkit you will be prompted to create a user that can perform administrative actions via the web interface.

Note

Versions prior to version 3.4 would allow the root user to login to the web interface. This was changed in version 3.4 for security purposes hence the required prompt.

Follow the prompts to complete the process as shown below:

  1. Login with username root and the password you created during the installation process. You will get a prompt to create a new user:

    _images/install_config_first_time-user1.png
  2. At the prompt enter the username you’d like to create.

    Note

    The names psadmin and perfsonar are not allowed as they conflict with existing users and/or groups on the system.

    _images/install_config_first_time-user2.png
  3. You will be prompted if you would like to user to be able to login via SSH. If this user will only be used to access the web interface, you may answer no. The default is to answer no.

    _images/install_config_first_time-user3.png
  4. You will be prompted to give the user a password and then to confirm it. Remember this password as it will be used to log-in to the web interface to perform administrative functions. Normal precautions should be taken to protect the root password as it can be used to make changes to the system. For example, safe password practices would recommend a password that contains a mixture of letters of different case, numbers, symbols, and a length greater than 8. It is also not recommend to re-use passwords on multiple machines, in the event of a system breach.

    _images/install_config_first_time-user4.png
  5. After entering your password the account is created

    _images/install_config_first_time-user5.png

See also

For more information on adding and managing users see Managing Users

Accessing the Web Interface

You may access the web interface by typing http://<hostname> in your web browser.

Note

For best results it is recommended a browser other than Internet Explorer is used due to some javascript incompatibilities. All other major browsers have been shown to display the web interface without error.

You will be presented with a page like the following:

_images/install_config_first_time-web1.png

Updating Your Administrative Information

You may notice on the left-side of the web interface that Administrative Info is highlighted in yellow. This is to highlight that this information needs to be populated. You will be prompted for basic location and contact information. This information is needed so other perfSONAR users can more accurately find your node. To populate the information do the following:

  1. Open http://<hostname> in a web browser where <hostname> is the name or address of your host

  2. Click on Administrative Info in the left menu and login as the user created in the previous step

    _images/install_quick_start-admininfo.png
  3. On the page that loads, click the Edit button (1) and enter the requested information in the provided fields. Click OK (2) and then Save (3) when you are done.

    _images/install_quick_start-admininfo2.png

    See also

    For more information on updating administrative information see Updating Administrative Information

After completing this step, you should be able to access the Global Services page and see your host listed within 24 hours of making the change.

Managing Toolkit Security

perfSONAR hosts are just like any other host and need to be actively managed to avoid being compromised. perfSONAR hosts run a number of common services, listen on numerous ports and may be outside you site’s normal firewall. No set of steps will make your host invincible, but below are some steps that can be taken to contribute toward protecting your host:

  • An important aspect of security is to stay informed. Multiple system administrators from your site should be subscribed to the perfsonar security announcement list. This mailing list keeps users up-to-date on actions that need to be taken when critical security updates for both perfSONAR and third-party packages are released.

  • Always follow best common security practices when it comes to creating user accounts and choosing passwords. Normal precautions should be taken to protect the root password as it can be used to make changes to the system. For example, safe password practices would recommend a password that contains a mixture of letters of different case, numbers, symbols, and a length greater than 8. It is also not recommend to re-use passwords on multiple machines, in the event of a system breach.

  • If you have enabled SSH on the system, consider restricting access to specific subnets to the SSH port via IPTables, or implement a jump host that allows only logins from one location.

  • Consider configuring rsyslog to send logs to other locations for aggregation and analysis

  • If email has been enabled on the host, forward email from root to a central location

  • If applicable, use a management network on a spare networking interface to further restrict the access profile for users and system data.

  • If your site uses any form of automated management (CFEngine, Puppet, Forman, etc.), integrate the perfSONAR node into this procedure. See this resource for more information.

  • If you run Nagios, add your perfSONAR host to your monitoring infrastructure. Consider running some of the nagios security plugins such as check_yum

  • Automatic updates are enabled by default on all perfSONAR Toolkit hosts. In order to understand how to update your Toolkit and if automatic updates are right for your system, see Updating the Toolkit

    Note

    Automatic updates were enabled starting in perfSONAR Toolkit version 3.4. If you are running an older version then automatic updates are not enabled.

  • The perfSONAR Toolkit ships with a default iptables rule-set and intrusion detection system (IDS) software. In order to learn more about these components and how to do things like add custom firewall rules see Firewalls and Security Software

Those are just a few steps and there is always more than can be done. If you have access to system administrators leverage that resource and any other available. A little extra effort can prevent serious headaches later if your host falls victim to an attack.

Scheduling Regular Measurements

You will now want to schedule some tests that run on regular time intervals. There are two commonly used ways to add these tests and you may take one or both of these approaches depending on your needs:
  1. Configure your tests via the web interface - This approach can be used if you have a small number of perfSONAR nodes running a small number of tests. You will use the web interface to find and define tests. See Configuring Regular Tests.
  2. Participate in a centrally managed mesh - This approach is best if you manage a large number of hosts or are participating in a large community of organizations running measurements. This requires updating a configuration file to point at a centrally managed file. See Reading a Central Configuration File for more details.

What next?

You should now have a fully configured host regularly collecting data. A few things you may consider exploring: