23 | | A. ''Operating System:'' Fedora 8 ''('''Note:''' Input FEDORA8-STD as operating system when you create nodes)'' |
24 | | |
25 | | B. ''Open Ports:'' For !RootBeacon server: MySQL TCP/3306, Graphite TCP/2003 and TCP/17280, Collector TCP/7777, HTTP TCP/17290; For !NodeBeacon server: BWCTL TCP/4823, Nodescheduler TCP/17249, HTTP TCP/17290 |
| 23 | A. ''Operating System:'' Fedora 8 ('''Note:''' Input FEDORA8-STD as operating system when you create nodes) |
| 24 | |
| 25 | B. ''Open Ports:'' For Root Beacon server: MySQL TCP/3306, Graphite TCP/2003 and TCP/17280, Collector TCP/7777, HTTP TCP/17290, Supervisor TCP/17291; For Node Beacon server: Nodescheduler TCP/17249, HTTP TCP/17290, Supervisor TCP/17291 ('''Note:''' These ports are opened by default) |
29 | | D. ''ProtoGENI slice:'' Create a new experimental slice in the [https://www.emulab.net/beginexp_html.php3 Emulab website] with at least 3 nodes. One is the root beacon. The others are node beacons. |
30 | | |
31 | | '''Note 1:''' We suggest to use the ProtoGENI Cooked Mode to create a new slice. You can refer to our [http://groups.geni.net/geni/wiki/ExperienceWithProtoGENI#a4.ExperiencesinCreatingProtoGENISlices Experiences in Creating ProtoGENI Slices]. If you still use the command line Emulab test scripts to create a slice, see the end of this document for the example RSpec. |
32 | | |
33 | | '''Note 2:''' Following are the pre-requisite software and Perl modules, which will be installed automatically by the scripts delivered in the !OnTimeMeasure release package. |
34 | | |
35 | | ''Pre-requisite Software:'' MySQL, Graphite, Perl, Python, Iperf, Ruby, Bwctl-server, Bwctl-client, Cairo, Python_Twisted, Python_Piddle |
| 29 | D. ''ProtoGENI slice:'' Create a new experimental slice in the [https://www.emulab.net/beginexp_html.php3 Emulab website] with at least 3 PCs. |
| 30 | |
| 31 | '''Note 1:''' We suggest to use the ProtoGENI Cooked Mode to create a new slice. You can refer to our [http://groups.geni.net/geni/wiki/ExperienceWithProtoGENI#a4.ExperiencesinCreatingProtoGENISlices Experiences in Creating ProtoGENI Slices]. If you still use the command line Emulab test scripts to create a slice, see the end of this document for an example RSpec. |
| 32 | |
| 33 | '''Note 2:''' Typically, two or more Node Beacons and one Root Beacon need to be installed on separate dedicated PCs in a slice; it is however possible to install Root Beacon on one of the Node Beacon PCs. |
| 34 | |
| 35 | '''Note 3:''' Following are the pre-requisite software and Perl modules, which will be installed automatically by the scripts delivered in the !OnTimeMeasure release package. |
| 36 | |
| 37 | ''Pre-requisite Software:'' Iperf, MySQL, Graphite, Perl, Python, Ruby, Python-setuptools, Supervisor |
51 | | Next, login using SSH to each of the servers, copy the appropriate tar files over, and run the following commands to install the measurement service: |
52 | | |
53 | | |
54 | | __'''''On the Root Beacon Server:'''''__ |
| 61 | Next, login using SSH to each of the PCs, run the following commands to install the measurement service. You will be prompted to set a supervisor account during the Graphite installation, and also will be prompted to set a password of an automatically created database user: ''collector''. |
| 62 | |
| 63 | '''Note:''' Note that the ''collector'' password will apply to both centralized and distributed measurement cases of !OnTimeMeasure. |
| 64 | |
| 65 | |
| 66 | __'''''On the Root Beacon PC:'''''__ |
72 | | === 3.2 Software Configuration === |
73 | | |
74 | | __'''''On the Root Beacon Server:'''''__ |
75 | | |
76 | | __MySQL configuration__ |
77 | | |
78 | | {{{ |
79 | | mysql -u root < BuildWebServicesDatabase.sql |
80 | | mysql -u root < BuildMeasurementDatabase.sql |
81 | | mysql -u root |
82 | | }}} |
83 | | At the mysql prompt, type |
84 | | {{{ |
85 | | CREATE USER 'collector'@'%' IDENTIFIED BY '<collector password>'; |
86 | | GRANT ALL PRIVILEGES ON `Measurements` . * TO 'collector'@'%'; |
87 | | GRANT ALL PRIVILEGES ON `WebServices` . * TO 'collector'@'%'; |
88 | | exit |
89 | | }}} |
90 | | '''Note 1:''' Please change the <collector password> to a safe password. |
91 | | |
92 | | '''Note 2:''' If remote access to MySQL on the Root Beacon is disabled, please open the port TCP/3306 in the firewall and follow the tutorial at http://www.cyberciti.biz/tips/how-do-i-enable-remote-access-to-mysql-database-server.html |
93 | | |
94 | | |
95 | | __Invocation options configuration__ |
96 | | |
97 | | {{{ |
98 | | perl config_wizard.pl |
99 | | }}} |
100 | | Follow the steps as directed by the wizard script. |
101 | | |
102 | | __'''''On a Node Beacon Server:'''''__ |
103 | | |
104 | | __Invocation options configuration__ |
105 | | |
106 | | {{{ |
107 | | perl config_wizard.pl |
108 | | }}} |
109 | | Follow the steps as directed by the wizard script. |
110 | | |
111 | | __'''''On the Web-portal:'''''__ |
112 | | |
113 | | Login to the [http://ontime.oar.net OnTimeMeasure Researcher Web-portal] and provide the Slice RSpec information. |
114 | | |
115 | | |
116 | | === 3.3 Software Invocation === |
117 | | |
118 | | __'''''On the Root Beacon Server:'''''__ |
119 | | |
120 | | |
121 | | Go to "!RootBeacon/!RootScheduler/" and run |
122 | | {{{ |
123 | | screen |
124 | | /opt/graphite/bin/run-graphite-devel-server.py /opt/graphite |
125 | | }}} |
126 | | If no error is reported, press '<CTRL>+a, c' sequence to open a new blank command window. |
127 | | {{{ |
128 | | perl file_server.pl |
129 | | }}} |
130 | | If no error is reported, press '<CTRL>+a, c' sequence to open a new blank command window. |
131 | | {{{ |
132 | | perl action_script.pl |
133 | | }}} |
134 | | If no error is reported, press '<CTRL>+a, c' sequence to open a new blank command window. |
135 | | {{{ |
136 | | cd ../Collector/ |
137 | | perl collector.pl |
138 | | }}} |
139 | | If no error is reported, press '<CTRL>+a, d' sequence in the SSH window to keep the service running in the background. |
140 | | |
141 | | |
142 | | |
143 | | __'''''On a Node Beacon Server:'''''__ |
144 | | |
145 | | Go to '!NodeBeacon/Datagen/' and run |
146 | | |
147 | | {{{ |
148 | | screen |
149 | | perl file_server.pl |
150 | | }}} |
151 | | If no error is reported, press '<CTRL>+a, c' sequence to open a new blank command window. |
152 | | {{{ |
153 | | perl node_scheduler.pl |
154 | | }}} |
155 | | If no error is reported, press '<CTRL>+a, d' sequence in the SSH window to keep the service running in the background. |
156 | | |
| 83 | === 3.2 Software Configuration and Invocation === |
| 84 | |
| 85 | ==== Through !OnTime Beacon web-portal ==== |
| 86 | |
| 87 | Login to the [http://ontime.oar.net OnTimeBeacon]. Setup resources (provide RSpec information) and control Node/Root Beacons within slice in an ''interactive'' manner. Video demos of these steps can be viewed at [http://ontime.oar.net/demo/] |
| 88 | |
| 89 | |
| 90 | ==== Through !OnTime Control command-line tools ==== |
| 91 | |
| 92 | Follow the [https://svn.osc.edu/trac/activemon/wiki/OnTimeControlManual ''OntimeControl Manual''] to control Node/Root Beacons within slice in an ''automated'' manner. |
179 | | === 4.2 Software Configuration === |
180 | | |
181 | | |
182 | | __NTP Configuration__ |
183 | | |
184 | | {{{ |
185 | | sudo vim /etc/ntp.conf |
186 | | }}} |
187 | | Edit the last line to: |
188 | | {{{ |
189 | | server owamp.newy.net.internet2.edu |
190 | | }}} |
191 | | Restart ntpd service |
192 | | {{{ |
193 | | sudo /etc/init.d/ntpd restart |
194 | | }}} |
195 | | |
196 | | __BWCTL Configuration__ |
197 | | |
198 | | Edit the BWCTL config: /etc/bwctld/bwctld.conf |
199 | | |
200 | | Remove the comments on the below lines and edit them as: |
201 | | {{{ |
202 | | allow_unsync |
203 | | sync_fuzz 5 |
204 | | }}} |
205 | | |
206 | | Edit the BWCTL limits: /etc/bwctld/bwctld.limits |
207 | | Change the regular limit to: |
208 | | |
209 | | {{{ |
210 | | limit regular with parent=root, \ |
211 | | duration=30, \ |
212 | | allow_tcp=on, \ |
213 | | allow_udp=on, \ |
214 | | allow_open_mode=on |
215 | | }}} |
216 | | |
217 | | Restart BWCTL: |
218 | | {{{ |
219 | | sudo /etc/init.d/bwctld restart |
220 | | }}} |
221 | | |
222 | | '''Note:''' For more detailed instructions to configure NTP and BWCTL, please refer to the BWCTL Tool website. (http://www.internet2.edu/performance/bwctl/) |
223 | | |
224 | | __Node Beacon invocation options configuration__ |
225 | | |
226 | | {{{ |
227 | | cd NodeBeacon/InstallScript |
228 | | perl config_wizard.pl |
229 | | }}} |
230 | | Follow the steps as directed by the wizard script. |
231 | | |
232 | | __'''''On the Web-portal:'''''__ |
233 | | |
234 | | Login to the [http://ontime.oar.net OnTimeMeasure Researcher Web-portal] and provide the Slice information. |
235 | | |
236 | | |
237 | | === 4.3 Software Invocation === |
238 | | |
239 | | Go to '!NodeBeacon/Datagen/' and run |
240 | | {{{ |
241 | | screen |
242 | | perl file_server.pl |
243 | | }}} |
244 | | If no error is reported, press '<CTRL>+a, c' sequence to open a new blank command window. |
245 | | |
246 | | '''Note:'''Centralize and distributed share the same file server script. If you run both centralized and distributed on the same machine, you only need to run the file_server.pl once. |
247 | | {{{ |
248 | | perl dist_scheduler.pl |
249 | | }}} |
250 | | If no error is reported, press '<CTRL>+a, d' sequence in the SSH window to keep the service running in the background. |
| 118 | |
| 119 | === 4.2 Software Configuration and Invocation === |
| 120 | |
| 121 | ==== Through !OnTime Beacon web-portal ==== |
| 122 | |
| 123 | Login to the [http://ontime.oar.net OnTimeBeacon]. Setup resources (provide RSpec information) and control Node/Root Beacons within slice in an ''interactive'' manner. Video demos of these steps can be viewed at [http://ontime.oar.net/demo/] |
| 124 | |
| 125 | |
| 126 | ==== Through !OnTime Control command-line tools ==== |
| 127 | |
| 128 | Follow the [https://svn.osc.edu/trac/activemon/wiki/OnTimeControlManual ''OntimeControl Manual''] to control Node/Root Beacons within slice in an ''automated'' manner. |
| 129 | |