website2017/contribute.php at master · ixmaps/website2017 · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>Contribute | IXmaps</title>
    <?php include '_includes/global-head.php'; ?>
</head>

<body id="contribute-page">
<?php include '_includes/global-navigation.php'; ?>

<header class="hero">
    <div class="content">
        <h1>Contribute</h1>
    </div>
</header>

<div class="content">

<article>
    <h4 style="background-color: lightyellow; padding: 15px;">Our IXmapsClient contribution tool is experiencing some issues at the moment. You may not be able to successfully submit new routes until these issues are resolved. Thank you for your understanding.
    <br/><br/>
    In the meantime, you might want to check out the <a href="https://d3i5ru2umva58b.cloudfront.net/" class"link" target="blank">Canadian Traceroute Database (CTRD)</a> being developed by <a href="https://www.cira.ca/" class="link" target="blank">CIRA</a> based on IXmaps.</h4>

    <h2>Contributing to the IXmaps database anonymously</h2>
    <p>IXmaps relies on voluntary contributions of anonymized traceroute data. We invite you to join over 1000 other contributors who have helped to grow the database to well over 500,000 traceroutes. The more distinct the originating points, in terms of both city and ISP, and the more varied the destination targets, the better able we are to display interesting internet routings.</p>

    <p>Contributing data involves installing traceroute generating software built by the IXmaps development team. It initiates traceroute requests from your location either at batches of pre-selected target sites, or at individual hostnames (like URLs) of your choosing. You can view the traceroutes you and others have contributed via the <a href="map.php" class="link">Map page.</a></p>

    <p>To ensure the anonymity of contributors, we do not store the IP address of your personal device, but only a truncated version, with the last quad zeroed out. eg. 127.123.123.0. To verify this and any other features of this software, check out our free and open source code on <a href="https://github.com/ixmaps/IXmapsClient">GitHub</a>.</p>

    <p>You should be aware that in order to work effectively, the traceroute generation software needs access to low-level (e.g. "socket layer") functions of your computer. Read carefully the ReadMe document that comes with the download package before installing and running the software. See our Privacy page, for more on how we anonymize your IP address and protect your privacy.</p>

    <h3>Update</h3>
    <p>As of August 30th, 2020, IXmapsClient version 1.0.6 will no longer function correctly. Please download IXmapsClient 1.1.1 to continue to contribute to this project.</p>

    <h3>Installing and running the IXmaps Client</h3>

    <p>IXmapsClient works on <strong>Windows</strong>, <strong>Mac OS X</strong>, and <strong>Linux</strong>.</p>

        <h5>Windows</h5><a class="dl-btn" href="https://www.ixmaps.ca/IXmapsClient/IXmapsClient.1.1.1.win64.exe">Download</a>
        <div style="clear:both"></div>
        This version of the software runs on Windows 10.
        <ul class="nobullet">
          <li><a href="https://www.ixmaps.ca/IXmapsClient/IXmapsClient.1.1.1.win64.exe">Download the <strong>IXmapsClient</strong> installer IXmapsClient.1.1.1.win64.exe</a></li>
          <li>Double click on <strong>IXmapsClient.1.1.1.win64.exe</strong> and install the application in the directory <strong>C:\IXmapsClient</strong></li>
          <li>Copy the <strong>IXmapsClient-Shortcut</strong> to your Desktop</li>
          <li>In order to allow the <strong>IXmapsClient</strong> to run properly, you may need to authorize <strong>Windows Firewall</strong> to allow inbound connections. For a detailed guide on how to change these settings, see the included README file</li>
          <li>Double click on <strong>IXmapsClient-Shortcut</strong> to launch</li>
        </ul>
        <strong>IXmapsClient</strong> needs to be executed in a terminal with administrator's privileges. For this reason, when double clicking <strong>IXmapsClient-Shortcut</strong>, a new terminal window will be opened asking permission to run the application as an administrator; you may need to enter your admin password to proceed. The <strong>IXmapsClient</strong> interface should appear in your browser, or use your browser to go http://localhost:2040/.</p>

        <strong>Removing IXmapsClient</strong>
        <ul class="nobullet">
          <li>Run <strong>C:\IXmapsClient\unins000.exe</strong> to completely remove <strong>IXmapsClient</strong> from your machine</li>
        </ul>

        <br />

        <h5>Mac OSX</h5><a class="dl-btn" href="https://www.ixmaps.ca/IXmapsClient/IXmapsClient.1.1.1.macos.dmg">Download</a>
        <div style="clear:both"></div>
        <ul class="nobullet">
          <li><a href="https://www.ixmaps.ca/IXmapsClient/IXmapsClient.1.1.1.macos.dmg">Download the <strong>IXmapsClient</strong> installer <strong>IXmapsClient.1.1.1.macos.dmg</strong></a></li>
          <li>Double click on the <strong>IXmapsClient.1.1.1.macos.dmg</strong> to open it</li>
          <li>Drag the <strong>IXmapsClient.app</strong> application to your <strong>Applications</strong> folder</li>
          <li>Double click on <strong>IXmapsClient.app</strong> to launch</li>
        </ul>

        <p>IXmapsClient for macOS is not signed with an Apple Developer ID and macOS <a href="https://support.apple.com/HT202491">Gatekeeper security settings</a> will not allow it to be started. To bypass Gatekeeper one time for IXmapsClient, control-click or right-click on the <strong>IXmapsClient.app</strong> icon and choose <strong>Open</strong> from the context menu.</p>

        <p><strong>If you have upgraded to OSX Catalina, you may experience further challenges getting the IXmapsClient to work correctly on your machine. It has been tested on Catalina and is confirmed to work, but you may need to approve multiple libraries in Settings - Security & Privacy. We are working to resolve this issue, please bear with us!</strong></p>

        <p><strong>IXmapsClient</strong> needs to be executed in a terminal with administrator's privileges. For this reason, make sure to use an Administrator user account instead of a Standard user account when running <strong>IXmapsClient</strong>. When double clicking <strong>IXmapsClient.app</strong>, a new terminal window will be opened asking for the administrator's password; you may need to enter your admin password to proceed. The <strong>IXmapsClient</strong> interface should appear in your browser, or use your browser to go to http://localhost:2040/.</p>

        <strong>Removing IXmapsClient</strong>
        <p>Move the <strong>IXmapsClient.app</strong> application from your <strong>Applications</strong> folder to the Trash. Emptying the trash will completely remove the IXmaps Client from your computer</p>

        <br />

        <h5>Linux</h5><a class="dl-btn" href="https://www.ixmaps.ca/IXmapsClient/IXmapsClient.1.1.1.linux.tar.gz">Download</a>
        <div style="clear:both"></div>
        <ul class="nobullet">
          <li><a href="https://www.ixmaps.ca/IXmapsClient/IXmapsClient.1.1.1.linux.tar.gz">Download the <strong>IXmapsClient</strong> installer <strong>IXmapsClient.1.1.1.linux.tar.gz</strong></a></li>
          <li>Extract the contents of the file <strong>IXmapsClient.1.0.6.linux.tar.gz</strong>, e.g. with the Linux Archive Manager or by running the following command in a terminal window: <strong>tar xzvf IXmapsClient.1.1.1.linux.tar.gz</strong></li>
          <li>Run <strong>./start.sh</strong> in the terminal to launch the application</li>
        </ul>
        <p><strong>IXmapsClient</strong> needs to be executed in a terminal with administrator's privileges. For this reason, when executing <strong>IXmapsClient</strong>, a new terminal window will be opened asking for the administrator's password; you may be required to enter your admin password to proceed. The <strong>IXmapsClient</strong> interface should then be shown in a new browser window, or use your browser to go http://localhost:2040/.</p>

        <strong>Removing IXmapsClient</strong>
        <p>Delete the <strong>IXmapsClient</strong> folder. In a Linux terminal window, navigate to the directory where <strong>IXmapsClient</strong> resides, then you run the following command:
        rm -r IXmapsClient
        This will completely remove the <strong>IXmapsClient</strong> from your computer.</p>

    <div class="ui divider"></div>
    <h2>Other welcome contributions</h2>

    <h3>Correcting the location of routers</h3>
    <p>Locating accurately the individual routers that switch data packets along the way to their destination is challenging. You may find when examining traceroutes displayed on the Map page that some routers appear out of place, sometimes even wildly. We invite you to use the Flag option to point these out and suggest more accurate locations for the IP addresses of such routers so we can correct it later. This can be done by clicking on the routers (dots) or hops (lines), and then the appropriate Flag button. Any information you provide about why you think the router location is inaccurate, and where it is more likely to be, is helpful in making corrections. See our FAQ page for more on geolocation.</p>

    <h3>Improving our software</h3>
    <p>While we do our best to ensure that our software operates reliably and safely, and is easy to use, this is not a polished, high-end application, but rather the latest product of a on-going, unevenly funded research project. If you encounter difficulties or see obvious areas for improvement, please be patient and let us know what needs to be improved. Or better, if you have the skills, make the improvements yourself! The code used for gathering traceroutes, as well as the code for the website and various related components, is free and open source, and available from our GitHub repositories.</p>
    <p>We welcome all feedback (critical and appreciative), technical inquiries or offers for assistance regarding IXmaps software, database, or website. Please email the IXmaps team.</p>
    <div class="ui hidden section divider"></div>
</article>

</div>

<?php include '_includes/global-footer.php'; ?>
</body>
</html>