This section describes how to install the Registry Client software contained in the registry-client package. The following topics can be found in this section:
The Registry Client software was developed using Python and will run on any platform with a supported Python installation. It is compatible with Python 2.6 or 2.7. It is not compatible with Python 2.5 or earlier versions, nor with Python 3 or later versions. The following commands test the local Python installation in a UNIX-based environment:
% which python
/usr/bin/python
% python --version
Python 2.7.2
The first command above checks whether the python executable is in the environment's path and the second command reports the version. If Python is not installed or the version is not 2.6 or 2.7, Python will need to be downloaded and installed in the current environment. Consult the local system administrator for installation of this software.
By far, the easiest way to install the Registry Client (pds.registry) is to use the Python utilities pip or easy_install. As a privileged user, install the package with one of the following commands:
% pip install https://pds.nasa.gov/software/pds4/registry/pds.registry-1.12.0.tar.gz
or
% easy_install https://pds.nasa.gov/software/pds4/registry/pds.registry-1.12.0.tar.gz
The software as well as its dependencies will be downloaded and installed automatically. Of course, you can use it in virtualenvs and buildouts too. If neither pip nor easy_install are available on your system, just install the package from source. Download the package from the PDS FTP site. Unpack the selected distribution file with the following command:
% tar -xzvf pds.registry-1.12.0.tar.gz
In the extracted directory, perform the following command as a privileged user to install the package:
% python setup.py install
The package is now ready to utilize in your Python applications.