Installing the Jetty Plugin in SageTV v6 or Earlier

Thanks to  Brent on the SageTV forums for initially consolidating these instructions.

These instructions are only for installing the Jetty server. Applications must be installed separately. The method for installing on Mac OSX are slightly different.

1. Download the Jetty plugin from the  Download Page on the SageTV forums, or from  SourceForge.
2. Shut Down SageTV and SageTV Services (if you run as service)
3. Unzip the jettystarter_x_x.zip file into the SageTV installation directory (e.g. Program Files\SageTV\SageTV), so that (for example) the ZIP's /JARs/ directory is merged into SageTV's /JARs/ directory.
4. Open up Sage.properties file and the following line (note: If the key has multiple values, they need to be separated by a semicolon)

   sagex.jetty.starter.Main
   

   should be added to this line:

   load_at_startup_runnable_classes
   

   Note: in version 1.4, this value changed from net.sf.sageplugins.jetty.starter.Main to sagex.jetty.starter.Main
5. Decide what port you want to use for the mobile web app (default is 8080). Use a different, unused port (not the same port as neilms webadmin). If you want to change the port, change it in JettyStarter.properties. Assuming you wanted to change the port to 8500, you would change

    #jetty.port=8080
   

   To

    jetty.port=8500
   

   Notice that you have to remove the # from that line or it won't work
   NOTE: You will have to port forward this port to access outside your network
6. The default username and password is sage/frey. This can be changed in SAGE_HOME/jetty/etc/realm.properties. NOTE: Currently there is no way to specify security for URLs like there is in nielm's webserver
7. Run SageTV

Installed Files

Unzipping the download creates the following folders and files:

 / SAGE_HOME
     JettyStarter.properties
     / jetty
         jetty_license.txt (v1.3 or later)
         jettystarter_plugin_license.txt (v1.3. or later)
         / contexts
         / etc
             jetty.xml
             jetty-ajp.xml (v1.6 or later)
             jetty-jaas.xml
             jetty-logging.xml
             jetty-plus.xml
             jetty-ssl.xml
             jetty-sslengine.xml
             keystore
             login.conf
             login.properties
             realm.properties
             webdefault.xml
         / lib
         / logs
         / static
         / webapps
   / JARs
       ant-1.6.5.jar
       core-3.1.1.jar
       jetty-6.1.19.jar (v1.6 or later)
       jetty-6.1.11.jar (v1.3 - v1.5)
       jetty-6.1.7.jar (v1.0 - v1.2)
       jetty-ajp-6.1.19.jar (v1.6 or later)
       jetty-rewrite-handler-6.1.19.jar (v1.6 or later)
       jetty-sslengine-6.1.19.jar (v1.6 or later)
       jetty-sslengine-6.1.11.jar (v1.3 - v1.5)
       jetty-starter.jar
       jetty-util-6.1.19.jar (v1.6 or later)
       jetty-util-6.1.11.jar (v1.3 - v1.5)
       jetty-util-6.1.7.jar (v1.0 - v1.2)
       jsp-2.1-jetty-6.1.19.jar (v1.6 or later)
       jsp-2.1.jar
       jsp-api-2.1.jar
       serlvet-api-2.5-6.1.19.jar (v1.6 or later)
       serlvet-api-2.5-6.1.11.jar (v1.3 or later)
       servlet-api-2.5-6.1.7.jar (v1.0 - v1.2)