Configuration of webCDwriter
The first time CDWserver is started, it will create the file
/etc/CDWserver/config and write the default configuration to it.
You can edit this file to change the default behaviour. There
are several sections.
1. Features
burnProof
If your CD-writer supports burnPROOF, you may try this
option.
copySupport
Support of copying a data CD in the CD-ROM drive "on the fly".
imageOnTheFly
If you want to put some files to a data CD, a filesystem has to be
created that contains all your files and directories in one big file.
This file is called the image of the CD. imageOnTheFly=on
means that the image is generated while writing the data to the CD.
This will save time and the space for the image on the disk. But be
careful: if you CPU and/or harddisk isn't fast enough, the CD-writer
will run out of data and the CD will be unusable. It is recommended
to run a test session in simulation mode at maximal speed. The
session should consist of lots of small files (like the Linux kernel source
tree).
MP3decoding
If mpg123 is installed on your system, CDWserver offers the possibility
to decode MP3s for audio CDs.
2. Server
CDWserver will try to run as user and group. It will
listen on port portNo for client connections and on
port statusPortNo for status requests. maxOpenConnections
clients could be connected to it at the same time.
3. Directories
exportDir
The exportDir is the root directory of a software archive
on the server. The default is /etc/CDWserver/export/.
logDir
Log information will be written to the directory logDir.
spoolDir
The session and image data will be stored in spoolDir.
4. Cache
CDWserver will store all sessions and image files in spoolDir.
It is important that there is always enough free disk space on
the partition containing spoolDir. By maxMBytesInSpoolDir
you can limit the disk space CDWserver will use, but you also have
to make sure that it can use this space at any time.
maxMBytesPerSession limits the size of a single session.
By maxOpenSessions you can limit the number of clients that
can transmit there session at the same time.
CDWserver won't use the last reservedMBytes on the partition.
5. CD-ROM(s) and CD-writer(s)
CDROMs
Examples
CDROMs=auto
CDROMs=0,0,0
CDROMs=0,2,0;0,5,0
CDwriters or cdrecordDevArg
If your CD-writer isn't autodetected by CDWserver, you can determine
the bus,ID,LUN-triple of your writer by
Examples
CDwriters=auto
CDwriters=0,0,0
CDwriters=0,2,0;0,5,0
defaultSpeed
maxSpeed
6. Programs
You may set an absolute path to the programs cdrecord,
mkisofs, and mpg123.
7. Options
anonymousUse on|off
Should it be possible to burn a CD without an account?
cdrecordArgs
By cdrecordArgs you can give additional special
arguments to cdrecord. Be careful not to introduce conflicts
with the regular arguments.
defaultFilesDir
The optional directory defaultFilesDir can contain files
that should be included in each session.
ejectOnReservation
To avoid writing to the CD of the wrong user
make sure the CDs are inserted after reservation.
logoURL
You may give a logo for the status page by logoURL.
logRequests
Set logRequests to write the major client requests
to logDir/version.log.
logSubProcess
Set logSubProcess to write the output of child processes
like cdrecord and mkisofs to logDir/sessionID/.
logVerbose
Set logVerbose to write all client requests
and log messages to logDir/version.vlog.
organization
By organization you can give a name that should be
written to the images.
removeSessions
Normally CDWserver removes the oldest session when running
out of disk space. By the option removeSessions you can
tell it to remove the sessions when they are closed.
showUsers
By showUsers you can control, if the users of webCDwriter
should be visible on the status page.
waitForCD
By waitForCD you can set the number of minutes the CD-writer
will be reserved.