Manually install clients

Once centralized is running on it’s own server, you’ll need to install an agent on each managed server, let’s proceed to the install. Those instructions are valid for any debian based or redhat based distribution

Note: In the following instructions, please replace pip3 by pip in redhat based systems.

What you need to install and where.

Centralized comes with 2 packages.

• daemon_register
• admintool

daemon register is to be ran on every managed system. admintool is to be ran only on systems where the administrator will configure centralized.

While not recommended, both can run on a same machine.

Those programs require configuration files that were generated when you ran the service. Those configuration files embed information such as the IP address of the server, it's encoded SSL CA, etc...

Configuring package sources.

Debian based

# As root user.
echo 'deb http://deb.centralized.pw/apt/debian stable main' > /etc/apt/sources.list.d/centralized.list
wget -O - 'http://deb.centralized.pw/apt/centralized.gpg.key' |apt-key add -
apt-get update

Redhat based

Create /etc/yum.repos.d/centralized.repo with the following contents

[centralized]
name=Centralized
baseurl=http://deb.centralized.pw/yum/
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/Centralized.gpgkey

Now run those commands:

curl 'http://deb.centralized.pw/apt/centralized.gpg.key' > /etc/pki/rpm-gpg/Centralized.gpgkey
rpm --import /etc/pki/rpm-gpg/Centralized.gpgkey

daemon_register

The daemon is to be ran on every managed system.

Dependencies

You’ll need python3. The command /usr/bin/env python3 must lead you to python3. You’ll need to run the following commands:

pip3 install requests

DEB

apt-get install centralizeddaemon

RPM

yum install centralizeddaemon

Configuration file

You can get it from /tmp/centralized/config.ini on the centralized server machine.

About the configuration file, here are the rules:

• Named config.ini
• With rights 0600
• With ownership root:root

In a directory:

• Named /etc/centralized
• With rights 0700
• With ownership root:root

Register

Now, we register the server. Please note that "$(hostname) additional info." can be replaced by anything meaningful to you, just please ensure unicity here.

python3 /usr/local/bin/centralized_register_server.py "$(hostname) additional info."

Management interface

Installation

First, you need the config file that’s generated by centralized for admin tools. You can find it on the centralized server in /tmp/centralized/centralized_admin.json Please copy it on the admin machine on ~/.centralized_admin.json

Dependencies

You’ll need python3. The command /usr/bin/env python3 must lead you to python3. You’ll need to run the following commands (‘pip3’ become ‘pip’ in rpm environments):

pip3 install terminaltables

DEB

apt-get install centralizedadmin

RPM

yum install centralizedadmin

Testing

If everything went fine, the admin tool should list your users by typing centralized_admin.py users list