Install the clients - DLR-SC/DataFinder GitHub Wiki

On this page the different installation options of the DataFinder clients are described. After installation you can setup your data repository using the administrative client. The basic steps are explaind in section Configure your data repository.

The DataFinder distributions are published on the SourceForge project web site.

Please download here.

Source Distribution Installation

The source distribution allows the platform-independent usage of the DataFinder clients. The following table gives an overview about the required and optional Python package used by the DataFinder clients.

Name Version Remarks PyPI Package Name
Python Interpreter 2.6.5 Must be 32-bit, also the other packages. Can be the newest version of 2.x, e. g. 2.7.11.
setuptools 0.6.c11 Is only required if you want to simplify installation of dependencies using easy_install. setuptools
pip 9.0.1 Is only required if you want to simplify installation using pip (recommended). To upgrade from an older version: python -m pip install --upgrade pip
PyQt 3 PyQt3.18, SIP4.10, Qt 3.3.8 Required by the administrative client only. Make sure to use identical versions of SIP for both PyQt3 and PyQt4.
PyQt 4 PyQt4.7.3, SIP4.10, Qt4.6.2 Required by the user client only. Make sure to use identical versions of SIP for both PyQt3 and PyQt4.
Pyparsing 1.5.2 Required by the user client only. pyparsing
Python WebDAV Library 0.3.1 Do not confuse with PyWebDAV (on PyPI) or python-webdav (Debian/Ubuntu) Python_WebDAV_Library
PyWin32 214 Required on Windows operating systems only. Download from (e.g.) here, install: pip install pywin32-221-cp27-cp27m-win32.whl. You may have to manually copy pywintypes27.dll to the pywin system directory (e. g. C:\Python27\Lib\site-packages\pywin32_system32, see the related stackoverflow question). pywin32
Paramiko 1.7.6 Required for Tivoli Storage Manager data store access of the user client only. paramiko

To build the DataFinder clients follow these instructions:

  • Install the required dependencies.
  • Extract the DataFinder source package and change into the created directory.
  • Set the environment variable DF_HOME to the path of the installation directory.
  • Set the environment variable DF_START to a valid data repository configuration URL (at least this environment variable has to be set to any value).
  • The adimistrative client is started as follows:
python bin/datafinder-admin-client.py
  • The user client is started as follows:
python bin/datafinder-client.py

Binary Distribution Installation

The provided binary distributions allow out-of-the-box usage of the DataFinder clients without prior installation of the above mentioned dependencies.

Binary Linux Distribution Installation

These distributions are provided as tar archives. To use the DataFinder clients follow these instructions.

Note: For SuSE Linux Enterprise Desktop 10 (SLED 10), 64 bit only at time of release 2.2.0!

  • Extract the archive and change to created directory.
tar -xvzf DataFinder-2.2.0-RELEASE-220_SLED10_64.tar.gz
cd DataFinder-2.2.0-RELEASE-220_SLED10_64
  • Set the environment variable DF_HOME to the path of the installation directory.
export DF_HOME#$(pwd)
  • Set the environment variable DF_START to a valid data repository configuration URL (at least this environment variable has to be set to any value).
export DF_START#http://localhost/webdav/config
  • The adimistrative client is started as follows:
./datafinder-admin-client
  • The user client is started as follows:
./datafinder-client

Binary Windows Distribution Installation##

The provided Windows installer guides you through the whole installation process and also create shortcuts and program folder entries.

When updating the DataFinder clients to a newer version DO NOT install in the former installation directory before you have uninstalled the former version.

If you have NOT sufficient prvileges to set system-wide environment variables you will have to set the environment variables DF_HOME and DF_START manually.

  • Set the environment variable DF_HOME to the path of the installation directory.
  • Set the environment variable DF_START to a valid data repository configuration URL (at least this environment variable has to be set to any value).

To use the DataFinder clients follow these instructions:

  • Start the corresponding installer program and follow the instructions.
  • Adapt the environment variable DF_START to the URL of your data repository configuration URL.
  • Start clients with the help of the created symbolic links or program folder entries.