Installation

WINDOWS:
        Just unpack the binaries of server and example services and client applications and run coid.exe. To compile, look for the .dsp and .dsw project files for Visual Studio.


LINUX:

•     Compiling:

        make

•     Quick start: after calling make the binaries are put into the bin directory, and you can run the server right away from there:
  

        bin/coid -l bin/libcoidserver.so bin

        That means:
        Start bin/coid, load server library bin/libcoidserver.so.
        Look for config file in the 'bin' directory (probably there won't be any config (.devconf) file, when the program defaults to loading all devices from the <config_dir>/device directory, what is bin/device in this case).

•     Running from any directory (without installation):

        coid -l path/server_library.so config_directory

        and in the .devconf file (placed in config_directory) add/change entry "directory" to path where your device directory is placed.

•     Installation to /usr/local/...:

        make install
       
        (as root), this will install coid loader, coid server library, coidgen, coidc (console) and console device.

•     Chat service and http server service:

        If you want to compile and install other services (http server or chat), type:

        make chat
        make http

        or just:
        make all
        to build everything, and finally copy their device folders (bin/chat, bin/httpserv) to /usr/local/lib/coid/device

        Another way:
        make install_chat
        make install_http

        to install all, type:
        make install_all

•     Running coid (after the installation):

        just type:
        coid

        If you have installed coid, its default startup is:
        load /usr/local/lib/coid/libcoidserver.so and search for /etc/coid/.devconf (if no config dir was given as argument).
        It will look there for the device directory, default is /usr/local/lib/coid/device

•     Need help ?

        man coid
        man coidgen
                documentation

•     Examples:

        bin/coid -l bin/libcoidserver.so bin -p 54321
        coid -p 12345 ~/.coid

        bin/coid -l bin/libcoidserver.so bin -p 54321
        # -l option requires path (if the library is not located in common locations
        # such as /usr/lib, ...),
        # so you must use prefix './' for current directory,  e.g. ./libcoidserver.so
        cd bin
        coid -l ./libcoidserver.so . -p 54321

        # console:
        coidc localhost:12345
        coidc -all localhost:55099