--- lbbs/INSTALL.md 2025/11/07 07:27:36 1.6 +++ lbbs/INSTALL.md 2025/11/08 15:37:45 1.7 @@ -7,51 +7,53 @@ To install LBBS, please perform the foll It is highly recommended to finish the configuration steps of web version first and make sure those features could work properly. 1) Common requirements - gcc >= 14.2.0 + gcc >= 14.2 autoconf >= 2.68 automake >= 1.16 - libssh >= 0.11.1 - PHP >= 8.2 - MySQL >= 8.4 + libssh >= 0.11 + pcre2 >= 10.38 + php >= 8.2 + mysql >= 8.4 -2) Extract the source files from a tarball or export from GitHub +3) Extract the source files from a tarball or export from GitHub Run the following command to set up the autoconf/automake environment, sh ./autogen.sh -3) Compile source files - export LBBS_HOME_DIR=/usr/local/lbbs +4) Compile source files + export LBBS_HOME_DIR=/usr/local/lbbs ./configure --prefix=$LBBS_HOME_DIR make -4) Create user and group +5) Create user and group sudo useradd bbs -5) Install binary files and data files +6) Install binary files and data files sudo make install chown -R bbs:bbs $LBBS_HOME_DIR -6) Modify following configuration files +7) Modify following configuration files Default configuration files is saved as *.default, you should rename them first. $LBBS_HOME_DIR/conf/bbsd.conf $LBBS_HOME_DIR/conf/badwords.conf $LBBS_HOME_DIR/utils/conf/db_conn.conf.php -7) Generate menu configuration file with section data by running the script +8) Generate menu configuration file with section data by running the script sudo -u bbs php $LBBS_HOME_DIR/utils/bin/gen_section_menu.php sudo -u bbs php $LBBS_HOME_DIR/utils/bin/gen_ex_list.php -8) Create SSH2 RSA certificate +9) Create SSH2 RSA certificate ssh-keygen -t rsa -C "Your Server Name" -f $LBBS_HOME_DIR/conf/ssh_host_rsa_key -9) Startup +10) Startup sudo -u bbs $LBBS_HOME_DIR/bin/bbsd -10) Set up systemd +11) Set up systemd Create your own /usr/lib/systemd/system/lbbs.service from the sample at conf/lbbs.service.default, and make any change if necessary. Reload daemon config and start the service. -11) Cleanup on abnormal service termination +12) Cleanup on abnormal service termination 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: sudo -u bbs ipcs There should be no item owned by bbs. Otherwise, run the following command to cleanup: sudo -u bbs ipcrm -a +