Python Introduction

Agate Python client, a command line scripting tool written in Python, enables automation of tasks in a Agate server.

Requirements

Python 2.x must be installed on the system. See more about Python.

Installation

You can install Agate Python Client via the following two methods:

  • use the Debian/RPM package manager
  • use a Python package

Debian Package Installation

Follow the OBiBa Debian Repository instructions and run:

sudo apt-get install agate-python-client

RPM Package Installation

Follow the OBiBa RPM Repository instructions and run:

sudo yum install agate-python-client

Python Package Installation

This type of package is cross-platform (Linux, Windows, Mac).

Install on Linux or Mac

  1. Download the most recent version
  2. Decompress the file and enter the installation folder:
tar xvzf agate-python-client-X.XX.tar.gz
cd agate-python-client-X.XX
  1. Install the package:
sudo python setup.py install --record installed_files.lst

Note

The –record will generate a list of installed files on your system. Since there is no uninstaller, you can use this file to remove the Agate Python Client package. You can do this by executing the following command: sudo cat installed_files.lst | xargs rm -rf

Install on Windows

  • Using Cygwin

You can install Cygwin, making sure that CURL, Python, gcc are included and follow these steps inside a Cygwin BASH window:

cd /usr/lib
cp libcurl.dll.a libcurl.a
cd <your-desired-dir>
curl -C - -O http://download.obiba.org/agate/stable/agate-python-client-X.XX.tar.gz
tar xzvf agate-python-client-X.XX.tar.gz
cd agate-python-client-X.XX
python setup.py install --record installed_files.lst
  • Using plain Windows tools

This Windows installation is the most complicated one but does not required any third party tools. You are required to do a few manual installations before the package is fully usable. The following steps were tested on a Windows 7.

  1. You must have Python installed on your Windows system. Run this installer in case you don’t have one.
  2. Download the Google protobuf binary and make sure that its containing folder is in your path.
  3. Download the Google protobuf source package containing the setup.py file and follow these steps:
unzip protobuf-2.5.0.zip
cd protobuf-2.5.0/python
python setup.py install
  1. Go to the Python Libs site and download the file pycurl-7.19.0.win-amd64-py2.7.‌exe
  2. Run the installer and follow the instructions until the package is installed
  3. Download the most recent version and follow these steps:
unzip http://download.obiba.org/agate/stable/agate-python-client-X.XX.zip
cd agate-python-client-X.XX
python setup.py bdist_wininst
cd dist
  1. Execute the generated installer and follow the instructions (agate-python-client-X.XX.win-amd64.exe)

Usage

To get the options of the command line:

agate --help

This command will display which sub-commands are available. Further, given a subcommand obtained from command above, its help message can be displayed via:

agate <subcommand> --help

This command will display available subcommands.