/=/==================================================================================================== Enthral BBS - 11/18/2009 Build 438/SQ Alpha. Interm Release, This release or code sync is just to get the code in development up to date with the new code being written on my Desktop. It's a bit inbetween points at the time as everything is going through a MYSQL Backend rewrite. So stay tuned for more to come. ############################################################## Extra Release Notes. ############################################################## Extra Release Notes, this temp version currently is linking MySql, if you get any problems compiling this source, make sure you have the Mysql installed, the software is now moving away from the Husky SAMPI (JAM Message Format) to a MySql Database. /=/==================================================================================================== There are two ways to install Enthral. The manual way (which some people enjoy since they get a kick out of having full control) and the automated way via the install.pl script. We have detailed instructions for both steps as well as an auto update scripts that will update and compile your current Enthral install via the svn. Basic Installation - PreREQ and small overview. ================== You can run the install.pl script to install and compile the source in your current Directoy. Or you can manally run. $ ./autogen.sh (detects OS and Platform and generates configure script) $ ./configure (run the configure script to setup make files) $ gmake (gmake or make is fine) Some dependencies exists, you should have Autotools installed beore running either method. Some distro's don't have much installed, so you should check and verify the follow are installed before trying to compile. g++ compiler (c++ compiler) libc (standard library for c/c++) sed (needed for scripts) wget (downloads programs from the web) automake (Development tools for ccompiling source code) libtools (Used with automake to detect compiling settings) Husky SMAPI Lib, (Install.pl will download and attempt to compile it) xinetd / telnetd (Used for Answering and Handeling Telnet Connections) mysql Database/Libs (New - Now Required, still WIP) python (optional) perl (optional) OpenSSL (Optional) I believe i have everything here, although it's easy to miss something accross different linux/bsd/osx distro's. If i have, please let me know so we can keep track and make getting everything setup easier on everyone. MySQL instructions will be coming soon once it's more intergrated and used in the system. /=/==================================================================================================== Auto Install. For those of you that would rather have every dependancy and the sysop name/ bbs name changed in the code for you we have an automated perl script that will do all the heavy lifting for you. If you interested in having your system do everything for you, all you need to do is run the following: ./install.pl You need to have perl installed on your system to use the install script. Along with the PreREQ's mentioned above. /=/==================================================================================================== Manual Install. Remember things are still very incomplete so still there are not a lot of options for many things, but I'm working on it.. :) You can get the source through svn thanks to Netsurge. $ svn --username svn co http://svn.enthralbbs.com /your/path/enthral If it asks for a password just hit ENTER or leave it blank. Before you can compile you need the Husky SMAPI lib, this is for jam message support. ############################################################################ NOTE: Husky, Is being removed in the future, due to lots of bugs and issues. ############################################################################ You can get the latest 2.4 RC5 from here: http://sourceforge.net/projects/husky/ *Note, Some people have had problem with 2.4, if you get crashes in message scanning, please switch to 2.2-Stable Release. Go into the source directory, rename makefile.lnx to Makefile (case sensitive) and run make. This will generate the libsmapilnx.a which is needed by the bbs, copy this to the src directory for enthral and your all set. *Note, Both BSD and Linux will compile correctly with the makefile.lnx After smapi is all set and compiles cleanly: You have to edit the config.ini file located in the ini folder. Here you will add the handle/username of your sysop user. It should match exactly case and all. Soon there will be a user editor where you can assign a sysop flag. Now that we have made all the necessary changes to the code, we can now run configure and make. At a shell just type the following... /=/==================================================================================================== # First run autogen.sh to generate a multi-platform configure script. # If your on BSD and most other OS's, you will need to install Automake and Libtools ./autogen.sh # Now run configure and make to build the system, if you have any pronlems, # try running 'make distclean' then re-run 'make', make sure the libsmapilnx.a library # is placed in your src folder before running make, it's a dependancy. ./configure && make We still have two small binaries to build to ensure that Enthral runs nice and smooth. Stats is used to generate top callers and posters and Snoop allows you to see what's going on when a user is logged in. /=/==================================================================================================== For Stats Stats is located in src/stats. You will need to change the path statement in main.cpp to match the path of your enthral setup. Inside of main.cpp change the following line to your path. Line 19 - PATH = "/home/merc/enthral/src/"; Once you have made the change run the following at a prompt to compile stats. g++ -o stats main.cpp process2.cpp userdat.cpp You will also need to edit [CommandRec009] in src/menu/logon.txt to the proper location of the stats binary we just compiled. /=/==================================================================================================== For Snoop Go to the src/snoop directory and execute the following from a prompt. g++ -o snoop snoop.cpp /=/==================================================================================================== Post Compile. The first thing you'll want to do it connect to the bbs, and create your sysop user, the name should match exactly what you updated in the logon.cpp. Now once your at the main menu, as a Sysop you can hit * from the main menu to go into the message forum editor. You will want to create an email area as your first area, and a system announcements as your second area. Your system annoucements area must be named "system" (no quotes) to ensure that only a sysop can post in it. This will be fixed later on. After these 2 areas, you can create general message and as many areas as you like. Once you are done creating your areas, hit C to compile them. Once everything is compiled and working, you'll want to setup xindetd, and telnetd to login to the bbs. If your unsure how to set either one of them up, send me a message and i'll email you some sample scripts. Your all done. If you have any questions feel free to email me or Netsurge and we'll try to help you out. /=/==================================================================================================== Auto update There is a script in the root dir called update.pl. This script will automatically update your to the latest build via svn and replace all the instances of the default sysop and bbs name in the source code. It will also run configure, make clean, and make for you. This should make updating your installation a lot easier. /=/==================================================================================================== One last note You can also add |IP MCI Code for ip address in the matrix ansi file, i took this out while I was hunting a bug a while back and forgot to add it back in.. ;) You can always pop into #enthral on irc.bbs-scene.org and ask for help. I try to pop in nightly and answer any questions, but you can also chat with Netsurge, Esc, and even pook who have also setup the bbs for testing. -=+[Team Enthral]+=- Mike -Mercyful Fate Frank -Netsurge http://www.enthralbbs.com