WebOS Internals - User contributions [en]

Application:MetaDoctor

2011-03-19T05:15:59Z

Johncc:

[[Category:Application]]
This page is currently available in four languages:
:[[Image:Australia.png]] [[Image:USA.png]] [[Application:MetaDoctor]]
:[[Image:France.png]] [[Application:MetaDoctor-FR]]
:[[Image:Germany.png]] [[Application:MetaDoctor-DE]]
:[[Image:Mexico.png]] [[Image:Spain.png]] [[Application:MetaDoctor-ES]]

= What is the Meta Doctor? =

The Webos Internals Meta Doctor is a Makefile which can 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. It accomplishes this by reaching into Palm's distributed Doctor JAR file and making changes to it. It can prevent the first use app from running, as well as applying other tweaks to the OS.

'''Documentation for the features that the MetaDoctor offers is at the top of the Makefile (you find out where that is later).'''

= Step 1: Setting up Meta-Doctor=

== Windows ==

Windows users can use [http://www.cygwin.com/ Cygwin] to run the Meta-Doctor.

Simply install Cygwin, and make sure you include the following additional packages:

# Python
# Make
# Patch
# Git
# Zip
# Unzip
# wget

(use View "Full" to find these specific packages more easily)

You can download an illustrated installation guide for Cygwin and the appropriate packages from [http://forums.precentral.net/attachments/palm-pre/56225d1299460428-sprint-webos-2-1-0-upgrade-simplified-install_cygwin_v1.2.pdf here].

# Go to Start>Programs>Cygwin>Cygwin Bash Shell to open a terminal
# Now type: <pre>git clone git://git.webos-internals.org/tools/meta-doctor.git</pre>
# Download and install the Palm Novacom software from http://developer.palm.com.
# Navigate to the meta-doctor directory that was created by the git clone command. For example: <pre>cd meta-doctor</pre>
# Ensure that there is a downloads directory. If there is not one, create one using <pre>mkdir downloads</pre>

== Linux ==

# 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-core</pre> and follow the directions to install git.
# Now type: <pre>git clone git://git.webos-internals.org/tools/meta-doctor.git</pre>
# If you do not have patch installed, you will need to install patch. On an Ubuntu system type: <pre>sudo apt-get install patch</pre>
# If you do not have java installed, do so. To install java, choose ( Applications > Ubuntu Software Center ) and 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 Novacom software from http://developer.palm.com. Download the version for Ubuntu [https://cdn.downloads.palm.com/sdkdownloads/1.3.1.314/sdkBinaries/palm-novacom_1.0.46_i386.deb here] and install it. (If you choose to install the full SDK instead, and are running the 64-bit version of Ubuntu 9.x you will have difficulty installing the SDK and the instructions on the download site are wrong. Read [https://developer.palm.com/distribution/viewtopic.php?f=31&t=2308 this thread] and [http://forums.precentral.net/showpost.php?p=2021966&postcount=108 this post] for help.)
# Open a terminal and navigate to the meta-doctor directory where the meta-doctor was copied to in step 3 above. For example: <pre>cd meta-doctor</pre>
# Ensure that there is a downloads directory. If there is not one, create one using <pre>mkdir downloads</pre>

== Mac OS X 10.6 ==

#Install MacPorts first, which will allow us to easily install the necessary packages for MetaDoctor. [http://www.macports.org/install.php]. Please note that MacPorts requires Apple's Xcode Developer Tools (version 3.2.1 or later for Snow Leopard, 3.1.4 or later for Leopard, or 2.5 for Tiger), found at the [http://connect.apple.com/ Apple Developer Connection site] or on your Mac OS X installation CDs/DVD.
#Install md5sum: <pre>sudo port install md5sha1sum</pre>
#Install gnutar: <pre>sudo port install gnutar</pre>
#Install git: <pre>sudo port install git-core</pre>
#Install wget: <pre>sudo port install wget</pre>
# Now type: <pre>git clone git://git.webos-internals.org/tools/meta-doctor.git</pre>
#Install patch: <pre>sudo port install gpatch</pre>
#If you do not have Java installed, do so. To install Java, click on the "Apple" icon and select "Software Update." This will automatically update you to the latest version of Java if necessary, as Apple supplies their own version of Java. Further instructions can be found [http://support.apple.com/kb/HT1338?viewlocale=en_US here].
#Download and install the Palm Novacom software from http://developer.palm.com. The Mac OS X SDK is located [http://cdn.downloads.palm.com/sdkdownloads/1.4.5.465/sdkBinaries/Palm_webOS_SDK.1.4.5.465.dmg here].
#Open a terminal and navigate to the meta-doctor directory where the meta-doctor was copied to in step 6 above.<pre>cd meta-doctor</pre>
#Ensure that there is a downloads directory. If there is not one, create one using <pre>mkdir downloads</pre>

==Using a Virtual Machine==

'''Note that some people have trouble connecting to their device over USB from a virtual machine. If you experience this problem, run the webOS Doctor from your native OS, not from the 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 10.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 10.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

= Step 2: Running the webOS Doctor=

Note that if you are following a procedure on another wiki page which only requires the installation of the MetaDoctor and then tells you to return to that other page, then this is the place at which you should return.

'''If you intend to enable WIFI Profiles, you must copy a file off of the phone before doctoring. See the section below on enabling wifi profiles.'''

# Navigate to the meta-doctor directory in the terminal
# Download the latest webosdoctor file using the download paths found at [http://www.webos-internals.org/wiki/Webos_Doctor_Versions Webos Doctor Versions] .The wr version is the French,German,Irish,Spanish and UK GSM version. An example (i.e. will not work, you need to look for the latest URL) download command would be: <pre>cd downloads</pre><pre>wget http://palm.cdnetworks.net/rom/pre/p1351r0d01082010/sr1ntp1351rod/webosdoctorp100ewwsprint.jar</pre>
# Rename the file that you download to include the version number for future reference (examples: webosdoctorp100ewwsprint-1.3.5.1.jar, webosdoctorp100eww-wr-1.1.3.jar, or webosdoctorp100ewwbellmo-1.2.1.jar). An example (i.e. will not work, you need to work out the filename based on the URL you used to download it) command to do that would be:<pre>mv webosdoctorp100ewwbellmo.jar webosdoctorp100ewwbellmo-1.3.5.1.jar</pre>
# If you would like Meta-Doctor to apply patches to webOS in order to add or change functionality from the factory install, open the Makefile with your favorite text editor and uncomment (remove the leading # characters from) the options you would like to use.
# Before doing the next step, make sure you change back into the meta-doctor directory first. All the following commands must be run from the meta-doctor directory.
# Type one of the following:
#: <pre>make DEVICE=pre all-wr</pre>
#: <pre>make DEVICE=preplus all-wr</pre>
#: <pre>make DEVICE=pixiplus all-wr</pre>
#: <pre>make DEVICE=pre all-sprint</pre>
#: <pre>make DEVICE=pixi all-sprint</pre>
#: <pre>make DEVICE=pre all-bellmo</pre>
#: <pre>make DEVICE=pre all-telcel</pre>
#: <pre>make DEVICE=preplus all-verizonwireless</pre>
#: <pre>make DEVICE=pixiplus all-verizonwireless</pre>
#: <pre>make DEVICE=preplus all-att</pre>
#: <pre>make DEVICE=pixiplus all-att</pre>
#: depending on the carrier in question.
'''Note ''': use make DEVICE=palm_smartphone_type all-wr for O2 Germany, UK and Ireland / Movistar Spain / SFR France

This should begin a process within the 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.

=== If the build fails ===

If the make command fails, you can use <pre>make clobber</pre> to clean up the build directory. After this you can re-run the command.

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

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

If you are running Ubuntu using 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.

CD to the folder where your new jar file is, and type something like:

java -jar webosdoctorp100ewwsprint-1.3.5.1.jar

If you were using a VM or some other virtual method, you will need to copy the jar file out to your main operating system before running it.

''Windows host:''

[http://ubuntuexperiment.wordpress.com/2008/11/12/sharing-folders-between-host-and-guest-os-in-virtualbox/ VirtualBox folder Sharing]

[http://www.howtogeek.com/howto/ubuntu/how-to-share-folders-with-your-ubuntu-virtual-machine-guest/ VMWare folder Sharing]

''Mac OSX host:''

[http://davidherron.com/blog/topics/628-virtualbox-running-ubuntu-accessing-host-file-system-mac-os-x VirtualBox folder Sharing]

: ''NOTE: this only applies to WUBI Users''
You should be able to run the JAR as if you had Linux installed natively because in a sense you do (as long as Java is installed and you run the Jar using Java) but if you rather run it in windows

Using terminal the following command in a Wubi installation of Ubuntu will copy the JAR file to the host Windows OS :<pre>cp /meta-doctor/build/pre-p100eww-sprint-1.2.1/webosdoctorp100ewwsprint-1.2.1.jar /host/webosdoctorp100ewwsprint-1.2.1.jar</pre>
This will place the Jar either in your Windows C:\ drive or whatever drive you installed Wubi to.

== Once the Doctor is running ==

# Select your language
# Accept the license agreement
# 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:

# With the USB cable connected, completely power off the Pre (hold down the power button until the option to power off appears)
# Hold down the Up button on the volume rocker
# While holding the Up button, power on the Pre
# "Next" should now be enabled - proceed with the recovery
{{tux|Tux_with_Pre.png|float:right;}}
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.

----

After the doctor completes, you will need to run the "First Run" application. To do this, you will need an active internet connection. Either WiFi or Cellular. If you do not have WiFi and cannot connect to the Palm Profile servers, you might have a problem with your programming. This Meta Doctor (or webOS Doctor in general) could possibly erase the modem's programming. To resolve you will need to perform the following steps:

'''Note:''' This has only been confirmed to resolve Sprint CDMA issues, YMMV.

'''Note 2:''' You should try to update your profile first. Open the phone app, open the App Menu and select ''Preferences'' then select ''Update Network Settings''. If you get an error, then procede with these instructions.
*'''1.''' Open the Phone App.
*'''2.''' Enter ''##MSL#'' (MSL= 6 digit lock code. Get this from Sprint.)
*'''3.''' Verify your MDN and MSID are incorrect. If they are incorrect, continue. If they are correct, this is not your problem and you should not continue.
*'''4.''' Select ''Edit''.
*'''5.''' Select the first box (MDN) and enter your 10-digit cellular number.
*'''6.''' Select the second box (MSID) and enter your 10-digit MSID (Get this from Sprint).
*'''7.''' Select ''Save''.
*'''8.''' Backswipe out of the the view.
*'''9.''' You should now be able to open complete '''Note 2''' above without any errors.

You should now be able to run the ''First Use'' application without any problems.

=If the Doctor will not run=
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.

=Miscellaneous=
Clarification for Linux beginners on where to place the prefsDB.sl file, per instructions in the makefile.
Steps:
1. Open makefile using a text editor (like WordPad) and use the instructions there to retrieve your prefsDB.sl file from your device. Save it somewhere convenient on your host machine (aka, computer).
2. Navigate to the meta-doctor directory and create the config directory: mkdir -p config
3. Rename your prefsDB.sl file to com.palm.wifi.prefsDB.sl
4. Put com.palm.wifi.prefsDB.sl in the config directory.
5. Continue following instructions in the makefile.

==How to enable WIFI profiles==
To enable wifi profiles it is necessary to copy your wifi profile file off of your phone and place this in a directory, as well as enable the wifi profile option in the makefile.

# Move to the meta-doctor directory (cd meta-doctor)
# Create a "config" folder in the meta-doctor directory (mkdir config)
# Copy the prefsDB.sl file off of your phone from the var/preferences/com.palm.wifi/ and into the "config" directory that you just created.
# Rename this file "com.palm.wifi.prefsDB.sl" without the quotes
# Open the makefile (which is in the meta-doctor directory) and remove the "#" from the line "# INSTALL_WIFI_PROFILES = 1". Save the makefile.
# Build the custom doctor by running the script, or otherwise building it.

On launch of the new doctor your wifi profile should automatically connect, but '''only if''' you had previously connected to the WIFI network you are trying to use.

See these links for more information: [http://forums.precentral.net/webos-internals/276460-how-install-webos-2-1-0-pre-pre-using-meta-doctor-27.html#post2882495 Post 1], [http://discussion.treocentral.com/webos-internals/276460-how-install-webos-2-1-0-pre-pre-using-meta-doctor-43.html#post2884415 Post 2].

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

[http://forums.precentral.net/gsm-pre/211728-modifying-webos-carrier-network-settings.html#post2002079 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. webOS 1.3.1 allows setting of the providers data directly from the activation screen for providers that are present in the DB. Some report that they are not able to do that and that they cannot get 3G datacom working on 1.3.1

== Problems with Novacom ==
If you are Running a new Distro, like Archlinux, you could run into problem with novacom while trying to connect your pre. Running novacomd on the command line could provide further information. This may be a problem with libusb. Get a older version like described in [http://developer.palm.com/distribution/viewtopic.php?f=11&t=4233&start=0 this thread].

== How to Install webOS 2.x on "unoffical" Devices==
With the release of the O2-DE webOS Doctor, efforts have been made to apply the techniques of MetaDoctor and create a custom doctor to apply 2.1.0 to devices that it was not been officially released for. For those not faint of heart, a step-by-step can be found at the following: [[WebOS 2 Upgrade]]

== Cygwin Note (unconfirmed) ==

Do not do this unless you experience the problem it is said to solve.

I used a WinXP box with cygwin and everything worked fine, except I had to add the switch --no-same-owner in line 802 of the Makefile. That's because I'm as root in cygwin and without this switch the tar-command failed.

Code:
mkdir -p build/${PATIENT}/webOS
${TAR} --no-same-owner -C build/${PATIENT}/webOS \
-f build/${PATIENT}/resources/webOS.tar \
-x ./${CUSTIMAGEOLD}.rootfs.tar.gz ./${INSTIMAGEOLD}.uImage ./${BOOTLOADEROLD}.bin ./${CODENAMEOLD}.xml ./installer.xml

Application:MetaDoctor

2011-03-19T05:15:27Z

Johncc:

[[Category:Application]]
This page is currently available in four languages:
:[[Image:Australia.png]] [[Image:USA.png]] [[Application:MetaDoctor]]
:[[Image:France.png]] [[Application:MetaDoctor-FR]]
:[[Image:Germany.png]] [[Application:MetaDoctor-DE]]
:[[Image:Mexico.png]] [[Image:Spain.png]] [[Application:MetaDoctor-ES]]

= What is the Meta Doctor? =

The Webos Internals Meta Doctor is a Makefile which can 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. It accomplishes this by reaching into Palm's distributed Doctor JAR file and making changes to it. It can prevent the first use app from running, as well as applying other tweaks to the OS.

'''Documentation for the features that the MetaDoctor offers is at the top of the Makefile (you find out where that is later).'''

= Step 1: Setting up Meta-Doctor=

== Windows ==

Windows users can use [http://www.cygwin.com/ Cygwin] to run the Meta-Doctor.

Simply install Cygwin, and make sure you include the following additional packages:

# Python
# Make
# Patch
# Git
# Zip
# Unzip
# wget

(use View "Full" to find these specific packages more easily)
You can download an illustrated installation guide for Cygwin and the appropriate packages from [http://forums.precentral.net/attachments/palm-pre/56225d1299460428-sprint-webos-2-1-0-upgrade-simplified-install_cygwin_v1.2.pdf here].

# Go to Start>Programs>Cygwin>Cygwin Bash Shell to open a terminal
# Now type: <pre>git clone git://git.webos-internals.org/tools/meta-doctor.git</pre>
# Download and install the Palm Novacom software from http://developer.palm.com.
# Navigate to the meta-doctor directory that was created by the git clone command. For example: <pre>cd meta-doctor</pre>
# Ensure that there is a downloads directory. If there is not one, create one using <pre>mkdir downloads</pre>

== Linux ==

# 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-core</pre> and follow the directions to install git.
# Now type: <pre>git clone git://git.webos-internals.org/tools/meta-doctor.git</pre>
# If you do not have patch installed, you will need to install patch. On an Ubuntu system type: <pre>sudo apt-get install patch</pre>
# If you do not have java installed, do so. To install java, choose ( Applications > Ubuntu Software Center ) and 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 Novacom software from http://developer.palm.com. Download the version for Ubuntu [https://cdn.downloads.palm.com/sdkdownloads/1.3.1.314/sdkBinaries/palm-novacom_1.0.46_i386.deb here] and install it. (If you choose to install the full SDK instead, and are running the 64-bit version of Ubuntu 9.x you will have difficulty installing the SDK and the instructions on the download site are wrong. Read [https://developer.palm.com/distribution/viewtopic.php?f=31&t=2308 this thread] and [http://forums.precentral.net/showpost.php?p=2021966&postcount=108 this post] for help.)
# Open a terminal and navigate to the meta-doctor directory where the meta-doctor was copied to in step 3 above. For example: <pre>cd meta-doctor</pre>
# Ensure that there is a downloads directory. If there is not one, create one using <pre>mkdir downloads</pre>

== Mac OS X 10.6 ==

#Install MacPorts first, which will allow us to easily install the necessary packages for MetaDoctor. [http://www.macports.org/install.php]. Please note that MacPorts requires Apple's Xcode Developer Tools (version 3.2.1 or later for Snow Leopard, 3.1.4 or later for Leopard, or 2.5 for Tiger), found at the [http://connect.apple.com/ Apple Developer Connection site] or on your Mac OS X installation CDs/DVD.
#Install md5sum: <pre>sudo port install md5sha1sum</pre>
#Install gnutar: <pre>sudo port install gnutar</pre>
#Install git: <pre>sudo port install git-core</pre>
#Install wget: <pre>sudo port install wget</pre>
# Now type: <pre>git clone git://git.webos-internals.org/tools/meta-doctor.git</pre>
#Install patch: <pre>sudo port install gpatch</pre>
#If you do not have Java installed, do so. To install Java, click on the "Apple" icon and select "Software Update." This will automatically update you to the latest version of Java if necessary, as Apple supplies their own version of Java. Further instructions can be found [http://support.apple.com/kb/HT1338?viewlocale=en_US here].
#Download and install the Palm Novacom software from http://developer.palm.com. The Mac OS X SDK is located [http://cdn.downloads.palm.com/sdkdownloads/1.4.5.465/sdkBinaries/Palm_webOS_SDK.1.4.5.465.dmg here].
#Open a terminal and navigate to the meta-doctor directory where the meta-doctor was copied to in step 6 above.<pre>cd meta-doctor</pre>
#Ensure that there is a downloads directory. If there is not one, create one using <pre>mkdir downloads</pre>

==Using a Virtual Machine==

'''Note that some people have trouble connecting to their device over USB from a virtual machine. If you experience this problem, run the webOS Doctor from your native OS, not from the 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 10.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 10.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

= Step 2: Running the webOS Doctor=

Note that if you are following a procedure on another wiki page which only requires the installation of the MetaDoctor and then tells you to return to that other page, then this is the place at which you should return.

'''If you intend to enable WIFI Profiles, you must copy a file off of the phone before doctoring. See the section below on enabling wifi profiles.'''

# Navigate to the meta-doctor directory in the terminal
# Download the latest webosdoctor file using the download paths found at [http://www.webos-internals.org/wiki/Webos_Doctor_Versions Webos Doctor Versions] .The wr version is the French,German,Irish,Spanish and UK GSM version. An example (i.e. will not work, you need to look for the latest URL) download command would be: <pre>cd downloads</pre><pre>wget http://palm.cdnetworks.net/rom/pre/p1351r0d01082010/sr1ntp1351rod/webosdoctorp100ewwsprint.jar</pre>
# Rename the file that you download to include the version number for future reference (examples: webosdoctorp100ewwsprint-1.3.5.1.jar, webosdoctorp100eww-wr-1.1.3.jar, or webosdoctorp100ewwbellmo-1.2.1.jar). An example (i.e. will not work, you need to work out the filename based on the URL you used to download it) command to do that would be:<pre>mv webosdoctorp100ewwbellmo.jar webosdoctorp100ewwbellmo-1.3.5.1.jar</pre>
# If you would like Meta-Doctor to apply patches to webOS in order to add or change functionality from the factory install, open the Makefile with your favorite text editor and uncomment (remove the leading # characters from) the options you would like to use.
# Before doing the next step, make sure you change back into the meta-doctor directory first. All the following commands must be run from the meta-doctor directory.
# Type one of the following:
#: <pre>make DEVICE=pre all-wr</pre>
#: <pre>make DEVICE=preplus all-wr</pre>
#: <pre>make DEVICE=pixiplus all-wr</pre>
#: <pre>make DEVICE=pre all-sprint</pre>
#: <pre>make DEVICE=pixi all-sprint</pre>
#: <pre>make DEVICE=pre all-bellmo</pre>
#: <pre>make DEVICE=pre all-telcel</pre>
#: <pre>make DEVICE=preplus all-verizonwireless</pre>
#: <pre>make DEVICE=pixiplus all-verizonwireless</pre>
#: <pre>make DEVICE=preplus all-att</pre>
#: <pre>make DEVICE=pixiplus all-att</pre>
#: depending on the carrier in question.
'''Note ''': use make DEVICE=palm_smartphone_type all-wr for O2 Germany, UK and Ireland / Movistar Spain / SFR France

This should begin a process within the 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.

=== If the build fails ===

If the make command fails, you can use <pre>make clobber</pre> to clean up the build directory. After this you can re-run the command.

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

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

If you are running Ubuntu using 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.

CD to the folder where your new jar file is, and type something like:

java -jar webosdoctorp100ewwsprint-1.3.5.1.jar

If you were using a VM or some other virtual method, you will need to copy the jar file out to your main operating system before running it.

''Windows host:''

[http://ubuntuexperiment.wordpress.com/2008/11/12/sharing-folders-between-host-and-guest-os-in-virtualbox/ VirtualBox folder Sharing]

[http://www.howtogeek.com/howto/ubuntu/how-to-share-folders-with-your-ubuntu-virtual-machine-guest/ VMWare folder Sharing]

''Mac OSX host:''

[http://davidherron.com/blog/topics/628-virtualbox-running-ubuntu-accessing-host-file-system-mac-os-x VirtualBox folder Sharing]

: ''NOTE: this only applies to WUBI Users''
You should be able to run the JAR as if you had Linux installed natively because in a sense you do (as long as Java is installed and you run the Jar using Java) but if you rather run it in windows

Using terminal the following command in a Wubi installation of Ubuntu will copy the JAR file to the host Windows OS :<pre>cp /meta-doctor/build/pre-p100eww-sprint-1.2.1/webosdoctorp100ewwsprint-1.2.1.jar /host/webosdoctorp100ewwsprint-1.2.1.jar</pre>
This will place the Jar either in your Windows C:\ drive or whatever drive you installed Wubi to.

== Once the Doctor is running ==

# Select your language
# Accept the license agreement
# 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:

# With the USB cable connected, completely power off the Pre (hold down the power button until the option to power off appears)
# Hold down the Up button on the volume rocker
# While holding the Up button, power on the Pre
# "Next" should now be enabled - proceed with the recovery
{{tux|Tux_with_Pre.png|float:right;}}
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.

----

After the doctor completes, you will need to run the "First Run" application. To do this, you will need an active internet connection. Either WiFi or Cellular. If you do not have WiFi and cannot connect to the Palm Profile servers, you might have a problem with your programming. This Meta Doctor (or webOS Doctor in general) could possibly erase the modem's programming. To resolve you will need to perform the following steps:

'''Note:''' This has only been confirmed to resolve Sprint CDMA issues, YMMV.

'''Note 2:''' You should try to update your profile first. Open the phone app, open the App Menu and select ''Preferences'' then select ''Update Network Settings''. If you get an error, then procede with these instructions.
*'''1.''' Open the Phone App.
*'''2.''' Enter ''##MSL#'' (MSL= 6 digit lock code. Get this from Sprint.)
*'''3.''' Verify your MDN and MSID are incorrect. If they are incorrect, continue. If they are correct, this is not your problem and you should not continue.
*'''4.''' Select ''Edit''.
*'''5.''' Select the first box (MDN) and enter your 10-digit cellular number.
*'''6.''' Select the second box (MSID) and enter your 10-digit MSID (Get this from Sprint).
*'''7.''' Select ''Save''.
*'''8.''' Backswipe out of the the view.
*'''9.''' You should now be able to open complete '''Note 2''' above without any errors.

You should now be able to run the ''First Use'' application without any problems.

=If the Doctor will not run=
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.

=Miscellaneous=
Clarification for Linux beginners on where to place the prefsDB.sl file, per instructions in the makefile.
Steps:
1. Open makefile using a text editor (like WordPad) and use the instructions there to retrieve your prefsDB.sl file from your device. Save it somewhere convenient on your host machine (aka, computer).
2. Navigate to the meta-doctor directory and create the config directory: mkdir -p config
3. Rename your prefsDB.sl file to com.palm.wifi.prefsDB.sl
4. Put com.palm.wifi.prefsDB.sl in the config directory.
5. Continue following instructions in the makefile.

==How to enable WIFI profiles==
To enable wifi profiles it is necessary to copy your wifi profile file off of your phone and place this in a directory, as well as enable the wifi profile option in the makefile.

# Move to the meta-doctor directory (cd meta-doctor)
# Create a "config" folder in the meta-doctor directory (mkdir config)
# Copy the prefsDB.sl file off of your phone from the var/preferences/com.palm.wifi/ and into the "config" directory that you just created.
# Rename this file "com.palm.wifi.prefsDB.sl" without the quotes
# Open the makefile (which is in the meta-doctor directory) and remove the "#" from the line "# INSTALL_WIFI_PROFILES = 1". Save the makefile.
# Build the custom doctor by running the script, or otherwise building it.

On launch of the new doctor your wifi profile should automatically connect, but '''only if''' you had previously connected to the WIFI network you are trying to use.

See these links for more information: [http://forums.precentral.net/webos-internals/276460-how-install-webos-2-1-0-pre-pre-using-meta-doctor-27.html#post2882495 Post 1], [http://discussion.treocentral.com/webos-internals/276460-how-install-webos-2-1-0-pre-pre-using-meta-doctor-43.html#post2884415 Post 2].

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

[http://forums.precentral.net/gsm-pre/211728-modifying-webos-carrier-network-settings.html#post2002079 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. webOS 1.3.1 allows setting of the providers data directly from the activation screen for providers that are present in the DB. Some report that they are not able to do that and that they cannot get 3G datacom working on 1.3.1

== Problems with Novacom ==
If you are Running a new Distro, like Archlinux, you could run into problem with novacom while trying to connect your pre. Running novacomd on the command line could provide further information. This may be a problem with libusb. Get a older version like described in [http://developer.palm.com/distribution/viewtopic.php?f=11&t=4233&start=0 this thread].

== How to Install webOS 2.x on "unoffical" Devices==
With the release of the O2-DE webOS Doctor, efforts have been made to apply the techniques of MetaDoctor and create a custom doctor to apply 2.1.0 to devices that it was not been officially released for. For those not faint of heart, a step-by-step can be found at the following: [[WebOS 2 Upgrade]]

== Cygwin Note (unconfirmed) ==

Do not do this unless you experience the problem it is said to solve.

I used a WinXP box with cygwin and everything worked fine, except I had to add the switch --no-same-owner in line 802 of the Makefile. That's because I'm as root in cygwin and without this switch the tar-command failed.

Code:
mkdir -p build/${PATIENT}/webOS
${TAR} --no-same-owner -C build/${PATIENT}/webOS \
-f build/${PATIENT}/resources/webOS.tar \
-x ./${CUSTIMAGEOLD}.rootfs.tar.gz ./${INSTIMAGEOLD}.uImage ./${BOOTLOADEROLD}.bin ./${CODENAMEOLD}.xml ./installer.xml

Application:MetaDoctor

2011-03-19T05:14:19Z

Johncc: /* Windows */ added link to Cygwin installation guide.

[[Category:Application]]
This page is currently available in four languages:
:[[Image:Australia.png]] [[Image:USA.png]] [[Application:MetaDoctor]]
:[[Image:France.png]] [[Application:MetaDoctor-FR]]
:[[Image:Germany.png]] [[Application:MetaDoctor-DE]]
:[[Image:Mexico.png]] [[Image:Spain.png]] [[Application:MetaDoctor-ES]]

= What is the Meta Doctor? =

The Webos Internals Meta Doctor is a Makefile which can 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. It accomplishes this by reaching into Palm's distributed Doctor JAR file and making changes to it. It can prevent the first use app from running, as well as applying other tweaks to the OS.

'''Documentation for the features that the MetaDoctor offers is at the top of the Makefile (you find out where that is later).'''

= Step 1: Setting up Meta-Doctor=

== Windows ==

Windows users can use [http://www.cygwin.com/ Cygwin] to run the Meta-Doctor.

Simply install Cygwin, and make sure you include the following additional packages:

# Python
# Make
# Patch
# Git
# Zip
# Unzip
# wget

(use View "Full" to find these specific packages more easily)

(You can download an illustrated installation guide for Cygwin and the appropriate packages from [http://forums.precentral.net/attachments/palm-pre/56225d1299460428-sprint-webos-2-1-0-upgrade-simplified-install_cygwin_v1.2.pdf here].)

# Go to Start>Programs>Cygwin>Cygwin Bash Shell to open a terminal
# Now type: <pre>git clone git://git.webos-internals.org/tools/meta-doctor.git</pre>
# Download and install the Palm Novacom software from http://developer.palm.com.
# Navigate to the meta-doctor directory that was created by the git clone command. For example: <pre>cd meta-doctor</pre>
# Ensure that there is a downloads directory. If there is not one, create one using <pre>mkdir downloads</pre>

== Linux ==

# 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-core</pre> and follow the directions to install git.
# Now type: <pre>git clone git://git.webos-internals.org/tools/meta-doctor.git</pre>
# If you do not have patch installed, you will need to install patch. On an Ubuntu system type: <pre>sudo apt-get install patch</pre>
# If you do not have java installed, do so. To install java, choose ( Applications > Ubuntu Software Center ) and 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 Novacom software from http://developer.palm.com. Download the version for Ubuntu [https://cdn.downloads.palm.com/sdkdownloads/1.3.1.314/sdkBinaries/palm-novacom_1.0.46_i386.deb here] and install it. (If you choose to install the full SDK instead, and are running the 64-bit version of Ubuntu 9.x you will have difficulty installing the SDK and the instructions on the download site are wrong. Read [https://developer.palm.com/distribution/viewtopic.php?f=31&t=2308 this thread] and [http://forums.precentral.net/showpost.php?p=2021966&postcount=108 this post] for help.)
# Open a terminal and navigate to the meta-doctor directory where the meta-doctor was copied to in step 3 above. For example: <pre>cd meta-doctor</pre>
# Ensure that there is a downloads directory. If there is not one, create one using <pre>mkdir downloads</pre>

== Mac OS X 10.6 ==

#Install MacPorts first, which will allow us to easily install the necessary packages for MetaDoctor. [http://www.macports.org/install.php]. Please note that MacPorts requires Apple's Xcode Developer Tools (version 3.2.1 or later for Snow Leopard, 3.1.4 or later for Leopard, or 2.5 for Tiger), found at the [http://connect.apple.com/ Apple Developer Connection site] or on your Mac OS X installation CDs/DVD.
#Install md5sum: <pre>sudo port install md5sha1sum</pre>
#Install gnutar: <pre>sudo port install gnutar</pre>
#Install git: <pre>sudo port install git-core</pre>
#Install wget: <pre>sudo port install wget</pre>
# Now type: <pre>git clone git://git.webos-internals.org/tools/meta-doctor.git</pre>
#Install patch: <pre>sudo port install gpatch</pre>
#If you do not have Java installed, do so. To install Java, click on the "Apple" icon and select "Software Update." This will automatically update you to the latest version of Java if necessary, as Apple supplies their own version of Java. Further instructions can be found [http://support.apple.com/kb/HT1338?viewlocale=en_US here].
#Download and install the Palm Novacom software from http://developer.palm.com. The Mac OS X SDK is located [http://cdn.downloads.palm.com/sdkdownloads/1.4.5.465/sdkBinaries/Palm_webOS_SDK.1.4.5.465.dmg here].
#Open a terminal and navigate to the meta-doctor directory where the meta-doctor was copied to in step 6 above.<pre>cd meta-doctor</pre>
#Ensure that there is a downloads directory. If there is not one, create one using <pre>mkdir downloads</pre>

==Using a Virtual Machine==

'''Note that some people have trouble connecting to their device over USB from a virtual machine. If you experience this problem, run the webOS Doctor from your native OS, not from the 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 10.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 10.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

= Step 2: Running the webOS Doctor=

Note that if you are following a procedure on another wiki page which only requires the installation of the MetaDoctor and then tells you to return to that other page, then this is the place at which you should return.

'''If you intend to enable WIFI Profiles, you must copy a file off of the phone before doctoring. See the section below on enabling wifi profiles.'''

# Navigate to the meta-doctor directory in the terminal
# Download the latest webosdoctor file using the download paths found at [http://www.webos-internals.org/wiki/Webos_Doctor_Versions Webos Doctor Versions] .The wr version is the French,German,Irish,Spanish and UK GSM version. An example (i.e. will not work, you need to look for the latest URL) download command would be: <pre>cd downloads</pre><pre>wget http://palm.cdnetworks.net/rom/pre/p1351r0d01082010/sr1ntp1351rod/webosdoctorp100ewwsprint.jar</pre>
# Rename the file that you download to include the version number for future reference (examples: webosdoctorp100ewwsprint-1.3.5.1.jar, webosdoctorp100eww-wr-1.1.3.jar, or webosdoctorp100ewwbellmo-1.2.1.jar). An example (i.e. will not work, you need to work out the filename based on the URL you used to download it) command to do that would be:<pre>mv webosdoctorp100ewwbellmo.jar webosdoctorp100ewwbellmo-1.3.5.1.jar</pre>
# If you would like Meta-Doctor to apply patches to webOS in order to add or change functionality from the factory install, open the Makefile with your favorite text editor and uncomment (remove the leading # characters from) the options you would like to use.
# Before doing the next step, make sure you change back into the meta-doctor directory first. All the following commands must be run from the meta-doctor directory.
# Type one of the following:
#: <pre>make DEVICE=pre all-wr</pre>
#: <pre>make DEVICE=preplus all-wr</pre>
#: <pre>make DEVICE=pixiplus all-wr</pre>
#: <pre>make DEVICE=pre all-sprint</pre>
#: <pre>make DEVICE=pixi all-sprint</pre>
#: <pre>make DEVICE=pre all-bellmo</pre>
#: <pre>make DEVICE=pre all-telcel</pre>
#: <pre>make DEVICE=preplus all-verizonwireless</pre>
#: <pre>make DEVICE=pixiplus all-verizonwireless</pre>
#: <pre>make DEVICE=preplus all-att</pre>
#: <pre>make DEVICE=pixiplus all-att</pre>
#: depending on the carrier in question.
'''Note ''': use make DEVICE=palm_smartphone_type all-wr for O2 Germany, UK and Ireland / Movistar Spain / SFR France

This should begin a process within the 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.

=== If the build fails ===

If the make command fails, you can use <pre>make clobber</pre> to clean up the build directory. After this you can re-run the command.

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

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

If you are running Ubuntu using 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.

CD to the folder where your new jar file is, and type something like:

java -jar webosdoctorp100ewwsprint-1.3.5.1.jar

If you were using a VM or some other virtual method, you will need to copy the jar file out to your main operating system before running it.

''Windows host:''

[http://ubuntuexperiment.wordpress.com/2008/11/12/sharing-folders-between-host-and-guest-os-in-virtualbox/ VirtualBox folder Sharing]

[http://www.howtogeek.com/howto/ubuntu/how-to-share-folders-with-your-ubuntu-virtual-machine-guest/ VMWare folder Sharing]

''Mac OSX host:''

[http://davidherron.com/blog/topics/628-virtualbox-running-ubuntu-accessing-host-file-system-mac-os-x VirtualBox folder Sharing]

: ''NOTE: this only applies to WUBI Users''
You should be able to run the JAR as if you had Linux installed natively because in a sense you do (as long as Java is installed and you run the Jar using Java) but if you rather run it in windows

Using terminal the following command in a Wubi installation of Ubuntu will copy the JAR file to the host Windows OS :<pre>cp /meta-doctor/build/pre-p100eww-sprint-1.2.1/webosdoctorp100ewwsprint-1.2.1.jar /host/webosdoctorp100ewwsprint-1.2.1.jar</pre>
This will place the Jar either in your Windows C:\ drive or whatever drive you installed Wubi to.

== Once the Doctor is running ==

# Select your language
# Accept the license agreement
# 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:

# With the USB cable connected, completely power off the Pre (hold down the power button until the option to power off appears)
# Hold down the Up button on the volume rocker
# While holding the Up button, power on the Pre
# "Next" should now be enabled - proceed with the recovery
{{tux|Tux_with_Pre.png|float:right;}}
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.

----

After the doctor completes, you will need to run the "First Run" application. To do this, you will need an active internet connection. Either WiFi or Cellular. If you do not have WiFi and cannot connect to the Palm Profile servers, you might have a problem with your programming. This Meta Doctor (or webOS Doctor in general) could possibly erase the modem's programming. To resolve you will need to perform the following steps:

'''Note:''' This has only been confirmed to resolve Sprint CDMA issues, YMMV.

'''Note 2:''' You should try to update your profile first. Open the phone app, open the App Menu and select ''Preferences'' then select ''Update Network Settings''. If you get an error, then procede with these instructions.
*'''1.''' Open the Phone App.
*'''2.''' Enter ''##MSL#'' (MSL= 6 digit lock code. Get this from Sprint.)
*'''3.''' Verify your MDN and MSID are incorrect. If they are incorrect, continue. If they are correct, this is not your problem and you should not continue.
*'''4.''' Select ''Edit''.
*'''5.''' Select the first box (MDN) and enter your 10-digit cellular number.
*'''6.''' Select the second box (MSID) and enter your 10-digit MSID (Get this from Sprint).
*'''7.''' Select ''Save''.
*'''8.''' Backswipe out of the the view.
*'''9.''' You should now be able to open complete '''Note 2''' above without any errors.

You should now be able to run the ''First Use'' application without any problems.

=If the Doctor will not run=
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.

=Miscellaneous=
Clarification for Linux beginners on where to place the prefsDB.sl file, per instructions in the makefile.
Steps:
1. Open makefile using a text editor (like WordPad) and use the instructions there to retrieve your prefsDB.sl file from your device. Save it somewhere convenient on your host machine (aka, computer).
2. Navigate to the meta-doctor directory and create the config directory: mkdir -p config
3. Rename your prefsDB.sl file to com.palm.wifi.prefsDB.sl
4. Put com.palm.wifi.prefsDB.sl in the config directory.
5. Continue following instructions in the makefile.

==How to enable WIFI profiles==
To enable wifi profiles it is necessary to copy your wifi profile file off of your phone and place this in a directory, as well as enable the wifi profile option in the makefile.

# Move to the meta-doctor directory (cd meta-doctor)
# Create a "config" folder in the meta-doctor directory (mkdir config)
# Copy the prefsDB.sl file off of your phone from the var/preferences/com.palm.wifi/ and into the "config" directory that you just created.
# Rename this file "com.palm.wifi.prefsDB.sl" without the quotes
# Open the makefile (which is in the meta-doctor directory) and remove the "#" from the line "# INSTALL_WIFI_PROFILES = 1". Save the makefile.
# Build the custom doctor by running the script, or otherwise building it.

On launch of the new doctor your wifi profile should automatically connect, but '''only if''' you had previously connected to the WIFI network you are trying to use.

See these links for more information: [http://forums.precentral.net/webos-internals/276460-how-install-webos-2-1-0-pre-pre-using-meta-doctor-27.html#post2882495 Post 1], [http://discussion.treocentral.com/webos-internals/276460-how-install-webos-2-1-0-pre-pre-using-meta-doctor-43.html#post2884415 Post 2].

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

[http://forums.precentral.net/gsm-pre/211728-modifying-webos-carrier-network-settings.html#post2002079 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. webOS 1.3.1 allows setting of the providers data directly from the activation screen for providers that are present in the DB. Some report that they are not able to do that and that they cannot get 3G datacom working on 1.3.1

== Problems with Novacom ==
If you are Running a new Distro, like Archlinux, you could run into problem with novacom while trying to connect your pre. Running novacomd on the command line could provide further information. This may be a problem with libusb. Get a older version like described in [http://developer.palm.com/distribution/viewtopic.php?f=11&t=4233&start=0 this thread].

== How to Install webOS 2.x on "unoffical" Devices==
With the release of the O2-DE webOS Doctor, efforts have been made to apply the techniques of MetaDoctor and create a custom doctor to apply 2.1.0 to devices that it was not been officially released for. For those not faint of heart, a step-by-step can be found at the following: [[WebOS 2 Upgrade]]

== Cygwin Note (unconfirmed) ==

Do not do this unless you experience the problem it is said to solve.

I used a WinXP box with cygwin and everything worked fine, except I had to add the switch --no-same-owner in line 802 of the Makefile. That's because I'm as root in cygwin and without this switch the tar-command failed.

Code:
mkdir -p build/${PATIENT}/webOS
${TAR} --no-same-owner -C build/${PATIENT}/webOS \
-f build/${PATIENT}/resources/webOS.tar \
-x ./${CUSTIMAGEOLD}.rootfs.tar.gz ./${INSTIMAGEOLD}.uImage ./${BOOTLOADEROLD}.bin ./${CODENAMEOLD}.xml ./installer.xml

Application:Preware

2010-10-14T04:14:19Z

Johncc:

[[Category:Application]]
This page is currently available in three languages:
:[[Image:Australia.png]] [[Image:USA.png]] [[Application:Preware]]
:[[Image:France.png]] [[Application:Preware-FR]]
:[[Image:Germany.png]] [[Application:Preware-DE]]

{{application
|name=Preware
|type=webOS
|version=Version: 1.3.6 (5 Sep 2010)
|tag=Utilities
|screenshot=Preware_ss1.png
|description=
}}

 
=Summary=

[[image:Icon_Preware.png|frameless|left]]
Preware is a package management application for the Palm Pre and the Palm Pixi. Preware allows the user to install any package from any of the open standard package repositories on preware.org (or any other location that hosts an open standard package repository). Preware relies on a custom written service developed from community research which allows the mojo app to talk to the built-in ipkg tool.

'''Preware requires webOS 1.4.0 or later to function. Do not try to install it on earlier webOS versions, it will not work.'''

This application was the result of extensive community-based design in [[IPKG Service]] and [[Preware Design]].

For application management, Preware can access more applications, and has more features, than any other on-device package installer.

And since it is open source, and has a completely open development process supported by a team of world-class WebOS Internals developers, it will continue to get better much faster than any other package management application.

Preware is the open application installer that has been written specifically to support a homebrew ecosystem where any developer can upload any application to any submission site, and that application can then be installed by any user. Developers no longer need to upload their applications to multiple submission sites, and users are no longer excluded from accessing applications from any open standard package repository.

 
===Key Features===
Install / Remove / Update:
*Homebrew Applications including advanced applications with special requirements.
*WebOS Themes
*Patches
*webOS Kernels
*Palm App Catalog Applications
*Support for installation of signed packages

 
===Status===
Preware has been upgraded to release status, and is no longer considered beta.

Some milestones worth mentioning in Preware's history include:

* Since 27 August 2009 it is the only over-the-air installer for the palm capable of installing advanced palm applications such as the [[On_Screen_Keyboard|On Screen Keyboard]] or the terminal application.
* Since 27 August 2009 it is the only application supporting installation from all existing palm homebrew feeds.
* Since 17 September 2009 it also supports installation of themes.
* Since 8 October 2009 it also supports installation of webOS patches.
* Since 12 Jan 2010 it also supports all Palm App Catalog feeds.
* Since 3 May 2010 it also supports installation of webOS custom kernels.
* Since 20 July 2010 it also supports installation of packages from URLs and local files.
* Since 24 July 2010 is also supports blacklisting packages and authors.

 
===License===
Please be aware that org.webosinternals.preware is licensed under the [http://www.gnu.org/licenses/gpl-2.0.html GPLv2].

Code from Preware cannot be used by a closed source application. If you want to use them in a non-GPLv2 but otherwise open source application, please contact the [mailto:support@webos-internals.org authors].

 
=Installing Preware=

There are three supported methods for installing Preware: WebOS Quick Install, Stand Alone Installers, and Command Line.

You do not need to access the Linux command line or "root your Pre" to install or use Preware.

You ''cannot'' use fileCoaster, or PreLoad, or PreUpdate to install or update Preware. Those tools are unable to operate correctly on advanced homebrew packages.

If you are a developer who uses the Palm emulator, you should know that Preware works just as well on the Emulator as it does on a real device, and is installed in exactly the same way.

 
===Installing Preware with WebOS Quick Install===
You can use version 3.14 or later of [http://forums.precentral.net/canuck-software/228310-webos-quick-install-v3-14-a.html WebOS Quick Install] to install Preware directly from the WebOS Internals feed.

'''Latest Version of WebOS Quick Install available here: [http://forums.precentral.net/canuck-software/228310-webos-quick-install-v3-14-a.html WebOS Quick Install v3.14]'''

# Install the required Software
## [http://www.java.com/en/download/installed.jsp?detect=jre&try=1 Click here] to verify that you have the latest java installed on your computer and update if needed
## [http://images.precentral.net/sites/precentral.net/files/webos-homebrew-apps/wosqi/WebOSQuickInstall.jar Click Here] to download the latest version of WebOS Quick Install
## Optionally, [http://www.webos-internals.org/wiki/Webos_Doctor_Versions Click here] to download the current webOS Doctor for your carrier and phone in a subdirectory your will remember (maybe "Palm"?) and the same one in which WebOSQuickInstall will execute. If you already have it, skip this step.
##* You do not need to download webOS Doctor separately unless you wish to do so, as WebOSQuickInstall will download it itself if not found.
##* '''Do not run the webOS Doctor'''
# Put your device in [[Getting started|Developer Mode]]
# Connect your device to your computer with the USB cable, and select "Just Charge" (do not select USB Drive)
# Run WebOS Quick Install. If webOS Doctor is not present, you will be asked if you wish to download it prior to execution.
# Click the third button on the right (Blue Down Arrow)
# Choose WebOS Internals Feed (Pre) or WebOS Internals Feed (Pixi) from the drop-down list at the top.
# Select ''Preware'' from the list.
# Click Download.
# Click Close.
# Click Install.

 
===Installing Preware with the Standalone Installer===
Preware installers can be downloaded here: [http://get.preware.org Preware Standalone Installers]. These instructions are currently only for Mac and PC users.

# Install the required software.
## [http://www.java.com/en/download/installed.jsp?detect=jre&try=1 Click here] to verify that you have the latest version of Java installed on your computer and update it if needed.
## [http://www.webos-internals.org/wiki/Webos_Doctor_Versions Click here] to download the current webOS Doctor for your carrier and phone in a subdirectory you will remember (maybe "Palm"?). If you already have it, skip this step.
##* '''Do not run the webOS Doctor.'''
# Put your device into [[Getting started|Developer Mode]].
#* '''Windows users:''' When connecting your device to the computer for the first time, you will be prompted to install new hardware. Click Next to start the device installation. You may get a message regarding Novacom drivers not being installed. If so, you can disregard it. Once your device is installed, proceed with the Preware installation.
# Download the [http://get.preware.org/PrewareInstaller-1.1.0.jar Preware Standalone Installer] and place it in the same directory as the webOS Doctor .jar file.
# Run the Preware Installer.
# Click on the Tools menu and choose Install Drivers. This will install the Palm Novacom drivers for webOS devices.
# Once the drivers have finished installing, click on Install Preware. After Preware is installed, your device will be unresponsive for a few seconds while Luna restarts.

 
===Installing Preware from the Commandline===
If you have access to the command line of your webOS Device or emulator using Terminal, Novaterm, the "Linux Commandline" in WebOS Quick Install, or other techniques, you can install Preware by typing three lines. This technique is always the shortest and in many ways the simplest, but if you are in any way unsure of operating at the Linux command line, please use either of the methods described above.

<source lang="bash">
cd /tmp
wget http://bit.ly/preware-bootstrap
sh preware-bootstrap</source>

 
===Updating Preware===
To update Preware, just run Preware and select "Package Updates" from the main scene. If an update to Preware is available, it will appear in the list. Then select the "Update" button. Preware will close automatically after the update is complete.

Note that you cannot use fileCoaster, or PreLoad, or PreUpdate to install or update Preware. Those tools are unable to operate correctly on advanced homebrew packages.

 

===Removing Preware===
''Why would you ever want to remove Preware?''

To remove Preware, hold the Orange button on your keypad and choose Preware from the Launcher. Choose Delete.

 
=Usage=

===Preferences===
{| Width="70%" VAlign="top"
|valign="top"|[[image:Preferences.png|160px|frameless|left|text-top]]
|valign="top"|You can select preferences in the top left corner of the Pre to bring up the preferences screen. On the Preferences screen you can specify the look of the application, the frequency that feeds are updated, and what Preware will show you by default.
 
{| style="color:black; background-color:#F9F9F9;border:1px outset;" cellpadding="3" cellspacing="0"
|TIP:
|-
|To make it easier to find things, set "Show Available Types" to yes. This will show separate categories (Applications/Themes/Patches/etc.) rather than show everything in one long list.
|}
|}
 

===Feed Management===
{| Width="70%" VAlign="top"
|valign="top"|[[image:Preware_feeds.png|160px|frameless|left|text-top]]
|valign="top"|In the preferences section on the top bar on the right side is a button that takes you to the feeds screen. On the feeds screen you can select which feeds are loaded and which ones are not. Simply select the on or off button for that feed. (If you are not interested in themes you can disable the two feeds for themes to speed up the updating of feeds) Preware comes with the following feeds by default (some are disabled by default, but are easily enabled if desired).

{| style="color:black; background-color:#FFFFE0;" cellpadding="3" cellspacing="0" Border="1"
|align="center" colspan="4" | '''Default Feeds'''
|-
|align="center" | [http://ipkg.preware.org/feeds/palm-beta/ Palm Beta]
|align="center" | [http://ipkg.preware.org/feeds/palm-beta-updates Palm Beta Updates]
|align="center" | [http://ipkg.preware.org/feeds/palm-catalog/ Palm Catalog]
|align="center" | [http://ipkg.preware.org/feeds/palm-catalog-updates/ Palm Catalog Updates]
|-
|align="center" | [http://ipkg.preware.org/feeds/palm-web-updates/ Palm Web]
|align="center" | [http://ipkg.preware.org/feeds/palm-web-updates/ Palm Web Updates]
|align="center" | [http://ipkg.preware.org/feeds/precentral-themes/ PreCentral]
|align="center" | [http://ipkg.preware.org/feeds/precentral-themes/ PreCentral Themes]
|-
|align="center" | [http://ipkg.preware.org/feeds/webos-internals/ WebOS Internals]
|align="center" | [http://ipkg.preware.org/feeds/optware/ Optware]
|align="center" | [http://ipkg.preware.org/feeds/webos-patches/ WebOS Patches]
|align="center" | [http://ipkg.preware.org/feeds/webos-kernels/ WebOS Kernels]
|-
|}
|}

{| style="color:black; background-color:#F9F9F9;border:1px outset;" VAlign="middle" cellpadding="3" cellspacing="0" Width="70%"
|align="center" | See [[Testing Feeds]] for detailed instructions on adding custom feeds.
|}
 

===Package Updates===
{| Width="70%" VAlign="top"
|valign="top"|[[image:UpdateFeeds.png|160px|frameless|left|text-top]]
|valign="top"|To update feeds, simply select "Update Feeds" from the Application Menu. Preware will download the package list information from your enabled feeds. After processing the data, you will be back at the main list of available items.
|}
 

===Installing Packages===
{| Width="70%" VAlign="top"
|valign="top"|[[image:SelectApp.png|160px|frameless|left|text-top]]
|valign="top"|There are a few ways to select and install a "package" (application/patch/theme/etc.). Using "List of Everything" would be the simplest.
#Find the package you want to install either by scrolling and tapping on it, or just start typing
#Tap the "Install" button that the bottom of the package's page to install.
|}
 

===Removing Packages===
{| Width="70%" VAlign="top"
|valign="top"|[[image:RemoveAppTap.png|160px|frameless|left|text-top]]
|valign="top"|Removing a package is just as easy.
#On the main screen, tap "Installed Packages", then the category of the package you want to remove
#Tap the Package you want to remove
#Tap the "Remove" button that the bottom of the package's page.
|}
 



= Operating notes =

===Limitations===
No known limitations.

 
===Known bugs===
*When selecting a patch with dependencies, if you view those dependencies then install them, when Preware returns you to the original patch's screen it will still have the 'install' button showing even though it is installed successfully. Swiping back and returning will show the correct status.

*The Update All button can get confused if there are patches with complex dependencies. This will be fixed in a future version.

*If updates to App Catalog applications are pending, they will be silently skipped when using the Update All button.

*The Updates feature from the regular Palm Launcher, may claim that application updates are needed, and then when the user clicks Show Updates shows the App Catalog's installed applications, there are none shown that need updating. This isn't as expected. This is because an app that was previously only in Preware has now migrated to the Palm Catalog. Don't worry, your apps are up to date (with the possible exception of the one with the conflict.) This is not a bug in Preware per se' but an app version conflict because the app is in both the Palm Catalog and also in Homebrew. Notice that you don't need to remove Preware to install the app from the official catalog, but simply disable the feed in Preware then "update feeds" to refresh the list then it should install fine from the official app catalog.

 
=Changelog=
 
For those interested, the full Changelog can be [http://git.webos-internals.org/?p=applications/preware.git;a=tags found here]. Listed below is the Changelog since the 1.0 milestone.
 

;1.3.6:
* Preware now supports installation of application package files (.ipk files) directly from URLs, email attachments, and local files.
* Also supported are Send to Preware links on homebrew application gallery and news websites (this requires the Neato! application to also be installed).
* If Preware continually asks you about file associations on every single launch, even after you have answered Yes to the questions it asks, then you may have a damaged file association table and will need to run the Emergency MimeTable Reset tool and then reboot to repair it.

;1.3.5:
* Updated German translations.

;1.3.3:
* Always ask the user before modifying the file association list.
* Updated French translations.

;1.3.1:
* Check whether Preware is the default application for handling packages, and advise the user if it is not.

;1.3.0:
* Added Preware to the Default Applications list to allow for installing packages from email messages and the browser.

;1.2.9:
* Fixed the Saved Package List swipe to delete bug.

;1.2.8:
* Open the My Applications app catalog screen when multiple app catalog applications need updating.

;1.2.7
* Fixed the Install Package problem when running on the emulator.

;1.2.6
* Remove most of the curl download progress messages from the ipkg log (this fixes a buffer overrun crash).

;1.2.5
* Added Ask At Launch option to update preference.
* Added Blacklist support.
* German Translation updates.
* Fixed update banner problem.
* Fixed package with too many dependent packages problem.

;1.2.4
* Added support for MinWebOSVersion, DeviceCompatibility and PreActionMessage package attributes.

;1.2.3
* Enable the Install Package feature to also work for incorrectly formatted filenames.

;1.2.1
* Robustified the Install Package feature - will now run post-install scripts for all correctly formatted filenames (packageid_version_arch.ipk).

;1.2.0
* Added Install Package functionality, allowing installation of packages from URLs and local files.
* Moved Saved Package List from the main screen to the app menu.

;1.1.7
* Added support for Kernel Modules.

;1.1.5
* Use a gentler reboot procedure to allow open files to be flushed to disk.

;1.1.4
* Fixed hang on package download failures.

;1.1.2
*Added support for the ENABLE_TESTING_FEEDS Meta-Doctor feature.
*Removed the tag line about eventually reaching 1.0.
*Minor French translation updates, courtesy of Yannick LE NY.

;1.1.1
*Added languages field in package descriptions.
*Added preference to only show packages with English descriptions.

;1.1.0
*Now defaults (selectable by a preference option) to using an alternative installation method to avoid the webOS 1.4 rescan bug which closes and stops notifications from your phone, email and messaging applications.
*Updated German and French translations.
*Fixed deletion of disabled feeds.
*Added service version number to the ipkgservice API. Robustified the service upgrade process.

;1.0.0
*The Package Manager Service has been rewritten in C and incorporated into this single Preware package.
*Installing Preware 1.0.0 will remove the Package Manager Service as the last step of the upgrade process.

 
=Repository=
Preware and the Package Manager Service are housed in the applications/preware git repository at http://git.webos-internals.org/

For commit permission to the open source project, contact rwhitby on #webos-internals or email [mailto:support@webos-internals.org support@webos-internals.org]