-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathGettingStartedMac.html
More file actions
150 lines (133 loc) · 12.7 KB
/
GettingStartedMac.html
File metadata and controls
150 lines (133 loc) · 12.7 KB
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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
<!DOCTYPE html>
<html lang="en">
<head>
<title>Getting started!</title>
<link rel='stylesheet' style='text/css' href='css/skeleton.css' media='screen'/>
<link rel='stylesheet' style='text/css' href='css/skeleton.css' media='print'/>
<script src='js/jquery.js'></script>
<script src='js/main.js'></script>
</head>
<body>
<div class="container">
<center>
<main>
<div id='header'>
<div id='header_info'>
<h1 id='logo_cyber'>Cyberpaths</h1>
</div>
</div>
<div id='site_body'>
<div id='actual_content'>
<div id ='main_title'><h5>- Getting started! -</h5></div><br>
</center>
<br><div class='title_bg'><h3>Creating an Account</h3></div><hr>
<div class='subcontent'>
<ol class='instructions'>
<li>Go to <a href='https://portal.geni.net/' target='_blank'>https://portal.geni.net/</a> and click on the orange button that says "Use GENI"</li>
<li>On this page click the link located on the bottom of the page that says "Request a login here"</li>
<li>Fill out the form that will be shown in that page with all the proper information and submit it</li>
<li>Keep an eye on your email as the team at GENI will be emailing you when your account is ready for use</li>
</ol>
</div>
<br><div class='title_bg'><h3>Logging into GENI</h3></div><hr>
<div class='subcontent'>
<ol class='instructions'>
<li>Go to <a href='https://portal.geni.net'>https://portal.geni.net</a> and click on the orange button that says "Use GENI"</li>
<li>On this page select "National Center for Supercomputing Applications" for the orginization's name<br><br><center><img class="u-max-full-width" alt="Screenshot" src='img/screenshots/NCSAScreenShot.png'></center><br></li>
<li>Now write down your account details and log in</li>
</ol>
</div>
<br><div class='title_bg'><h3>Joining a Project</h3></div><hr>
<div class='subcontent'>
<ol class='instructions'>
<li>Once logged in, hover on the "Home" button at the top of the page and click on "Projects". Next, click the blue button that says "Join a Project".<br><center><table><tr><td><img class="u-max-full-width" alt="Screenshot" src='img/screenshots/Screenshot_62.png'></td><td><img class="u-max-full-width" alt="Screenshot" src='img/screenshots/Screenshot_63.png'></td></table></center></li>
<li>On this page write down your Instructor's name. When you find your class's project, click on the "Join" button.</li>
<li>You must now wait until your instructor approves the request to join the project</li>
</ol>
</div>
<br><div class='title_bg'><h3>Getting SSH Keys</h3></div><hr>
<div class='subcontent'>
<ol class='instructions'>
<li>On the GENI website on your first internet tab, the top corner of this page should have your name. Hover over your name and then select "SSH Keys".<br><br><center><img class="u-max-full-width" alt="Screenshot" src='img/screenshots/Screenshot_65.png'></center><br></li>
<li>Click the blue button that says, "generate and download an SSH keypair"</li>
<li>Follow the directions on the page and enter in a passphrase <b style='color:red;'>It is very important to remember this passphrase!</b></li>
<li>Next, click the blue button that reads "Generate SSH private key"</li>
<li>Click the button near the top of the window that reads "Download private key".</li>
<li>Lastly, you are going to store the private key in the directory<code>~/.ssh/</code>. In addition you are going to change the permissions of the key. This is done by executing the following commands in a terminal:</li><br><br>
<pre><code>mkdir ~/.ssh<br>mv ~/Downloads/id_geni_ssh_rsa ~/.ssh/<br>chmod 0600 ~/.ssh/id_geni_ssh_rsa</code></pre>
<center><img class="u-max-full-width" alt="Screenshot" src='img/screenshots/Screenshot_89.png'></center>
</ol>
</div>
<br><div class='title_bg'><h3>Hello GENI Experiment - Reserving Resources</h3></div><hr>
<div class='subcontent'>
<ol class='instructions'>
<li>At the portal home page click the <b>New slice</b> button <br><br><center><img class="u-max-full-width" alt='Screenshot' src='img/screenshots/newSliceScreenShot.png'></center><br></li>
<li>Name the slice something like <code><b>[yourLastName]HelloWorld</b></code>.</li>
<li>Next click the <b>Add Resources</b> button near the top of the page.</li>
<li>In the Choose Rspec section, select the existing <b>Hello GENI</b> option. The follwing topology should appear on the screen. <br><br><center><img class="u-max-full-width" alt='Screenshot' src='img/screenshots/helloGeniRspecScreenShot.png'></center><br></li>
<li>Click on the Site node and choose any aggregate with <i>InstaGeni</i> or <i>ExoGENI</i>. <br><br><center><img class="u-max-full-width" alt='Screenshot' src='img/screenshots/aggregatesScreenShot.png'><br></center></li>
<li> Finally, click the Reserve Resource button at the bottom of the page.</li>
</ol>
</div>
<br><div class='title_bg'><h3>Hello GENI Experiment - SSH to the Server Node</h3></div><hr>
<div class='subcontent'>
<ol class='instructions'>
<li>After you send the request to reserve the resources on the previous step, on the top of the pages hover your mouse over "Home" and select "Slices". On this page click on the slice that you created.</li>
<li>If the two boxes look Grey, it means that they are not ready yet. If they are green, it means that they have been reserved successfully and that you may now use them.<br><br><center><img class="u-max-full-width" alt="Screenshot" src='img/screenshots/Screenshot_67.png'></center><br></li>
<li>Now on GENI, on the page of your topology click on the "Details" button.<br><br>
<br><br><center> <img class="u-max-full-width" alt="Screenshot" src='img/screenshots/Screenshot_90.png'></center><br></li>
<li>Now for any one of your nodes you will copy the <code><b style='color:red;'>username</b>@<b style='color:blue;'>host_address</b> -p <b style='color:purple;'>some_port</b></code><br><br>
<br><br><center> <img class="u-max-full-width" alt="Screenshot" src='img/screenshots/Screenshot_91.png'></center><br></li>
<li>Execute the command <code>ssh -i ~/.ssh/id_geni_ssh_rsa <b style='color:red;'>username</b>@<b style='color:blue;'>host_address</b> -p <b style='color:purple;'>some_port</b></code></li>
<li>If you are asked if you want to continue, say <code><b>yes</b></code>. If prompted for a passphrase, enter the passphrase from when you generated the SSH key pairs. (It is important to note that as you write your passphrase it will not be displayed in the terminal!)<br><br>
<br><br><center> <img class="u-max-full-width" alt="Screenshot" src='img/screenshots/Screenshot_92.png'></center></li>
</ol>
<ul><ul>
<li>Now the key will be configured for your SSH connections to that one GENI rack (In my case Cornell, yours might be different depending on the site you chose), so later on to connect to your nodes, you will <b style='color:red;'>only</b> have to go to the "Details" page of the slice, like you did earlier, and then click on the SSH hyperlink for the node you want to connect to, you might have a pop-up asking you if you want to allow the web browser to use an application, Allow it, and you should be connected to your node.</li>
<li>For example, if I wanted to connect to my server node, I would just make a click on the "Details" page, like so:<br><br>
<center> <img class="u-max-full-width" alt="Screenshot" src='img/screenshots/Screenshot_93.png'></center><br></li>
<li><b style='color:red;font-size:25;'> *** </b><b>Although the screenshots for the rest of the tutorial show a black terminal, which is the SSH terminal used in Windows, the commands executed in these are the <b style='color:red;'>same</b> for MAC</b><b style='color:red;font-size:25;'> *** </b></li>
</ul></ul>
</div>
<br><div class="title_bg"><h3>Hello GENI Experiment - Continued</h3></div><hr>
<div class="subcontent">
<ol class="instructions">
<li>On your Server terminal, type in the following command: <b><code>ifconfig</code></b></li>
<li>Now, you should be able to see information corresponding to your Server node. Specifically, you should see information about "eth0", "eth1", and "lo".<br><center><img class="u-max-full-width" src="img/screenshots/Screenshot_73.png"></center><br></li>
<li>To the right of "eth0", you can notice that it says "inet addr" - the numbers right next to that make up the IP address of your node. Try copying and pasting this into your browser of preference, and click on "Web Server Statistics" to see the statistics corresponding to the web server on your node.<br><center><img class="u-max-full-width" src="img/screenshots/Screenshot_74.png"></center><br></li>
<li>Refreshing the page multiple times will yield different statistical information on the page. Refresh the page multiple times, and take note of these changes. These changes occur because you are requesting information every time you click the refresh button.</li>
<li>Next, hit the back button on your web browser. This time, click on the second link, which reads "Logs from the iperf Server". This shows statistical information from the iperf server.</li>
</ol>
</div>
<br><div class="title_bg"><h3>Hello GENI Experiment - Generating Traffic Between Nodes</h3></div><hr>
<div class="subcontent">
<ol class="instructions">
<li>To generate traffic, you will have to open a connection to the Client node. You can do so by following the same instructions you used to connect to the Server node; the only difference is that you will have to click the Client node on GENI, as opposed to the Server node, when trying to find out the host name and port.</li>
<li>After you connect successfully, your terminal for the Client should look similar to this:<br><center><img class="u-max-full-width" src="img/screenshots/Screenshot_75.png"></center><br></li>
<li>To start generating traffic between the Client and Server, execute the following command on the terminal of the Client: <b><code>iperf -c server -P 2</code></b></li>
<li>Try using the same command again, switching out the number <b style="color:red;">2</b> for another positive number (Don't make it too big!). You should notice different results on the output.</li>
</ol>
</div>
<br><div class="title_bg"><h3>Hello GENI Experiment - Finishing Up</h3></div><hr>
<div class="subcontent">
<ol class="instructions">
<li>On your Server terminal, type "exit", and hit enter in order to exit out of the Server node.</li>
<li>Do the same on the Client: type "exit" and hit enter to exit the Client node.</li>
<li>Lastly, looking at the webpage for your slice in the GENI Portal, click the "Delete" button, and click "Yes" on the pop-up. This will make the resources you reserved available again for other users.</li>
</ol>
</div>
<br><div class="title_bg"><h3>Related Readings and Videos</h3></div><hr>
<div class="subcontent">
<ol class="instructions">
<li>SSH Private Keys: <a href="https://www.youtube.com/watch?v=svRWcx7dT8g" target="_blank">Link</a>.</li>
<li>Network Switch: <a href="https://www.youtube.com/watch?v=Ofjsh_E4HFY" target="_blank">Link</a>.</li>
<li>WinSCP Installation and Usage Guide: <a href="https://www.wireshark.org/download.html" target="_blank">Link</a>.</li>
<li>Wireshark Installation and Usage Guide: <a href="https://winscp.net/eng/docs/guide_install" target="_blank">Link</a>.</li>
</ol>
</div>
</div>
</div>
</div>
</main>
</body>
</html>