Contents

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. All of the standard webos-internals disclaimers apply. 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

The binary the developer will give you is named LunaSysMgr.

You are using your browser to download files to your default download directory, ~/Downloads.

"~" 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).

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.

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:% /usr/local/bin/palm-install ~/Downloads/org.webosports.palm-lunasysmgr_3.0.5-3_arm.ipk% novacom run -- file:///sbin/rebootThis will install the stock ipkg and reboot your TouchPad.

If your TouchPad is still borked, it's probably time for the webOS Doctor.

Eject your TouchPad and disconnect it from your computer to take it out of USB mode.

NOW you're ready to test.

Work out with the developer you're helping where you're downloading the test LunaSysMgr binary and any tweaks .json file(s) from and what the MD5sum fingerprint of each file is.

Download it to ~/Downloads.

Open a terminal window (Linux) or Terminal.app (OS X).

Using that window, go to your downloads directory and check the MD5 fingerprint of the binary, which should match the fingerprint the developer gave you.

for Linux type% md5sum ~/Downloads/LunaSysMgrIf there are any .json files run the following on each of them. Be sure to replace new_tweak with the name of the file the developer gave you.% md5sum ~/Downloads/new_tweak.json

for OS X type% md5 ~/Downloads/LunaSysMgrIf there are any .json files run the following on each of them. Be sure to replace new_tweak with the name of the file the developer gave you.% md5 ~/Downloads/new_tweak.json

If the fingerprint strings do not match, discuss it with the developer. It could be a one time problem, or you may have to work out a different way to obtain a copy of the binary.

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:% novacom run -- file:///sbin/stop LunaSysMgr% novacom run file://bin/mount -- -o remount,rw /% novacom put file:///usr/bin/LunaSysMgr < ~/Downloads/LunaSysMgr% novacom run file://bin/mount -- -o remount,ro /% novacom run -- file:///sbin/rebootThis 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.