running schooltool on port 80

[Tom Hoffman]

Using the Debian/Ubuntu packages and init script, you cannot simply switch SchoolTool to port 80 using paste.ini, because the process doesn't start with sufficient privileges.

We either need to make this easy or provide instructions for the necessary manual changes.

[Gediminas Paulauskas (menesis)]

Running on port 80 is not advisable. Instead,

1) Serve through Apache's mod_rewrite. Add

    RewriteEngine on
    RewriteRule ^/(.*) http://localhost:7080/++vh++http:example.org:80/++/$1 [P]

to a virtual host definition in sites-enabled.

2) configure the router to redirect, e.g. example.org:80 to 10.0.0.2:7080

Document both options in http://book.schooltool.org/htmlhelp/remote.html

[Gediminas Paulauskas (menesis)]

Add this line to /etc/hosts

127.0.0.1 schooltool.local

Install apache2

Copy the attached file to /etc/apache2/sites-available/schooltool.local

$ sudo a2ensite schooltool.local
$ sudo apache2ctl graceful

Go to http://schooltool.local

[Tom Hoffman (tom-hoffman)]

Can we make a package that does this?

[Justas Sadzevičius (justas.sadzevicius)]

A rewrite rule for http://localhost/schooltool would also be nice. And maybe externally reachable http://xxx.xxx.xxx.xxx/schooltool

[Gediminas Paulauskas (menesis)]

I tried the rewrite rule above, and it didn't work. Turns out the needed apache modules are not enabled by default.

  $ sudo a2enmod proxy_http rewrite

Tom: yes, I am writing all this to a book page and an example file to be installed at /usr/share/doc/schooltool/examples or so.

[Gediminas Paulauskas (menesis)]

Looked at http://cando.cteresource.org/phase2install.html, rewritten to use apache ProxyPass directive instead of RewriteRule, and added to schooltool's README.txt and http://book.schooltool.org/apache.html