Test Config Notes: Difference between revisions

From OLPC
Jump to navigation Jump to search
 
(53 intermediate revisions by 24 users not shown)
Line 1: Line 1:
{{Developers}}
==Builds & Infrastructure==
{{Translations}}


{{RightTOC}}
=== OLPC-Update ===
==Builds & infrastructure==


=== Step 0: get a developer key and do disable-security ===
This is about how to use [[SoftwareBinaryDifferentialUpdate|sandboxed (differential) updates]], this might change in the future.


Instructions for this are available at [[Activation and Developer Keys]]
On builds older than 613, you should flash update to get the most recent versions of the required software. [[Autoreinstallation image]]


To use the olpc-update script to upgrade (or to downgrade!),:
=== olpc-update ===


This section has been moved to [[Olpc-update]].
First, run


===Firmware notes===
* rsync rsync://updates.laptop.org | sort


* [http://dev.laptop.org/~wmb/ Mitch Bradley's stuff]
<pre>
# rsync rsync://updates.laptop.org | sort
build-612
build-616
build-617
build-debian
build-debian-big
build-frs
build-joyride-53
build-joyride-56
build-joyride-58
build-joyride-59
build-joyride-66
build-joyride-67
build-joyride-68
build-joyride-76
build-meshtest
build-meshtest-47
build-meshtest-56
build-meshtest-73
build-meshtest-74
</pre>


* [[Boot Process]]
To find the builds available, and make sure that you are connected to the server. Then, run


To install a new firmware version: [[Manual Firmware Install]]
: olpc-update <build-no>


===Fixing XO clock data===
where <build-no> is the number of the build (e.g. 610, 588) to which you would like to move, e.g.,


From build 693 on (maybe earlier), the time is set automatically the first time you connect to the network.
olpc-update 617


From build 641 on (maybe earlier), if you have a good internet connection you can set the date/time by logging in as root and typing:
or


ntpdate pool.ntp.org
olpc-update joyride-74


~~ You can find out the current date and time in a terminal window by typing "date".
or
There is currently no way to get the clock to be on the "desktop" or home screen; but you could write that in Python as a change to Sugar-shell, and submit the improvement to the XO team!
Let Love Flow
[[User:Irielesli|Listen]]~~


On unupgraded early Give One Get One laptops, ntpdate may not be installed. You can set the date/time manually by logging in as root and typing:
olpc-update meshtest-74


date
Finally, the update mechanism preserves the build from which you ran the updater as an "alternate" image from which you can boot. To swap the "primary" and "alternate" images, hold the 'O' gamepad key during bootup.


which will show the laptop's current time and date. Using the same date and time format returned by the date command, type:
===Fixing XO clock Data===


date --set "Mon Apr 1 etc. etc."
From build 641 on (maybe earlier), if you have a good internet connection you can set the date/time by typing:


Some pre-test machines don't have valid manufacturing data. This isn't too much of a problem, but they also have clocks which are set to crazy values, which is. To fix this, boot and press Esc when prompted to get an OFW prompt. At the 'ok' prompt type:
ntpdate time.nist.gov


Some pre-test machines (C4s at the moment) don't have valid manufacturing data. This isn't too much of a problem, but they also have clocks which are set to crazy values, which is. To fix this, boot with the X key pressed and press Esc when prompted to get an OFW prompt. At the 'ok' prompt type:


clock-node @ iselect decimal 00 40 16 14 09 2007 set-time
clock-node @ iselect decimal 00 40 16 14 09 2007 set-time


The numbers here are the time and date: second, minute, hour, day, month, year. You can substitute the current time and date if you like, but the machine will activate correctly as long as it has a somewhat-sane date. You can use the date above, for example.
The numbers here are the time and date: second, minute, hour, day, month, year. You can substitute the current time and date if you like, but the machine will activate correctly as long as it has a somewhat-sane date. You can use the date above, for example.

[[Fix Clock| Steps to fix bad clock value on write protected machines]]


===Customizing a NAND image===
===Customizing a NAND image===
Line 71: Line 54:
*See [[Customizing NAND images]]
*See [[Customizing NAND images]]


===Internationalization Testing===
===Internationalization testing===

All the information for Quanta to put into SPI flash to ensure a laptop will come up using the appropriate keyboard and language is described here: [[mfg-data]]


* [[OLPC Keyboard layouts]]
* [[OLPC Keyboard layouts]]
Line 77: Line 62:
* [[Checking the Layout configuration]]
* [[Checking the Layout configuration]]
* [[Olpc-utils|Localization utilities]] (Olpc-utils)
* [[Olpc-utils|Localization utilities]] (Olpc-utils)
* Create a language pack to add to a release build: [[Localization/LanguagePacks]]

===Firmware Notes===

[http://dev.laptop.org/~wmb/ Mitch Bradley's stuff]

[[Boot Process]] (as of q2d03)

To check your firmware version:
cat /ofw/openprom/model


===Kernel changelog analysis===
===Kernel changelog analysis===
Line 91: Line 68:
At http://dev.laptop.org/~bert/joyride-pkgs.html is the joyride
At http://dev.laptop.org/~bert/joyride-pkgs.html is the joyride
changelog. In it you'll see the version of the kernel.
changelog. In it you'll see the version of the kernel.
An example of a Kernel change is in joyride build #258, and the new version

The kernel was last changed in joyride build #258, and the new version
of the kernel for joyride build #258 is kernel.i586 0:2.6.22-20071111.5.olpc.c1d02f5e6853b99
of the kernel is kernel.i586 0:2.6.22-20071111.5.olpc.c1d02f5e6853b99


You can find that information for _any_ kernel by running 'uname -r'.
You can find that information for _any_ kernel by running 'uname -r'.
Line 108: Line 84:
==Sugar & Activities==
==Sugar & Activities==


See [[Activities]].
===XO Files===


===Check which activity version you have===
*[http://olpc.download.redhat.com/activities/ List of .xo files] (usually most updated ones).
In [[Release notes/8.2.0]], the [[Home view]] in List view mode displays the version of each installed activity.


In any release, each activity's <tt>activity.info</tt> file has this information.
*[[GCompris]] &mdash; [http://gcompris.net/incoming/xo/ gcompris xo files]
* In [[Terminal Activity]],
cat ~olpc/Activities/''Activity_name''.activity/activity/activity.info
** There may still be activities in the old location <tt>/usr/share/activities/</tt>
* Look for the <tt>activity_version</tt> setting.


===Turning suspend/resume or screen saver off===
*See also: {{tl|OBX xobundle}} which will categorize all references to bundles ({{pending|the category name needs to be determined}})
You can turn off suspend/resume by typing:
touch /etc/ohm/inhibit-suspend


To turn off power management:
*[http://dev.laptop.org/~sj/SimCity-1.xo SimCity]

===Check Which Activity Version you have===

* Open the /usr/share/activities/{activity_name}.activity/activity.info file
* Check the activity_version setting

===Turning Suspend/Resume or screen saver off===
Note: suspend/resume code was included in joyride 258. If you have anything other than a C2 or ECO'd machine, it is fairly likely that going through the cycles will cause the laptop to freeze, reboot itself, etc.

To turn this feature off:
* For one boot (till the laptop is rebooted):
* For one boot (till the laptop is rebooted):
** As root, type:
** As [[root]], type:

/sbin/service ohmd stop
/sbin/service ohmd stop


* For all reboots:
* For all reboots:
** As root, type:
** As root, type:

rpm -e ohm
rpm -e ohm


To turn off the screen saver, type:
* More recently, you can turn off suspend/resume by typing: '''touch /etc/ohm/inhibit-suspend'''
xset dpms force off

* Turn off the screen saver: '''xset dpms force off''' from the developer's terminal.


===Control Panel===
===Control panel===


*[[Sugar Control Panel]]
*[[Sugar Control Panel]]


===Keyboard Shortcuts===
===Keyboard shortcuts===
* [[Keyboard Shortcuts]]
* [[Keyboard shortcuts]]
* [[Cheat codes]]
* [[Cheat codes]]


==Wireless & Network==
==Wireless & network==

===Removing network config settings===
# Open a virtual terminal
# rm /home/olpc/.sugar/default/nm/network.config


===Connectivity to Apple Extreme===
===Connectivity to Apple Extreme===
Line 158: Line 132:




;[[Wireless_Access_Point_Compatibility|Matrix of Wireless AP]] - Volunteer test results
===Testing of Different Connection Configurations===

===Testing of different connection configurations===
#[[Under a Tree]]
#[[Under a Tree]]
#[[Connected to AP]]
#[[Connected to AP]]
Line 164: Line 140:
#[[Same Mesh Same Server]]
#[[Same Mesh Same Server]]


===Test the Network and Mesh Details===
===Test the network and mesh details===
*[[Test_Network_Configuration|Step by step testing]] to examine your connectivity and network status. Run this '''[http://wiki.laptop.org/images/8/8a/Status.sh linux script]''' to view an overview of these results.
*[[Test_Network_Configuration|Step by step testing]] to examine your connectivity and network status. Run this '''[http://wiki.laptop.org/images/8/8a/Status.sh linux script]''' to view an overview of these results.
*[[Wireless Airtime Analysis]] - analysis tool for wifi
*[[Telepathy debugging]]


===Modify the Mesh Discovery Sequence===
===Modify the mesh discovery sequence===


You can put the following values in <tt>/etc/NetworkManager/mesh-start</tt>
You can put the following values in <tt>/etc/NetworkManager/mesh-start</tt>
Line 204: Line 182:
===Update the wireless firmware===
===Update the wireless firmware===


Please note that you do NOT need to get newer versions of wireless firmware if you are running a released version of OS. All releases include an appropriate, tested version of wireless firmware. These notes are for testing purposes only.
* First check what version you are running with: ''ethtool -i eth0''

* Next download the latest Libertas firmware, [http://laptop.org/teamwiki/index.php/Tech:Wireless], and unzip it with: ''tar xzf <filename>''
* You can check what version you are running with: ''ethtool -i eth0''
* Next download the latest Libertas firmware, ([http://laptop.org/teamwiki/index.php/Tech:Wireless non-released], [http://dev.laptop.org/pub/firmware/libertas/ released]), and unzip it with: ''tar xzf <filename>''
* Move, delete or rename the 'usb8388.bin' file that is currently being used in ''/lib/firmware/'
* Move, delete or rename the 'usb8388.bin' file that is currently being used in ''/lib/firmware/'
* Copy the new 'usb8388.bin' file from where you unzipped it into ''/lib/firmware/' (if the .bin file has a name other than usb8388, change it to usb8388.bin)
* Copy the new 'usb8388.bin' file from where you unzipped it into ''/lib/firmware/' (if the .bin file has a name other than usb8388, change it to usb8388.bin)
* Reboot; then check the version with: ''ethtool -i eth0''
* You could Reboot, or simply rmmod usb8xxx ,then modprobe usb8xxx ; then check the version with: ''ethtool -i eth0''

===Turn on wireless debug===

Instructions on how to enable driver debug can be found [[Libertas_Debug |here]].


===Turn your XO into a sniffer===
===Turn your XO into a sniffer===


# Install tcpdump ('yum install tcpdump' will probably do it)
# Install tcpdump ('yum install tcpdump' will probably do it)
# <code>killall NetworkManager</code> (is this really necessary?)
# <code>killall NetworkManager</code>
# <code>echo ${TRAFFIC_MASK} > /sys/class/net/msh0/device/libertas_rtap</code>
# <code>ifconfig msh0 down</code>
# <code>ifconfig eth0 down</code>
# <code>echo ${TRAFFIC_MASK} > /sys/class/net/eth0/lbs_rtap</code>
# <code>ifconfig rtap0 up</code>
# <code>ifconfig rtap0 up</code>
# <code>tcpdump -i rtap0 -w outputfile.dump </code>
# <code>tcpdump -i rtap0 -w outputfile.dump </code>
Line 230: Line 216:


===Turn on MPP Capability===
===Turn on MPP Capability===
As of build 570, automatic MPP ([[Mesh Network Details|mesh portal]]) is turned off. If you want to turn it on, log in as root (either from the VT with Ctl+Alt+F1 or 'su -' from the Dev Console in sugar), and do:
In build 693 and later, automatic MPP ([[Mesh Network Details|mesh portal]]) is turned off. If you want to turn it on, edit /etc/NetworkManager/dispatcher.d/mpp.py and remove the line near the start which says 'exit 0'. Next time you connect to a network, the mesh portal will turn on.

In build 570 or so, automatic MPP ([[Mesh Network Details|mesh portal]]) is also turned off. If you want to turn it on in these early builds, log in as root (either from the VT with Ctl+Alt+F1 or 'su -' from the Dev Console in sugar), and do:


/sbin/chkconfig --level 345 NetworkManagerDispatcher on
/sbin/chkconfig --level 345 NetworkManagerDispatcher on
Line 238: Line 226:


Warning: Laptops in MPP mode will not participate properly in sharing with other XO laptops.
Warning: Laptops in MPP mode will not participate properly in sharing with other XO laptops.


==== MPP with ppp or eth0 ====

To make an XO into an MPP with PPP (modem) or Eth0 (usb-eth dongle): [[XO_with_USB_Cellular_Modem]]


===Mesh and WDS===
===Mesh and WDS===
Line 249: Line 242:
==Security==
==Security==


===Activation and Developer Keys===
===Activation and developer keys===


To learn about activation and developer's keys and how to un-secure a laptop, see [[Activation And Developer Keys]].
To learn about activation and developer's keys and how to un-secure a laptop, see [[Activation and Developer Keys]].


How to pre-activate a laptop: [[Pre-Activate an XO]]
How to pre-activate a laptop: [[Pre-Activate an XO]]


===Turning on/off Activity Isolation (containerization)===
===Turning on/off activity isolation (containerization)===


In Update.1 (build 630+), isolation is enabled.
In Update.1 (build 630+), isolation is enabled.


; To turn off isolation
TO TURN OFF ISOLATION:


''rm /etc/olpc-security && reboot''
''rm /etc/olpc-security && reboot''


; To re-enable isolation
TO RE-ENABLE ISOLATION:


''touch /etc/olpc-security && reboot''
''touch /etc/olpc-security && reboot''
Line 285: Line 278:
==Logs==
==Logs==


===What logs go with which Bugs===
===What logs go with which bugs===
* '''Activities'''
* '''Activities'''
** All activity logs are located in /home/olpc/.sugar/default/logs
** All activity logs are located in /home/olpc/.sugar/default/logs
Line 305: Line 298:
** dmesg (another circular buffer, which contains low level debugging information)
** dmesg (another circular buffer, which contains low level debugging information)


===Turn on All logs===
===Turn on all logs===
* See [[Attaching Sugar logs to tickets]]

* [[Telepathy-debug|Enable Telepathy log files]]
** [[Telepathy-debug]] has more on enabling Telepathy log files.
* Copy the /home/olpc/.xsession-example to /home/olpc/.xsession and modify the file to turn on whatever logging you want
** see: [http://wiki.laptop.org/go/Olpc-utils#.2Fhome.2Folpc.2F.xsession .xsession file]
* Restarting X will take the changes into effect.
** (ctrl + alt + backspace) when in the home view will do this.


===To turn on full kernel logging===
===To turn on full kernel logging===
Line 318: Line 307:
* add ignore_loglevel inside quotations
* add ignore_loglevel inside quotations


===Get Version info===
===Get version info===
See [[How to check the OS and firmware versions]].
* OS version: open a virtual terminal (ctrl-alt-mesh)

* OFW version: cat /ofw/openprom/model(better) or cat /ofw/ec-name
==School Server==
* Wireless firmware: in a virtual terminal type 'ethtool -i eth0'

* Boot2 version: cat /proc/bus/usb/devices | grep 1286
*[[XS_Configuration_Management#Example_Configurations|Example School Server install]]
*[[Schoolserver Testing]]
*[[School server network debugging]]
*[[Telepathy-debug]]


==Misc==
==Misc==


===Reformat a bad USB drive===
===Reformat a bad USB drive===
MAC:
# Insert the USB into your mac
# Open Disk Utility (which you can find in the applications/utilities directory)
# Click on '967.5 MB USB 2.0...', the usb disk on the left.
# Click on the Partition tab
# Click on Partition to reformat the USB (this erases everything on the stick)


See [[Firmware/Storage/Formats|more details]].
===Basic Linux Commands===


[http://www.ss64.com/bash/ A list of commands]
===Basic Linux commands===


(See [[Category:linux software]] )
* cd : change directory (e.g. cd {path to directory}
* pwd : print working directory (tells you what your current directory is)
* ls : lists all in the directory
* ls -al : lists everything in directory, including hidden directories
* nano : change a file (e.g. nano {path to file}) If the file is in the working directory, then you only need to type the file name.
* cp : copy (e.g. cp {path to file} {path to destination})
* -r : recursive (makes any command recursive, e.g. cp -r will copy the entire directory)
* rm : remove (e.g. rm {path to file})
* mount : mount a usb device (e.g. mount /media/{usb_stick_name} (usb sticks are in the /media directory)
* umount : unmount a usb device
* halt -p : shutdown
* wget : get file from web (e.g. wget {url_to_file}
* unzip : will unzip a file (use with .xo)
* ifconfig :shows network connections (enter command in root)


===Manufacturing data===


Manufacturing data describes the hardware of a laptop as well as its activation setting.
[[mfg-data]]




[[Category:Preparing for testing]]
[[category:tests]]
[[Category:XO localization]]
[[Category:XO localization]]

Latest revision as of 01:32, 18 November 2015

  Please copy/paste "{{Translationlist | xx | origlang=en | translated={{{translated}}}}}" (where xx is ISO 639 language code for your translation) to Test Config Notes/translations HowTo [ID# 298155]  +/-  


Builds & infrastructure

Step 0: get a developer key and do disable-security

Instructions for this are available at Activation and Developer Keys

olpc-update

This section has been moved to Olpc-update.

Firmware notes

To install a new firmware version: Manual Firmware Install

Fixing XO clock data

From build 693 on (maybe earlier), the time is set automatically the first time you connect to the network.

From build 641 on (maybe earlier), if you have a good internet connection you can set the date/time by logging in as root and typing:

 ntpdate pool.ntp.org

~~ You can find out the current date and time in a terminal window by typing "date". There is currently no way to get the clock to be on the "desktop" or home screen; but you could write that in Python as a change to Sugar-shell, and submit the improvement to the XO team! Let Love Flow Listen~~

On unupgraded early Give One Get One laptops, ntpdate may not be installed. You can set the date/time manually by logging in as root and typing:

 date

which will show the laptop's current time and date. Using the same date and time format returned by the date command, type:

 date --set "Mon Apr 1 etc. etc."

Some pre-test machines don't have valid manufacturing data. This isn't too much of a problem, but they also have clocks which are set to crazy values, which is. To fix this, boot and press Esc when prompted to get an OFW prompt. At the 'ok' prompt type:

clock-node @ iselect  decimal   00 40 16   14 09 2007  set-time

The numbers here are the time and date: second, minute, hour, day, month, year. You can substitute the current time and date if you like, but the machine will activate correctly as long as it has a somewhat-sane date. You can use the date above, for example.

Steps to fix bad clock value on write protected machines

Customizing a NAND image

Internationalization testing

All the information for Quanta to put into SPI flash to ensure a laptop will come up using the appropriate keyboard and language is described here: mfg-data

Kernel changelog analysis

At http://dev.laptop.org/~bert/joyride-pkgs.html is the joyride changelog. In it you'll see the version of the kernel. An example of a Kernel change is in joyride build #258, and the new version of the kernel for joyride build #258 is kernel.i586 0:2.6.22-20071111.5.olpc.c1d02f5e6853b99

You can find that information for _any_ kernel by running 'uname -r'.


That 'c1d02f5e6853b99' uniquely identifies the version of the kernel. You can look it up in git (or gitweb) and see the changelog for precisely that kernel: http://dev.laptop.org/git?p=olpc-2.6;a=log;h=c1d02f5e6853b99

From that page, you should fairly easily be able to work out whether the patch you're interested in is included or not.

Sugar & Activities

See Activities.

Check which activity version you have

In Release notes/8.2.0, the Home view in List view mode displays the version of each installed activity.

In any release, each activity's activity.info file has this information.

 cat ~olpc/Activities/Activity_name.activity/activity/activity.info 
    • There may still be activities in the old location /usr/share/activities/
  • Look for the activity_version setting.

Turning suspend/resume or screen saver off

You can turn off suspend/resume by typing:

 touch /etc/ohm/inhibit-suspend

To turn off power management:

  • For one boot (till the laptop is rebooted):
     /sbin/service ohmd stop
  • For all reboots:
    • As root, type:
     rpm -e ohm

To turn off the screen saver, type:

 xset dpms force off

Control panel

Keyboard shortcuts

Wireless & network

Removing network config settings

  1. Open a virtual terminal
  2. rm /home/olpc/.sugar/default/nm/network.config

Connectivity to Apple Extreme

  1. Goto: http://www.corecoding.com/utilities/wep2hex.php and convert the password into a hex phrase.
  2. Click on the AP in the neighborhood mesh view
  3. Choose Hex input for the key; and choose 'shared' key instead of 'open'.
  4. You should be able to associate and authenticate now.


Matrix of Wireless AP - Volunteer test results

Testing of different connection configurations

  1. Under a Tree
  2. Connected to AP
  3. One Laptop acting as MPP
  4. Same Mesh Same Server

Test the network and mesh details

Modify the mesh discovery sequence

You can put the following values in /etc/NetworkManager/mesh-start

  • school-mpp
  • infra
  • xo-mpp
  • local

These will control where the mesh device starts. Since the mesh device is the first device that gets picked at startup, this affects the immediate connection search of the laptop.

Remember, the current automatic connection cycle is this. You can jump to a specific step in this cycle by putting the string above into mesh-start.

/* Steps:
 *
 * 1. For each channel in [1, 6, 11]:
 *    a. try DHCP
 *    b. if DHCP times out, try next channel
 *    c. if DHCP response includes a non-link-local IP address,
 *      then CONNECTED/DONE
 *
 * 2. Try last successful AP connection
 *    a. if success then CONNECTED/DONE
 *
 * 3. For each channel in [1, 6, 11]
 *    a. try DHCP
 *    b. if DHCP times out, try next channel
 *    c. if DHCP response includes a link-local IP address,
 *      then acquire autoip address and apply DHCP settings (except for
 *      IP address), CONNECTED/DONE
 *
 * 4. Jump to channel 1
 *    a. acquire autoip address, CONNECTED/DONE
 */

Update the wireless firmware

Please note that you do NOT need to get newer versions of wireless firmware if you are running a released version of OS. All releases include an appropriate, tested version of wireless firmware. These notes are for testing purposes only.

  • You can check what version you are running with: ethtool -i eth0
  • Next download the latest Libertas firmware, (non-released, released), and unzip it with: tar xzf <filename>
  • Move, delete or rename the 'usb8388.bin' file that is currently being used in /lib/firmware/'
  • Copy the new 'usb8388.bin' file from where you unzipped it into /lib/firmware/' (if the .bin file has a name other than usb8388, change it to usb8388.bin)
  • You could Reboot, or simply rmmod usb8xxx ,then modprobe usb8xxx ; then check the version with: ethtool -i eth0

Turn on wireless debug

Instructions on how to enable driver debug can be found here.

Turn your XO into a sniffer

  1. Install tcpdump ('yum install tcpdump' will probably do it)
  2. killall NetworkManager
  3. ifconfig msh0 down
  4. ifconfig eth0 down
  5. echo ${TRAFFIC_MASK} > /sys/class/net/eth0/lbs_rtap
  6. ifconfig rtap0 up
  7. tcpdump -i rtap0 -w outputfile.dump
  8. when you done capturing traffic type ctrl-c

TRAFFIC_MASK bits:

  • Data frames: 0x1
  • Mgmt frames but beacons: 0x2
  • Beacons: 0x4

Capturing wireless data

Instructions for capturing wireless data can be found here.

Turn on MPP Capability

In build 693 and later, automatic MPP (mesh portal) is turned off. If you want to turn it on, edit /etc/NetworkManager/dispatcher.d/mpp.py and remove the line near the start which says 'exit 0'. Next time you connect to a network, the mesh portal will turn on.

In build 570 or so, automatic MPP (mesh portal) is also turned off. If you want to turn it on in these early builds, log in as root (either from the VT with Ctl+Alt+F1 or 'su -' from the Dev Console in sugar), and do:

 /sbin/chkconfig --level 345 NetworkManagerDispatcher on
 /sbin/service NetworkManagerDispatcher start

Next time you reboot (or the next time you click on an AP) the mesh portal will come back on.

Warning: Laptops in MPP mode will not participate properly in sharing with other XO laptops.


MPP with ppp or eth0

To make an XO into an MPP with PPP (modem) or Eth0 (usb-eth dongle): XO_with_USB_Cellular_Modem

Mesh and WDS

Some information on issues related to bad interactions between Linksys wireless routers and the XO can be found here.

Setting up Jabber server

Ejabberd Configuration

Security

Activation and developer keys

To learn about activation and developer's keys and how to un-secure a laptop, see Activation and Developer Keys.

How to pre-activate a laptop: Pre-Activate an XO

Turning on/off activity isolation (containerization)

In Update.1 (build 630+), isolation is enabled.

To turn off isolation
rm /etc/olpc-security && reboot
To re-enable isolation
touch /etc/olpc-security && reboot


In earlier joyride builds, to play with activity containerization, you should:

  1. rainbow-daemon
  2. touch /etc/olpc-security
  3. restart sugar (e.g. type Ctrl-Alt-Erase)
  4. try out various activities; perhaps examine the output of rainbow-daemon
  5. rm /etc/olpc-security
  6. restart sugar

Note: it is important that rainbow-daemon be running when Sugar restarts. Therefore, rainbow-daemon should be started either on a virtual terminal (i.e. after htting Ctrl-Alt-F1 [F1 is the mesh-key]) or over SSH.

Please direct questions and comments to me: --Michael Stone 13:02, 17 September 2007 (EDT)


Logs

What logs go with which bugs

  • Activities
    • All activity logs are located in /home/olpc/.sugar/default/logs
    • Activity logging is turned on by default in builds after 650/joyride 350
    • These logs will contain any warnings and or errors with tracebacks, which should help the developers debug their activity
    • Also, the shellservice.log will sometimes contain information as to why an activity failed to launch.
    • Note: each time you restart X, the old logs will be stored in a directory in the same location, and new ones will be generated.
  • Journal
    • There is a journal log in /home/olpc/.sugar/default/logs
    • Also, the datastore.log file often has implications for problems with the journal.
      • Especially with problems resuming files or transferring files to/from USB keys
  • Network/Collaboration Problems
    • /var/log/messages
      • This is a circular buffer, which contains a lot of low level debugging information
    • in /home/olpc/.sugar/default/logs
      • presenceservice.log contains higher level network debugging information
      • telepathy-gabble.log/telepathy-salut.log (logs for salut and gabble; the collaboration software)
  • Kernel Problems
    • dmesg (another circular buffer, which contains low level debugging information)

Turn on all logs

To turn on full kernel logging

  • cd /boot
  • modify olpc.fth
  • add ignore_loglevel inside quotations

Get version info

See How to check the OS and firmware versions.

School Server

Misc

Reformat a bad USB drive

See more details.

Basic Linux commands

(See )

Manufacturing data

Manufacturing data describes the hardware of a laptop as well as its activation setting. mfg-data