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

This is an old revision of the document!


Table of Contents

webcit

webcit - Citadel Servlet Engine.

SYNOPSIS

webcit [-i ip_addr] [-p http_port] [-t tracefile] [-T Templatedebuglevel] [-c] [-f] [-d] [-s] [remotehost [remoteport] ]

DESCRIPTION

WebCit (the binaries name is webcit) is the Citadel Servlet engine. It can operate with Citserver on another box, but it can't operate without.

OPTIONS

SwitchResult
-hPATHSpecify the home directory eg. -h/usr/local/citadel not adding a leading / will make the path relative to the compiletime path. Needed for running several webcit/citadel instances at the same host
-dRun as a daemon; fork watcher process.
-DPATHRun as a daemon but create a pid file at PATH eg. -D/var/run/webcit.pid
-iIP_ADDRSpecify IP address to listen on as web server eg -i192.168.9.1; default is 0.0.0.0
-pPORTSpecify port to listen on eg. -p80; default is 2000
-tPATHSpecify trace file (where to put the log file) eg -t/var/log/webcit
-T VAL0 (default; recommended for production systems) 1: Parse template on each request
-xVALHow much info to put in the trace file (or to stdout) eg -x9
-fFollow X-Forwarded-For: headers.
-cUse a server cookie.
-suse SSL (turns the -p default to 443)
remotehostif the citserver lives on another box, its name / ip (remember to add your webserver IP to the citadel servers public_clients - Configfile.); else the path to the unix-domain-socket. Defaults to the compiled in unix domain socket
remoteportIf you want to connect to citserver via TCP specify its port here; usualy 504

ENVIRONMENT

To alter the names presented in the self signed certificates you can set these Environment Variables to override the defaults.

NameDefaultValue
OOrganization nameOrganization
OUCitadel ServerOrganizational Unit
CN*Common Name

DEFAULTS

The default for remotehost is to connect localy via Unix Domain Socket. The default TCP port is 504. webcit will open Port 2000 serving HTTP requests and bind 0.0.0.0 if not other specified.

FILES

The location of the files may vary depending on configure options.

/usr/share/citadel-webcit/static/ WebCits template files
/usr/share/citadel-webcit/static.local/ Your customized templates
/usr/share/tinymce/www/ the TinyMCE Javascript Editor
/etc/init.d/webcitThe initscript usually used to start this binary. Add Options here
/etc/default/webcitParameters to /etc/init.d/webcit in the LHFS ified installations
dpkg-reconfigure citadel-webcit will modify this file.

HISTORY

1998 - Now the Uncensored Communication Group

Copyright © 1987-2014 Uncensored Communications Group. All rights reserved.     Login (site admin)