Difference between revisions of "Template:Tenderloin Install Steps"

From WebOS-Ports
Jump to navigation Jump to search
m (WebOS -> webOS)
 
(38 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 
==Preparing your device & installation instructions==
 
==Preparing your device & installation instructions==
  
−
1. Create an ext3fs lvm partition of at least 1GB (use [http://forums.webosnation.com/webos-internals/304871-tailor-device-live-partition-filesystem-editor-beta-testing.html Tailor] or [http://www.webos-internals.org/wiki/UbuntuChroot#Step_1:_Creating_a_WebOS_Doctor Meta-Doctor] to achieve this). It must be named '''ext3fs''' ! Tailor automatically uses this name for an ext3 partition.
+
'''These instructions will guide you on how to create a dual boot on your TouchPad with webOS 3.0.x and LuneOS.'''
  
−
2. [http://www.androidfilehost.com/?fid=23212708291676440 Download the latest Moboot (0.3.8)] with filename moboot_038-tenderloin.zip
+
Prerequisites: You need to have Novacom/Novaterm installed on your machine. These are included in the PDK/SDK for example. Most of the links on the HP sites are no longer working, but you can still get them using the [http://forums.webosnation.com/webos-development/325645-looks-like-you-cant-get-sdk-anymore-almost.html links provided in this topic on WebOSNation] or at [http://www.openwebosproject.org/opensource/packages.html Open WebOS Project].
  
−
3. Unpack moboot_038-tenderloin.zip and you will have a file called uImage.moboot_0.3.8
+
===Creating a partition to host LuneOS===
  
−
2. Download the [http://build.webos-ports.org/webos-ports-staging/wip/images/tenderloin/webos-ports-dev-image-tenderloin.tar.gz image], copy it to the USB drive (/media/internal) and extract it into the new partition by issuing the following commands:
+
You need a lvm partition of at least 1GB to host LuneOS. You want to separate LuneOS from legacy webOS and optware, Ubuntu/Debian chroots and probably Android. For people that know their way around Linux and lvm, just create a lvm partition named "/dev/store/luneos-root" with ext3, maybe following [http://www.webos-internals.org/wiki/UbuntuChroot#Alternative_Step_1:_Re-partitioning_by_hand this guide] and adjusting to your needs. For everybody else I recommend the use of [http://forums.webosnation.com/webos-internals/304871-tailor-device-live-partition-filesystem-editor-beta-testing.html Tailor]. Please note that Tailor 0.3.1 added support for luneos-root, while earlier versions didn't support it.
  
−
<code>mkdir /media/ext3fs && mount /dev/store/ext3fs /media/ext3fs</code>
+
1. Reboot your TouchPad into webOS.
  
−
<code>cd /media/internal</code>
+
2. Start Tailor
  
−
<code>tar xzf webos-ports-dev-image-tenderloin.tar.gz -C /media/ext3fs</code>
+
3. Select "USB (media)" and select "Unmount Partition"
  
−
3. Download the kernel (luneos.uImage) and add it to the boot partition as uImage.LuneOS and either symlink it to uImage or use moboot. Follow the instruction below:
+
4. Now press "Check Filesystem" (USB should still be selected). This will take a while.
  
−
* Boot into webOS (make sure to have Developer Mode enabled!)
+
5. Now Select "Resize Partition" as activity (this will only be available after a filesystem check) and reduce the size by 1000-2000 MiB. This will take even longer.
  
−
* Run novaterm
+
6. Now select "Unused space" in the list of partitions, select "luneos-root" in Tailor 0.3.1 or higher or "Android (system)" (in Tailor 0.3.0 or lower) as partition type and create the partition.
  
 +
If you happen to have Android installed on your TouchPad and can not select "Android (system)" in Tailor, please run the following command in a command line on your device (see step 8 for command line instructions):
 +
 +
<code>lvrename /dev/store/cm-system /dev/store/cm-system-disabled</code>
 +
 +
Also make sure to follow the last step of this section and do not boot Android in between.
 +
 +
7. Now select "USB (media)" form partition list again, select "Mount partition" as activity and press the button.
 +
 +
The following steps are only required with Tailor 0.3.0 and lower, with Tailor 0.3.1 you DON'T need to follow step 8 and 9.
 +
 +
8. When the partition is created go into a command line on your device. The best way is probably to hook up the TP to your Computer and run [http://www.webos-internals.org/wiki/Accessing_Linux_Using_Novaterm novaterm].
 +
 +
9. Run the following command on device:
 +
 +
<code>lvrename /dev/store/cm-system /dev/store/luneos-root</code>
 +
 +
10. To check if everything went well, run this command: <code>lvscan</code>
 +
 +
The results should look like
 
<code>
 
<code>
−
mount -o remount,rw /boot
+
  ACTIVE            '/dev/store/root' [568.00 MB] inherit
 +
  ACTIVE            '/dev/store/var' [64.00 MB] inherit
 +
  ACTIVE            '/dev/store/update' [16.00 MB] inherit
 +
  ACTIVE            '/dev/store/log' [24.00 MB] inherit
 +
  ACTIVE            '/dev/store/mojodb' [256.00 MB] inherit
 +
  ACTIVE            '/dev/store/filecache' [136.00 MB] inherit
 +
  ACTIVE            '/dev/store/media' [19.86 GB] inherit
 +
  ACTIVE            '/dev/store/swap' [400.00 MB] inherit
 +
  ACTIVE            '/dev/store/luneos-root' [2.09 GB] inherit
 +
</code>
 +
Of course this depends a bit on what you use on your system. But important is the luneos-root part.
 +
 
 +
In case you're using Tailor 0.3.0 or lower and have Android on your Touchpad, you want to check the following as well:
 +
 
 +
11. If you had to rename the Android partition before, restore it with the following command:
 +
 
 +
<code>lvrename /dev/store/cm-system-disabled /dev/store/cm-system</code>
 +
 
 +
==Install the kernel==
 +
'''The following steps you need to do on your local PC'''
 +
 
 +
1. [http://www.androidfilehost.com/?fid=23212708291676440 Download the latest Moboot (0.3.8)] with filename moboot_038-tenderloin.zip
 +
 
 +
2. Unpack moboot_038-tenderloin.zip and you will have a file called uImage.moboot_0.3.8
 +
 
 +
3. Download the [http://build.webos-ports.org/luneos-stable/images/tenderloin/uImage kernel (uImage)] and add it to the boot partition as uImage.LuneOS and either symlink it to uImage or use Moboot. Follow the instruction below when using Moboot:
 +
 
 +
'''At this stage you have the following 2 files in a local folder/directory on your pc: uImage.moboot_0.3.8 and uImage'''
 +
 
 +
- Boot into webOS (make sure to have Developer Mode enabled!)
 +
 
 +
- Run novaterm
 +
 
 +
<code>mount -o remount,rw /boot
  
 
cd /boot
 
cd /boot
Line 28: Line 80:
 
rm uImage
 
rm uImage
  
−
exit
+
exit</code>
 +
 
 +
You '''should''' now be back at your command prompt on the OS (Linux, Windows, Mac OS) on your PC. In case you don't get returned to your command prompt, you can always open another one!
 +
From here run the following commands:
  
−
novacom put file://boot/uImage.LuneOS < luneos.uImage
+
(You need to make sure you can run novacom from the folder with uImage.moboot_0.3.8 and uImage (in Windows you need to add the folder/directory with Novacom to your PATH variable, [http://www.computerhope.com/issues/ch000549.htm instructions for this can be found here]). Another solution is to copy the 2 files uImage.moboot_0.3.8 and uImage to the folder where your Novacom is located.
  
−
novacom put file://boot/uImage < uImage.moboot_0.3.8
+
<code>
 +
novacom put file://boot/uImage.LuneOS < uImage
 +
 
 +
novacom put file://boot/uImage.moboot < uImage.moboot_0.3.8
  
 
novaterm
 
novaterm
  
 
cd /boot
 
cd /boot
 +
 +
ln -sf uImage.moboot uImage
  
 
ln -sf uImage-2.6.35-palm-tenderloin uImage.webOS
 
ln -sf uImage-2.6.35-palm-tenderloin uImage.webOS
Line 46: Line 106:
 
[[File:moboot.png|400px]]
 
[[File:moboot.png|400px]]
  
−
==Reinstalling the image==
+
==Install the image==
−
Sometimes it might be necessary to reinstall the image, in order to do so follow these steps:
+
Download the [http://build.webos-ports.org/luneos-stable/images/tenderloin/luneos-dev-image-tenderloin.tar.gz image], copy it to the USB drive (/media/internal), eject the USB drive, and extract the image into the new partition by issuing the following commands (using Novaterm or Command Line in WebOSQuickInstall):
 +
 
 +
<code>
 +
mount -o remount,rw /
 +
 
 +
mkdir /media/luneos-root
 +
 
 +
mount /dev/store/luneos-root /media/luneos-root
 +
 
 +
cd /media/internal
 +
 
 +
tar xzf luneos-dev-image-tenderloin.tar.gz -C /media/luneos-root
 +
</code>
 +
 
 +
If you installed LuneOS into ext3fs before and had no issues (because you don't use optware or a chroot in webOS), you can stay with that. Just exchange "ext3fs" against "luneos-root" in the instructions above.
 +
 
 +
==Installing a newer or different image==
 +
 
 +
===Using webOS===
 +
 
 +
# reboot your Touchpad into webOS
 +
# copy the new or different image to the USB drive
 +
# eject the USB drive
 +
# using Novaterm or Command Line in WebOSQuickInstall:
 +
 
 +
<code>
 +
mount /dev/store/luneos-root /media/luneos-root
 +
 
 +
rm -rf /media/luneos-root/*
 +
 
 +
tar xzf /media/internal/luneos-dev-image-tenderloin.tar.gz -C /media/luneos-root
 +
</code>
 +
 
 +
If you installed LuneOS into ext3fs before and had no issues (because you don't use optware or a chroot in webOS), you can stay with that. Just exchange "ext3fs" against "luneos-root" in the instructions above.
 +
 
 +
In case you also want to replace the kernel you need to do the following steps as well:
 +
 
 +
<code>mount -o remount,rw /boot</code>
 +
 
 +
On your PC issue the following command in the directory where your uImage is located:
  
−
<code>rm -rf /media/ext3fs</code>
+
<code>novacom put file://boot/uImage.LuneOS < uImage</code>
  
−
<code>cd /media/internal</code>
+
===Using Android===
  
−
<code>tar xzf webos-ports-dev-image-tenderloin.tar.gz -C /media/ext3fs</code>
+
# reboot your Touchpad into Android
 +
# copy the new or different image (both kernel and system) to the USB drive
 +
# authorize access through ADB, including root access
 +
# open a terminal on your PC, and start an adb shell:
 +
 
 +
<code>adb shell</code>
 +
 
 +
# now the steps are similar as for the install from webOS:
 +
 
 +
<code>
 +
mkdir /media/luneos-root
 +
 
 +
mount -t ext3 /dev/store/luneos-root /media/luneos-root
 +
 
 +
rm -rf /media/luneos-root/*
 +
 
 +
tar xzf /storage/sdcard0/Downloads/luneos-dev-image-tenderloin.tar.gz -C /media/luneos-root
 +
 
 +
umount /media/luneos-root
 +
</code>
 +
 
 +
If you installed LuneOS into ext3fs before and had no issues (because you don't use optware or a chroot in webOS), you can stay with that. Just exchange "ext3fs" against "luneos-root" in the instructions above.
 +
 
 +
In case you also want to replace the kernel you need to do the following steps as well:
 +
 
 +
<code>
 +
mount -o remount,rw /boot
 +
 
 +
cp /storage/sdcard0/Downloads/uImage /boot/uImage.LuneOS
 +
</code>

Latest revision as of 18:32, 3 December 2017

Preparing your device & installation instructions

These instructions will guide you on how to create a dual boot on your TouchPad with webOS 3.0.x and LuneOS.

Prerequisites: You need to have Novacom/Novaterm installed on your machine. These are included in the PDK/SDK for example. Most of the links on the HP sites are no longer working, but you can still get them using the links provided in this topic on WebOSNation or at Open WebOS Project.

Creating a partition to host LuneOS

You need a lvm partition of at least 1GB to host LuneOS. You want to separate LuneOS from legacy webOS and optware, Ubuntu/Debian chroots and probably Android. For people that know their way around Linux and lvm, just create a lvm partition named "/dev/store/luneos-root" with ext3, maybe following this guide and adjusting to your needs. For everybody else I recommend the use of Tailor. Please note that Tailor 0.3.1 added support for luneos-root, while earlier versions didn't support it.

1. Reboot your TouchPad into webOS.

2. Start Tailor

3. Select "USB (media)" and select "Unmount Partition"

4. Now press "Check Filesystem" (USB should still be selected). This will take a while.

5. Now Select "Resize Partition" as activity (this will only be available after a filesystem check) and reduce the size by 1000-2000 MiB. This will take even longer.

6. Now select "Unused space" in the list of partitions, select "luneos-root" in Tailor 0.3.1 or higher or "Android (system)" (in Tailor 0.3.0 or lower) as partition type and create the partition.

If you happen to have Android installed on your TouchPad and can not select "Android (system)" in Tailor, please run the following command in a command line on your device (see step 8 for command line instructions):

lvrename /dev/store/cm-system /dev/store/cm-system-disabled

Also make sure to follow the last step of this section and do not boot Android in between.

7. Now select "USB (media)" form partition list again, select "Mount partition" as activity and press the button.

The following steps are only required with Tailor 0.3.0 and lower, with Tailor 0.3.1 you DON'T need to follow step 8 and 9.

8. When the partition is created go into a command line on your device. The best way is probably to hook up the TP to your Computer and run novaterm.

9. Run the following command on device:

lvrename /dev/store/cm-system /dev/store/luneos-root

10. To check if everything went well, run this command: lvscan

The results should look like 

 ACTIVE            '/dev/store/root' [568.00 MB] inherit
 ACTIVE            '/dev/store/var' [64.00 MB] inherit
 ACTIVE            '/dev/store/update' [16.00 MB] inherit
 ACTIVE            '/dev/store/log' [24.00 MB] inherit
 ACTIVE            '/dev/store/mojodb' [256.00 MB] inherit
 ACTIVE            '/dev/store/filecache' [136.00 MB] inherit
 ACTIVE            '/dev/store/media' [19.86 GB] inherit
 ACTIVE            '/dev/store/swap' [400.00 MB] inherit
 ACTIVE            '/dev/store/luneos-root' [2.09 GB] inherit

Of course this depends a bit on what you use on your system. But important is the luneos-root part.

In case you're using Tailor 0.3.0 or lower and have Android on your Touchpad, you want to check the following as well:

11. If you had to rename the Android partition before, restore it with the following command:

lvrename /dev/store/cm-system-disabled /dev/store/cm-system

Install the kernel

The following steps you need to do on your local PC

1. Download the latest Moboot (0.3.8) with filename moboot_038-tenderloin.zip

2. Unpack moboot_038-tenderloin.zip and you will have a file called uImage.moboot_0.3.8

3. Download the kernel (uImage) and add it to the boot partition as uImage.LuneOS and either symlink it to uImage or use Moboot. Follow the instruction below when using Moboot:

At this stage you have the following 2 files in a local folder/directory on your pc: uImage.moboot_0.3.8 and uImage

- Boot into webOS (make sure to have Developer Mode enabled!)

- Run novaterm

mount -o remount,rw /boot

cd /boot

rm uImage

exit

You should now be back at your command prompt on the OS (Linux, Windows, Mac OS) on your PC. In case you don't get returned to your command prompt, you can always open another one! From here run the following commands:

(You need to make sure you can run novacom from the folder with uImage.moboot_0.3.8 and uImage (in Windows you need to add the folder/directory with Novacom to your PATH variable, instructions for this can be found here). Another solution is to copy the 2 files uImage.moboot_0.3.8 and uImage to the folder where your Novacom is located.

novacom put file://boot/uImage.LuneOS < uImage

novacom put file://boot/uImage.moboot < uImage.moboot_0.3.8

novaterm

cd /boot

ln -sf uImage.moboot uImage

ln -sf uImage-2.6.35-palm-tenderloin uImage.webOS

ls -l

Output should look like: Moboot.png

Install the image

Download the image, copy it to the USB drive (/media/internal), eject the USB drive, and extract the image into the new partition by issuing the following commands (using Novaterm or Command Line in WebOSQuickInstall):

mount -o remount,rw /

mkdir /media/luneos-root

mount /dev/store/luneos-root /media/luneos-root

cd /media/internal

tar xzf luneos-dev-image-tenderloin.tar.gz -C /media/luneos-root

If you installed LuneOS into ext3fs before and had no issues (because you don't use optware or a chroot in webOS), you can stay with that. Just exchange "ext3fs" against "luneos-root" in the instructions above.

Installing a newer or different image

Using webOS

  1. reboot your Touchpad into webOS
  2. copy the new or different image to the USB drive
  3. eject the USB drive
  4. using Novaterm or Command Line in WebOSQuickInstall:

mount /dev/store/luneos-root /media/luneos-root

rm -rf /media/luneos-root/*

tar xzf /media/internal/luneos-dev-image-tenderloin.tar.gz -C /media/luneos-root

If you installed LuneOS into ext3fs before and had no issues (because you don't use optware or a chroot in webOS), you can stay with that. Just exchange "ext3fs" against "luneos-root" in the instructions above.

In case you also want to replace the kernel you need to do the following steps as well:

mount -o remount,rw /boot

On your PC issue the following command in the directory where your uImage is located:

novacom put file://boot/uImage.LuneOS < uImage

Using Android

  1. reboot your Touchpad into Android
  2. copy the new or different image (both kernel and system) to the USB drive
  3. authorize access through ADB, including root access
  4. open a terminal on your PC, and start an adb shell:

adb shell

  1. now the steps are similar as for the install from webOS:

mkdir /media/luneos-root

mount -t ext3 /dev/store/luneos-root /media/luneos-root

rm -rf /media/luneos-root/*

tar xzf /storage/sdcard0/Downloads/luneos-dev-image-tenderloin.tar.gz -C /media/luneos-root

umount /media/luneos-root

If you installed LuneOS into ext3fs before and had no issues (because you don't use optware or a chroot in webOS), you can stay with that. Just exchange "ext3fs" against "luneos-root" in the instructions above.

In case you also want to replace the kernel you need to do the following steps as well:

mount -o remount,rw /boot

cp /storage/sdcard0/Downloads/uImage /boot/uImage.LuneOS

Retrieved from "http://webos-ports.org/index.php?title=Template:Tenderloin_Install_Steps&oldid=10327"