WebOS Internals - User contributions [en]

Next steps

2009-07-21T22:50:16Z

Gordian: /* Automated Setup of Optware, Users and Access */

''The old, manual setup of Optware and users can be found [[Setting_up_optware_feed | here]].''

=Automated Setup of Optware, Users and Access=
The webOS community asks that users who have obtained access to the Linux subsystem install a standard set of software to ensure everyone has the necessary tools in place to use the resources the community is providing.

In particular, this includes the Optware package manager. Palm's webOS uses the ''ipkg'' package manager internally. The community has a version of ''ipkg'' called ''ipkg-opt'' which accesses the Optware library of over 1300 Linux programs available for installation on the Pre.

Palm has indicated that they have no intention of using the /opt directory, so we direct our installs to /opt/bin rather than /bin to avoid being overwritten by future Palm software upgrades.

In addition, the standard package creates a non-root user, installs ''sudo'', and includes an SSH program (''dropbear'') and an sftp program.

For your convenience, we've packaged all this up into a simple script.

'''If you're attempting to install these packages to your emulator, you must first add sufficient space by [[Adding_Disks_to_the_Emulator|enabling a virtual disk]].'''

After completing the process of obtaining access to your Pre, do the following:

'''Type each line exactly as it appears. Copying and pasting is probably a good idea.'''

''Note to Windows Putty users: To paste in putty, simply right-click and the program pastes into the terminal whatever you have copied to the clipboard.''

<div style="font-size:140%;">
cd /tmp
wget <nowiki>http://gitorious.org/webos-internals/bootstrap/blobs/raw/master/optware-bootstrap.sh</nowiki>
sh optware-bootstrap.sh
</div>

Follow the on-screen instructions.

If you want to review the script before you run it, you can look here:

[http://gitorious.org/webos-internals/bootstrap/blobs/master/optware-bootstrap.sh http://gitorious.org/webos-internals/bootstrap/blobs/master/optware-bootstrap.sh]

Optionally, you can then install the ''quilt'' patch manager which allows multiple-file patches. (Yes, the pun was intentional. Quilt manages multiple patches.) This installation process has also been packaged into a simple script. It will install quilt, and all of its dependencies, and create a local clone of the WebOS-Internals patch repository.

'''Again, type each line exactly as it appears. Copying and pasting is probably a good idea.'''

<div style="font-size:140%;">
cd /tmp
wget <nowiki>http://gitorious.org/webos-internals/bootstrap/blobs/raw/master/quilt-bootstrap.sh</nowiki>
sh quilt-bootstrap.sh
</div>

If you want to review the script before you run it, you can look here:

[http://gitorious.org/webos-internals/bootstrap/blobs/master/quilt-bootstrap.sh http://gitorious.org/webos-internals/bootstrap/blobs/master/quilt-bootstrap.sh]

Adding Disks to the Emulator

2009-07-21T22:44:56Z

Gordian: /* Enabling Virtual Disk Support for the Emulator In Order to Successfully Setup Optware */

=Enabling Virtual Disk Support for the Emulator In Order to Setup Optware=
Many developers wish to maintain their emulator with the same software as their actual device. In order to install the Optware package manager on your emulator, you will need to allocate a virtual disk for additional storage.

''These instructions assume you are running Windows XP and Sun xVM VirtualBox''.

First run VirtualBox. Ensure that the emulator to which you wish to add storage is in the "Powered Off" state.

Goto "File" -> "Virtual Media Manager" (or Ctrl+D).

Click or select "New" and press "Next."

Choose whether you want a fixed- or dynamic-sized virtual disk then hit "Next."

Click the small folder icon next to the virtual disk's name to choose where the virtual drive will exist. This is important if one of your physical disks is low on space but you have ample space on another.

Choose the size of the virtual disk using the slider keeping in mind an out-of-the-box Pre itself has < 8gb free and give due consideration as to how much space your intentions may require.

When you click "Finish" the creation may take some time depending on the size of the virtual disk you created.

When everything is complete just click "OK."

Back in VirtualBox, select the emulator to which you wish to add the virtual drive and either click the "Settings" icon, hit Ctrl+S, or click through to "Machine" -> "Settings."

In the navigation panel on the left, choose "Hard Disks."

Press "Insert" or click the icon with the green plus sign to ''add an attachment''.

Make sure under "Slot" the selection reads "Primary Slave" and under "Hard Disk" you point to the virtual disk you created in the steps above.

Hit "OK," startup your emulator, and [[Next_steps|setup Optware]]!

Adding Disks to the Emulator

2009-07-21T22:44:31Z

Gordian: /* Adding Disks to the Emulator */

=Enabling Virtual Disk Support for the Emulator In Order to Successfully Setup Optware=
Many developers wish to maintain their emulator with the same software as their actual device. In order to install the Optware package manager on your emulator, you will need to allocate a virtual disk for additional storage.

''These instructions assume you are running Windows XP and Sun xVM VirtualBox''.

First run VirtualBox. Ensure that the emulator to which you wish to add storage is in the "Powered Off" state.

Goto "File" -> "Virtual Media Manager" (or Ctrl+D).

Click or select "New" and press "Next."

Choose whether you want a fixed- or dynamic-sized virtual disk then hit "Next."

Click the small folder icon next to the virtual disk's name to choose where the virtual drive will exist. This is important if one of your physical disks is low on space but you have ample space on another.

Choose the size of the virtual disk using the slider keeping in mind an out-of-the-box Pre itself has < 8gb free and give due consideration as to how much space your intentions may require.

When you click "Finish" the creation may take some time depending on the size of the virtual disk you created.

When everything is complete just click "OK."

Back in VirtualBox, select the emulator to which you wish to add the virtual drive and either click the "Settings" icon, hit Ctrl+S, or click through to "Machine" -> "Settings."

In the navigation panel on the left, choose "Hard Disks."

Press "Insert" or click the icon with the green plus sign to ''add an attachment''.

Make sure under "Slot" the selection reads "Primary Slave" and under "Hard Disk" you point to the virtual disk you created in the steps above.

Hit "OK," startup your emulator, and [[Next_steps|setup Optware]]!

Adding Disks to the Emulator

2009-07-21T22:36:58Z

Gordian: New page: =Adding Disks to the Emulator= Many developers wish to maintain their emulator with the same software as their actual device. In order to install the Optware package manager on your emula...

=Adding Disks to the Emulator=
Many developers wish to maintain their emulator with the same software as their actual device. In order to install the Optware package manager on your emulator, you will need to allocate a virtual disk for additional storage.

''These instructions assume you are running Windows XP and Sun xVM VirtualBox''.

First run VirtualBox. Ensure that the emulator to which you wish to add storage is in the "Powered Off" state.

Goto "File" -> "Virtual Media Manager" (or Ctrl+D).

Click or select "New" and press "Next."

Choose whether you want a fixed- or dynamic-sized virtual disk then hit "Next."

Click the small folder icon next to the virtual disk's name to choose where the virtual drive will exist. This is important if one of your physical disks is low on space but you have ample space on another.

Choose the size of the virtual disk using the slider keeping in mind an out-of-the-box Pre itself has < 8gb free and give due consideration as to how much space your intentions may require.

When you click "Finish" the creation may take some time depending on the size of the virtual disk you created.

When everything is complete just click "OK."

Back in VirtualBox, select the emulator to which you wish to add the virtual drive and either click the "Settings" icon, hit Ctrl+S, or click through to "Machine" -> "Settings."

In the navigation panel on the left, choose "Hard Disks."

Press "Insert" or click the icon with the green plus sign to ''add an attachment''.

Make sure under "Slot" the selection reads "Primary Slave" and under "Hard Disk" you point to the virtual disk you created in the steps above.

Hit "OK," startup your emulator, and [[Next_steps|setup Optware]]!

Portal:Accessing Linux

2009-07-21T22:14:34Z

Gordian:

__notoc__
{{portal-one-column-blue
|header=Accessing Linux (Rooting your Pre is the Old Inaccurate Term)
|column1=
The Palm pre is a Linux based device. As it is shipped, the linux is a fully installed and operational copy, and communicates with the outside world using the Novacomm protocols (the same as used by the iPhone.)

Therefore, enabling access to the Pre was remarkably simple and is officially documented by Palm in the public emulator instructions. Typing in the "developers code" ( ''upupdowndownleftrightleftrightbastart'' ) enables communication between the Linux and the outside world using novacomm.

After that, everything else is a process of installing a ''community standard library'' of Linux programs so that users have the same tools and options available to them.

One of the first choices was installing a package manager for the OptWare library of over 1000 Linux programs, compiled for the Pre.

Once this is done, basically, anything you can do on a Linux box, you can do on the Pre. The community is rapidly working on developing methods for Linux programs to interact with the end-user shell known as Luna or Mojo in addition to access via terminal programs.

The following links will walk you through the process of obtaining access to the Linux system from a terminal program, and installing the community standard software package.

It is necessary (as of this edit) to access the Linux operating system via a terminal program running on a separate PC. You can not achieve root access to the Linux operating system on the phone from the phone itself. However, once you have achieved secure root access, it is possible to make any changes you like to the underlying linux system on the phone.

The process of obtaining access to the Linux is actually a fairly simple procedure. Look below.

[http://www.youtube.com/watch?v=-LBXV0tYyyI Example of a Palm Pre with secure root access]

[http://www.youtube.com/watch?v=xoIE7Y_pyEU YouTube how-to instructions]

Note that if you are running the Pre emulator, you can achieve Linux access on the emulator (not on the real Pre) by using an ssh client (e.g. PuTTY on Windows) to connect to 'root@localhost' at port 5522 on the host machine (which is port forwarded by VirtualBox to the dropbear ssh daemon running on port 22 inside the emulator), and the instructions on this page are not required - you should go straight to the [[Next_steps|next steps]].

}}

{{portal-two-columns
|column1=
== Before you start ==

Please make a note of this page: [[How To Recover]]

If you are unfamiliar with basic Linux command usage, you should visit this page: [[Basic_Linux_Use|Basic Linux Use]]

You might also want to consider backing up any files you have in the usb drive portion of the Pre.
|column2=
== Procedure: ==

There are four versions of the secure root access procedure:
* [[deprecated|Windows XP via wifi]] '''This version is deprecated. Use the USB cable versions.'''
* [[Accessing Linux From Windows|Windows XP or Windows Vista via USB cable (novaproxy) ]]
* [[Accessing Linux From OSX|Mac OS X procedure via usb cable ]]
* [[Accessing Linux From Linux|Linux procedure via usb cable ]]

}}
{{portal-two-columns
|column1=
== Next steps after Accessing Linux ==

* [[Next_steps|Set up users, Optware, and access]]
* [[Applying_Patches|Applying Patches]]
* [[Setup_SFTP|Setup SFTP]]
* [[Tutorials_Linux_DDNS_for_EVDO|DDNS for EVDO]]

|column2=
== Advanced Topics ==

* [[Change_From_Loopback|Change from loopback]]
* [[Adding Disks to the Emulator]]

}}