Difference between revisions of "Next steps"

From WebOS Internals
Jump to navigation Jump to search
m (Added profile update, so the user can easily use the binaries in /opt right away)
(→‎Introduction: Install_OpenSSH replaced with Application:OpenSSH)
 
(40 intermediate revisions by 17 users not shown)
Line 1: Line 1:
−
''The old, manual setup of Optware and users can be found [[Setting_up_optware_feed | here]].''
+
__notoc__
 +
{{reorganize|This page is deprecated (see Introduction).}}
 +
==Introduction==
 +
The Portal [[Accessing_Linux|Accessing Linux]] links here (Set up users, Optware, and access). There, this page here is marked '''DEPRECATED'''.
 +
The topics mentioned here have been superseded with the following pages:
 +
*[[Application:Preware]] to install Preware (containing optware feeds as well)
 +
*[[Application:OpenSSH]] to install OpenSSH
 +
*[[Dropbear_Install|Dropbear Install]] to install Dropbear (alternatively to OpenSSH)
 +
*[[Setup_Bash|Setup bash]] to replace sh by bash
  
−
=Automated Setup of Optware, Users and Access=
+
See also the other portals on the left navigation pane:
−
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.
+
#[[Portal:webOS_Applications|webOS Applications]] introduces you to the Preware application manager. A convenient programm to install further apps to your device.
 +
#[[Portal:Linux_Applications|Linux Applications]] introduces you to common linux applications, mainly contained in the optware feeds. The optware feeds can also be accessed via preware.
  
−
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.  
+
==The following is deprecated==
 +
To start getting the most out of your new webOS Device you should install Preware. Continue on to the [[Application:Preware|Preware]] page. There you will see all the ways to install Preware on your device.
  
−
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.  
+
Then go to the Optware section in [[Preware]] and install OpenSSH and OpenSSH SFTP Server from there.
  
−
In addition, the standard package creates a non-root user, installs ''sudo'', and includes a SSH program (''Dropbear'') and SFTP program.  
+
Then go to the [http://www.webos-internals.org/wiki/Application:OpenSSH OpenSSH package homepage] and read the instructions there to create an SSH key for use when accessing your phone via ssh or sftp.
  
−
For your convenience, we've packaged all this up into a simple script.
+
If you want to access the optware command line package library, then also install the Optware Advanced Linux Command Line Installer package.
−
 
 
−
==Optware Setup==
 
−
 
 
−
'''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
 
−
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]:
 
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 with [http://checkmyip.com/ CheckMyIP.com]
+
*Find your IP address on your Pre with [http://checkmyip.com/ CheckMyIP.com]
−
*SSH to that IP address on port 222
+
**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 22
 
**If you're doing this over EVDO, there may be a lot of latency.  Be patient.
 
**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>
 
**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
+
**[[Tutorials_Linux_DDNS_for_EVDO|Dynamic DNS]] is helpful for consistently accessing the Pre over EVDO with a simple name.
−
**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
+
*Log in as root using the SSH key you created during the Optware installation
−
 
 
−
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.
 

Latest revision as of 14:10, 25 July 2011

Warning: This page is deprecated (see Introduction).

Introduction

The Portal Accessing Linux links here (Set up users, Optware, and access). There, this page here is marked DEPRECATED. The topics mentioned here have been superseded with the following pages:

See also the other portals on the left navigation pane:

  1. webOS Applications introduces you to the Preware application manager. A convenient programm to install further apps to your device.
  2. Linux Applications introduces you to common linux applications, mainly contained in the optware feeds. The optware feeds can also be accessed via preware.

The following is deprecated

To start getting the most out of your new webOS Device you should install Preware. Continue on to the Preware page. There you will see all the ways to install Preware on your device.

Then go to the Optware section in Preware and install OpenSSH and OpenSSH SFTP Server from there.

Then go to the OpenSSH package homepage and read the instructions there to create an SSH key for use when accessing your phone via ssh or sftp.

If you want to access the optware command line package library, then also install the Optware Advanced Linux Command Line Installer package.

Once you are finished, you may SSH into your Pre with an SSH client like Putty:

  • Find your IP address on your Pre with 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 22
    • If you're doing this over EVDO, there may be a lot of latency. Be patient.
    • You can optionally install Avahi and SSH to castle.local.
    • Dynamic DNS is helpful for consistently accessing the Pre over EVDO with a simple name.
  • Log in as root using the SSH key you created during the Optware installation
Retrieved from "http://wiki.webos-internals.org/index.php?title=Next_steps&oldid=17507"