/[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.15 by sysadm, Thu Nov 20 13:10:45 2025 UTC Revision 1.16 by sysadm, Fri Nov 21 02:28:23 2025 UTC
# Line 39  To install LBBS on Linux (e.g. Debian 13 Line 39  To install LBBS on Linux (e.g. Debian 13
39     $LBBS_HOME_DIR/conf/badwords.conf       $LBBS_HOME_DIR/conf/badwords.conf  
40     $LBBS_HOME_DIR/utils/conf/db_conn.conf.php       $LBBS_HOME_DIR/utils/conf/db_conn.conf.php  
41    
42  8) Generate menu configuration file with section data by running the script    8) Copy CA cert file of MySQL server to $LBBS_HOME_DIR/conf/ca_cert.pem  
43    
44    9) Generate menu configuration file with section data by running the script  
45     sudo -u bbs php $LBBS_HOME_DIR/utils/bin/gen_section_menu.php       sudo -u bbs php $LBBS_HOME_DIR/utils/bin/gen_section_menu.php  
46     sudo -u bbs php $LBBS_HOME_DIR/utils/bin/gen_ex_list.php       sudo -u bbs php $LBBS_HOME_DIR/utils/bin/gen_ex_list.php  
47    
48  9) Create SSH2 RSA certificate    10) Create SSH2 RSA certificate  
49     ssh-keygen -t rsa -C "Your Server Name" -f $LBBS_HOME_DIR/conf/ssh_host_rsa_key     ssh-keygen -t rsa -C "Your Server Name" -f $LBBS_HOME_DIR/conf/ssh_host_rsa_key
50    
51  10) Startup    11) Startup  
52     sudo -u bbs $LBBS_HOME_DIR/bin/bbsd     sudo -u bbs $LBBS_HOME_DIR/bin/bbsd
53    
54  11) (Optional) Set up systemd    12) (Optional) Set up systemd  
55     Enable systemd related feature during config, by running:       Enable systemd related feature during config, by running:  
56       ./configure --prefix=$LBBS_HOME_DIR --enable-systemd       ./configure --prefix=$LBBS_HOME_DIR --enable-systemd
57     Create your own /usr/lib/systemd/system/lbbs.service from the sample at conf/lbbs.service, and make any change if necessary.       Create your own /usr/lib/systemd/system/lbbs.service from the sample at conf/lbbs.service, and make any change if necessary.  
58     Reload daemon config and start the service.       Reload daemon config and start the service.  
59    
60  12) (Optional) Set up logrotate    13) (Optional) Set up logrotate  
61     Create your own /etc/logrotate.d/lbbs from the sample at conf/lbbs.logrotate, and make any change if necessary.       Create your own /etc/logrotate.d/lbbs from the sample at conf/lbbs.logrotate, and make any change if necessary.  
62     Restart logrotate service.       Restart logrotate service.  
63    
64  13) Cleanup on abnormal service termination    14) Cleanup on abnormal service termination  
65     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:  
66     sudo -u bbs ipcs       sudo -u bbs ipcs  
67     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:  
68     sudo -u bbs ipcrm -a     sudo -u bbs ipcrm -a
69    
70    
71  For MSYS2 / CygWin User  For MSYS2 User
72  ==================  ==================
73  Installation of LBBS on MSYS2 is similar to the above steps for Linux, except that:  Installation of LBBS on MSYS2 is similar to the above steps for Linux, except that:
74    
75  1) Use additional config switches to keep compatible with the MSYS2 / CygWin environment.    1) Use additional config switches to keep compatible with the MSYS2 environment.  
76     ./configure --prefix=$LBBS_HOME_DIR --with-mariadb --without-epoll --without-sysv       ./configure --prefix=$LBBS_HOME_DIR --with-mariadb --without-epoll --without-sysv  
77    
78  2) Skip those steps not supported by Cygwin (e.g. systemd and logrotate).    2) Skip those steps not supported (e.g. systemd and logrotate).  
79    


Legend:
Removed lines/characters  
Changed lines/characters
  Added lines/characters

webmaster@leafok.com
ViewVC Help
Powered by ViewVC 1.3.0-beta1