Application:MetaDoctor

From WebOS Internals
Revision as of 20:12, 31 October 2009 by Jack87 (talk | contribs) (→‎Doing it)
Jump to navigation Jump to search

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


Using Virtual Machine


1) Download Ubuntu 9.10. 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:

VirtualBox-3.0.10-54097-Win

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


Using WUBI this is another option to avoid using a virtual machine --Jack87 18:58, 31 October 2009 (UTC)


This guide will let you install it without harming your current installation of windows using simple Ubuntu installer called WUBI. Also no need for moding any partitions or installing any boot loaders. It will just appear as program in your installed software list and when you do not want it anymore simply uninstall it while in windows through Control Panel Super easy and not virtual machine headaches of trying to configure USB, Network and File sharing with host computer... To access it you just reboot and choose Uubuntu from dual boot screen.

1. download Ubuntu 9.10

2. burn to cd or mount to virtual drive

3. run cd in windows (the wubi.exe file inside the disk, it also comes up in auto run)

4. Click on Install Inside windows

this will install ubuntu while running windows without the need of making a partition I would recomand making the install image the full 30 gigs if you have the hard drive space and think you are interested in actually using the Ubuntu OS, otherwise the minimum recommended by Wubi should be just fine.

now restart and you can dual boot to windows/ubuntu


Nice thing about this is that it will allow you to uninstall ubuntu right from windows as if it was never there and remove the dual boot. Not to mention the fact you do not need to partition your drive.

If you are still wondering what Wubi is the fallowing link should explain it to you better. Wubi Guide

Note: this will only work with the cd image found at the Ubuntu Download link. The dvd image of 9.04/9.10 is a live cd/installer and does not have the option to install inside windows using Wubi


How do to access the Windows drives: The Windows partition where you installed Wubi is available as /host within Ubuntu (places > computer > file system > host) All the other partitions will be available under places > removable media

When in Linux



2) Open terminal from the applications, accessories menu. (all inputs without quotes throughout all steps of this procedure!)

  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>Ubuntu Software Center> type java 6 runtime in search)

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

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

  Download the version for linux.  Here

6) Download the latest webosdoctor file from Webos Doctor Versions .The wr version is the German/UK GSM version.

  Rename the file.  webosdoctorp100ewwsprint-1.2.1.jar (or webosdoctorp100eww-wr-1.1.3.jar or webosdoctorp100ewwbellmo-1.2.1.jar)


(If you are using Wubi installation of ubuntu ignore 6.1-6.7)

NOTE that the fallowing is assuming you downloaded the SDK and Doctor using windows side if you used your ubuntu virtual machine to download the files you can ignore 6.1-6.7


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

6.1. Make a folder on your windows desktop called "shared"

6.2. Copy both the palm SDK and the webosdoctorp100ewwsprint-1.2.1.jar into that folder

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

6.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. (After Installation you need to restart your Virtual machine.)

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

6.6. Now follow these instructions

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

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

6.9. Now copy the webosdoctor file into the downloads folder.


Doing it


7) navigate to the meta-doctor directory in the terminal by opening terminal and typing "cd meta-doctor"

Next type "make CARRIER=sprint unpack patch pack" if you are using the sprint file. Or type "make CARRIER=wr 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.

There are 2 known error conditions

- If an error message appears with unknown in a file name, check the file rename in step 6

- If a checksum error occurs you might want to try to download the webosdoctorp100eww from within the virtual box's browser. Rename that according to step 6, and probably start at step 7

8) The updated doctor version has the same name as the original, but is in a new folder: meta-doctor/build/pre-p100eww-sprint-1.2.1/webosdoctorp100ewwsprint-1.2.1.jar

9) 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

9a) If running step 9 on Windows: close the virtualbox before double clicking on the JAR file. (the box might prevent windows seeing the USB Pre when JAR asks to connect the Pre)

9b) If using Ubuntu via Wubi installation you can copy the Jar file to your windows partition by going to top of screen Places>Computer>FileSystem>host (/host) and copying it there. And after you reboot back into windows it will be on your C:\ drive you can run it from there

cp /meta-doctor/build/pre-p100eww-sprint-1.2.1/webosdoctorp100ewwsprint-1.2.1.jar /host/webosdoctorp100ewwsprint-1.2.1.jar