Difference between revisions of "Application:MetaDoctor"

From WebOS Internals
Jump to navigation Jump to search
m (correct mentioning the right step (7 iso step 10))
(Added Wubi instructions and some minor clearification notes as well as cleaned up linkes and updated ubuntu version number. -Jack87)
Line 4: Line 4:
  
  
Getting Ready
+
 
 +
== 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.
+
'''''Using Virtual Machine'''''
 +
 
 +
----
 +
 
 +
1) Download [http://www.ubuntu.com/getubuntu/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:
 
-- 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
+
[http://download.virtualbox.org/virtualbox/3.0.10/VirtualBox-3.0.10-54097-Win.exe VirtualBox-3.0.10-54097-Win]
  
 
Now install virtualbox just like you would install any other windows application, nothing fancy here.
 
Now install virtualbox just like you would install any other windows application, nothing fancy here.
Line 17: Line 23:
  
 
http://www.helpdeskgeek.com/linux-tips/how-to-install-ubuntu-in-virtualbox/
 
http://www.helpdeskgeek.com/linux-tips/how-to-install-ubuntu-in-virtualbox/
 +
 
http://www.psychocats.net/ubuntu/virtualbox
 
http://www.psychocats.net/ubuntu/virtualbox
 +
 +
----
 +
 +
'''''Using WUBI this is another option to avoid using a virtual machine''''' --[[User:Jack87|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 [http://www.ubuntu.com/getubuntu/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.
 +
https://wiki.ubuntu.com/WubiGuide
 +
 +
'''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!)
 
2) Open terminal from the applications, accessories menu. (all inputs without quotes throughout all steps of this procedure!)
Line 28: Line 70:
 
3) Type "sudo apt-get install patch" to make sure you have patch installed
 
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)
+
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
 
   Easiest to search java to find it, then follow on screen instructions, should be pretty simple
  
5) install the palm sdk ---  developer.palm.com
+
5) Download and install the palm sdk ---  developer.palm.com
  
   Download the version for linux.   
+
   Download the version for linux.  [https://cdn.downloads.palm.com/sdkdownloads/1.2.0.33/sdkBinaries/palm-sdk_1.2.0-svn202408-sdk77-pho33_i386.deb Here]
  
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.
+
6) Download the latest webosdoctor file from [http://www.webos-internals.org/wiki/Webos_Doctor_Versions 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)
 
   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.
 
Now things get somewhat tricky.  Youll have to share these files from your windowsOS to the virtual ubuntu machine.
Line 57: Line 106:
 
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.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 from your shared folder into the downloads folder.
+
6.9.  Now copy the webosdoctor file into the downloads folder.
  
  
Doing it
+
 
 +
== Doing it ==
 +
 
 
-----------
 
-----------
 
7) navigate to the meta-doctor directory in the terminal by opening terminal and typing "cd meta-doctor"  
 
7) navigate to the meta-doctor directory in the terminal by opening terminal and typing "cd meta-doctor"  
Line 78: Line 129:
  
 
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)
 
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 wherever you like. And then running it after you reboot back into windows

Revision as of 19:58, 31 October 2009

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. https://wiki.ubuntu.com/WubiGuide

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 wherever you like. And then running it after you reboot back into windows