perfSONAR installation and configration - pragmagrid/pragma

perfSONAR installation

Environment

We recommend that the host for perfSONAR should have at least two network interfaces. One is for the internet connection and management (NATed private network works), the other is for ENT connection. Your perfSONAR host needs to download a central configuration file via the internet. But, ENT is basically an isolated local network. You cannot use ENT to download the central configuration file.

The network interface for ENT should be connected to an OpenFlow switch or Open vSwitch participating to ENT data plane. If you plan to use a VM, use the following configuration in the libvirt XML to connect the virtual interface to an Open vSwitch. br0 and mac address need to be replaced with actual values.

<interface type='bridge'>
  <mac address='xx:xx:xx:xx:xx:xx'/>
  <source bridge='br0'/>
  <virtualport type='openvswitch'/>
</interface>

Ask ENT administrators about the available IP address range for your ENT interface.

Installation

See the document of perfSONAR guide: http://docs.perfsonar.net/install_centos_netinstall.html.

Enable congestion control properly

perfSONAR tries to use htcp as a congestion control method. But, sometimes, it fails to configure the kernel parameter in the booting process. So, execute the following command and see if the parameter is configured properly.

Run the following command and reboot.

# echo "sysctl -p" >> /etc/rc.local

See if the parameter is configured properly after the rebooting.

# sysctl -a | grep tcp_congestion_control
net.ipv4.tcp_congestion_control = htcp

Allow internal address

Since ENT is an internal network, you need to allow internal address to be used by perfSONAR. Set allow_internal_addresses to 1 in /opt/perfsonar_ps/toolkit/web/root/gui/services/etc/web_admin.conf.

allow_internal_addresses  1

Participating in the centrally configured mesh for ENT

Ask ENT administrators to add your host in the central configuration file. Then, follow the instruction below.

Edit '/opt/perfsonar_ps/mesh_config/etc/agent_configuration.conf' and add the following lines.

<mesh>
  configuration_url    https://raw.githubusercontent.com/pragmagrid/pragma_ent/master/resources/perfSONAR/perfSONAR-ent.json
</mesh>

Run the following command.

/opt/perfsonar_ps/mesh_config/bin/generate_configuration

You can see a throughput test configuration added automatically to your host on the perfSONAR Web UI.

perfSONAR installation and configration - pragmagrid/pragma_ent GitHub Wiki