Difference between revisions of "Application:MetaDoctor"

From WebOS Internals
Jump to navigation Jump to search
(massive reorganization)
Line 1: Line 1:
== Getting Ready ==
+
== Next, how to change a provider's DB-entry so 3G data can be used on the Pre==
 +
-
 +
==If the Doctor will not run==
 +
+
 +
[http://forums.precentral.net/gsm-pre/210030-carrier-apn-settings-1-13-german-1-21-us-2.html#post1990055 This post] and [http://forums.precentral.net/palm-pre/209222-few-questions-about-german-palm-pre-6.html this thread] describe various ways to adjust
 +
-
 +
Go [http://www.webos-internals.org/wiki/How_To_Recover here] if you have further problems connecting your Pre to the running Meta'ed Doctor.
 +
+
 +
the provider's data base in the Pre, so the 3G datacom works on non-supported networks. This can only be done after activation has been completed over WiFi.
  
'''''Using a 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:
+
= What is the Meta Doctor? =
  
[http://download.virtualbox.org/virtualbox/3.0.10/VirtualBox-3.0.10-54097-Win.exe VirtualBox-3.0.10-54097-Win]
+
The Webos Internals Meta Doctor is a set of shell scripts which modify a copy of the Palm Webos Doctor to bypass the "First Use" application and allow the phone to run without having been activated on a cell network.  
  
Now install virtualbox just like you would install any other windows application, nothing fancy here.
+
They reach into Palm's distributed Doctor jar file and make changes which prevent the first use app from running.
  
Next start up virtualbox and follow either of these instructions to install Ubuntu
+
If you are on a Linux system, the process is very easy: 
  
http://www.helpdeskgeek.com/linux-tips/how-to-install-ubuntu-in-virtualbox/
+
If you are on a Windows or Mac system, you will need to find a Linux system, or you will need to install a virtual machine.  Detailed instructions for that are below under ''[[Application:MetaDoctor#Using_a_Virtual_Machine | Using a Virtual Machine]]''.
  
http://www.psychocats.net/ubuntu/virtualbox
+
=Using the Meta-Doctor in Linux=
 
 
----
 
 
 
'''''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 there is no 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 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) It is 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 [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 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  [http://ubuntuexperiment.wordpress.com/2008/11/12/sharing-folders-between-host-and-guest-os-in-virtualbox/ 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.
 
  
 +
== Getting Ready ==
  
 +
# Open terminal from the applications, accessories menu.
 +
# If you have git installed, skip this step.  If you do not have git installed, type: <pre>sudo apt-get install git</pre> and follow the directions to install git.
 +
# Now type: <pre>git clone git://git.webos-internals.org/tools/meta-doctor.git</pre>
 +
# Type <pre>sudo apt-get install patch</pre> to make sure you have patch installed.
 +
#If you do not have java installed do so. To install java, choose (applications>Ubuntu Software Center> type '''java 6 runtime''' in search) It is easiest to search for java to find it, then follow the on screen instructions. It should be pretty simple.
 +
# Download and install the palm sdk from http://developer.palm.com. 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].
 +
# 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 that you download to webosdoctorp100ewwsprint-1.2.1.jar (or webosdoctorp100eww-wr-1.1.3.jar or webosdoctorp100ewwbellmo-1.2.1.jar)
  
 
== Doing it ==
 
== Doing it ==
  
-----------
+
# 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"  
+
# Type one of the following:
 +
#: <pre>make CARRIER=sprint unpack patch pack</pre>
 +
#: <pre>make CARRIER=wr unpack patch pack</pre>
 +
#: <pre>make CARRIER=bellmo unpack patch pack</pre>
 +
#: depending on the carrier in question.
  
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.
 
This should begin a process within terminal that should take 10 minutes max.
 
   
 
   
There are 2 known error conditions
+
===Error conditions===
  
- If an error message appears with unknown in a file name, check the file rename in step 6
+
If an error message appears with unknown in a file name, check the file rename in step 8 above.
  
- 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
+
===How to change a provider's DB-entry so 3G data can be used on the Pre===
  
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
+
[http://forums.precentral.net/gsm-pre/210030-carrier-apn-settings-1-13-german-1-21-us-2.html#post1990055 This post] and [http://forums.precentral.net/palm-pre/209222-few-questions-about-german-palm-pre-6.html this thread] describe various ways to adjust the provider's data base in the Pre, so the 3G datacom works on non-supported networks. This can only be done after activation has been completed over WiFi.
  
== Prepare to run the new Meta'ed Doctor ==
+
= Prepare to run the new Meta'ed Doctor =
 +
 
 +
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''.
  
 
If you are running in Ubuntu, you can just run the new jar file now.   
 
If you are running in Ubuntu, you can just run the new jar file now.   
  
If you are running Ubuntu in a VM, you will need to exit out of the VM into your live desktop to run the jar.   
+
If you are running Ubuntu in a VM, you will need to copy the new jar out of the VM into your live desktop to run the jar in your native OS.   
  
9a) If you are on Windows, the easiest thing to do is to copy the new doctor image to that shared folder, then run it in Windows. 
+
* If you are 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 (Assuming that is where you installed Wubi) you can run it from there
 
+
* Using terminal in the VM copy the following command:<pre>cp /meta-doctor/build/pre-p100eww-sprint-1.2.1/webosdoctorp100ewwsprint-1.2.1.jar /host/webosdoctorp100ewwsprint-1.2.1.jar</pre>
:close the virtualbox before double clicking on the JAR file.
 
 
 
 
 
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 (Assuming that is where you installed Wubi) you can run it from there
 
 
 
9c) If you are using a VM under Max OSx, you will still need to copy the jar file out of the VM to the host drive.
 
 
 
==== Universal technique to copy the jar out of the VM ====
 
 
 
Using terminal in the VM copy the following command:
 
<pre>cp /meta-doctor/build/pre-p100eww-sprint-1.2.1/webosdoctorp100ewwsprint-1.2.1.jar /host/webosdoctorp100ewwsprint-1.2.1.jar</pre>
 
 
 
Go [http://www.webos-internals.org/wiki/How_To_Recover here] if you have problems
 
  
 
== Once the Doctor is running ==
 
== Once the Doctor is running ==
Line 159: Line 82:
  
 
When the process finishes, the Pre will reboot and your new modified image will have been installed.
 
When the process finishes, the Pre will reboot and your new modified image will have been installed.
== Next, how to change a provider's DB-entry so 3G data can be used on the Pre==
 
  
[http://forums.precentral.net/gsm-pre/210030-carrier-apn-settings-1-13-german-1-21-us-2.html#post1990055 This post] and [http://forums.precentral.net/palm-pre/209222-few-questions-about-german-palm-pre-6.html this thread] describe various ways to adjust
+
==If the Doctor will not run==
the provider's data base in the Pre, so the 3G datacom works on non-supported networks. This can only be done after activation has been completed over WiFi.
+
Go [http://www.webos-internals.org/wiki/How_To_Recover here] if you have further problems connecting your Pre to the running Meta'ed Doctor.
 +
 
 +
 
 +
=Using a Virtual Machine=
 +
 
 +
If you do not have a Linux system, you will need to run the meta-doctor in a virtual machine.  For windows users there are two options.  For Mac users, follow option 1
 +
 
 +
==Running in VMware or VirtualBox==
 +
 
 +
# Download [http://www.ubuntu.com/getubuntu/download Ubuntu 9.10]. 
 +
# Download a virtual machine program, either vmware or virtualbox. A virtual machine is simply a program that allows you to piggyback a second operating system on top of your native 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 a link for the virtualbox download for Windows: [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 application, nothing fancy here.
 +
# 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==
 +
 
 +
Windows users have another option to avoid using a virtual machine.  They can use the meta doctor  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. It is easy and there is no virtual machine headaches of trying to configure USB, Network and File sharing with host computer... To access it you just reboot and choose Ubuntu from dual boot screen.
 +
 
 +
# download [http://www.ubuntu.com/getubuntu/download Ubuntu 9.10]
 +
# burn that file to a cd or mount to virtual drive
 +
# Run cd in windows (the wubi.exe file inside the disk, it also comes up in auto run)
 +
# 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 recommended 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.  
 +
# Restart your computer and you can dual boot to Windows or Ubuntu
 +
 
 +
The 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 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
 +
 
 +
==Proceed in Linux to run the new Doctor==
 +
 
 +
Go to the top of this article and follow the instructions as though you were running Linux, since you now are.

Revision as of 21:32, 2 November 2009

Next, how to change a provider's DB-entry so 3G data can be used on the Pre

-

If the Doctor will not run

+ This post and this thread describe various ways to adjust - Go here if you have further problems connecting your Pre to the running Meta'ed Doctor. + the provider's data base in the Pre, so the 3G datacom works on non-supported networks. This can only be done after activation has been completed over WiFi.


What is the Meta Doctor?

The Webos Internals Meta Doctor is a set of shell scripts which modify a copy of the Palm Webos Doctor to bypass the "First Use" application and allow the phone to run without having been activated on a cell network.

They reach into Palm's distributed Doctor jar file and make changes which prevent the first use app from running.

If you are on a Linux system, the process is very easy:

If you are on a Windows or Mac system, you will need to find a Linux system, or you will need to install a virtual machine. Detailed instructions for that are below under Using a Virtual Machine.

Using the Meta-Doctor in Linux

Getting Ready

  1. Open terminal from the applications, accessories menu.
  2. If you have git installed, skip this step. If you do not have git installed, type:
    sudo apt-get install git
    and follow the directions to install git.
  3. Now type:
    git clone git://git.webos-internals.org/tools/meta-doctor.git
  4. Type
    sudo apt-get install patch
    to make sure you have patch installed.
  5. If you do not have java installed do so. To install java, choose (applications>Ubuntu Software Center> type java 6 runtime in search) It is easiest to search for java to find it, then follow the on screen instructions. It should be pretty simple.
  6. Download and install the palm sdk from http://developer.palm.com. Download the version for linux Here.
  7. Download the latest webosdoctor file from Webos Doctor Versions .The wr version is the German/UK GSM version.
  8. Rename the file that you download to webosdoctorp100ewwsprint-1.2.1.jar (or webosdoctorp100eww-wr-1.1.3.jar or webosdoctorp100ewwbellmo-1.2.1.jar)

Doing it

  1. Navigate to the meta-doctor directory in the terminal by opening terminal and typing "cd meta-doctor"
  2. Type one of the following:
    make CARRIER=sprint unpack patch pack
    make CARRIER=wr unpack patch pack
    make CARRIER=bellmo unpack patch pack
    depending on the carrier in question.

This should begin a process within terminal that should take 10 minutes max.

Error conditions

If an error message appears with unknown in a file name, check the file rename in step 8 above.

How to change a provider's DB-entry so 3G data can be used on the Pre

This post and this thread describe various ways to adjust the provider's data base in the Pre, so the 3G datacom works on non-supported networks. This can only be done after activation has been completed over WiFi.

Prepare to run the new Meta'ed Doctor

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.

If you are running in Ubuntu, you can just run the new jar file now.

If you are running Ubuntu in a VM, you will need to copy the new jar out of the VM into your live desktop to run the jar in your native OS.

  • If you are 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 (Assuming that is where you installed Wubi) you can run it from there
  • Using terminal in the VM copy the following command:
    cp /meta-doctor/build/pre-p100eww-sprint-1.2.1/webosdoctorp100ewwsprint-1.2.1.jar /host/webosdoctorp100ewwsprint-1.2.1.jar

Once the Doctor is running

  1. Select your language
  2. Accept the license agreement
  3. Connect your Pre to your PC via USB and select "Next" when it becomes available

After completion the device will reboot and present you with the activation set-up.

If your PC does not recognize your Pre and you cannot go past step 3 above, try the following steps:

  1. With the USB cable connected, power off the Pre
  2. Hold down the Up button on the volume rocker
  3. While holding the Up button, power on the Pre
  4. "Next" should now be enabled - proceed with the recovery
{{#icon:Tux_with_Pre.png|}}

The above steps will put the Pre into bootloader recovery mode and should allow the PC to recognize your device and proceed with the restore. In this mode the screen will display a giant USB logo instead of the usual Palm startup logo.

When the process finishes, the Pre will reboot and your new modified image will have been installed.

If the Doctor will not run

Go here if you have further problems connecting your Pre to the running Meta'ed Doctor.


Using a Virtual Machine

If you do not have a Linux system, you will need to run the meta-doctor in a virtual machine. For windows users there are two options. For Mac users, follow option 1.

Running in VMware or VirtualBox

  1. Download Ubuntu 9.10.
  2. Download a virtual machine program, either vmware or virtualbox. A virtual machine is simply a program that allows you to piggyback a second operating system on top of your native 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 a link for the virtualbox download for Windows: VirtualBox-3.0.10-54097-Win
  3. Now install virtualbox just like you would install any other application, nothing fancy here.
  4. Start up virtualbox and follow either of these instructions to install Ubuntu
    1. http://www.helpdeskgeek.com/linux-tips/how-to-install-ubuntu-in-virtualbox/
    2. http://www.psychocats.net/ubuntu/virtualbox


Using WUBI

Windows users have another option to avoid using a virtual machine. They can use the meta doctor 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. It is easy and there is no virtual machine headaches of trying to configure USB, Network and File sharing with host computer... To access it you just reboot and choose Ubuntu from dual boot screen.

  1. download Ubuntu 9.10
  2. burn that file to a 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 recommended 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.
  5. Restart your computer and you can dual boot to Windows or Ubuntu

The 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

Proceed in Linux to run the new Doctor

Go to the top of this article and follow the instructions as though you were running Linux, since you now are.