The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
 / 
Dicop-Server-3.03
++
/ DICOPD

NAME

DICOPD - Details for the dicopd daemon.

Last update: 2004-11-25

OVERVIEW

dicopd is the master server daemon. Use the Dicop::Proxy package if you want to setup a proxy.

Installing

Follow the instructions in INSTALL before you attempt to start the daemon.

Starting

To start the daemon in the foreground, type

        ./dicopd

It is recommended to run it in the background, as well as redirect its STDERR output to a file with:

        ./dicopd 2>stderr.txt &

You can then follow the startup phase with tail -f stderr.txt, which might take a few seconds to complete.

Connecting to it, Administration

You can connect with any webbrowser to the running daemon like it where a web server. If your daemon is on IP 192.168.0.1 and listening on port 8888 (the default), then connect to:

        http://192.168.0.1:8888/

From there on you should be able to navigate through the pages.

Troubleshooting

Taint checking

Please note that

        perl dicopd

will not work, since then the taint checking won't work. You must either start it with -T on the commandline like this:

        perl -w -T dicopd

or this:

        ./dicopd
ssh

When using ssh to connect to a machine, and then starting the daemon from there, it is possible that the daemon is killed when you simple close the terminal window. You need to logout first, the logout might hang, but you can then safely close the terminal window.

PORT, GROUP, USER

The port to bind on, the user and group can be set in config/server.cfg. You should, for security reasons, create a new user and group for the daemon.

Please make sure that the user and group actually exist, or the daemon will not start.

CHROOT

Setting the chroot key in the config file to an non-empty string will cause the daemon to attempt to change the root directory to the specified directory while running. The usual setting is:

        chroot  = "."

AUTHOR

(c) Bundesamt fuer Sicherheit in der Informationstechnik 1998-2004

DiCoP is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation.

See the file LICENSE or http://www.bsi.bund.de/ for more information.