Lighttpd

= Configuring the Lighttpd web server =

Preliminaries
Update: Replace this older method by installing Lighty (lighttpd) from the Optware section of Preware.
 * 1) Gain  access to Linux on your device.
 * 2) Setup the  Optware Feed.
 * 3) Open the root file system to read/write with rootfs_open.

Install Lighttpd with PHP support
ipkg-opt install lighttpd php-fcgi

Tweak settings
vi /opt/etc/lighttpd/lighttpd.conf If you are going to run static HTML pages, there is no need to do this. If you want the ability to run PHP pages then this line must be uncommented:

"mod_fastcgi",

For Python on CGI, see section below.

You may also want to adjust the port that the web server runs on. Sprint blocks port 80 and this package installs Lighttpd to run on port 8081 :

server.port               = 8081
 * 1) bind to port (default: 80)

Start the web server:

/opt/etc/init.d/S80lighttpd start

Update: The current methods of starting and stopping Lighty (lighttpd) are: start mobi.optware.lighttpd stop mobi.optware.lighttpd

It may be convenient to use a simple shell script for starting, stopping and restarting: #!/bin/sh if [ "$1" = "start" ] then   start mobi.optware.lighttpd; exit elif [ "$1" = "stop" ] then   stop mobi.optware.lighttpd; exit elif [ "$1" = "restart" ] then   stop mobi.optware.lighttpd start mobi.optware.lighttpd else   echo "Instruction is missing or incorrect." echo "Usage: lighty start|stop"; exit fi
 * 1) lighty.sh

Add a startup script
I placed a file at /etc/event.d/optware-lighttpd so that the web server starts up after each reboot and the iptables firewall rules are executed to allow access to port 8080:

start on stopped finish stop on runlevel [!2]
 * 1) don't start until the WebOS finishes it's normal boot
 * 2) that way no delay is added to the GUI startup

respawn
 * 1) Restart the lighttpd daemon if it exits/dies

exec /opt/sbin/lighttpd -f /opt/etc/lighttpd/lighttpd.conf

pre-start script /usr/sbin/iptables -D INPUT -p tcp --dport 8081 -j ACCEPT || /bin/true /usr/sbin/iptables -I INPUT -p tcp --dport 8081 -j ACCEPT end script

Reboot the phone so that the firewall rules are executed:

/sbin/reboot

Add files to the web directory:
The default home directory lives at:

/opt/share/www/

Update: The default home directory defined in the conf file is now /media/internal/www/ However, it useful to create subdirectories cgi-bin (for CGI scripts) and htdocs (for HTML documents). (See the Python section below for the relevant conf file tweaks.)

Sample gps.php file that will load your current location via Google maps:

&1 | cut -d, -f4,5 | sed -r 's/[^-\.0-9,]//g'`; ?> &amp;z=16&amp;ll=&amp;output=embed"> &amp;z=16&amp;ll=&amp;source=embed" style="color:#0000FF;text-align:left">View Larger Map

FrankenPre webos 2.1 gps.php needs the following (getCurrentPosition different output for webOS 2.0+?): `luna-send -n 1 palm://com.palm.location/getCurrentPosition {} 2>&1 | cut -d, -f5,6 | sed -r 's/[^-\.0-9,]//g'`

= Other Considerations =

Dynamic DNS

 * 1) Install the ez-ipupdate package
 * 2) Configure ez-ipupdate to update a DDNS service any time the EVDO IP changes
 * 3) CNAME record of primary domain - I have a CNAME record pointed to my DDNS record so that I always have the most up-to-date IP of my phone

Log files

 * 1) Need to keep an eye on the /opt/var/log/lighttpd/ log files and make sure they are rotated consistently

= Tweaking for CGI with Python =

Installation and tweaks
Install python25 and cgi module from Optware  following the example on the Optware page, and creat softlink: mount -o rw,remount / ipkg-opt install python25 ipkg-opt install python25 cgi mount -o ro,remount / ln -sf /var/opt/bin/python2.5 /usr/bin/python

Add directories to /media/internal/www to conform to more-or-less standard practice: mkdir /media/internal/www/htdocs mkdir /media/internal/www/cgi-bin

Tweak /opt/etc/lighttpd/lighttpd.conf as follows:

1. Add to the server.modules list: “mod_cgi”,

2. Change document root to match new directory: server.document-root       = “/media/internal/www/htdocs”

3. Check that the Python extension is included in the non-static list: static-file.exclude-extensions = ( “.fcgi”, “.php”, “.pl”, “.py”, “.rb”, “.sh” )

4. Add cgi-bin alias: “/cgi-bin/”   => “/media/internal/www/cgi-bin/”,

5. Add python path assignment (note python2.5 link defined above): cgi.assign   = ( “.py” => “/usr/bin/python” )

Usage: HTML files
In /media/internal/www/htdocs. Example: pythontest.html Test of Python on webOS  JustType :)  

Usage: CGI files
In /media/internal/www/cgi-bin. Example: #!/usr/bin/python
 * 1) pythontest-cgi.py

import cgi import cgitb; cgitb.enable

fs = cgi.FieldStorage if fs.has_key('instring'): instring = fs['instring'].value else: instring = ''

def htmlinit: return 'Content-type: text/html\n\n'

def htmlhead: head = ' \n \n Test of Python on webOS \n \n ' return head

def htmltail: tail = ' ' return tail

print htmlinit print htmlhead print instring print htmltail