/[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.12 by sysadm, Tue Nov 18 16:15:54 2025 UTC Revision 1.23 by sysadm, Mon Nov 24 02:12:27 2025 UTC
# Line 10  To install LBBS on Linux (e.g. Debian 13 Line 10  To install LBBS on Linux (e.g. Debian 13
10     gcc >= 14.2       gcc >= 14.2  
11     autoconf >= 2.68       autoconf >= 2.68  
12     automake >= 1.16       automake >= 1.16  
    libssh >= 0.11    
    pcre2 >= 10.38    
13     php >= 8.2       php >= 8.2  
14     mysql >= 8.4       mysql >= 8.4  
15       (For Debian / Ubuntu)  
16       sudo apt-get install -y libssh-dev libsystemd-dev  
17       (For CentOS / RHEL)  
18       sudo dnf install -y libssh-devel systemd-devel  
19       (For MSYS2 with MinGW-w64 toolchain)  
20       pacman -S --needed msys2-runtime-devel libssh pcre2-devel mingw-w64-x86_64-libiconv mingw-w64-x86_64-libmariadbclient  
21    
22  3) Extract the source files from a tarball or export from GitHub    3) Extract the source files from a tarball or export from GitHub  
23     Run the following command to set up the autoconf/automake environment,       Run the following command to set up the autoconf/automake environment,  
# Line 21  To install LBBS on Linux (e.g. Debian 13 Line 25  To install LBBS on Linux (e.g. Debian 13
25    
26  4) Compile source files    4) Compile source files  
27     export LBBS_HOME_DIR=/usr/local/lbbs       export LBBS_HOME_DIR=/usr/local/lbbs  
28       (For Linux)  
29     ./configure --prefix=$LBBS_HOME_DIR       ./configure --prefix=$LBBS_HOME_DIR  
30     make     (For MSYS2 with MinGW-w64 toolchain)  
31       ./configure --prefix=$LBBS_HOME_DIR --disable-shared PKG_CONFIG_PATH=/mingw64/lib/pkgconfig/  
32       make  
33    
34  5) Create user and group    5) Create user and group  
35     sudo useradd bbs     sudo useradd bbs
# Line 37  To install LBBS on Linux (e.g. Debian 13 Line 44  To install LBBS on Linux (e.g. Debian 13
44     $LBBS_HOME_DIR/conf/badwords.conf       $LBBS_HOME_DIR/conf/badwords.conf  
45     $LBBS_HOME_DIR/utils/conf/db_conn.conf.php       $LBBS_HOME_DIR/utils/conf/db_conn.conf.php  
46    
47  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  
48    
49    9) Generate menu configuration file with section data by running the script  
50     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  
51     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  
52    
53  9) Create SSH2 RSA certificate    10) Create SSH2 RSA certificate  
54     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
55    
56  10) Startup    11) Startup  
57     sudo -u bbs $LBBS_HOME_DIR/bin/bbsd     sudo -u bbs $LBBS_HOME_DIR/bin/bbsd
58    
59  11) (Optional) Set up systemd    12) (Optional) Set up systemd  
    Enable systemd related feature during config, by running:    
      ./configure --prefix=$LBBS_HOME_DIR --enable-systemd  
60     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.  
61     Reload daemon config and start the service.       Reload daemon config and start the service.  
62    
63  12) (Optional) Set up logrotate    13) (Optional) Set up logrotate  
64     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.  
65     Restart logrotate service.       Restart logrotate service.  
66    
67  13) Cleanup on abnormal service termination    14) Cleanup on abnormal service termination  
68     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:  
69     sudo -u bbs ipcs       sudo -u bbs ipcs  
70     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:  
71     sudo -u bbs ipcrm -a     sudo -u bbs ipcrm -a
72    
   
 For Cygwin User  
 ==================  
 Installation of LBBS on Cygwin is similar to the above steps for Linux, except that:  
   
 a. Use additional config switches to keep compatible with the Cygwin environment.    
    ./configure --prefix=$LBBS_HOME_DIR --with-mariadb --without-epoll    
   
 b. Enable Cygserver with optimized parameters (as large as possible) of XSI semaphore and shared memory in /etc/cygserver.conf    
   
 c. Skip those steps not supported by Cygwin (e.g. systemd and logrotate).    

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