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

Differences

This shows you the differences between two versions of the page.

documentation:appproto:system_config [2014/05/12 22:19]
ajc
documentation:appproto:system_config [2016/04/24 18:12] (current)
ajc
Line 7: Line 7:
 This command creates, or re-creates, a database of Internet e-mail addresses using the vCard information in the Global Address Book room.  This procedure is normally run internally when the server determines it necessary, but is also provided as a server command to be used as a troubleshooting/maintenance tool.  Only a system Aide can run the command.  It returns OK on success or ERROR on failure. This command creates, or re-creates, a database of Internet e-mail addresses using the vCard information in the Global Address Book room.  This procedure is normally run internally when the server determines it necessary, but is also provided as a server command to be used as a troubleshooting/maintenance tool.  Only a system Aide can run the command.  It returns OK on success or ERROR on failure.
  
 +====  CONF   (get or set global CONFiguration options)  ====
  
 +Retrieves or sets various system-wide configuration and policy options.  This command is only available to Admins.
  
 +The six forms of this command are:
 +  CONF GET
 +  CONF SET
 +  CONF GETVAL|name
 +  CONF SETVAL|name|value
 +  CONF LISTVAL
 +  CONF GETSYS|name
 +  CONF PUTSYS|name
  
 +There are two ways to read and change the system configuration.  In the legacy mode (the sole parameter is GET or SET), an entire portion of the system configuration is transferred, with each field indicated by its position in the listing.  In the new mode (first parameter is GETVAL or SETVAL), a single configuration variable may be read or set by name, or the entire configuration variable set may be retrieved with LISTVAL.
  
- +If the GET command succeeds, CONF will return LISTING_FOLLOWS followed by the fields described below, one line at a time.  If the SET command succeeds, CONF will return SEND_LISTING and expect the fields described below, one line at a time (don't worry about other fields being added in the future; if a 'short' configuration list is sent, the missing values at the end will be left unchanged on the system).  If either command fails for any reason, ERROR is returned.
- +
-====  CONF   (get or set global CONFiguration options)  ==== +
- +
-Retrieves or sets various system-wide configuration and policy options.  This command is only available to Aides.  The sole parameter accepted is a command, which should be either GET or SET.  If the GET command succeeds, CONF will return LISTING_FOLLOWS followed by the fields described below, one line at a time.  If the SET command succeeds, CONF will return SEND_LISTING and expect the fields described below, one line at a time (don't worry about other fields being added in the future; if a 'short' configuration list is sent, the missing values at the end will be left unchanged on the system).  If either command fails for any reason, ERROR is returned.+
  
 The configuration lines are as follows: The configuration lines are as follows:
Line 44: Line 51:
 | 23   | c_pop3_port           | Port number for POP3 service                                                           | | 23   | c_pop3_port           | Port number for POP3 service                                                           |
 | 24   | c_smtp_port           | Port number for SMTP service                                                           | | 24   | c_smtp_port           | Port number for SMTP service                                                           |
-| 25   | c_rfc822_strict_from  | Flag (0 or 1) - strict RFC822 adherence - don't correct Fromforgeries                |+| 25   | c_rfc822_strict_from  | Flag (0-3) - strict RFC822 adherence - 0: no from: headers altered; 1: only if not a valid email alias of the user; 2: always the users primary email address; 3Reject the mail if its not a valid alias |
 | 26   | c_aide_zap            | Flag (0 or 1) - allow Aides to zap (forget) rooms                                      | | 26   | c_aide_zap            | Flag (0 or 1) - allow Aides to zap (forget) rooms                                      |
 | 27   | c_imap_port           | Port number for IMAP service                                                           | | 27   | c_imap_port           | Port number for IMAP service                                                           |
Line 71: Line 78:
 | 50   | c_pftcpdict_port      | [[http://www.postfix.org/tcp_table.5.html|Port number for Postfix TCP Dict]]           | | 50   | c_pftcpdict_port      | [[http://www.postfix.org/tcp_table.5.html|Port number for Postfix TCP Dict]]           |
 | 51   | c_mgesve_port         | Port number for managesieve service                                                    | | 51   | c_mgesve_port         | Port number for managesieve service                                                    |
-| 52   | c_auth_mode           | Authentication mode (0 for native, 1 for host auth)                                    |+| 52   | c_auth_mode           | Authentication mode (0 for native, 1 for host (PAM) auth, 2 LDAP, 3 LDAP with MS AD scheme); (Please note that users are bound to authmodes, and are only visible for the mode they were created with |
 | 53   | c_funambol_host       | Host name of Funambol server with Citadel connector                                    | | 53   | c_funambol_host       | Host name of Funambol server with Citadel connector                                    |
 | 54   | c_funambol_port       | Port number of Funambol server with Citadel connector                                  | | 54   | c_funambol_port       | Port number of Funambol server with Citadel connector                                  |
Line 96: Line 103:
  
 Please note that the LDAP-specific configs have no effect on Citadel servers in which LDAP support is not enabled. Please note that the LDAP-specific configs have no effect on Citadel servers in which LDAP support is not enabled.
- 
- 
- 
- 
- 
- 
  
 ===== Autopurger Related ===== ===== Autopurger Related =====
Line 142: Line 143:
  
 ===== Server Maintainance Commands ===== ===== Server Maintainance Commands =====
 +
 +==== RSEN Retrieve Seen Status ====
 +Administrative command to debug seen stati. Hint: enable seen database debug logs.
 +=== GET|<msgid> ===
 +fetches the timestamp (if) whether a message of this identity is in the database
 +=== SET|<MSGID>|timestamp ===
 +Sets the timestamp for this message ID in the database
 +=== DEL|<MSGID|===
 +Removes this entry from the database (if)
  
 ====  SMTP   (utility commands for the SMTP gateway)  ==== ====  SMTP   (utility commands for the SMTP gateway)  ====
Line 181: Line 191:
 [[documentation:appproto:statuscodes|ERROR+HIGHER_ACCESS_REQUIRED]] if a non-aide user calls this. [[documentation:appproto:statuscodes|ERROR+HIGHER_ACCESS_REQUIRED]] if a non-aide user calls this.
 Parameters are the facility to change (see [[#LOGP|LOGP]] output for the available list) plus 0 for enable, 1 for disable. Parameters are the facility to change (see [[#LOGP|LOGP]] output for the available list) plus 0 for enable, 1 for disable.
 +
 +==== MIGR (Migration & system repair) ====
 +These facilities are used by [[faq:systemadmin:how_do_i_move_citadel_to_another_host|the ctdlmigrate utility]] which you can use to transfer the contents from an old to a new host.
 +=== listdirs ===
 +Outputs a list of directories, which should be transfered outside of the scope of the protocol
 +=== export ===
 +Outputs xml containing all floor, room, messages and configurations
 +=== import ===
 +Facility that imports the output of export
 +=== restoremeta ===
 +This utility is not directly related to migration. It analyses internal datastructures, tries to find inconsistencies and fix them.
 +  - messages linked in rooms which aren't present in the system anymore are removed
 +  - message metadata is reconstructed from the core message data itself. Therefore the whole message database is crawled, all messages loaded, parsed and analysed.
 +
  
Copyright © 1987-2016 Uncensored Communications Group. All rights reserved.     Login (site admin)