1 | Subject:
|
---|
2 | Feedback for WiMAX wiki
|
---|
3 | From:
|
---|
4 | Luisa Nevers <lnevers@bbn.com>
|
---|
5 | Date:
|
---|
6 | Wed, 05 Jan 2011 15:23:15 -0500
|
---|
7 | To:
|
---|
8 | harry.mussman@bbn.com, Abhimanyu Gosain <agosain@bbn.com>
|
---|
9 | CC:
|
---|
10 | Heidi Picher Dempsey <hpd@bbn.com>, Luisa Nevers <lnevers@bbn.com>
|
---|
11 |
|
---|
12 | Hello,
|
---|
13 |
|
---|
14 | I have just finished reviewing the WiMAX page at http://wimax.orbit-lab.org
|
---|
15 | and have captured all feedback, as a first time reader. Please let me know
|
---|
16 | if the feedback is is not clear.
|
---|
17 |
|
---|
18 | => Overall Comments:
|
---|
19 |
|
---|
20 | 1. Navigation is cumbersome, the table of content is the only way to
|
---|
21 | move through the lengthy document; the table of content is only
|
---|
22 | available on the WikiStart page. Suggest adding "Previous" and "Next"
|
---|
23 | to navigate between chapters.
|
---|
24 |
|
---|
25 | 2. At the very top of every chapter there are 2 non-working
|
---|
26 | links that looks as follows "WiMAX/NUM". The "WiMax/" does not
|
---|
27 | exist and the "/NUM" is a number (00, 01, etc) and this link
|
---|
28 | also does not work on any of the chapter pages.
|
---|
29 |
|
---|
30 | => Initial page "GENI WiMax Platform"
|
---|
31 |
|
---|
32 | 1. Should have link to GENI page, since this is a GENI project.
|
---|
33 | 2. Are there other external web sites that should be referenced to
|
---|
34 | provide some background to WiMAX?
|
---|
35 | 3. Replace "modifed BS" with "modified BS" in 3rd sentence.
|
---|
36 | 4. Should spell out first instance of "BS" (Base Station).
|
---|
37 |
|
---|
38 | => Chapter 1 "GENI WiMAX System Configuration":
|
---|
39 |
|
---|
40 | 1. Configuration chapter starts with a diagram. Needs some introduction
|
---|
41 | to provide an overview of the configuration and its requirements. The
|
---|
42 | picture is useful, but it should not be the starting point.
|
---|
43 |
|
---|
44 | => Section 1.2 "APIs"
|
---|
45 |
|
---|
46 | 1. Section provides a brief overview of the interaction between different
|
---|
47 | system components as shown in the Figure 1. These two components are
|
---|
48 | described: Slice Manager (SM), Radio Management (RM), but neither component
|
---|
49 | names are found in Figure 1.
|
---|
50 |
|
---|
51 | => Chapter 2 "GENI WiMAX Base Station Configuration"
|
---|
52 |
|
---|
53 | 1. Is the intent for the user to choose one of this configuration scenarios? Or
|
---|
54 | is the intent of this page to have the user start with "Case 1" then move to
|
---|
55 | "Case 2" and eventually end-up with "Case 3"? Some text needed to explain
|
---|
56 | the scope of this chapter.
|
---|
57 |
|
---|
58 | => Chapter 3 "Hardware"
|
---|
59 |
|
---|
60 | 1. I assume there is more to come in this section, right now, the hardware
|
---|
61 | platforms listed are somewhat vague and incomplete.
|
---|
62 |
|
---|
63 | => Chapter 4 "Software"
|
---|
64 |
|
---|
65 | 1. Before any text is provided, chapter 4 starts with the following images
|
---|
66 | in the order listed:
|
---|
67 | Fig 2-1) Case 1 WiMAX Base Station Configuration
|
---|
68 | Fig 3-1) Case 1 Detailed WiMAX Base Station Configuration
|
---|
69 | Fig 4-1) Case 1 WiMAX Software Configuration
|
---|
70 | Fig 2-2) Case 2 WiMAX Base Station Configuration
|
---|
71 | Fig 3-2) Case 2 Detailed WiMAX Base Station Configuration
|
---|
72 | Fig 4-2) Case 2 WiMAX Software Configuration
|
---|
73 |
|
---|
74 | The figure numbering scheme naming is confusing. Need a small introduction
|
---|
75 | to explain the scope of the chapter and how it will be presented to the user.
|
---|
76 |
|
---|
77 | 2. There 5 sentences (4.1, 4.2, 4.3.1, 4.4.1, 4.4.2) that tell the user to
|
---|
78 | configuration file by stating "see (reference below)". Should have link
|
---|
79 | to the actual example. I found it difficult to map each reference to the file.
|
---|
80 |
|
---|
81 | => Chapter 5 "Case 1: Software Installation, Configuration and Operation"
|
---|
82 | Before any text is provided, chapter 5 starts with the following images
|
---|
83 | in the order listed:
|
---|
84 | Fig 2-1) Case 1 WiMAX Base Station Configuration
|
---|
85 | Fig 3-1) Case 1 Detailed WiMAX Base Station Configuration
|
---|
86 | Fig 4-1) Case 1 WiMAX Software Configuration
|
---|
87 |
|
---|
88 | Need a small introduction to explain the scope of the chapter
|
---|
89 |
|
---|
90 | => Section 5.1 "WiMAX OID and IP Address Assignment"
|
---|
91 |
|
---|
92 | 1. Section starts with a OID table that dives into the details of what is in
|
---|
93 | use at various campuses and then provides some background. Should explain
|
---|
94 | and them provide the current table of OID & and IP addresses.
|
---|
95 |
|
---|
96 | 2. There are two outstanding questions in this section that need answers.
|
---|
97 |
|
---|
98 | => Section 5.5 "Manual Configuration of SAMrb"
|
---|
99 |
|
---|
100 | 1. All configuration seems to be manual, why is this one identified as manual?
|
---|
101 | Am I missing something?
|
---|
102 |
|
---|
103 | => Section 5.7 "Configuration of CLICK", suggest adding "router" to title.
|
---|
104 |
|
---|
105 | 1. Missing example configurations.
|
---|
106 |
|
---|
107 |
|
---|
108 | => Section 5.8 "Operations and Testing":
|
---|
109 |
|
---|
110 | 1. Section 5.8.2 "Login to BTS" is missing example.
|
---|
111 |
|
---|
112 | 2. No information in the following sections:
|
---|
113 | 5.8.5 SAM Monitoring
|
---|
114 | 5.8.6 CLICK Modular Router Monitoring
|
---|
115 | 5.8.9 Mobile Station Registration
|
---|
116 |
|
---|
117 | => Chapter 6 "Case 2: Software Installation, Configuration and Operation"
|
---|
118 | Before any text is provided, chapter 5 starts with the following images
|
---|
119 | in the order listed:
|
---|
120 | Fig 2-2) Case 2 WiMAX Base Station Configuration
|
---|
121 | Fig 3-2) Case 2 Detailed WiMAX Base Station Configuration
|
---|
122 | Fig 4-2) Case 2 WiMAX Software Configuration
|
---|
123 |
|
---|
124 | Need a small introduction to explain the scope of the chapter
|
---|
125 |
|
---|
126 | => Section 6.1 "WiMAX OID and IP Address Assignment"
|
---|
127 |
|
---|
128 | 1. Section starts with a OID table that dives into the details of what is in
|
---|
129 | use and then provides some background. Should explain and them provide
|
---|
130 | the current table of OID & and IP addresses.
|
---|
131 |
|
---|
132 | => Section 6.6 "Configuration of CLICK", suggest adding "router" to title.
|
---|
133 |
|
---|
134 | 1. Missing example configurations.
|
---|
135 |
|
---|
136 | => Section 6.9 "Operations and Testing":
|
---|
137 |
|
---|
138 | 1. Section 6.9.2 "Login to BTS" is missing example.
|
---|
139 |
|
---|
140 | 2. No information in the following sections:
|
---|
141 | 6.9.5 SAM Monitoring
|
---|
142 | 6.9.6 CLICK Modular Router Monitoring
|
---|
143 | 6.9.7 Mobile Station Registration
|
---|
144 | 6.9.9 Login to OMF as Experimenter
|
---|
145 | 6.9.10 Use of OMF to Configure Service
|
---|
146 | 6.9.11 Use of OML to Monitor BTS
|
---|
147 | 6.9.12 Use of OML to Monitor Service
|
---|
148 |
|
---|
149 | => Chapter 7 "Case 3: Software Installation, Configuration and Operation" is empty.
|
---|
150 |
|
---|
151 | => Appendix A: "APIs"
|
---|
152 |
|
---|
153 | 1. Section A.2.1 "Sample Experiment Setup Using API" has macro error, missing figure
|
---|
154 |
|
---|
155 | 2. Section A.2.2 "Sample Experiment: Custom Service Class Control" has macro error, missing figure
|
---|
156 |
|
---|
157 | => Appendix B: "Errata/ Things we had to change but haven't formally committed to documentation"
|
---|
158 |
|
---|
159 | 1. Reference to non-existing "wiki:WiMAX/Software/Configuration"
|
---|
160 |
|
---|
161 | => Appendix C: "WiMAX Mobile Stations"
|
---|
162 |
|
---|
163 | 1. Section c.1.1 "Installing image" point user to "Geni Configuration Instructions"
|
---|
164 | which is a link to "http://wimax.orbit-lab.org/downloads/NDnSAgentConfig_forDriver"
|
---|
165 | this does not exist.
|
---|
166 |
|
---|
167 |
|
---|
168 | Luisa
|
---|
169 |
|
---|
170 |
|
---|