Build dependencies:
Name Tested Notes
- libdb 4.3.29 4.2 and earlier won't work
+ libdb 4.3.29 not 4.2.x; 4.4+ might work.
libgc 6.8
libvorbisfile 1.1.2
libpcre 6.7 need UTF-8 support
If adding new 'player' commands, see README.raw for details on setting up
"raw format" players. Non-raw players are still supported but not in all
- configurations and they cannot support pausing and gapless play.
+ configurations and they cannot support pausing and gapless play. If you
+ want additional formats to be supported natively please point the author at
+ a GPL-compatible library that can decode them.
5. Make sure the server is started at boot time.
"Thought I was a gonner baby, but I'm bullet proof"
-These instructions assumes you are using Apache 1.3.x.
+As above, if you install from a .deb, much of the work will be done
+automatically.
You need to configure a number of things to make this work:
-1. If you want online registration to work then you set mail_sender in
+1. If you want online registration to work then set mail_sender in
/etc/disorder/config to the email address that communications from the web
- interface will appear to be sent. If this is not a valid, deliberable email
- address then the results are not likely to reliable.
+ interface will appear to be sent. If this is not a valid, deliverable email
+ address then the results are not likely to be reliable.
mail_sender webmaster@example.com
If you don't want to allow online registration instead use:
- disorder -- setup-guest --no-online-registration
+ disorder setup-guest --no-online-registration
-3a. If you want to have a 'jukebox' virtual host, modify the DNS accordingly
- and use a fragment such as this one:
-
- <VirtualHost HOSTNAME>
- DocumentRoot /home/jukebox/public_html
- ServerName jukebox.DOMAIN
- ServerAlias jukebox
- ServerAdmin webmaster@DOMAIN
- ErrorLog /var/log/apache/jukebox/error.log
- TransferLog /var/log/apache/jukebox/access.log
- Alias /static/ /usr/local/share/disorder/static/
- </VirtualHost>
-
- Don't forget to reload Apache after modifying its configuration.
-
- You must tell the web interface how to find its icons and stylesheet:
-
- echo label url.static /static/ >> /etc/disorder/options.user
- echo label links.css /static/disorder.css >> /etc/disorder/options.user
-
-3b. If you don't want a virtual host then you must still make sure that
- DisOrder can find its icons and stylesheet. For example in your web server
- configuration:
+3. Make sure that DisOrder can find its icons and stylesheet. For example in
+ your web server configuration:
Alias /disorder/ /usr/local/share/disorder/static/
Alternatively you could use a symlink from the right location in your
document root, provided your web server is configured to follow them.
- Also you must tell the web interface how to find them:
-
- echo label url.static /disorder/ >> /etc/disorder/options.user
- echo label links.css /disorder/disorder.css >> /etc/disorder/options.user
+ cd /var/www
+ ln -s /usr/local/share/disorder/static disorder
4. Install disorder.cgi in an appropriate location. Remember to make it
- executable. For example assuming a virtual host as above (3a):
-
- install -m 755 clients/disorder.cgi ~jukebox/public_html/index.cgi
-
- or not (3b):
+ executable. Example:
install -m 755 clients/disorder.cgi /usr/lib/cgi-bin/disorder
set of initial choices to anything that can be expressed with regexps. The
regexps must be URL-encoded UTF-8 PCRE regexps.
+If you want to give DisOrder its own virtual host, see README.vhost.
Copyright
=========