|
Starting Ogham
To start ogham type python ./serv.py , this will attempt to start ogham on port 9080. If that does not work you probably do not have permission to start a service on port 9080 , or another web server such as apache is running.You may
1. Edit serv.py to start ogham on another port
2. Stop the other web server or use an account that has the necessary permissions. WARNING , Ogham is probably very insecure , it is not recommended to run this as root, except possibly on an intranet.
3. If you dont not intend to use the default pages and images directories
you will need to edit __init__.py in the webapps folder for ogham.
change the section
configItems={
'pagesDir':'./webapps/ROOT/pages/',
'imagesDir':'./webapps/ROOT/images/',
}
To point to the directories where you would like to store pages/images.
Likewise if Ogham is not to be the ROOT webapp in the snakelets server
you will need to edit this file.
Upgrading
If you are upgrading ogham you will need to copy the contents of your
previous pages and images directories, no other changes should be necessary.
Running Ogham behind Apache
This was for Apache 1.3 running on debian stable.
1. Uncomment this line in your httpd.conf , or add it if its not already present.
LoadModule proxy_module /usr/lib/apache/1.3/libproxy.so
2. Add the virtual host configuration to your httpd.conf
<VirtualHost oghamdemo.odonnell.nu >
ServerName oghamdemo.odonnell.nu
ProxyPass / http://localhost:9080/
ProxyPassReverse / http://localhost:9080/
</VirtualHost>
3. Secure the virtual host by adding these lines to httpd.conf.
If you dont anyone can use your webserver as a proxy. A tactic
favored by purveyors of porn dialers , trojans , etc.
<Directory oghamdemo.odonnell.nu:9080>
Order Deny,Allow
Deny from all
Allow from oghamdemo.odonnell.nu
</Directory>
Authentication
If you wish to password protect your Ogham installation
edit the following line in __init__.py in the webapps/ROOT directory
passwords = {"ogham":"0gham"}
the format is "username":"password" , these should obviously be changed.
The change the first item in configItems from
'loginEnabled': False,
to
'loginEnabled': True,
Then restart snakelets and you should be prompted to log in.
More Information
For information on progress on new versions visit http://blog.odonnell.nu where I ramble on this and other topics.
Sean O'Donnell
|
