Subject: gicqd server quick start info
Date: Tue, 4 May 1999 01:22:35 -0400 (EDT)
From: Bishop Bettini
Reply-To: bishop@ateb.com
To: icq-devel@lists.realminfo.com
CC: Bishop Bettini , Mike Walton

Hey-

Sorry that is is (maybe) a little off topic...

I've received an overwhelming number of questions about how to fire up the server... I know we need documentation. :) Here's the candy (command line friendly format + comments):

   gzip -cd gicqd-0.0.90b.tar.gz | tar -xvf -   # get the source code ready
   cd gicqd-0.0.90b                             # go into source directory
   ./configure                                  # go configure it
   make                                         # build it
   make createbase                              # make a basic database
   ./src/gicqd -f conf/gicqd.conf -d .          # start it up
   

A few caveats, right now just FYI:

1. assuming you don't do a "make install," which at this point I don't recommend because of the beta-ness of the code, you will need to pass two parameters into the server to start it up:
   1. -f configfile
   2. -d rootdir
   where (a) specifies the location of the configuration file and (b) specifies the server root directory (which will be chdir'd to)
2. kill the server with a signal (TERM, QUIT, etc). reload the configuration file with a HUP signal; you can find the server pid in /tmp/gicqd.pid.4000 (unless you do a `make install' in which case you should review conf/gicqd.conf before doing the install)
3. do a `./configure --with-debugging' to be inundated by event + diagnostic messages when you start up the server. If you configure with debugging, you will get the messages on stderr.
4. `make createbase' creates three users (Mike, Derek and myself). These probably aren't terribly useful to you (unless you feel like changing your client's info temporarily), so you'll probably want to use the included `dbtool' to add users. Something like

      echo "add -f uin=54321 passwd=foobar nick=bishop" | ./src/dbtool userinfo /tmp/userinfo.db
      

   will get you started out of the box, with this result:

      Database Manipulation Tool (dbtool) 0.1.2
      Type `help' for commands or `quit' to exit.
      >> OK: record added
      >>
      

   NOTE that you currently get "warnings" when you run `make createbase' These are okay (get the latest 0.0.90b tarball if you want a version without the errors)
5. We did this project originally for research in GNU's viability as a development model to create highly configurable, readily distributable and portable code, and as such the server proper is lacking in some areas. From where we are at now to having a usable, rigorous V2 server is a few short hops. This lack of meat is the reason the server itself is version < 0.0.

Later,
bishop