Internet Delay Measurements using Test Traffic Installing and hosting a Test Box Henk Uijterwaal RIPE NCC November 12, 1997 Document: RIPE-168 Abstract: In RIPE-158, we presented a proposal to do Internet performance measurements using test traffic generated by test-boxes. This document is intended for ISP's interested in hosting a test-box. It describes the requirements for hosting a test-box at an ISP. It also describes the installation and day-to-day management of such a test-box. After reading this document, one should be able to judge if one can successfully host a test-box at a site. This document is not a formal request asking which sites are interested in hosting a test-box. 1 Introduction In a previous document [1], we described a proposal to do Internet performance measurements using test traffic. The test traffic used in this project is generated by test-boxes installed at the ISP's participating in this project. This document lists the requirements that have to be met before one can host a test-box. It also gives details about installation and day-to-day operation of the test-box. This document is intended to solicit input from interested parties. It should provide all information that one might have to know before installing a test-box. If you think that our requirements are unreasonable or impractical, do not hesitate to contact us. A formal request asking for sites interested in hosting a test-box will be sent around later this year (1997). 2 Requirements for hosting a Test Box This section discusses the requirements for hosting a test-box. Please read this section and make sure that you can meet all requirements, before applying to host a test-box. An application sheet will be found online (http://www.ripe.net/test-traffic/host_testbox.html) when we start to accept requests for hosting test-boxes. If you cannot meet all requirements or want to discuss your specific situation before applying to host a test-box, do not hesitate to contact us. 2.1 Rack space The RIPE-NCC test-boxes consists of 19" wide crate. The crate is 4u (approximately 20cm) high. It is recommended to mount the crate in a standard 19" rack in a computer room or the like, though the crate can be located anywhere where one would consider installing a networked PC. However, one has to keep in mind that the test-boxes have to be connected to an external antenna, see section 2.2. The operating system of the machine is FreeBSD. The security issues related to the installation of a test-box will be discussed in a separate document [2]. The test-box has to be connected to a 110 or 220V power supply and the local network using 10base-T Ethernet. We will supply a 220V power cable with a plug for a standard European, grounded, 220V socket. In some places (the UK, for example) you may have to replace this plug with one that fits into your sockets. 2.2 Antenna The test-boxes have to be connected to a GPS antenna. The antenna has to be mounted outside, with a clear view of of about half the sky (see figure 1). If there are local obstructions, try to find a location such that the antenna has a clear view to the south. We will support two mounting options (see figure 2): * A magnetic mount antenna. (default choice). * An antenna with a post-mounting bracket. Figure 2 shows two other mounting options. However, support from the manufacturer (Motorola) for these option is or will be discontinued soon. We will therefore not offer these options for our test-boxes. Motorola will also replace its line of antennas with new models soon. These antennas will be slightly smaller, but the mounting options will be the same. The antenna has to be mounted (roughly) horizontally. The maximum cable length to the antenna is about 50m. For calibration purposes, the length of the antenna cable has to be known. Therefore, before installing any antenna cables, measure their length. Figure 1: Placing the antenna on a building. The best choice is somewhere in the dark grey area, the second choice is somewhere in the light grey area. The white area is a third choice. Figure 2: Mounting options for the GPS antenna. We will support the magnetic mount and post-mounting options (first and third option from the left). 2.3 Network topology As discussed in a previous document [1], the test-boxes should connected 0 hops away from a border router, or, if that is not feasible, as close to the border router as possible. On the information sheet, please provide a short description or drawing of your local network situation. In the same document, we discussed also discussed the case where an ISP has more border routers. If this applies to you, please provide a list of possible locations. We will then discuss the preferred location of the test-box with you, taking into account the location and connectivity to test-boxes at other ISP's. 2.4 Local Contact Although we plan to control the test-boxes from a central point with no operators or service required at the local sites, we do expect that each site that hosts a test-box appoints a local contact. This contact should take care of things that cannot be done remotely, such as rebooting the machine or copy information from the console in case of network or hardware problems. The local contact, obviously, has to be reachable by phone or email. In an ideal situation, the contact would be reachable 24 hours a day, 7 days a week (``24/7'') and could take care of our email's and phone-calls immediately. This could be the case at, for example, a place with operators around on a 24/7 basis. However, we do not think that there are many places where this ideal situation will exist. The minimum requirement for the local contact would be that he is reachable during office hours (9am-5pm, Monday to Friday, except for public holidays), is able to respond to our requests within a day and can appoint a replacement during holidays and the like. In the latter case, if a test-box causes trouble outside the hours where the local contact is reachable, it will removed from the measurement network until the problems can be solved. There several possible intermediate steps between the minimum requirements and the ideal situation possible. In general, the shorter the time between a request from our side and an action from the local contact, will increase fraction of time that the measurement network is active (``duty-cycle''). The higher the duty-cycle, the more that can be derived from the data. 2.5 Console The test-boxes do not have a console. They will be delivered with the correct IP and Gateway numbers pre-configured and, when powered up, automatically connect to the network assuming that real configuration is the same as the one described on the information sheet. For normal operation, the test-boxes do not need a console. However, it would be useful if the host site can provide a standard PC monitor and keyboard that can be connected to the test-box for trouble shooting. That way, it might be possible to solve problems while the test-box is at your site. If no console is available, then the only solution will be to send the test-box back for repair. 2.6 DNS Issues The test-boxes will be called: ttXYZU.tt.ripe.net where XYZU is a number ranging from 0001 to 9999. The hosting organization should provide an IP number for this test-box. The mapping of names to IP numbers will be set up in the the RIPE name server. The host should set up the in-addr mapping shortly after the domain name is known. In order to configure the test-boxes, the host should also provide the IP address of at least one topologically nearby resolving name-server. 2.7 Routing Issues The test-boxes are set up to listen to the RIP and IRDP protocols. If those protocols are not available on the local net, then the address of a static gateway should be provided. 2.8 Disclosure of data In section 4.1 of [1], we discussed the disclosure of data. When a site agrees to host a test-box, this site also agrees to the disclosure of data policy as described there. The sites hosting the test-boxes will get access to the data at the level of a ``Participating ISP''. The format and the exact contents of the data that will be made available is still under discussion. 2.9 Form If you meet all the requirements, please let us know by filling out the application sheet. This sheet can be found online at: http://www.ripe.net/test-traffic/host_testbox.html. Again, if you cannot meet all requirements or want to discuss your specific situation first, please do not hesitate to contact us. 3 First installation Figure 3: A test-box. This section describes the first installation of a test-box. Figure 3 shows a drawing of a test-box that should help you to locate the various connectors on the test-box. The connectors will be labelled. 3.1 Installation When the test-box arrives check it for obvious shipment damage before mounting it into a rack. If the test-box has been damaged, notify the delivery company as well as the RIPE-NCC. Depending on the nature of the problem, we will then decide how to proceed. Do not switch on a damaged test-box. The antenna has to be mounted outside. Details depend on the mounting option selected. The antenna cable can be extended using standard coaxial cable and BNC plugs up to 50m. However, for calibration purposes, we have to know the length of the antenna cable with an accuracy of about 1m, so please measure the length of the cables before installing them. The antenna cable has to be connected to the BNC plug on the back of the crate (figure 3). Then connect the test-box to Ethernet using the RJ-45 connector on the back. If your site uses BNC connectors for the local Ethernet, get an adapter. Do not use the BNC connector on the back to connect the box to the local Ethernet, this may seriously damage your routers as well as the test-box. Finally, connect the test-box to 110 or 220V. The power-supply will recognize the voltage automatically. A power cord is included, you may, however, have to replace the plug. Now switch on the test-box. A console monitor can optionally be attached to the test-box to monitor the boot process but this is not necessary. The test-box will boot automatically. When the test-box is running (approximately 3 minutes after it has been switched on, or when a login prompt appears on the screen), check if it is visible from your local network by pinging it at the pre-configured address. After that, confirm the installation by sending email to tt-ops@ripe.net. Please put the length of the antenna cable in this email. The front panel of the test-box can be locked. After you have powered up the test-box, we suggest that you lock the front panel, remove the key from the lock and put the key in a safe place away from the test-box. This will make it harder, though by no means impossible, to tamper with the test-box. 3.2 Configuring the test-box There is no need for the local contact to configure the test-box, as the test-box will be pre-configured at the RIPE-NCC before it is sent to you. Also, system maintenance and further configuration will be done from the RIPE-NCC. 3.3 Troubleshooting We will, as we get more experience with the installation of our test-boxes, put a list with questions and problems, as well as their solution, related to the installation of test-boxes on our web page. 4 Day to day management 4.1 Security There are several security related issues involved in day to day management. These are discussed elsewhere [2]. We assume that the local contact has read and will follow (the spirit of) this document. 4.2 Reboots First of all, do not reboot the test-box unless you are asked to do so by the RIPE-NCC. The test-box can be rebooted by pressing the reset button. The reboot process will take a couple of minutes and can optionally be monitored by attaching a console monitor. The test-box is running again when the login prompt appears or when the box can be ping-ed from another machine. 4.3 Moving test-boxes, power outages If a test-box has to have its IP or gateway numbers changed, please provide us with the new numbers and the day that they become effective as soon as possible but at least a week in advance. We will then reconfigure the test-box remotely, shut it down and let you know when it can be moved. After the test-box has been moved, follow the procedures for first installation. If a power outage is planned at your site, please notify us a couple of days in advance. We will then do an orderly shutdown of the test-box shortly before the power outage. After the power is switched back on, the test-box can be booted as usual. 4.4 Operating system upgrades If we decide to upgrade the operating system, we will download and install the new kernel. After that, we will ask to local contact to optionally monitor the console and be standby while we are rebooting the machine. 5 Hardware problems In the first instance, test-boxes with hardware problems have to be dismounted and sent back to the RIPE-NCC for repair. Unless the problem is related to the GPS receiver, the antenna does not have to be dismounted. As we get more experience with our test-boxes, we might provide instructions to the local contacts for doing small repairs. References 1 H. Uijterwaal, O. Kolkman, ``Internet Delay Measurements using Test-Traffic, Design Note'', RIPE-158. 2 O. Kolkman, ``Internet Delay Measurements using Test-Traffic, Security Document'', in preparation. ---------------------------------------------------------------------------- Henk Uijterwaal, Wed Nov 12 14:30:36 MET 1997