WebOS Internals - User contributions [en]

Talk:Next steps

2009-09-09T03:56:16Z

Superduperpre:

Next steps

2009-09-09T03:55:24Z

Superduperpre: /* Finishing */

''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 a SSH program (''Dropbear'') and SFTP program.

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

==Optware Setup==

===Installing Optware in the Emulator?===
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:100%;">
<source lang=bash>
cd /tmp
wget http://gitorious.org/webos-internals/bootstrap/blobs/raw/master/optware-bootstrap.sh
#Alternately you can use this tiny url http://tinyurl.com/n8q2vy
sh optware-bootstrap.sh
source /etc/profile.d/optware
</source></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]

==Quilt setup==

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. [[Applying_Patches | Applying Patches]] provides a more thorough guide on the use of quilt.

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

<div style="font-size:100%;">
<source lang=bash>
cd /tmp
wget http://gitorious.org/webos-internals/bootstrap/blobs/raw/master/quilt-bootstrap.sh
sh quilt-bootstrap.sh
</source></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]

==Finishing==

To finish off, turn Developer Mode back to "Off" (which will reboot your Pre).

Once you are finished, you may SSH into your Pre with an SSH client like [http://www.chiark.greenend.org.uk/~sgtatham/putty/ Putty]:
*Find your IP address on your Pre with [http://checkmyip.com/ CheckMyIP.com]
**In many cases, you are in a local network, but checkmyip.com gives you the WAN addess. Install whatismyip from the homebrew catalog to get your pre's ip address within the local network and use that
*SSH to that IP address on port 222
**If you're doing this over EVDO, there may be a lot of latency. Be patient.
**You can optionally install [[Avahi]] and SSH to <tt>castle.local.</tt>
*Log in with the username and password you created during the Optware installation
**Many operations cannot be carried out with the permissions of that username. You'll need to [[Basic_Linux_Use#sudo|sudo]] those operations with the new username's password

Only the default shell (/bin/ash) will work for ssh. To change your shell to bash (located in /opt/bin/bash after the install), you will have to [http://www.webos-internals.org/wiki/Setup_Bash create] an /etc/shells file, and add the following lines:

/bin/ash
/bin/sh
/opt/bin/bash

Then you will be able to edit /etc/passwd and change the shell parameter for the user you created. Note that if you try to change your shell without adding an /etc/shells the SSH server (Dropbear) will look like it is rejecting your password on subsequent connections.

Talk:Next steps

2009-09-09T02:08:14Z

Superduperpre:

This script method does not seem to account for accessing SSH via USB instead of EVDO or Wifi. I don't believe it sets up the firewall correctly to allow USB0. --[[user:SagaciousB|SagaciousB]]

AND WHERE EXACTLY DO I TYPE THIS INTO? WHAT PROGRAM, IF IN CMD WINDOW, WHERE? - [[User:Srlake314|Srlake314]]

"To change your shell to bash (located in /opt/bin/bash after the install), you will have to create an /etc/shells file, and add the following lines" How exactly does one create this /etc/shells file? same as creating a directory (mkdir)? and then we just "add the following lines" to the putty terminal?

What about editing the page the page to include information which allows users to "create an /etc/shells file"?

Perhaps this edit would work?... "Only the default shell (/bin/ash) will work for ssh. To change your shell to bash (located in /opt/bin/bash after the install), you will have to [http://www.webos-internals.org/wiki/Setup_Bash create] an /etc/shells file, and add the following lines:" [[User:superduperpre|superduperpre]]

Talk:Next steps

2009-09-09T02:07:16Z

Superduperpre:

This script method does not seem to account for accessing SSH via USB instead of EVDO or Wifi. I don't believe it sets up the firewall correctly to allow USB0. --[[user:SagaciousB|SagaciousB]]

AND WHERE EXACTLY DO I TYPE THIS INTO? WHAT PROGRAM, IF IN CMD WINDOW, WHERE? - [[User:Srlake314|Srlake314]]

"To change your shell to bash (located in /opt/bin/bash after the install), you will have to create an /etc/shells file, and add the following lines" How exactly does one create this /etc/shells file? same as creating a directory (mkdir)? and then we just "add the following lines" to the putty terminal?

I suggest editing the page the page to include what this information which allows users to "create an /etc/shells file". Perhaps this edit would work? "Only the default shell (/bin/ash) will work for ssh. To change your shell to bash (located in /opt/bin/bash after the install), you will have to [http://www.webos-internals.org/wiki/Setup_Bash create] an /etc/shells file, and add the following lines:" [[User:superduperpre|superduperpre]]

Next steps

2009-09-09T02:05:47Z

Superduperpre:

''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 a SSH program (''Dropbear'') and SFTP program.

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

==Optware Setup==

===Installing Optware in the Emulator?===
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:100%;">
<source lang=bash>
cd /tmp
wget http://gitorious.org/webos-internals/bootstrap/blobs/raw/master/optware-bootstrap.sh
#Alternately you can use this tiny url http://tinyurl.com/n8q2vy
sh optware-bootstrap.sh
source /etc/profile.d/optware
</source></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]

==Quilt setup==

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. [[Applying_Patches | Applying Patches]] provides a more thorough guide on the use of quilt.

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

<div style="font-size:100%;">
<source lang=bash>
cd /tmp
wget http://gitorious.org/webos-internals/bootstrap/blobs/raw/master/quilt-bootstrap.sh
sh quilt-bootstrap.sh
</source></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]

==Finishing==

To finish off, turn Developer Mode back to "Off" (which will reboot your Pre).

Once you are finished, you may SSH into your Pre with an SSH client like [http://www.chiark.greenend.org.uk/~sgtatham/putty/ Putty]:
*Find your IP address on your Pre with [http://checkmyip.com/ CheckMyIP.com]
**In many cases, you are in a local network, but checkmyip.com gives you the WAN addess. Install whatismyip from the homebrew catalog to get your pre's ip address within the local network and use that
*SSH to that IP address on port 222
**If you're doing this over EVDO, there may be a lot of latency. Be patient.
**You can optionally install [[Avahi]] and SSH to <tt>castle.local.</tt>
*Log in with the username and password you created during the Optware installation
**Many operations cannot be carried out with the permissions of that username. You'll need to [[Basic_Linux_Use#sudo|sudo]] those operations with the new username's password

Only the default shell (/bin/ash) will work for ssh. To change your shell to bash (located in /opt/bin/bash after the install), you will have to create an /etc/shells file, and add the following lines:

/bin/ash
/bin/sh
/opt/bin/bash

Then you will be able to edit /etc/passwd and change the shell parameter for the user you created. Note that if you try to change your shell without adding an /etc/shells the SSH server (Dropbear) will look like it is rejecting your password on subsequent connections.

Talk:Next steps

2009-09-09T01:51:53Z

Superduperpre:

This script method does not seem to account for accessing SSH via USB instead of EVDO or Wifi. I don't believe it sets up the firewall correctly to allow USB0. --[[user:SagaciousB|SagaciousB]]

AND WHERE EXACTLY DO I TYPE THIS INTO? WHAT PROGRAM, IF IN CMD WINDOW, WHERE? - [[User:Srlake314|Srlake314]]

"To change your shell to bash (located in /opt/bin/bash after the install), you will have to create an /etc/shells file, and add the following lines" How exactly does one create this /etc/shells file? same as creating a directory (mkdir)? and then we just "add the following lines" to the putty terminal? [[User:superduperpre|superduperpre]]

I edited the page to include what I think is a link to the information which allows users to "create an /etc/shells file". Please correct if wrong. [[User:superduperpre|superduperpre]]

Next steps

2009-09-09T01:49:46Z

Superduperpre:

Talk:Next steps

2009-09-09T01:44:44Z

Superduperpre:

Talk:Next steps

2009-09-09T01:44:12Z

Superduperpre:

Help:Questions

2009-09-09T01:25:13Z

Superduperpre: /* Is there a way to change the password for a user? */

Feel free to PUT some in here, and someone else may answer them!!!

== Can I Move a Article? ==

Of course you can, but make sure you're doing it for a valid reason (naming scheme, bad wording etc.) and that you fix all old links that went to said article. Make sure to place the old articles link into the [[Admin Changes]] article so that an admin can delete the old page node. If you do not place it there it may get cleaned up later, or work as a redirect.

== I Want to Showcase an Application I Made ==

Yep, applications are separated into [[Portal:webOS Applications|webOS applications]] and [[Portal:Linux Applications|Linux applications]]. Then follow the steps on the page to add your application.

== Can we get some kind of syntax highlighting for code blocks? ==

There is already syntax highlighting as described in the [[Help:Style_Guide|style guide]].

== Is there a portal yet for things like graphic libraries ie; Dialer Backgrounds, or Wallpapers? ==

If so, how/where is it, and how can I link [[Pre_Dialer_Backgrounds]]

to it? IF there is not, what is the best portal TO link that to?

[[Portal:Misc]] Would be the best location. Most of the wiki is for technical information. --[[User:Templarian|Templarian]] 03:54, 6 September 2009 (UTC)

Help:Questions

2009-09-09T00:12:57Z

Superduperpre: /* Is there a way to change the password for a user? During "Next Steps" I mismatched my password entries: result was "password for [username] is unchanged". What is this "unchanged password", given that I never successfully created one, and how do I

Help:Questions

2009-09-09T00:10:52Z

Superduperpre: /* Is there a way to change the password for a user? During "Next Steps" I mismatched my password entries: result was "password for [username] is unchanged. What is this "unchanged password", given that I never successfully created one, and how do I

Help:Questions

2009-09-09T00:10:18Z

Superduperpre: /* Is there a way to change the password for a user? I followed "Next Steps" but mismatched my password entries: the process said "password for [my selected username] is unchanged. What would this unchanged password be, given that I never successfull

Help:Questions

2009-09-09T00:08:31Z

Superduperpre: adding a question to help