Synchronet v3.18b-Win32 (install) has been released (Sept-2020).

Synchronet v3.19a, now under development, requires libarchive-dev to build successfully.

You can donate to the Synchronet project using PayPal.

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
config:nix [2010/02/22 23:45]
digitalman
config:nix [2020/09/15 16:41] (current)
digital man Don't [Unix] User/Group settings unless you have to
Line 1: Line 1:
 ====== UNIX ====== ====== UNIX ======
  
-===== sbbs.ini ​=====+Configuration of ''​[UNIX]''​ section of the Synchronet initialization file (e.g. ''​[[dir:​ctrl]]/​[[config:​sbbs.ini]]''​).
  
-Unix Sysops will particularly want to pay attention to the ''​[UNIX]'' ​section of your initialization file (e.g. ''​[[dir:ctrl]]/​sbbs.ini''​ file.+===== User/Group ===== 
 +If you are **not** ​[[howto:​linux_non-root|starting sbbs as ''​root''​]], then you should **not** set these values. 
 + 
 +==== User ==== 
 + 
 +Default: <​none>​ 
 + 
 +==== Group ==== 
 + 
 +Default: <​none>​
  
 If you do not want to run Synchronet (and all external programs/​doors) as If you do not want to run Synchronet (and all external programs/​doors) as
-root, you will have to set the ''​User''​ and ''​Group''​ key values. ​Example:+root (the Unix //​administrator//​ user), you will have to set the ''​User''​ and ''​Group''​ key values.
  
-  User=sbbsgroup +Example:
-  Group=sbbsuser+
  
-Also, the file +  User=sbbsuser 
-permissions/​ownership should be such that the other user would have read+  Group=sbbsgroup 
 +   
 +NOTE: the ''​sbbsuser''​ and ''​sbbsgroup''​ names are just examples. You must pick valid user/group names for your system (e.g. exist in your system'​s ''/​etc/​passwd''​ file) and both the user and group name may be the same. 
 +   
 +Also, the Synchronet ​file 
 +permissions/​ownership should be such that this user/​group ​would have read
 and write access to them.  The best way to accomplish this is a command and write access to them.  The best way to accomplish this is a command
 like: like:
Line 18: Line 31:
   # chown -R sbbsuser:​sbbsgroup /sbbs   # chown -R sbbsuser:​sbbsgroup /sbbs
  
-If you want Synchronet ​to fork and run in the background ​as a daemon, logging +If you do this, then be sure to run any Synchronet utilities (e.g. [[util:​SCFG]]) ​as the same user that the BBS is going to run as: 
-via syslog rather than the local console, set Daemonize=True in this section. Example:+   
 +  # su -c /​sbbs/​exec/​scfg sbbs  ​
  
-  Daemonize=True+===== Logging ===== 
 +==== LogFacility ==== 
  
-To configure syslog ​and the ''​LogFacility''​, a good default ​to use is:+Default: ''​U''​ (User) 
 + 
 +Supported Values: ''​0''​-''​7''​ ("​Local0"​ through "​Local7"​ facility), ''​U''​ (for "​User"​ facility), ​and ''​S''​ or ''​F''​ (for "​Standard"​ facilities) 
 + 
 +If you have ''​sbbs''​ installed to run in the background as a daemon, logging 
 +via [[monitor:​syslog]] rather than the local console, you may want to set the ''​LogFacility'' ​key value. A good value to use is:
  
   LogFacility=3   LogFacility=3
    
-  +Then, in ''/​etc/​syslog.conf'' ​(or ''/​etc/​rsyslog.d/​sbbslog.conf''​) ​you will need to add the line:
-Then, in ''/​etc/​syslog.conf''​ you will need to add the line:+
  
-  local3.* ​                /​var/​log/​synchronet.log+  local3.* ​                /​var/​log/​sbbs.log
  
 Depending on how your vendor set up ''​syslog.conf''​ initially, you may also want Depending on how your vendor set up ''​syslog.conf''​ initially, you may also want
Line 39: Line 58:
  
 You will have to create this file manually initially by running: You will have to create this file manually initially by running:
-  # touch /var/log/synchronet.log+  # touch /var/log/sbbs.log
  
 Then send a HUP to syslogd like so: Then send a HUP to syslogd like so:
   # killall -HUP syslogd   # killall -HUP syslogd
 +  ​
 +Or it might be necessary to:
 +  # service syslogd restart
 +  ​
 +You could then monitor the Synchronet daemon log output with:
 +  # tail -f /​var/​log/​sbbs.log
  
 You will want to investigate how your system rotates logs and set it up to You will want to investigate how your system rotates logs and set it up to
-rotate ''​synchronet.log''​ also.+rotate ''​sbbs.log''​ also. 
 + 
 +  # cat /​etc/​logrotate.d/​sbbs 
 +  /​var/​log/​sbbs*.log { 
 +        weekly 
 +        missingok 
 +        rotate 52 
 +        notifempty 
 +        create 640 root adm 
 +        sharedscripts 
 +        postrotate 
 +                invoke-rc.d rsyslog reload > /dev/null 
 +        endscript 
 +  } 
  
 Further use of the ''​LogFacility''​ setting is beyond the scope of this document. Further use of the ''​LogFacility''​ setting is beyond the scope of this document.
Line 58: Line 97:
     LOG_MAIL     LOG_MAIL
     LOG_CRON     LOG_CRON
 +    ​
 +Note: the LogFacility value in the ''​sbbs.ini''​ file may be overridden with the ''​-d''​ command-line option (e.g. ''​sbbs -d3''​ to daemonize ''​sbbs''​ with LogFacility of ''​Local3''​).
        
-=== LogIdent === +==== LogIdent ===
-Default: Synchronet + 
-=== PidFile ===+Default: ​''​Synchronet''​ 
 + 
 +This is the value passed as the ''​ident''​ argument to the system'​s ''​openlog''​ function. Run ''​man openlog''​ for more details on this setting. 
 + 
 +===== Process Control =====  
 + 
 +==== PidFile ===
 Default: ''/​var/​run/​sbbs.pid''​ Default: ''/​var/​run/​sbbs.pid''​
-=== umask === 
-Default: 077 
  
-===== Terminal Capabilities =====+This key contains the path of the file which will contain the process identifier (PID) of Synchronet and is used by background/​daemon startup scripts to query the current state of ''​sbbs''​.
  
-As you may have noticed by now, most telnet clients designed for use with +  # service sbbs status 
-ANSI BBSes do not display full-screen Unix programs correctly. Included with +  Synchronet BBS services status: [running] 
-Synchronet ​is a pair of terminal capability definition files that enable you +  ​PID(s): 6270
-to run native full-screen Unix programs and have the output displayed correctly +
-in a standard ANSI-BBS terminal. ​ These files are ''​termcap''​ and ''​terminfo'',​ +
-located in your Synchronet install directory. ​ Your system will use one or the +
-other, and it won't hurt to install both.  You will need to be logged in as +
-root to install the files.+
  
-==== Installing ​the terminfo file ====+If you change ​the value of this key, you may also need to modify your startup script (e.g. ''/​etc/​init.d/​sbbs''​).
  
-1) Get the Synchronet ANSI-BBS terminfo file from: +==== umask ====
-http://​cvs.synchro.net/​cgi-bin/​viewcvs.cgi/​*checkout*/​install/​terminfo+
  
-2) Enter the command ``tic terminfo''​+Default: ''​077''​
  
-==== Installing the termcap ​file ====+Sets ''​sbbs'''​s  ​file mode creation mask.
  
-1) Get the Synchronet ANSI-BBS termcap file from: +NoteIf the value begins with a ''​0'',​ it will be interpreted in //octal// notation.
-http://​cvs.synchro.net/​cgi-bin/​viewcvs.cgi/​*checkout*/​install/​termcap +
-2) Enter the command ``cat termcap >> /​etc/​termcap''​ +
-3) *** FreeBSD Only *** run the command: +
-  # cap_mkdb -f /usr/share/misc/termcap /​etc/​termcap+
  
-Once the terminal capability files are installed, edit the ''​ExternalTermANSI''​ +Run ''​man umask'' ​for more details on this setting.
-value in the ''​[BBS]''​ section of your ''​[[sbbs.ini]]''​ file to read: +
-    ExternalTermANSI=ansi-bbs+
  
-Note: Once again, many Linux distros do not have a termcap. ​ This is fine. +==== Daemonize ====
-You do NOT need to install the termcap-compat package. ​ If termcap +
-isn't installed, it means nothing uses it.  Only if there is a +
-termcap do you need to add the ansi-bbs termcap definition.+
  
 +Default: ''​false''​
 +
 +When set to ''​true'',​ forces ''​sbbs''​ to run daemonized (in the background) without specifying the ''​-d''​ command-line option. Setting this value to ''​true''​ is not recommended.
  
 ===== See Also ===== ===== See Also =====
   * [[:​config:​|Configuration]]   * [[:​config:​|Configuration]]
 +  * [[:​monitor:​syslog]]
 +
  
 +{{tag>​unix syslog sbbs.ini}}

In Other Languages