XS Community Edition/0.4/Testing: Difference between revisions
No edit summary |
|||
Line 9: | Line 9: | ||
=Installation= |
=Installation= |
||
Purpose |
Purpose |
||
# Verify the installation process works correctly. |
# Verify the installation process works correctly. |
||
Prerequisites |
Prerequisites |
||
# None |
# None |
||
Steps |
Steps |
||
# NOTE please use the command "wget http://xsce.activitycentral.com/repos/xsce-release.repo" to get the current branch. |
# NOTE please use the command "wget http://xsce.activitycentral.com/repos/xsce-release.repo" to get the current branch. |
||
# Install using the the [[User:Holt/XS_Community_Edition/0.4/Installing | instructions]] and a fresh OLPC-OS 13.2.0 or Fedora 18 install. |
# Install using the the [[User:Holt/XS_Community_Edition/0.4/Installing | instructions]] and a fresh OLPC-OS 13.2.0 or Fedora 18 install. |
||
Results |
Results |
||
# The install should complete without errors. |
# The install should complete without errors. |
||
Line 27: | Line 26: | ||
==External SD Card== |
==External SD Card== |
||
Purpose |
Purpose |
||
# Verify the External SD card used for additional storage is functional. |
# Verify the External SD card used for additional storage is functional. |
||
Prerequisites |
Prerequisites |
||
# SD card inserted into XO. |
# SD card inserted into XO. |
||
Steps |
Steps |
||
# Mount /dev/mmcblk0p1 |
# Mount /dev/mmcblk0p1 |
||
Results |
Results |
||
# Should report on /library |
# Should report on /library |
||
==External USB Drive== |
==External USB Drive== |
||
Purpose |
Purpose |
||
# If you are using an external USB hard drive, verify the External USB hard drive used for additional storage is functional. |
# If you are using an external USB hard drive, verify the External USB hard drive used for additional storage is functional. |
||
Prerequisites |
Prerequisites |
||
# External drive should be attached to XO via USB cable. |
# External drive should be attached to XO via USB cable. |
||
Steps |
Steps |
||
# ??? |
# ??? |
||
Results |
Results |
||
# ??? |
# ??? |
||
Line 59: | Line 58: | ||
# Verify the dynamic host configuration is functional. |
# Verify the dynamic host configuration is functional. |
||
Prerequisites |
Prerequisites |
||
# None |
# None |
||
Line 66: | Line 65: | ||
# Click on the name of your Access Point. |
# Click on the name of your Access Point. |
||
Results |
|||
Result |
|||
# After a few seconds the connections status will change to "Connected." |
# After a few seconds the connections status will change to "Connected." |
||
==Network Address Translation/NAT (iptables)== |
==Network Address Translation/NAT (iptables)== |
||
Purpose |
Purpose |
||
# Verify network address translation is functional. |
# Verify network address translation is functional. |
||
Line 76: | Line 75: | ||
# XO should be connected to XSCE. |
# XO should be connected to XSCE. |
||
Steps |
Steps |
||
# In a browser, go to https://mail.google.com (any site with HTTPS). |
# In a browser, go to https://mail.google.com (any site with HTTPS). |
||
Line 83: | Line 82: | ||
==Registration (idmgr)== |
==Registration (idmgr)== |
||
Purpose |
Purpose |
||
# Verify XO registration is functional. |
# Verify XO registration is functional. |
||
Prerequisites |
Prerequisites |
||
# XO should be connected to XSCE. |
# XO should be connected to XSCE. |
||
Steps |
Steps |
||
# Register the XSCE. |
# Register the XSCE. |
||
Results |
Results |
||
# Receive a message that registration was successful. |
# Receive a message that registration was successful. |
||
# Registration creates a directory named the XO's serial number in /library/users. |
# Registration creates a directory named the XO's serial number in /library/users. |
||
==XMPP Server (ejabberd)== |
==XMPP Server (ejabberd)== |
||
Purpose |
Purpose |
||
# Verify that the XMPP server is functional. |
# Verify that the XMPP server is functional. |
||
Prerequisites |
Prerequisites |
||
# XO should be registered. |
# XO should be registered. |
||
Steps |
Steps |
||
# If you get a message that registration failed, go to the Sugar Control Panel and in Network, clear out the collaboration server field. Upon successful registration, both XOs will appear in Network Neighborhood. |
# If you get a message that registration failed, go to the Sugar Control Panel and in Network, clear out the collaboration server field. Upon successful registration, both XOs will appear in Network Neighborhood. |
||
# To verify that ejabberd is managing collaboration and not the LAN, issue this in a root terminal: |
# To verify that ejabberd is managing collaboration and not the LAN, issue this in a root terminal: |
||
# ejabberdctl connected-users |
# ejabberdctl connected-users |
||
Results |
Results |
||
# ??? |
# ??? |
||
==XMPP based collaboration (ejabberd)== |
==XMPP based collaboration (ejabberd)== |
||
Purpose |
Purpose |
||
# Verify that the XMPP based collaboration is functional. |
# Verify that the XMPP based collaboration is functional. |
||
Prerequisites |
Prerequisites |
||
# 2 client XOs. |
# 2 client XOs. |
||
Steps |
Steps |
||
# On both XO's click on the same XSCE network |
# On both XO's click on the same XSCE network |
||
# Confirm that both units are on the same network |
# Confirm that both units are on the same network |
||
Line 130: | Line 129: | ||
# Follow the same steps, but starting with the second XO. (see that it works both ways) |
# Follow the same steps, but starting with the second XO. (see that it works both ways) |
||
Results |
Results |
||
# The shared chat activity shows up in the network view of both laptops |
# The shared chat activity shows up in the network view of both laptops |
||
# Whatever one laptop types in the chat window after both are connected is seen by both laptops |
# Whatever one laptop types in the chat window after both are connected is seen by both laptops |
||
Line 138: | Line 137: | ||
==Apache Web Server (httpd)== |
==Apache Web Server (httpd)== |
||
Purpose |
Purpose |
||
# Verify the web server is functional. |
# Verify the web server is functional. |
||
Prerequisites |
Prerequisites |
||
# XO should be connected to XSCE. |
# XO should be connected to XSCE. |
||
Steps |
Steps |
||
# Go to http://schoolserver and http://schoolserver.local. |
# Go to http://schoolserver and http://schoolserver.local. |
||
Results |
Results |
||
# Both should resolve to the XSCE homepage. |
# Both should resolve to the XSCE homepage. |
||
Line 154: | Line 153: | ||
#Verify Proxy caching is functional. |
#Verify Proxy caching is functional. |
||
Prerequisites |
Prerequisites |
||
#XO should be connected to XSCE. |
#XO should be connected to XSCE. |
||
Steps |
Steps |
||
# On XSCE Check the initial size of the squid cache directory: du -sk /library/cache. |
# On XSCE Check the initial size of the squid cache directory: du -sk /library/cache. |
||
# On XO open Browse Activity and surf the internet. |
# On XO open Browse Activity and surf the internet. |
||
# On XSCE Check the squid cache directory size again |
# On XSCE Check the squid cache directory size again |
||
Results |
Results |
||
# Cache size should increase |
# Cache size should increase |
||
==OLPC-update (rsync)== |
==OLPC-update (rsync)== |
||
Purpose |
Purpose |
||
# Verify OLPC-update is functional. |
# Verify OLPC-update is functional. |
||
Prerequisites |
Prerequisites |
||
# ??? |
# ??? |
||
Steps |
Steps |
||
# ??? |
# ??? |
||
Results |
Results |
||
# ??? |
# ??? |
||
Line 184: | Line 183: | ||
PLEASE NOTE: ds-backup is broken client side in 13.1.0 due to problem with ping being prevented. Please test against a client running 13.2.0 |
PLEASE NOTE: ds-backup is broken client side in 13.1.0 due to problem with ping being prevented. Please test against a client running 13.2.0 |
||
Purpose |
Purpose |
||
# Verify OLPC-back is functional. |
# Verify OLPC-back is functional. |
||
Prerequisites |
Prerequisites |
||
# XO should be connected to XSCE. |
# XO should be connected to XSCE. |
||
# XO should be registered. |
# XO should be registered. |
||
Steps |
Steps |
||
# rm /home/olpc/.sugar/default/ds-backup-done #delete the ds-backup-done if it exists. |
# rm /home/olpc/.sugar/default/ds-backup-done #delete the ds-backup-done if it exists. |
||
# /usr/bin/ds-backup.sh nosleep# run backup with the nosleep argument. |
# /usr/bin/ds-backup.sh nosleep# run backup with the nosleep argument. |
||
Results |
Results |
||
# On XO /home/olpc/.sugar/default/ds-backup-done should exist |
# On XO /home/olpc/.sugar/default/ds-backup-done should exist |
||
# On XSCE each successful backup run creates a new directory under `/library/users/<Serial Number>/datastore`. |
# On XSCE each successful backup run creates a new directory under `/library/users/<Serial Number>/datastore`. |
||
Line 202: | Line 201: | ||
==Activity Server (uses httpd)== |
==Activity Server (uses httpd)== |
||
Purpose |
Purpose |
||
# Verify http://schoolserver/activities resolves. |
# Verify http://schoolserver/activities resolves. |
||
Prerequisites |
Prerequisites |
||
# ??? |
# ??? |
||
Steps |
Steps |
||
# Upload an Activity to the school server by using a browser to navigate to http://schoolserver.local/upload_activity.php. |
# Upload an Activity to the school server by using a browser to navigate to http://schoolserver.local/upload_activity.php. |
||
# Click on "Choose File" |
# Click on "Choose File" |
||
Line 214: | Line 213: | ||
# Create a USB stick with the activities you want to install in a folder called xs-activity-server and create the md5sums as specified at http://dev.laptop.org/git/users/martin/xs-activity-server/tree/README |
# Create a USB stick with the activities you want to install in a folder called xs-activity-server and create the md5sums as specified at http://dev.laptop.org/git/users/martin/xs-activity-server/tree/README |
||
Results |
Results |
||
# Browse to the root directory of the schoolserver and click on the "Download an Activity" link. You should see the activities you uploaded on the resulting page. |
# Browse to the root directory of the schoolserver and click on the "Download an Activity" link. You should see the activities you uploaded on the resulting page. |
||
==Virtual Private Network (OpenVPN)== |
==Virtual Private Network (OpenVPN)== |
||
Purpose |
Purpose |
||
# Verify VPN is functional. See http://wiki.laptop.org/go/Setting_Up_an_XSCE_VPN |
# Verify VPN is functional. See http://wiki.laptop.org/go/Setting_Up_an_XSCE_VPN |
||
Prerequisites |
Prerequisites |
||
# ??? |
# ??? |
||
Steps |
Steps |
||
# ??? |
# ??? |
||
Results |
Results |
||
# ??? |
# ??? |
||
==Statistics Collection - Pending Santi/Anish== |
==Statistics Collection - Pending Santi/Anish== |
||
Purpose |
Purpose |
||
# Verify Statistics collection is functional. |
# Verify Statistics collection is functional. |
||
Prerequisites |
Prerequisites |
||
# ??? |
# ??? |
||
Steps |
Steps |
||
# ??? |
# ??? |
||
Results |
Results |
||
# ??? |
# ??? |
||
==Book server(Pathagar) - Pending Sameer/Seth== |
==Book server(Pathagar) - Pending Sameer/Seth== |
||
Purpose |
Purpose |
||
# Verify book server is functional. |
# Verify book server is functional. |
||
Prerequisites |
Prerequisites |
||
# ??? |
# ??? |
||
Steps |
Steps |
||
# ??? |
# ??? |
||
Results |
Results |
||
# ??? |
# ??? |
||
Line 291: | Line 290: | ||
==Internet-in-a-Box - Pending Braddock== |
==Internet-in-a-Box - Pending Braddock== |
||
Purpose |
Purpose |
||
# |
# |
||
Prerequisites |
Prerequisites |
||
# You need an Internet-in-a-Box hard drive. If used with the XO-1.5, the external hard drive requires a powered USB Hub to power up properly. |
# You need an Internet-in-a-Box hard drive. If used with the XO-1.5, the external hard drive requires a powered USB Hub to power up properly. |
||
Steps |
Steps |
||
Verify Internet in Box is functional. |
# Verify Internet in Box is functional. |
||
# Browse to the root directory of the schoolserver and click on the "Internet-In-A-Box" link. You should see the IIAB home page displayed. |
# Browse to the root directory of the schoolserver and click on the "Internet-In-A-Box" link. You should see the IIAB home page displayed. |
||
Results |
Results |
||
# ??? |
# ??? |
||
Revision as of 13:59, 19 August 2013
XSCE Smoke Test
This set of test cases represents a quick smoke test that a build should pass. Please file bugs at https://sugardextrose.org/projects/xsce/issues
Tests are run against reference hardware first, generally XO-1.75 and XO-4 Touch and Trim-Slice. We ask your help running against more hardware variations serving global implementers' and contributors' needs.
Please see our evolving table of smoke test results.
Installation
Purpose
- Verify the installation process works correctly.
Prerequisites
- None
Steps
- NOTE please use the command "wget http://xsce.activitycentral.com/repos/xsce-release.repo" to get the current branch.
- Install using the the instructions and a fresh OLPC-OS 13.2.0 or Fedora 18 install.
Results
- The install should complete without errors.
Hardware
The XSCE can detect and utilize several types of hardware.
External SD Card
Purpose
- Verify the External SD card used for additional storage is functional.
Prerequisites
- SD card inserted into XO.
Steps
- Mount /dev/mmcblk0p1
Results
- Should report on /library
External USB Drive
Purpose
- If you are using an external USB hard drive, verify the External USB hard drive used for additional storage is functional.
Prerequisites
- External drive should be attached to XO via USB cable.
Steps
- ???
Results
- ???
Core Service
Core service should be tested using a School Server and a 'client' XO running 13.1.0.
Dynamic Host Configuration (dhcpd)
Purpose
- Verify the dynamic host configuration is functional.
Prerequisites
- None
Steps
- Go to my neighborhood.
- Click on the name of your Access Point.
Results
- After a few seconds the connections status will change to "Connected."
Network Address Translation/NAT (iptables)
Purpose
- Verify network address translation is functional.
Prerequisites
- XO should be connected to XSCE.
Steps
- In a browser, go to https://mail.google.com (any site with HTTPS).
Results
- Site should open correctly.
Registration (idmgr)
Purpose
- Verify XO registration is functional.
Prerequisites
- XO should be connected to XSCE.
Steps
- Register the XSCE.
Results
- Receive a message that registration was successful.
- Registration creates a directory named the XO's serial number in /library/users.
XMPP Server (ejabberd)
Purpose
- Verify that the XMPP server is functional.
Prerequisites
- XO should be registered.
Steps
- If you get a message that registration failed, go to the Sugar Control Panel and in Network, clear out the collaboration server field. Upon successful registration, both XOs will appear in Network Neighborhood.
- To verify that ejabberd is managing collaboration and not the LAN, issue this in a root terminal:
- ejabberdctl connected-users
Results
- ???
XMPP based collaboration (ejabberd)
Purpose
- Verify that the XMPP based collaboration is functional.
Prerequisites
- 2 client XOs.
Steps
- On both XO's click on the same XSCE network
- Confirm that both units are on the same network
- Open chat with one XO
- Share the activity with the neighborhood
- Go to the Network view of that XO
- Go to the Network view of the second XO
- In the network view of the second XO click on the chat activity that the first one just shared
- Type a few lines in the chat activity on each XO
- Close the chat activity on both XOs
- Follow the same steps, but starting with the second XO. (see that it works both ways)
Results
- The shared chat activity shows up in the network view of both laptops
- Whatever one laptop types in the chat window after both are connected is seen by both laptops
- Chat works both ways and on all three networks
Extended Service
Apache Web Server (httpd)
Purpose
- Verify the web server is functional.
Prerequisites
- XO should be connected to XSCE.
Steps
- Go to http://schoolserver and http://schoolserver.local.
Results
- Both should resolve to the XSCE homepage.
Proxy Caching (squid)
Purpose.
- Verify Proxy caching is functional.
Prerequisites
- XO should be connected to XSCE.
Steps
- On XSCE Check the initial size of the squid cache directory: du -sk /library/cache.
- On XO open Browse Activity and surf the internet.
- On XSCE Check the squid cache directory size again
Results
- Cache size should increase
OLPC-update (rsync)
Purpose
- Verify OLPC-update is functional.
Prerequisites
- ???
Steps
- ???
Results
- ???
http://dev.laptop.org/git/users/martin/xs-rsync/tree/README
OLPC-backup
PLEASE NOTE: ds-backup is broken client side in 13.1.0 due to problem with ping being prevented. Please test against a client running 13.2.0
Purpose
- Verify OLPC-back is functional.
Prerequisites
- XO should be connected to XSCE.
- XO should be registered.
Steps
- rm /home/olpc/.sugar/default/ds-backup-done #delete the ds-backup-done if it exists.
- /usr/bin/ds-backup.sh nosleep# run backup with the nosleep argument.
Results
- On XO /home/olpc/.sugar/default/ds-backup-done should exist
- On XSCE each successful backup run creates a new directory under `/library/users/<Serial Number>/datastore`.
Please see http://wiki.laptop.org/go/XS_Blueprints:Datastore_Simple_Backup_and_Restore for more information
Activity Server (uses httpd)
Purpose
- Verify http://schoolserver/activities resolves.
Prerequisites
- ???
Steps
- Upload an Activity to the school server by using a browser to navigate to http://schoolserver.local/upload_activity.php.
- Click on "Choose File"
- Use the file chooser to indicate which Activity you would like to upload.
- Create a USB stick with the activities you want to install in a folder called xs-activity-server and create the md5sums as specified at http://dev.laptop.org/git/users/martin/xs-activity-server/tree/README
Results
- Browse to the root directory of the schoolserver and click on the "Download an Activity" link. You should see the activities you uploaded on the resulting page.
Virtual Private Network (OpenVPN)
Purpose
- Verify VPN is functional. See http://wiki.laptop.org/go/Setting_Up_an_XSCE_VPN
Prerequisites
- ???
Steps
- ???
Results
- ???
Statistics Collection - Pending Santi/Anish
Purpose
- Verify Statistics collection is functional.
Prerequisites
- ???
Steps
- ???
Results
- ???
Book server(Pathagar) - Pending Sameer/Seth
Purpose
- Verify book server is functional.
Prerequisites
- ???
Steps
- ???
Results
- ???
Ejabberd Web Interface ???
This isn't necessary for testing, but is fun to poke around in:
Register the admin user: ejabberdctl register admin schoolserver.local <password>
In a browser, go to http://schoolserver.local:5280/admin
The username is admin@schoolserver.local and the password is whatever you set above.
Using Pidgin to Monitor Ejabberd
When testing the XSCE, it can be helpful to see at a glance which XO clients have successfully connected to the ejabberd server. Pidgin is a cross platform XMPP client you can use to connect to the schoolserver's ejabberd server from any Windows/Linux/Mac computer. Connected XO clients will appear in the Buddy List.
In the Buddy List window, go to Accounts -> Manage Accounts. Click Add.
In the Basic tab under Login Options, enter the following values:
Protocol: XMPP Username: yourname Domain: schoolserver.local Resource: pidgin Password: yourpassword
Check "Remember password"
In the Advanced tab, enter the following values:
Connection security: Use old-style SSL Connect port: 5223 Connect server: schoolserver.local
At the very bottom of the "Modify Account" window, check "Create this new account on the server." Click Add, then a registration box will pop up. Click Register, then you should get a pop up box that registration was successful. Click close. In the Accounts box, click the tick box in the "Enabled" column next to your username. If a box pops up for the server certificate, click Accept.
Now in the Buddy List, you should see the XOs that are currently connected to the XSCE's ejabberd server.
Internet-in-a-Box - Pending Braddock
Purpose
Prerequisites
- You need an Internet-in-a-Box hard drive. If used with the XO-1.5, the external hard drive requires a powered USB Hub to power up properly.
Steps
- Verify Internet in Box is functional.
- Browse to the root directory of the schoolserver and click on the "Internet-In-A-Box" link. You should see the IIAB home page displayed.
Results
- ???