/[LeafOK_CVS]/lbbs/INSTALL.md
ViewVC logotype

Diff of /lbbs/INSTALL.md

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.7 by sysadm, Sat Nov 8 15:37:45 2025 UTC Revision 1.15 by sysadm, Thu Nov 20 13:10:45 2025 UTC
# Line 1  Line 1 
1  Installation  Installation
2  ==================  ==================
3  To install LBBS, please perform the following steps:  To install LBBS on Linux (e.g. Debian 13, CentOS Stream 10), please perform the following steps:
4    
5  0) Prerequisite    0) Prerequisite  
6     Follow README.md under [leafok_bbs](https://github.com/leafok88/leafok_bbs) to initialize the database structure shared by both web version and telnet version.       Follow README.md under [leafok_bbs](https://github.com/leafok/leafok_bbs) to initialize the database structure shared by both web version and telnet version.  
7     It is highly recommended to finish the configuration steps of web version first and make sure those features could work properly.     It is highly recommended to finish the configuration steps of web version first and make sure those features could work properly.
8    
9  1) Common requirements    1) Common requirements  
# Line 17  To install LBBS, please perform the foll Line 17  To install LBBS, please perform the foll
17    
18  3) Extract the source files from a tarball or export from GitHub    3) Extract the source files from a tarball or export from GitHub  
19     Run the following command to set up the autoconf/automake environment,       Run the following command to set up the autoconf/automake environment,  
20     sh ./autogen.sh     autoreconf --install --force
21    
22  4) Compile source files    4) Compile source files  
23     export LBBS_HOME_DIR=/usr/local/lbbs       export LBBS_HOME_DIR=/usr/local/lbbs  
24     ./configure --prefix=$LBBS_HOME_DIR       Choose different implementation based on System V or Posix  
25     make     ./configure --prefix=$LBBS_HOME_DIR --with-sysv  
26       ./configure --prefix=$LBBS_HOME_DIR --without-sysv  
27       make  
28    
29  5) Create user and group    5) Create user and group  
30     sudo useradd bbs     sudo useradd bbs
# Line 47  To install LBBS, please perform the foll Line 49  To install LBBS, please perform the foll
49  10) Startup    10) Startup  
50     sudo -u bbs $LBBS_HOME_DIR/bin/bbsd     sudo -u bbs $LBBS_HOME_DIR/bin/bbsd
51    
52  11) Set up systemd    11) (Optional) Set up systemd  
53     Create your own /usr/lib/systemd/system/lbbs.service from the sample at conf/lbbs.service.default, and make any change if necessary.       Enable systemd related feature during config, by running:  
54         ./configure --prefix=$LBBS_HOME_DIR --enable-systemd
55       Create your own /usr/lib/systemd/system/lbbs.service from the sample at conf/lbbs.service, and make any change if necessary.  
56     Reload daemon config and start the service.       Reload daemon config and start the service.  
57    
58  12) Cleanup on abnormal service termination    12) (Optional) Set up logrotate  
59       Create your own /etc/logrotate.d/lbbs from the sample at conf/lbbs.logrotate, and make any change if necessary.  
60       Restart logrotate service.  
61    
62    13) Cleanup on abnormal service termination  
63     In case of any unexpected failure or improper operation which results in abnormal termination of lbbs process, manual cleanup of shared memory / semaphore might be required before re-launch the process. Run the following command to check first:       In case of any unexpected failure or improper operation which results in abnormal termination of lbbs process, manual cleanup of shared memory / semaphore might be required before re-launch the process. Run the following command to check first:  
64     sudo -u bbs ipcs       sudo -u bbs ipcs  
65     There should be no item owned by bbs. Otherwise, run the following command to cleanup:       There should be no item owned by bbs. Otherwise, run the following command to cleanup:  
66     sudo -u bbs ipcrm -a     sudo -u bbs ipcrm -a
67    
68    
69    For MSYS2 / CygWin User
70    ==================
71    Installation of LBBS on MSYS2 is similar to the above steps for Linux, except that:
72    
73    1) Use additional config switches to keep compatible with the MSYS2 / CygWin environment.  
74       ./configure --prefix=$LBBS_HOME_DIR --with-mariadb --without-epoll --without-sysv  
75    
76    2) Skip those steps not supported by Cygwin (e.g. systemd and logrotate).  
77    

Legend:
Removed lines/characters  
Changed lines/characters
  Added lines/characters
webmaster@leafok.com
 ViewVC Help
Powered by ViewVC 1.3.0-beta1