Installation

Epoptes consists of a server package called epoptes and a client package called epoptes-client. Install the server part on the PC where you'll be monitoring the clients from. If you want to use the GUI from a thin-client, install it on the LTSP server.

Adding the epoptes PPA to your sources

You don't need to add the epoptes repository to your sources if you're using Debian 7.0 (Wheezy), Ubuntu 12.04 (Precise) or newer versions. For previous Debian and Ubuntu versions, you need to execute the following commands, but not yet, wait until you're prompted to do from the following sections.
apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 0350B375
series=$(lsb_release -s -c)
test "$series" = wheezy && series=precise
test "$series" = jessie && series=vivid
echo "deb http://ppa.launchpad.net/epoptes/ppa/ubuntu $series main" > \
     "/etc/apt/sources.list.d/epoptes-ppa-$series.list"
apt-get update

Server package installation

Execute the following commands as root (use sudo -i first on Ubuntu or su - on Debian):
==> now run the commands from the "Adding the epoptes PPA to your sources" step
apt-get install epoptes

After the installation you need to add some users to group "epoptes" (or use another group as mentioned in the Configuration section below). These users will be allowed to launch the GUI and control clients:
gpasswd -a username epoptes

Users that are currently logged on need to logoff/logon for the group change to take effect (or use newgrp).

Client package installation for LTSP chroots

For LTSP chroots, execute the following commands. Substitute i386 with amd64 if you have an amd64 chroot:
sudo chroot /opt/ltsp/i386
==> now run the commands from the "Adding the epoptes PPA to your sources" step
apt-get install epoptes-client
epoptes-client -c             # Fetches the OpenSSL certificate from the server
exit

On Ubuntu, you also need to update the NBD image for the changes to take effect:
sudo ltsp-update-image

Client package installation for standalone clients

By default, epoptes-client tries to connect to an epoptes server with the DNS name "server". If your don't have a DNS server, you can put your epoptes server IP to /etc/hosts in all clients, before installing epoptes-client, so that it's then easier to fetch the server certificate.

If your epoptes server doesn't have a static IP, and it's named for example epoptes-server, you might be able to use the "epoptes-server.local" MDNS name that avahi provides. If you can ping epoptes-server.local from the clients, then you can put SERVER=epoptes-server.local it in /etc/default/epoptes-client in them even if your server has a dynamic IP.

After you've configured where the clients will find the epoptes server, execute those commands as root in all of them (use sudo -i first on Ubuntu or su - on Debian):
==> now run the commands from the "Adding the epoptes PPA to your sources" step
apt-get install epoptes-client
epoptes-client -c             # Fetches the OpenSSL certificate from the server

Note that packages are not allowed to start programs inside a user's session, so you need to reboot the clients for the epoptes-client installation to take effect.
Comments