Difference between revisions of "Testing LunaCE"

From WebOS-Ports
Jump to: navigation, search
 
(39 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This is my outline! Lots more to come! :)
+
==Introduction==
<pre>
+
The intent of this page is to provide a tester who may have far more enthusiasm than knowledge of webOS software development with some basic information on what they're doing, a set of commands that they can cut and paste into a terminal window and some reference material. The webos-internals [http://www.webos-internals.org/wiki/WebOS_Internals:General_disclaimer disclaimer] and [http://testing.preware.org/ testing feeds rules] all apply here. While it's highly unlikely, you '''can''' brick your TouchPad while testing. Be prepared to need to recover LunaSysMgr with palm-install (part of the SDK-PDK), or to have to use the webOS doctor to restore webOS, or to lose all of your data. Those last three are all covered below.
download file per dev's instructions
 
open xterm/terminal.app
 
cd ~/Download
 
check md5sum (need mac: /sbin/md5 LunaSysMgr & linux /usr/bin/md5sum commands)
 
install with novacom
 
novacom run -- file:///sbin/stop LunaSysMgr
 
novacom run file://bin/mount -- -o remount,rw /
 
novacom put file:///usr/bin/LunaSysMgr < ./LunaSysMgr
 
novacom run file://bin/mount -- -o remount,ro /
 
novacom run -- file:///sbin/reboot
 
</pre>
 
rwhitby sez best recovery method is palm-install the recovery ipk downloaded manually
 
  
===Notes and Assumptions===
+
==Notes and Assumptions==
 +
*"<code>~</code>" is Unix/Linux shorthand for the location of your home directory.
 +
*"<code>%</code>" represents the command prompt in your terminal window.
 +
*The commands you are to cut and paste are in <code>'''bold'''</code>.
 +
*Do not include the "<code>%</code>" when you cut and paste (it's ok if you include the space between the "<code>%</code>" and the command).
 
*You have at least skimmed WebOS Internals' [http://www.webos-internals.org/wiki/Basic_Linux_Use Basic Linux Use] page.
 
*You have at least skimmed WebOS Internals' [http://www.webos-internals.org/wiki/Basic_Linux_Use Basic Linux Use] page.
*You are downloading files to your default download directory, ~/Downloads, using your browser.
+
*Unless you're intending to try your hand at building WOCE, you don't need to install VirtualBox.
*"~" is Unix/Linux shorthand for the location of your home directory.
 
*"%" represents the command prompt in your terminal window.
 
*The commands you can cut and paste are in '''bold'''.
 
  
===Requirements===
+
==Requirements==
 
*Computer running Ubuntu Linux or Mac OS X
 
*Computer running Ubuntu Linux or Mac OS X
*'Developer Mode' enabled on your TouchPad ([https://developer.palm.com/content/api/dev-guide/tools/enabling-developer-mode.html How To Enable Developer Mode])
+
*'Developer Mode' is enabled on your TouchPad ([https://developer.palm.com/content/api/dev-guide/tools/enabling-developer-mode.html How To Enable Developer Mode])
 +
*Install git.
 
*Install the appropriate versions of the Palm SDK-PDK (you will need this if you have to recover) and novacom on your computer (the novacom install is on the SDK-PDK install page).
 
*Install the appropriate versions of the Palm SDK-PDK (you will need this if you have to recover) and novacom on your computer (the novacom install is on the SDK-PDK install page).
 
**[https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Installing the SDK-PDK on Linux]
 
**[https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Installing the SDK-PDK on Linux]
 
**[https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#osx Installing the SDK-PDK on OS X]
 
**[https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#osx Installing the SDK-PDK on OS X]
*Install Save/Restore from Preware on your TouchPad and set it to back up your app data daily.
+
*Install [http://www.webos-internals.org/wiki/Application:SaveRestore Save/Restore] from [http://www.webos-internals.org/wiki/Application:Preware Preware] on your TouchPad and set it to back up your app data daily.
 
*Check that the Palm Backup app backups are "on" and that your data is being backed up to their servers daily.
 
*Check that the Palm Backup app backups are "on" and that your data is being backed up to their servers daily.
 +
*[http://www.webos-internals.org/wiki/WebOS_Internals:Site_support Donate to webos-internals.] Yes, right now. We'll wait :)
  
 
+
==How to Recover==
===How to Recover===
 
 
#Download the stock [http://ipkg.preware.org:8080/feeds/woce/org.webosports.palm-lunasysmgr_3.0.5-3_arm.ipk Palm LunaSysMgr 3.0.5-3] to your computer. This is the same recovery package that you can install with Preware, but if something goes really wrong, you won't be able to run Preware.
 
#Download the stock [http://ipkg.preware.org:8080/feeds/woce/org.webosports.palm-lunasysmgr_3.0.5-3_arm.ipk Palm LunaSysMgr 3.0.5-3] to your computer. This is the same recovery package that you can install with Preware, but if something goes really wrong, you won't be able to run Preware.
 
#Open a terminal window (Linux) or Terminal.app (OS X).
 
#Open a terminal window (Linux) or Terminal.app (OS X).
#Using that window, go to your downloads directory and check the MD5sum (fingerprint) of the ipkg, which should match this string: 20501828cc5b29200a0a3feaf8535dd4
+
#Using that window, go to your downloads directory and check the MD5 fingerprint of the ipkg, which should match this string: <code>'''20501828cc5b29200a0a3feaf8535dd4'''</code>
#*for Linux type<br>% '''cd ~/Downloads'''<br>% '''md5sum org.webosports.palm-lunasysmgr_3.0.5-3_arm.ipk'''
+
#*for Linux type
#*for OS X type<br>% '''cd ~/Downloads'''<br>% '''md5 org.webosports.palm-lunasysmgr_3.0.5-3_arm.ipk'''
+
#*:<code>% '''md5sum ~/Downloads/org.webosports.palm-lunasysmgr_3.0.5-3_arm.ipk'''</code>
#If the fingerprint strings do not match, something may have gone wrong. Delete the file you just downloaded and download another copy.
+
#*for OS X type
 +
#*:<code>% '''md5 ~/Downloads/org.webosports.palm-lunasysmgr_3.0.5-3_arm.ipk'''</code>
 +
#If the fingerprint strings do not match, something may have gone wrong. Delete the file you just downloaded and download another copy. If they still don't match, let the developer you're working with know and/or send a PM via the [http://forums.webosnation.com/ webOS Nation forums] to member lagoldste.
 +
#If it's not still connected from doing the install, connect your TouchPad via USB to your computer.
 +
#From your TouchPad, when the connection is detected, just tap 'Close' in the notification window.
 +
#Go back to the terminal window on your computer and type:
 +
#:<code>% '''/usr/local/bin/palm-install ~/Downloads/org.webosports.palm-lunasysmgr_3.0.5-3_arm.ipk'''</code>
 +
#:<code>% '''novacom run -- file:///sbin/reboot'''</code>
 +
#:This will install the stock ipkg and reboot your TouchPad.
 +
 
 +
*If your TouchPad is still borked, it's probably time for the [http://www.palm.com/ROM webOS Doctor].
 +
 
 +
==Installing a LunaSysMgr pre-release test binary==
 +
*Before you do anything else:
 +
**Run a Save/Restore backup.
 +
**Run a Palm Backup app backup.
 +
**Connect your TouchPad via USB to your computer, put it in USB mode, and copy the entire USB drive folder to your computer.
 +
**Eject your TouchPad and disconnect it from your computer to take it out of USB mode.
 +
 
 +
'''NOW''' you're ready to test.
 +
 
 +
#Connect your TouchPad via USB to your computer.
 +
#From your TouchPad, when the connection is detected, just tap 'Close' in the notification window.
 +
#Go to the terminal window on your computer, download the binary from the WOCE git repository and install it on your TouchPad.
 +
#*If this is your first time testing, you need to clone the repository:
 +
#:<code>% '''cd'''</code>
 +
#:<code>% '''git clone https://github.com/woce/LunaSysMgr-binaries'''</code>
 +
#:<code>% '''cd ./LunaSysMgr-binaries'''</code>
 +
#:<code>% '''bash ./install.sh'''</code>
 +
#*If you already have a copy of the repository:
 +
#:<code>% '''cd ~/LunaSysMgr-binaries'''</code>
 +
#:<code>% '''git pull'''</code>
 +
#:<code>% '''bash ./install.sh'''</code>
 +
#*Note: The script will stop the LunaSysMgr that is currently installed on the TouchPad, make the root filesystem writeable, copy over the test LunaSysMgr, make the root filesystem read only again and reboot the TouchPad.
 +
 
 +
Have fun testing :)
 +
 
 +
==Is it a LunaCE related issue?==
 +
From [[Contributors#rwhitby | rwhitby]]:
 +
 
 +
This is the required test sequence for any person who is beta testing, to prove whether the issue is related to LunaCE or not.
  
[http://www.palm.com/ROM webOS Doctor]
+
#Install Palm LunaSysMgr ; reboot ; test.
 +
#Install LunaCE ; reboot ; test
 +
#Install Palm LunaSysMgr ; reboot ; test
 +
#Install LunaCE ; reboot ; test
  
===Installing a LunaSysMgr pre-alpha test binary===
+
If it is repeatable in that sequence, then please open a ticket in the [[Issue_Tracking | Issue Tracker]].
#Before you do anything else:
 
##Run a Save/Restore backup.
 
##Run a Palm Backup app backup.
 
##Connect your TouchPad to your computer, put it in USB mode, and copy the entire USB drive folder to your computer.
 

Latest revision as of 07:43, 21 November 2013

Introduction

The intent of this page is to provide a tester who may have far more enthusiasm than knowledge of webOS software development with some basic information on what they're doing, a set of commands that they can cut and paste into a terminal window and some reference material. The webos-internals disclaimer and testing feeds rules all apply here. While it's highly unlikely, you can brick your TouchPad while testing. Be prepared to need to recover LunaSysMgr with palm-install (part of the SDK-PDK), or to have to use the webOS doctor to restore webOS, or to lose all of your data. Those last three are all covered below.

Notes and Assumptions

  • "~" is Unix/Linux shorthand for the location of your home directory.
  • "%" represents the command prompt in your terminal window.
  • The commands you are to cut and paste are in bold.
  • Do not include the "%" when you cut and paste (it's ok if you include the space between the "%" and the command).
  • You have at least skimmed WebOS Internals' Basic Linux Use page.
  • Unless you're intending to try your hand at building WOCE, you don't need to install VirtualBox.

Requirements

How to Recover

  1. Download the stock Palm LunaSysMgr 3.0.5-3 to your computer. This is the same recovery package that you can install with Preware, but if something goes really wrong, you won't be able to run Preware.
  2. Open a terminal window (Linux) or Terminal.app (OS X).
  3. Using that window, go to your downloads directory and check the MD5 fingerprint of the ipkg, which should match this string: 20501828cc5b29200a0a3feaf8535dd4
    • for Linux type
      % md5sum ~/Downloads/org.webosports.palm-lunasysmgr_3.0.5-3_arm.ipk
    • for OS X type
      % md5 ~/Downloads/org.webosports.palm-lunasysmgr_3.0.5-3_arm.ipk
  4. If the fingerprint strings do not match, something may have gone wrong. Delete the file you just downloaded and download another copy. If they still don't match, let the developer you're working with know and/or send a PM via the webOS Nation forums to member lagoldste.
  5. If it's not still connected from doing the install, connect your TouchPad via USB to your computer.
  6. From your TouchPad, when the connection is detected, just tap 'Close' in the notification window.
  7. Go back to the terminal window on your computer and type:
    % /usr/local/bin/palm-install ~/Downloads/org.webosports.palm-lunasysmgr_3.0.5-3_arm.ipk
    % novacom run -- file:///sbin/reboot
    This will install the stock ipkg and reboot your TouchPad.
  • If your TouchPad is still borked, it's probably time for the webOS Doctor.

Installing a LunaSysMgr pre-release test binary

  • Before you do anything else:
    • Run a Save/Restore backup.
    • Run a Palm Backup app backup.
    • Connect your TouchPad via USB to your computer, put it in USB mode, and copy the entire USB drive folder to your computer.
    • Eject your TouchPad and disconnect it from your computer to take it out of USB mode.

NOW you're ready to test.

  1. Connect your TouchPad via USB to your computer.
  2. From your TouchPad, when the connection is detected, just tap 'Close' in the notification window.
  3. Go to the terminal window on your computer, download the binary from the WOCE git repository and install it on your TouchPad.
    • If this is your first time testing, you need to clone the repository:
    % cd
    % git clone https://github.com/woce/LunaSysMgr-binaries
    % cd ./LunaSysMgr-binaries
    % bash ./install.sh
    • If you already have a copy of the repository:
    % cd ~/LunaSysMgr-binaries
    % git pull
    % bash ./install.sh
    • Note: The script will stop the LunaSysMgr that is currently installed on the TouchPad, make the root filesystem writeable, copy over the test LunaSysMgr, make the root filesystem read only again and reboot the TouchPad.

Have fun testing :)

Is it a LunaCE related issue?

From rwhitby:

This is the required test sequence for any person who is beta testing, to prove whether the issue is related to LunaCE or not.

  1. Install Palm LunaSysMgr ; reboot ; test.
  2. Install LunaCE ; reboot ; test
  3. Install Palm LunaSysMgr ; reboot ; test
  4. Install LunaCE ; reboot ; test

If it is repeatable in that sequence, then please open a ticket in the Issue Tracker.