Home Download News FAQ / Knowledge Base Screenshots Documentation Support Site map
philosophical imaginary

This is an old revision of the document!


Table of Contents

Files and where Easy Install and LHFS (.rpm / .deb) installs put them

The differences between Easy Install (Legacy) are grounded in historicaly grown sructures (remeber, citadel has its roots in the eighties), and won't fit into the nowadays commonly used Linux Filesystem Herarchy. To follow these modern demands as the debian policy strongly recommends, packages integrated into Distributions (as Debian/Ubuntu (.deb)/Gentoo (ebuild))put files and directories into different locations.
So if you want to migrate from one to another you need to move files arround:

Citserver

Legacy (prepend /usr/local/citadel) LHFS LHFS/RPM similar to LHFS where empty File Purpose
Configuration Files and directories
citadel.config /var/lib/citadel/data/citadel.config Citadel Server Base config
citadel.control /var/lib/citadel/data/citadel.control Citadel Server State File
refcount_adjustments.dat /var/lib/citadel/data/refcount_adjustments.dat * List of id's that where deleted cached.
public_clients /etc/citadel/public_clients Clients from which source ips are allowed to set the remote user ip?
nework/mail.alias /etc/citadel/mail.alias Email Address Aliases Database
help/ /usr/share/citadel-server/help/ The help files for the commandline client
messages/ /etc/citadel/messages/ Citadels Welcome messages and so on.
netconfigs/ /etc/citadel/netconfigs extended per room configurations like mailinglist recipients, Inter Citadel Node Configurations, or RSS Aggregartions
keys/ /etc/ssl/citadel/ Server SSL Certificates
citadel.rc /etc/citadel/citadel.rc Citadel Commandline Client Configfile
Data Files
bio/ /var/lib/citadel/bio/ The users Biography files
bitbucket/ /var/lib/citadel/bitbucket/ Trashcan; depricated.
files/ /var/lib/citadel/files/ Room File uploads
images/ /var/lib/citadel/images/ Room Pictures
info/ /var/lib/citadel/info/ Room Info Text Files
userpics/ /var/lib/citadel/userpics/ Users Pictures
data/ /var/lib/citadel/data/ Berkeley Database files, short the very Heart of your citadel
network/spoolin/ /var/spool/citadel/network/spoolin Inbound Citadel Internode-Spool
network/spoolout/ /var/spool/citadel/network/spoolout Outbound Citadel Internode-Spool
network/systems/ /var/spool/citadel/network/spoolsystems/
Sockets, pidfiles (non volatile, so you won't need to move them)
citadel.pid /var/run/citadel/citadel.pid The Actual PID of the Server Process
citadel.socket /var/run/citadel/citadel.socket Citadel Protocol Speaking Unix Domain Socket
lmtp.socket /var/run/citadel/lmtp.socket LMTP (Slightly modified SMTP) UDS
lmtp-unfiltered.socket /var/run/citadel/lmtp-unfiltered.socket Non AVAS passing mail feed UDS
Binaries (the debs will bring 'em on update…)
citserver /usr/sbin/citserver The citadel server itself.
sendcommand /usr/sbin/sendcommand Pipe messages into citadel.sock
setup /usr/lib/citadel/setup /usr/sbin/citadel-setup The Citadel Base Setup Program. The debs use it via debconf.
citadel /usr/bin/citadel The citadel commandline client
base64 /usr/lib/citadel-server/base64 The base 64 de/encrypter
citmail /usr/sbin/citmail
or /usr/sbin/sendmail (via mta package) Citadels sendmail replacement for local Mail sending
/etc/init.d/citadel /etc/init.d/citadel Citadels startup script. (a bit different on debian)
aidepost /usr/lib/citadel-server/aidepost /usr/lib/citadel/aidepost Tool to post messages with aide permissions
msgform /usr/lib/citadel-server/msgform /usr/lib/citadel/msgform
userlist /usr/lib/citadel-server/userlist /usr/lib/citadel/userlist show a list of users logged in
getmail /usr/lib/citadel-server/getmail /usr/lib/citadel/getmail utility extracting single mails from the store
ctdlmigrate /usr/lib/citadel-server/ctdlmigrate /usr/sbin/ctdlmigrate Utility for over the wire migration of one citadel to another
Documentation
database_cleanup.sh /usr/share/doc/citadel-server/examples/database_cleanup.sh /usr/share/doc/citadel/examples/database_cleanup.sh Sample script howto repair berkeley db files

WebCIT

Legacy (prepend /usr/local/webcit) LHFS LHFS/RPM File Purpose
binaries
webcit (formaly known as webserver) /usr/sbin/webcit Webcit itself
setup Not included Webcits setup program. Debconf does its job in the debs.
/etc/init.d/webcit /etc/init.d/webcit Webcits init script. (a bit different on debian)
% /etc/default/webcit the debian init scripts config values; created by debconf
locale/ /usr/share/locale Webcits different tongues
static /usr/share/citadel-webcit/static/ Static templates and Images
static.local /usr/share/citadel-webcit/static.local/ Your overrides
tiny_mce % Ommitted on debian as there are Tiny MCE debs; we depend on them.
Copyright © 1987-2014 Uncensored Communications Group. All rights reserved.     Login (site admin)