Skip to content
This repository has been archived by the owner on Nov 9, 2017. It is now read-only.

Latest commit

 

History

History
81 lines (48 loc) · 3.45 KB

installation.md

File metadata and controls

81 lines (48 loc) · 3.45 KB
Raw

The Zanata client (zanata-cli) can be installed on most systems. Installation is easiest under Fedora, other systems can use Apache Ivy for installation. Manual installation is also possible.

Installation on Fedora

If you are using Fedora, zanata-cli is available through the yum package manager.

sudo yum install zanata-client

Note: If you are not running the latest version of Fedora, the latest version of the client may not be available, so you might want to try the Ivy version (below).

Installation with Ivy (Recommended)

The Ivy distribution of the client is a small script that will download the client the first time it is run. This distribution requires Apache Ivy to run.

  1. See Setup Ivy for Apache Ivy installation.
  2. Save this script somewhere on your path, and make sure it is executable. For example, assuming you have ~/bin in $PATH,
cd ~/bin
wget https://raw.github.com/zanata/zanata-client-ivy/master/zanata-cli
chmod 755 zanata-cli

Note: It's a good idea to check for a new version of zanata-cli once in a while (especially when a new version of Zanata server is released).

Installation with 0install

The 0install distribution of the client is to allow zanata-cli to be available on multiple platform. This distribution requires 0install to run.

  1. See Setup 0install for 0install installation.

  2. If you are new to Zanata-CLI, run command below to install zanata-cli.

    0install -c add zanata-cli http://zanata.org/files/0install/zanata-cli.xml

    Now you can run zanata-cli --help for more options.

    If you already have a copy of zanata-cli in your machine and wish to keep 0install zanata-cli as a separate command, you can still run 0install with:

    0launch http://zanata.org/files/0install/zanata-cli.xml {command}

Update 0install Zanata-CLI

To update Zanata CLI, run

0install update http://zanata.org/files/0install/zanata-cli.xml

Manual Installation

To manually install zanata-cli:

  1. Navigate to zanata-cli on Maven Central.

  2. Download either dist.zip or dist.tar.gz.

  3. Extract the contents of the archive to your location of choice.

  4. Create a symbolic link to the zanata-cli script in the bin directory of the extracted archive. e.g. from the archive directory, run sudo ln -s bin/zanata-cli /usr/local/bin/zanata-cli.

  5. (optional) you can also enable tab-autocomplete for the client if you use bash as your terminal shell. This can be done by copying or linking the zanata-cli-completion script from the bin directory to /etc/bash_completion.d/. e.g. ln -s bin/zanata-cli-completion /etc/bash_completion.d/zanata-cli-completion.

Nightly Builds

If you like to live dangerously, the client nightly relase is available. This may have newer features, but is not guaranteed to be stable.

The latest nightly build is available as an archive that can be installed manually. To install the latest nightly build:

  1. Open Client nightly builds.
  2. Open the directory showing the highest version number.
  3. Download either of the distributable archives (ending with -dist.zip or -dist.tar.gz).
  4. Install as per manual installation instructions above.