Application:MetaDoctor-DE

From WebOS Internals
Jump to navigation Jump to search

Diese Seite existiert derzeit in vier Sprachen

Australia.png USA.png Application:MetaDoctor
France.png Application:MetaDoctor-FR
Germany.png Application:MetaDoctor-DE
Mexico.png Spain.png Application:MetaDoctor-ES

Translation in progress

Was ist der MetaDoctor?

Der WebOS Internals MetaDoctor ist ein Makefile, der eine Kopie des HP WebOS Doctors modifizieren kann, bevor dieser auf ein webOS Gerät aufgespielt wird. Der MetaDoctor verändert dazu die von HP zur Verfügung gestellte JAR Datei, die den webOS Doctor enthält. Dies kann genutzt werden um den Aktivierungsprozess bei der ersten Benutzung eines webOS Gerätes zu umgehen und das Gerät ohne ein Funknetzwerk zu aktivieren.

Die Dokumentation der Funktionen des MetaDoctors, befindet sich am Anfang des Makefile (du musst das Repositorium klonen und in den Makefile schauen um die möglichen Funktionen zu sehen.)

Schritt 1: Einrichten des MetaDoctors

Unter Windows

ACHTUNG: DIE BENUTZUNG VON CYGWIN UNTER WINDOWS WIRD NICHT LÄNGER UNTERSTÜTZT UND FÜHRT DAZU, DASS DEIN TELEFON NICHT MEHR STARTET

Windowsnutzer können den MetaDoctor nutzen ohne ihre derzeitige Windowsinstallation zu gefährden, indem die den einfachen Ubuntu Installer WUBI nutzen. Es ist hierbei auch nicht nötig irgendwelche Partitionen anzulegen oder Bootloader zu installieren. WUBI erscheint als Programm im Startmenü und wenn es nicht mehr benötigt wird, kann es einfach über die Systemsteuerung -> „Programme deinstallieren“ entfernt werden. Es ist einfach und typische Probleme einer virtuellen Maschine wie USB, Netzwerk und Dateisystem des Host Computers bleiben erspart... Um Zugriff auf das Ubuntu zu erhalten musst du einfach den Computer neu starten und Ubuntu beim Dualboot Menü auswählen.

  1. Lade Ubuntu 11.04 herunter, die Ubuntu Desktop Edition, nicht die Windows Insallter Version
  2. Brenne die Datei auf eine CD oder mounte sie in ein virtuelles Laufwerk
  3. Starte die CD unter Windows (die wubi.exe Datei auf der CD, es wird normalerweise auch als Autostart gestartet) – Starte deinen Computer nicht mit der CD (Diese LiveCD genannte Option gibt dir nicht genügend Platz auf der Festplatte um den MetaDoctor zu nutzen).
  4. Klicke auf Unter Windos installieren.
    Jetzt wird Ubuntu installiert während Windows läuft, ohne extra Partitionen erzeugen zu müssen. Ich empfehle die vollständige 30 Gigabyte Installation wenn du genügend Platz auf der Festplatte hast und daran interessiert bist Ubuntu auch weiter zu nutzen. Anderenfalls reicht auch die minimale Installation, die von Wubi empfohlen wird aus.
  5. Starte deinen Computer neu und du kannst nun bei Start zwischen Windows und Ubuntu auswählen.

Das Schöne dabei ist, dass du Ubuntu deinstallieren kannst, wie du es von anderen Programmen unter Windows gewöhnt bist. Windows ist dann genau wie zuvor als ob nie ein Ubuntu dagewesen wäre und der Dualboot wird auch entfernt. Nicht zu vergessen, dass du dein Laufwerk nicht partitionieren musst.

Wenn du dich immer noch fragst was Wubi eigentlich ist, kannst du hier nach lesen Wubi Guide(engl.) oder hier Wubi(deut.)

Wenn du WUBI installiert hast solltest du nun den Anweisungen im Abschnitt Linux folgen.

Unter Linux

  1. Terminal öffnen (Anwendungen > Zubehör).
  2. Aktualisiere die Paketliste und installiere git und Java Runtime (das Canonical Partner Repositorium wird benötigt um Sun Java JRE zu installieren, weil dies mit der Version 10.04 aus dem Multiverse Repositorium entfernt wurde). Tippe: 
    sudo add-apt-repository "deb http://archive.canonical.com/ lucid partner"
    sudo apt-get update
    sudo apt-get install git
    sudo apt-get install sun-java6-jre
    Um die Java Lizenz zu akzeptieren, drücke solange auf die Tabulatortaste bis 'OK' hervorgehoben ist und drücke dann die Entertaste. Wenn die Java Installation fehl schlägt, schaue in den Support auf der Java Webseite hier. Wenn du einen Fehler von git bekommst, wiederhole das Kommando mit git-core anstelle von git.
  3. Lade die Palm Novacom Software herunter und installiere sie 32-bit oder 64-bit. Wenn du Probleme bei der Installation hast , findest du hier (engl.) Informationen.
  4. Stelle sicher das du nicht als root angemeldet bist und navigiere zu deinem Home Verzeichnis. 
    cd
  5. Lade das MetaDoctor Skript mittels git herunter. 
    git clone git://git.webos-internals.org/tools/meta-doctor.git
  6. Navigiere zu dem MetaDoctor Verzeichnis. 
    cd meta-doctor
  7. Erzeuge ein Downloadverzeichnis. 
    mkdir downloads

Unter Mac OS X 10.6

  1. Installiere als erstes MacPorts. Dies ermöglicht es dir die benötigten Pakete für den MetaDoctor zu installieren. [1]. Bitte beachte , dass MacPorts die Apple Xcode Developer Tools (Version 3.2.1 oder höher für Snow Leopard, 3.1.4 oder höher für Leopard oder 2.5 für Tiger). Diese Tools sind auf der Apple Developer Connection Seite, auf der Mac OS X Installations-CD/DVD oder im App Store zu finden.
  2. Installiere gnutar: 
    sudo port install gnutar
  3. Installiere git: 
    sudo port install git-core
  4. Stelle sicher, dass du nicht als root angemeldet bist und navigiere zu deinem Home Verzeichnis:
    cd
  5. Tippe jetzt folgenden Befehl ein: 
    git clone git://git.webos-internals.org/tools/meta-doctor.git
  6. Installiere Patch:
    sudo port install gpatch
  7. Wenn du Java noch nicht installiert hast, installiere es jetzt. Um Java zu installieren, Klicks auf das Apple Icon und wähle Software Update aus. Der folgende Vorgang aktualisiert Java auf die neuste Version, wenn diese nicht schon installiert ist. Apple nutzt hier seine eigene Java Version. Weitere Informationen sind hier zu finden.

Verwenden einer Virtual Machine

Falls kein Linux System vorhanden ist muss der MetaDoctor unter einer Virtuellen Maschine ausgeführt werden. Für Windows Benutzer gibts 2 Möglichkeiten, Mac Nutzer verwenden die erste Option.

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

Using Cygwin

Windows users can alternatively use Cygwin to run Meta-Doctor. This can often be simpler and faster than installing a full-blown Virtual Machine.

Simply install Cygwin, and include the following additional packages:

  1. Python
  2. Make
  3. Patch
  4. Git
  5. Zip
  6. Unzip
  7. wget

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

After you have installed these packages, you can follow the Linux instructions


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

NB: You can find the Makefile to edit in <cygwin install folder>\home\<username>\meta-doctor

For example 

C:\cygwin\home\johndoe\meta-doctor

Media:Example.ogg

= Step 2: Running the patched webOS 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.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:

VirtualBox folder Sharing

VMWare folder Sharing

Mac OSX host:

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 :

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

This will place the Jar either in your Windows C:\ drive or whatever drive you installed Wubi to.

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, completely power off the Pre (hold down the power button until the option to power off appears)
  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.

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 here if you have further problems connecting your Pre to the running Meta'ed Doctor.

Miscellaneous

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. 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

Retrieved from "http://wiki.webos-internals.org/index.php?title=Application:MetaDoctor-DE&oldid=20015"