--- Some basic steps to install IServerd..
First of all you'll need to install Postgres SQL server. After that you can begin IServer compilation. If you plan use postgres database server located on another computer you at least will be need PgSQL header and library files.
==== STEP 1. Uncompress IServerd source archive.
Here is example how to do this on typical unix system
==== STEP 2. Compiling & installing IServerd
Do it as usual. You can run configure script with
--help to get all its options. Probably you'll need
--with-debug option to compile IServerd with debug
information and --with-russian to enable russian charset
in icontrol gui. IServerd from version 0.10.8 installs in
system directories. If you want to install it as single
package, you should specify --prefix option.
You can specify prefix before running configure
script. By default server will install into system directories (/etc;/usr/bin;/usr/sbin)
==== STEP 3. Configuring IServerd
Run db_manage.sh script with "create" as parameter. It will ask
database name (i.e. users_db), database user name (i.e. iserverd),
database user password. Then go to $PREFIX/iserverd/etc and
copy *.conf.default to *.conf. Now you should edit this files.
First of all you should specify bind interface (with mask /32),
admin email, info password (DEFAULT will not work), proper translate
table filename (you can write DEFAULT to disable translating).
Then you should specify correct database user, its password, database server
ip and port number. You can leave database addr field blank and database server
will use local socket instead of TCP/IP transport.
==== STEP 4. Database initialization
Make sure that database server is running. After that
you should create database with name, specified in iserv.conf.
Also edit database password field in iserv.conf
Then you can init it with icontrol (or simply run iserverd -
at first run it tell you that tables not found and create them)
==== STEP 5. Migration from NT ICQ server =[Optional]=
To migrate from Mirabilis Groupware ICQ server for NT you'll only need convert its Micro$oft Access database to PostgreSQL users database. First of all you'll should export Access database to text file with symbol ';' as delimiter. Open ICQSDB.mdb, highlight icqusers_tb table, then select menu file/export. In appeared window choose save as text file after that you can copy it on your Unix machine and start converting.
NOTE: Before converting you can choose apropriate translate file from translate directory to have databases in native unix codepages...
WARNING: You should run iserverd before convertation
at least one time to create all neccessary tables (or you can do this with icontrol).
==== STEP 6. Running IServerd
Now you can run IServerd - it will create pid file and three special files (unix domain sockets). Two of them - incoming and outgoing pipes, used for communications between processes. Third used for wwp messages (also you can send messages with it from text console). First of all after starting IServerd you should check if string "Purging online cache" exist in debug.log. After first run you debug.log may contain some error messages about non-existing tables. If you find this messages, try to rerun IServerd and they should disapear.
IServerd installed, now you can add users using script $PREFIX/iserverd/etc/db/icquser and
use it. Thanks for your choose and good luck.