My favorites | Sign in
Project Home Downloads Wiki Issues Source
Checkout   Browse   Changes  
Changes to /wiki/FrequentlyAskedQuestions.wiki
r191 vs. r205 Compare: vs.  Format:
Revision r205
Go to: 
Project members, sign in to write a code review
/wiki/FrequentlyAskedQuestions.wiki   r191 /wiki/FrequentlyAskedQuestions.wiki   r205
1 = Frequently Asked Questions = 1 = Frequently Asked Questions =
2 EDIT 2 EDIT
3 == General == 3 == General ==
4 4
5 *''What happened to Pebble Linux?''* 5 *''What happened to Pebble Linux?''*
6 6
7 You can still djjkjkkkoad [http://metrix.net/support/dist/old/ Metrix Pebble] and the original [http://nycwireless.net/pebble/ NycWireless Pebble]. Pyramid is almost as complete feature wise as pebble however there are still some things that need to be added. We suggest you try Pyramid, even [http://nycwireless.net Nycwireless] the original home of pebble has switched to using Pyramid. 7 You can still djjkjkkkoad [http://metrix.net/support/dist/old/ Metrix Pebble] and the original [http://nycwireless.net/pebble/ NycWireless Pebble]. Pyramid is almost as complete feature wise as pebble however there are still some things that need to be added. We suggest you try Pyramid, even [http://nycwireless.net Nycwireless] the original home of pebble has switched to using Pyramid.
8 8
9 *''Is Pyramid Ubuntu?''* 9 *''Is Pyramid Ubuntu?''*
10 10
11 No. Most of the stock system binaries are taken from Ubuntu but thats about it. There is no "apt" or any of the chrome you would expect to find in Ubuntu or a desktop focused operating system. 11 No. Most of the stock system binaries are taken from Ubuntu but thats about it. There is no "apt" or any of the chrome you would expect to find in Ubuntu or a desktop focused operating system.
12 12
13 *''Why do you store binaries in source control?''* 13 *''Why do you store binaries in source control?''*
14 14
15 Pyramid is primarily created from pre-built binaries. There is some new code, primarily the web interface. However we make a lot of changes to the system, its layout and the binaries from release to release. We need to track that. Since we do not build from source we keep all the files in source control. This allows us to track what changes we make to the distro and it allows you to track it as well. 15 Pyramid is primarily created from pre-built binaries. There is some new code, primarily the web interface. However we make a lot of changes to the system, its layout and the binaries from release to release. We need to track that. Since we do not build from source we keep all the files in source control. This allows us to track what changes we make to the distro and it allows you to track it as well.
16 16
17 == Setup and Install == 17 == Setup and Install ==
18 18
19 *''I just installed Pyramid, how do I log in?''* 19 *''I just installed Pyramid, how do I log in?''*
20 20
21 The default login is username: root password: root 21 The default login is username: root password: root
22 You should change this immediately, this allows you to login via the serial console, ssh, and the ssl web interface. 22 You should change this immediately, this allows you to login via the serial console, ssh, and the ssl web interface.
23 23
24 *''How do I install Pyramid on a device with on-board compact flash?''* 24 *''How do I install Pyramid on a device with on-board compact flash?''*
25 25
26 Use a PXE install environment to install the system. Check out the InstallingPyramid page. 26 Use a PXE install environment to install the system. Check out the InstallingPyramid page.
27 27
28 *''Can I upgrade from Pebble?''* 28 *''Can I upgrade from Pebble?''*
29 29
30 If you are working on a Soekris 4526 or 4826, and you already have Pyramid or Pebble installed, you can use InstallingPyramid/UpgradingImg 30 If you are working on a Soekris 4526 or 4826, and you already have Pyramid or Pebble installed, you can use UpgradingImg
31 31
32 32
33 == Captive Portals == 33 == Captive Portals ==
34 34
35 *'' What is the recommended captive portal on Metrix Pyramid and how does one most easily install it? ''* 35 *'' What is the recommended captive portal on Metrix Pyramid and how does one most easily install it? ''*
36 36
37 Currently [http://wifidog.org WifiDog] and [http://chillispot.org chillispot] are included in Pyramid. They both require a backend server to handle authentication and splash pages. On pyramid you get the gateway software which handles blocking and permitting of users on the network based authentication to the central server. 37 Currently [http://wifidog.org WifiDog] and [http://chillispot.org chillispot] are included in Pyramid. They both require a backend server to handle authentication and splash pages. On pyramid you get the gateway software which handles blocking and permitting of users on the network based authentication to the central server.
38 38
39 I have also packaged up nocat splash for pyramid, it provides minimal portal/splash page functionality. You can find it here: http://ken.ipl31.net/pyramid/ its meant to be untarred into /usr/local. The default config uses ath0 for the wireless interface and eth0 for the internal/ethernet interface. You will probably need to change that for your environment. You will also need it add it to the appropriate run level to start at boot. 39 I have also packaged up nocat splash for pyramid, it provides minimal portal/splash page functionality. You can find it here: http://ken.ipl31.net/pyramid/ its meant to be untarred into /usr/local. The default config uses ath0 for the wireless interface and eth0 for the internal/ethernet interface. You will probably need to change that for your environment. You will also need it add it to the appropriate run level to start at boot.
40 40
41 41
42 == Hardware Issues == 42 == Hardware Issues ==
43 43
44 44
45 *'' How do I use a USB drive on Mark II or Net48XX system ''* 45 *'' How do I use a USB drive on Mark II or Net48XX system ''*
46 46
47 This requires a couple of kernel modules to be loaded which are not loaded by default. Add the following modules to your '''/etc/modules''' file so they will be loaded at boot: 47 This requires a couple of kernel modules to be loaded which are not loaded by default. Add the following modules to your '''/etc/modules''' file so they will be loaded at boot:
48 48
49 {{{ 49 {{{
50 ohci_hcd 50 ohci_hcd
51 usb_storage 51 usb_storage
52 sd_mod 52 sd_mod
53 }}} 53 }}}
54 54
55 Alternatively if you just want to test the functionality you may manually load the modules from the command line: 55 Alternatively if you just want to test the functionality you may manually load the modules from the command line:
56 56
57 {{{ 57 {{{
58 modprobe ohci_hcd usb_storage sd_mod 58 modprobe ohci_hcd usb_storage sd_mod
59 }}} 59 }}}
60 60
61 If you run the 'dmesg' command you should see some informative output regarding the discovery of your USB hardware. 61 If you run the 'dmesg' command you should see some informative output regarding the discovery of your USB hardware.
62 62
63 At this point if your usb drive is connected you should see devices in the "/dev/" directory that begin with "sd": 63 At this point if your usb drive is connected you should see devices in the "/dev/" directory that begin with "sd":
64 64
65 {{{ 65 {{{
66 pyramid:~# ls /dev | grep sd 66 pyramid:~# ls /dev | grep sd
67 sda 67 sda
68 sda1 68 sda1
69 }}} 69 }}}
70 70
71 From here you may mount the drive to a mount point of your liking, in this case we created a directory called "usb" in "/mnt": 71 From here you may mount the drive to a mount point of your liking, in this case we created a directory called "usb" in "/mnt":
72 72
73 {{{ 73 {{{
74 cd /mnt 74 cd /mnt
75 mkdir usb 75 mkdir usb
76 mount /dev/sda1 /mnt 76 mount /dev/sda1 /mnt
77 }}} 77 }}}
78 78
79 If your usb drive is FAT formatted drive you may need to do the following: 79 If your usb drive is FAT formatted drive you may need to do the following:
80 80
81 {{{ 81 {{{
82 mount -t vfat /dev/sda1 /mnt -o iocharset=cp437 82 mount -t vfat /dev/sda1 /mnt -o iocharset=cp437
83 }}} 83 }}}
84 84
85 85
86 86
87 *''If I disable my Atheros interface (ath0 or ath1) it dissapears''* 87 *''If I disable my Atheros interface (ath0 or ath1) it dissapears''*
88 88
89 This is a bug in our web interface that is caused by how we handle creating VAPs with the madwifi driver. To re-enable the card edit the /etc/network/interfaces file and uncomment the line "#auto ath0" by removing the "#". Reboot the box and the interface should be back. 89 This is a bug in our web interface that is caused by how we handle creating VAPs with the madwifi driver. To re-enable the card edit the /etc/network/interfaces file and uncomment the line "#auto ath0" by removing the "#". Reboot the box and the interface should be back.
90 90
91 91
92 92
93 93
94 *''My Prism2 card is acting funny''* 94 *''My Prism2 card is acting funny''*
95 95
96 If your Prism card ( NL-2511MP ) is acting squirrely (can't keep an association in managed mode, doesn't scan correctly, etc.) you may need to update the firmware. 96 If your Prism card ( NL-2511MP ) is acting squirrely (can't keep an association in managed mode, doesn't scan correctly, etc.) you may need to update the firmware.
97 97
98 {{{ 98 {{{
99 99
100 cd /usr/local/firmware/prism 100 cd /usr/local/firmware/prism
101 prism2_srec -v -f wlan0 pk010101.hex sf010800.hex 101 prism2_srec -v -f wlan0 pk010101.hex sf010800.hex
102 prism2_srec -v -f wlan1 pk010101.hex sf010800.hex 102 prism2_srec -v -f wlan1 pk010101.hex sf010800.hex
103 hostap_diag wlan0 103 hostap_diag wlan0
104 hostap_diag wlan1 104 hostap_diag wlan1
105 105
106 }}} 106 }}}
107 107
108 *'' How do I disable antenna diversity? or I am only using one antenna on my Wi-Fi card in my router''* 108 *'' How do I disable antenna diversity? or I am only using one antenna on my Wi-Fi card in my router''*
109 109
110 If you are using only a single antenna port on your atheros card, you will want to disable antenna diversity (diversity enables the card to handle some forms of multipath interference, but if you only have a single antenna connected, then the card is just throwing away power to the unconnected antenna). 110 If you are using only a single antenna port on your atheros card, you will want to disable antenna diversity (diversity enables the card to handle some forms of multipath interference, but if you only have a single antenna connected, then the card is just throwing away power to the unconnected antenna).
111 111
112 To turn off antenna diversity (using madwifi-ng, which is the default on pyramid), add the following lines to {{{/etc/sysctl.conf}}}: 112 To turn off antenna diversity (using madwifi-ng, which is the default on pyramid), add the following lines to {{{/etc/sysctl.conf}}}:
113 113
114 {{{ 114 {{{
115 dev.wifi0.diversity = 4 115 dev.wifi0.diversity = 4
116 dev.wifi0.rxantenna = 1 116 dev.wifi0.rxantenna = 1
117 dev.wifi0.txantenna = 1 117 dev.wifi0.txantenna = 1
118 }}} 118 }}}
119 119
120 Of course, this assumes that your atheros device is {{{wifi0}}} and that the antenna is connected to port 0 on the card. If either of these things are not the case, you can change the {{{wifi0}}} to the correct device (perhaps {{{wifi1}}}) or you can change the antenna assignments to {{{rxantenna = 2}}} and {{{txantenna = 2}}}. 120 Of course, this assumes that your atheros device is {{{wifi0}}} and that the antenna is connected to port 0 on the card. If either of these things are not the case, you can change the {{{wifi0}}} to the correct device (perhaps {{{wifi1}}}) or you can change the antenna assignments to {{{rxantenna = 2}}} and {{{txantenna = 2}}}.
121 121
122 *'' How do I turn up the power on my wifi card? ''* 122 *'' How do I turn up the power on my wifi card? ''*
123 123
124 When you bought your router, you probably were sold a Wi-Fi card with a particular power rating (100mW, 200mW or even 400mW). Depending on the card you have, Pyramid may not enable it at the highest transmit power. The output power can be controlled by the "iwconfig" command. How high the power will go depends on your card. For a CM9 the highest output power is 19dbm ( note the '''Tx-Power''' ): 124 When you bought your router, you probably were sold a Wi-Fi card with a particular power rating (100mW, 200mW or even 400mW). Depending on the card you have, Pyramid may not enable it at the highest transmit power. The output power can be controlled by the "iwconfig" command. How high the power will go depends on your card. For a CM9 the highest output power is 19dbm ( note the '''Tx-Power''' ):
125 125
126 {{{ 126 {{{
127 127
128 ath0 IEEE 802.11g ESSID:"Metrix Atheros 1" 128 ath0 IEEE 802.11g ESSID:"Metrix Atheros 1"
129 Mode:Master Frequency:2.412 GHz Access Point: 00:0B:6B:57:22:56 129 Mode:Master Frequency:2.412 GHz Access Point: 00:0B:6B:57:22:56
130 Bit Rate:0 kb/s Tx-Power:19 dBm Sensitivity=0/3 130 Bit Rate:0 kb/s Tx-Power:19 dBm Sensitivity=0/3
131 Retry:off RTS thr:off Fragment thr:off 131 Retry:off RTS thr:off Fragment thr:off
132 Encryption key:off 132 Encryption key:off
133 Power Management:off 133 Power Management:off
134 Link Quality=0/94 Signal level=-95 dBm Noise level=-95 dBm 134 Link Quality=0/94 Signal level=-95 dBm Noise level=-95 dBm
135 Rx invalid nwid:2 Rx invalid crypt:0 Rx invalid frag:0 135 Rx invalid nwid:2 Rx invalid crypt:0 Rx invalid frag:0
136 Tx excessive retries:0 Invalid misc:0 Missed beacon:0 136 Tx excessive retries:0 Invalid misc:0 Missed beacon:0
137 137
138 138
139 139
140 }}} 140 }}}
141 141
142 Every card is different. To determine how high you can set the power, start increasing in increments of 1 dbm till you recieve an error: 142 Every card is different. To determine how high you can set the power, start increasing in increments of 1 dbm till you recieve an error:
143 143
144 144
145 {{{ 145 {{{
146 iwconfig ath0 txpower 16 146 iwconfig ath0 txpower 16
147 }}} 147 }}}
148 148
149 then 149 then
150 150
151 {{{ 151 {{{
152 iwconfig ath0 txpower 17 152 iwconfig ath0 txpower 17
153 }}} 153 }}}
154 154
155 etc... Until you see an error like this: 155 etc... Until you see an error like this:
156 156
157 {{{ 157 {{{
158 Error for wireless request "Set Tx Power" (8B26) : 158 Error for wireless request "Set Tx Power" (8B26) :
159 SET failed on device ath0 ; Invalid argument. 159 SET failed on device ath0 ; Invalid argument.
160 }}} 160 }}}
161 161
162 This usually indicates that they argument you have supplied is not supported by the card, this you have reached the maximum power setting. 162 This usually indicates that they argument you have supplied is not supported by the card, this you have reached the maximum power setting.
163 163
164 There are some issues in the MadwifiNg driver, where in client mode your power settings will only stick once the card is associated. If it loses association it will switch back to default power setting. 164 There are some issues in the MadwifiNg driver, where in client mode your power settings will only stick once the card is associated. If it loses association it will switch back to default power setting.
165 165
166 166
167 If you'd like this setting enabled by default, you can add it to {{{/etc/network/interfaces}}} after the {{{pre-up sleep 3}}} command: 167 If you'd like this setting enabled by default, you can add it to {{{/etc/network/interfaces}}} after the {{{pre-up sleep 3}}} command:
168 168
169 {{{ 169 {{{
170 pre-up iwconfig ath0 txpower 19 170 pre-up iwconfig ath0 txpower 19
171 }}} 171 }}}
172 172
173 173
174 174
175 *'' My WRAP does not reboot with Pyramid Linux!! Router hangs on reboot''* 175 *'' My WRAP does not reboot with Pyramid Linux!! Router hangs on reboot''*
176 176
177 It's just a problem with GRUB, let's fix this! 177 It's just a problem with GRUB, let's fix this!
178 178
179 First of all remount read write to modify files :) 179 First of all remount read write to modify files :)
180 {{{ 180 {{{
181 remountrw 181 remountrw
182 }}} 182 }}}
183 183
184 Now let's open the file to modify 184 Now let's open the file to modify
185 {{{ 185 {{{
186 nano /boot/grub/menu.lst 186 nano /boot/grub/menu.lst
187 }}} 187 }}}
188 188
189 on the lines that start with the word "kernel" append the string reboot=bios 189 on the lines that start with the word "kernel" append the string reboot=bios
190 190
191 This is the file I have after the changes 191 This is the file I have after the changes
192 {{{ 192 {{{
193 timeout 3 193 timeout 3
194 194
195 serial --device=/dev/ttyS0 --speed=19200 --word=8 --parity=no --stop=1 195 serial --device=/dev/ttyS0 --speed=19200 --word=8 --parity=no --stop=1
196 terminal serial 196 terminal serial
197 197
198 title Metrix 198 title Metrix
199 root (hd0,0) 199 root (hd0,0)
200 kernel /boot/vmlinuz root=/dev/hda1 console=ttyS0,19200n8 reboot=bios 200 kernel /boot/vmlinuz root=/dev/hda1 console=ttyS0,19200n8 reboot=bios
201 201
202 title Shell 202 title Shell
203 root (hd0,0) 203 root (hd0,0)
204 kernel /boot/vmlinuz root=/dev/hda1 console=ttyS0,19200n8 init=/bin/bash reboot=bios 204 kernel /boot/vmlinuz root=/dev/hda1 console=ttyS0,19200n8 init=/bin/bash reboot=bios
205 205
206 }}} 206 }}}
207 207
208 Save & Exit the nano editor :) 208 Save & Exit the nano editor :)
209 209
210 remount read only 210 remount read only
211 {{{ 211 {{{
212 remountro 212 remountro
213 }}} 213 }}}
214 214
215 Now switch the power off and on again for the last time! Since this boot the kernel option you are passing will allow correct reboots! :) 215 Now switch the power off and on again for the last time! Since this boot the kernel option you are passing will allow correct reboots! :)
216 216
217 217
218 == Setting Up a Pyramid Development Environment == 218 == Setting Up a Pyramid Development Environment ==
219 219
220 If you are interested in building a development environment, you will need to use Ubuntu Breezy as your starting point. Since the official mirrors have mostly been pulled, feel free to use ours. If you are just adding a binary or lib from the standard dist, it's extremely straightforward. 220 If you are interested in building a development environment, you will need to use Ubuntu Breezy as your starting point. Since the official mirrors have mostly been pulled, feel free to use ours. If you are just adding a binary or lib from the standard dist, it's extremely straightforward.
221 221
222 Just change your sources in /etc/apt/sources.list (on your dev box) to: http://metrix.net/ubuntu/ 222 Just change your sources in /etc/apt/sources.list (on your dev box) to: http://metrix.net/ubuntu/
223 223
224 The kernel config is located on a running box at /proc/config.gz 224 The kernel config is located on a running box at /proc/config.gz
Powered by Google Project Hosting