Application:MetaDoctor

Ok, I have no Linux experience whatsoever, so this should be a good "Meta Doctor For Dummies" Wiki.

Ill use confusedvorlon's initial Step-by-Step and add/edit the entries with more detail. Im stuck at step one right now, waiting for a new iso download so Ill finish editing this tomorrow.

Getting Ready

---

1) Download Ubuntu 9.04 . Then download a virtual machine either vmware or virtualbox. A virtual machine is simply a program that allows you to piggyback a second operating system on top of your Windows OS without dual booting or actually having a Linux machine.

-- I ended up using VirtualBox instead, because I found the VMware to be very confusing on what to actually download. The Virtual box website is very simple and straight forward. Here is the link for the virtualbox download:

http://download.virtualbox.org/virtualbox/3.0.8/VirtualBox-3.0.8-53140-Win.exe

Now install virtualbox just like you would install any other windows application, nothing fancy here.

Next start up virtualbox and follow either of these instructions to install Ubuntu

http://www.helpdeskgeek.com/linux-tips/how-to-install-ubuntu-in-virtualbox/ http://www.psychocats.net/ubuntu/virtualbox

2) Open terminal from the applications, accessories menu

  Type "sudo apt-get install git" and follow directions to install git

  Now type "git clone git://git.webos-internals.org/tools/meta-doctor.git"

(if necessary, follow the instructions to install git)

3) Type "sudo apt-get install patch" to make sure you have patch installed

4) install java (applications/add remove/show: all available applications/java 6 runtime)

  Easiest to search java to find it, then follow on screen instructions, should be pretty simple

5) install the palm sdk --- developer.palm.com

  Download the version for linux.  

6) Download the latest webosdoctor file from http://www.webos-internals.org/wiki/Webos_Doctor_Versions .The rw version is the German/UK GSM version.

  Rename the file.  webosdoctorp100eww-sprint-1.2.1.jar (or webosdoctorp100eww-wr-1.1.3.jar or webosdoctorp100eww-bellmo-1.2.1.jar)

Now things get somewhat tricky. Youll have to share these files from your windowsOS to the virtual ubuntu machine.

1. Make a folder on your windows desktop called "shared" (without quotes)

2. Copy both the palm SDK and the webosdoctorp100eww-sprint-1.2.1.jar into that folder

3. Now go to your Ubuntu VM, in the Virtualbox drop downs go to Devices>Install guest additions

4. This will mount an ISO image to the CD/Rom drive, open that directory and double click the "Autorun.sh" file and follow the onscreen instructions for installing the guest additions.

5. Now go to your ubuntu file browser and create a folder on the desktop named "shared"

6. Now follow these instructions

7. Once you have file sharing working open the shared folder on ubuntu and install the palm sdk.

8. Go to the file browser in ubuntu, find the "meta-doctor" folder, open it, and create a new folder inside there named "downloads"

9. Now copy the webosdoctor file from your shared folder into the downloads folder.

Doing it

---

5) navigate to the meta-doctor directory in the terminal by opening terminal and typing "cd meta-doctor" (without quotes)

Next type "make CARRIER=sprint unpack patch pack" if you are using the sprint file. Or type "make CARRIER=rw unpack patch pack" or "make CARRIER=bellmo unpack patch pack" for the other versions. This should begin a process within terminal that should take 10 minutes max. If a checksum error occurs you might want to try to download the webosdoctorp100eww from within the virtual box's browser.

6) The updated doctor version will be in the meta-doctor/build/pre... folder

7) You can try running the webosdoctor within the VM, but I had no luck with that. Easiest thing to do is to copy the new doctor image to that shared folder, then run it in Windows. Go here if you have problems