Please note that these Trac pages are no longer being updated. Wiki contents/documentation have moved to GitHub.

Version 17 (modified by imcheng, 10 years ago)

--

Using Seattle on the Nokia N800

Explains how to install Seattle as well as running the unit tests (optionally) on the Nokia N800 Internet Tablet.



Setting up Seattle


Tools Required

In order to run Seattle, you will need: Python, and root access to the system in the tablet. These can be obtained through the Application Manager.

  1. In the top menu, go to Tools -> Application Catalog.
  2. Select the "maemo extras" entry and Edit.
  3. Uncheck the "disabled" box.
  4. Refresh the installable package list, and packages that are required should now show up.


Python

For Python, you will need to install the "maemo-python-env" package. This will install Python 2.5 onto the tablet.


Root access

This is only required for the installation of Seattle. In particular, root access is required to configure Seattle to run on startup. There are several ways to obtain the root shell access. This article will describe two easy ways by which root shell access can be obtained.

rootsh

Find and install the "rootsh" package. The root shell package allows the user to gain root access through a simple command: "sudo gainroot" or simply "root".

openssh

Find and install "openssh" package. During installation the first time, you will be prompted for a new password. Enter your password of choice and remember it for later. Root shell access can be obtained using "ssh root@localhost". You will be prompted for the password you entered during installation.


Installation

  1. Download the Seattle tarball (the Linux one)  here.
  2. Next, extract the tarball, and navigate to the Seattle directory.
  3. Install Seattle.
    1. You will need root access to configure Seattle to run on startup properly during installation. See above on how to gain root access.
    2. To install, run ./install.sh. Seattle will be configured to run on startup. In addition, Seattle will be started after installation.
    3. To check that it is running, run the command
      ps -f | grep nmmain.py | grep -v grep
      
  4. To stop Seattle, run ./stop_seattle.sh. Run ./start_seattle.sh to restart it. You will not need root access for either of these.
  5. Uninstallation:
    1. You will again need root access to uninstall properly. This stops Seattle from running on startup.
    2. Run ./uninstall.sh.



Running Seattle Unit Tests (Optional)


This part is optional.

Tools required

In addition to the packages required for installing Seattle, you will also need Subversion to check out the Seattle repository to run unit tests in.


Subversion

You will need to install the "subversion" package in the same manner as above (through Application Manager). To run unit tests, you will need to install the "subversion" package and  check out the repository.


Running the tests

Follow the instructions on "Running the Repy VM tests"  here.



You may also try the  Node Manager tests and  Software Updater tests. However, these tests will take an extremely long time to run (up to a day) and it is likely that the tablet will need to be connected to the power supply during the tests. (To run these tests you will need developer access to the repository to have the assignments/webserver directory and files.)