ICQCorp
Navigator About News Links Install FAQ Screenshots Credits Author PostgreSQL Download Documents Guestbook IServerd project

--- 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
-----------------------------------------------------
>cd ~
>mkdir IServerd_src
>mv IServerd-x.x.x.tar.gz IServerd_src/
>cd IServerd_src
>tar xzvf ./IServerd-x.x.x.tar.gz
>cd ./IServerd-x.x.x
-----------------------------------------------------

==== 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.
-----------------------------------------------------
>cat COPYRIGHT | more :)
>./configure [--prefix=/usr/local] [--with-debug] [--with-russian]
>make all
>make install
-----------------------------------------------------

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)
----------------------------------------------------
>su postgres
>db_manage create
Please, input database name: users_db
Please, input database username: iserverd
Please, input database user passwd: ******
CREATE USER
CREATE DATABASE
>exit
----------------------------------------------------

==== 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.

About  ] Install  ] Credits  ] Screens  ] Postgres  ] Download  ]
News  ] FAQs  ] Author  ] Links  ] Documents  ] Guestbook  ]
Webmaster
A.V.Shutko