.. _management_client: Installing Management Clients ============================= The Management Clients are also implemented in Python and can be used on Linux and on Windows. There are DEB packages available which are known to run on Ubuntu 12.04 LTS (64bit), Debian Squeeze (64bit) and Debian Wheezy (64bit). If the package fails to run on your system, you can also install the management client from source or from the python package index (see :ref:`install_client_pypi`). The Management Client also runs on Windows XP, Windows 7 and Windows Server 2008. .. note:: There are two admin clients available – a command line client linotpadm.py and a GTK graphical user interface glinotpadm.py. The GTK client will only work with Python 2.6. The command line client can very well work with Python 2.5. The command line client only provides a reduced feature set. .. note:: If you want to enroll the USB based eToken NG-OTP you also need to install the SafeNet PKI Client. If you do not want to enroll eToken NG OTP and not enroll Yubikeys you can do all management task with the Web UI and do not need to install the management client. After having installed the management client, please refer to :ref:`management_guide` for configuring your LinOTP server and using the management client. Install the Debian packages --------------------------- The DEB packages for the Management Client require Python 2.6 to be installed on your system. On a distribution like Ubuntu 12.04 LTS or Debian you may install the Management Client by issuing the command:: dpkg -i linotp-adminclient-cli_*current_version*_all.deb linotp-adminclient-gui_*current_version*_all.deb If your Python search path is setup correctly (see :ref:`python_search_path`) you may now start the management client:: glinotpadm.py .. _install_client_pypi: Install python packages ----------------------- On other distributions you can install the management client either system wide or to your virtualenv:: pip install linotpadminclientcli pip install linotpadminclientgui Management Client Installation on Windows ----------------------------------------- On a Microsoft\R Windows you simply may install the bundled full installer ``LinOTP2MgmntClient-*current_version*-Full-Installer.exe``. The Management Client is known to run on Windows XP, Windows 7 (32/64bit), Windows 2008 and Windows 2008R2. The following software is contained in the bundle installer: 1. http://www.python.org/ftp/python/2.7.4/python-2.7.4.msi (You will not necessarily need Tcl/Tk, Documentation and Test suite) 2. http://ftp.gnome.org/pub/GNOME/binaries/win32/gtk+/2.18/gtk+-bundle_2.18.7-20100213_win32.zip 3. http://ftp.gnome.org/pub/GNOME/binaries/win32/pycairo/1.8/pycairo-1.8.6.win32-py2.6.exe 4. http://ftp.gnome.org/pub/GNOME/binaries/win32/pygobject/2.20/pygobject-2.20.0.win32-py2.6.exe 5. http://ftp.gnome.org/pub/GNOME/binaries/win32/pygtk/2.16/pygtk-2.16.0.win32-py2.6.exe Just run the installer and follow the instructions. .. figure:: images/full-installer.png *Choosing the components to install* .. note:: If you want to enroll the USB based eToken NG-OTP you also need to install the SafeNet PKI Client. .. note:: If you want to change the language of the LinOTP Management Client after the installation, you need to set the environment variable `LANG` to either `de` or `en`. .. _install_yubikey: Installing Yubikey components ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. index:: Yubikey components You need to install several additional components to enable the USB support and enroll Yubikeys on this workstation. .. note:: You do not need to install any software to use the Yubikey. Install setuptools .................. Download setuptools [#setuptools]_ and execute the installer. .. [#setuptools] https://pypi.python.org/packages/2.7/s/setuptools/setuptools-0.6c11.win32-py2.7.exe .. note:: As the full installer comes with python 2.7 32bit, you also need to install setuptools 32bit even if you are on a 64bit system. Python Yubico module .................... Download the modified python Yubico module [#yubico]_. The original module will not work at the moment. Unpack it and open a command prompt as administrator. In the unpacked directory run:: python setup.py install .. [#yubico] https://github.com/lsexperts/python-yubico Python USB .......... This are the python USB modules. Download [#pyusb]_, unpack it and open a command prompt as administrator. In the unpacked directory run:: python setup.py install .. [#pyusb] http://downloads.sourceforge.net/project/pyusb/PyUSB%201.0/1.0.0-alpha-3/pyusb-1.0.0a3.zip Install the driver .................. Now you need to install a libusb driver for the Yubikey. There are several ways to do this, the easiest is to download the tool *zadig* [#zadig]_, which will create the driver package for you. You need 7zip to unzip the tool! Download the tool and run zadig. Insert a Yubikey and select this USB device (vendor ID 1050, product ID: 0010). You might need to check ``List all devices`` in the options menu. The ``Target Driver`` needs to be set to ``libusb0``. Hit install and wait. .. note:: When authenticating the Yubikey works as a HID device. This is why you do not need any additional driver installed. But for enrolling the Yubikey on your Windows machine the associated driver for the Yubikey is set to libusb0. Thus you will not be able to use the Yubikey for authentication on your enrollment workstation. .. [#zadig] http://sourceforge.net/projects/libwdi/files/zadig/zadig_v1.1.1.140.7z/download Finally you should reboot your machine.