Skip to content

Commit

Permalink
Merge branch 'master' into ZNTA-2313
Browse files Browse the repository at this point in the history
  • Loading branch information
kathryngo committed Feb 9, 2018
2 parents 058d212 + 6491d3a commit b3fc4d1
Show file tree
Hide file tree
Showing 320 changed files with 4,829 additions and 875 deletions.
217 changes: 135 additions & 82 deletions docs/client/installation/linux-installation.md
View file
@@ -1,175 +1,190 @@
## RHEL 7
There are two ways to install zanata-client, via `0install` or `yum`.
There are two ways to install zanata-cli, via `0install` or `yum`.

### With 0install

**Note: If you have previously installed `zanata-cli` through 0install, please run this command to update your `zanata-cli`**

0install destroy zanata-cli | yes | 0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml

* To install a specific version (e.g. 4.1.1)

0install destroy zanata-cli | yes | 0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml --version=4.1.1


**Note: If you have previously installed `zanata-cli` with Ivy or yum, you need to uninstall it first**

---
0. If you have not install 0install, or not sure, run following commands to install 0install
and other dependencies:

1. Install EPEL repository for RHEL 7
sudo rpm -ivh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
sudo yum -y install 0install java-1.8.0-openjdk unzip

sudo rpm -ivh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
1. To install zanata-cli, run:

2. Install `0install`
mkdir -p ~/bin
0install destroy zanata-cli
yes | 0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml
0install -c update zanata-cli

sudo yum -y install 0install java-1.8.0-openjdk unzip
2. It should be done now. Run `zanata-cli --help` for the usage of the client.

3. Use `zanata-cli` as alias:
3. To update zanata-cli, run:

mkdir -p ~/bin | yes | 0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml
0install -c update zanata-cli

4. It should be done now. Run `zanata-cli --help` for the usage of the client.

---
### With yum

**Note: If you have previously installed `zanata-cli` with Ivy or 0install, you need to uninstall it first**

---
This method uses a 3rd-party yum repository, `Zanata_Team el-zanata` (a.k.a. dchen's epel-zanata).

1. Install `epel-zanata` repo
0. To install `Zanata_Team el-zanata`, run:

cd /etc/yum.repos.d ; sudo wget https://repos.fedorapeople.org/dchen/zanata/epel-zanata.repo
sudo curl -L -o /etc/yum.repos.d/el-zanata.repo https://repos.fedorapeople.org/Zanata_Team/zanata/el-zanata.repo

2. Install package `zanata-cli-bin`
1. To install zanata-cli, run:

sudo yum -y install zanata-cli-bin java-1.8.0-openjdk
sudo yum -y install zanata-cli-bin

3. It should be done now. Run `zanata-cli --help` for the usage of the client.
2. It should be done now. Run `zanata-cli --help` for the usage of the client.

3. To update zanata-cli, run:

sudo yum -y update zanata-cli-bin

## RHEL 6
There are two ways to install zanata-client, via `0install` or `yum`.

### With 0install

**Note: If you have previously installed `zanata-cli` through 0install, please run this command to update your `zanata-cli`**
**Note: If you have previously installed `zanata-cli` with Ivy or yum, you need to uninstall it first**

0install destroy zanata-cli | yes | 0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml

**Note: If you have previously installed `zanata-cli` with Ivy or yum, you need to uninstall it first**
0. If you have not install 0install, or not sure, run following commands to install 0install
and other dependencies:
a. Install other dependencies:

---
sudo yum -y install libcurl java-1.8.0-openjdk unzip

1. Download and extract `0install` binary package
a. for 64-bit machine (such as x86_64)
b. Download and extract 0install for 64-bit machine (such as x86_64)

cd /tmp; wget https://downloads.sourceforge.net/project/zero-install/0install/2.10/0install-linux-x86_64-2.10.tar.bz2
tar xjvf 0install-linux-x86_64-2.10.tar.bz2
cd 0install-linux-x86_64-2.10
b. for 32-bit machine (such as i486)

c. Download and extract 0install for 32-bit machine (such as i486)

cd /tmp; wget https://downloads.sourceforge.net/project/zero-install/0install/2.10/0install-linux-i486-2.10.tar.bz2
tar xjvf 0install-linux-i486-2.10.tar.bz2
cd 0install-linux-i486-2.10

2. Install `libcurl` if you have not
d. Install `0install`

sudo yum -y install libcurl java-1.8.0-openjdk unzip
./install.sh


3. Install `0install`
1. To install zanata-cli, run:

./install.sh
mkdir -p ~/bin
0install destroy zanata-cli
yes | 0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml
0install -c update zanata-cli

4. Use `zanata-cli` as alias:
2. It should be done now. Run `zanata-cli --help` for the usage of the client.

mkdir -p ~/bin | yes | 0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml
3. To update zanata-cli, run:

5. It should be done now. Run `zanata-cli --help` for the usage of the client.
0install -c update zanata-cli

---
### With yum

**Note: If you have previously installed `zanata-cli` with Ivy or 0install, you need to uninstall it first**

---
0. To install `Zanata_Team el-zanata`, run:

sudo curl -L -o /etc/yum.repos.d/el-zanata.repo https://repos.fedorapeople.org/Zanata_Team/zanata/el-zanata.repo

1. Install `epel-zanata` repo
1. To install zanata-cli, run:

cd /etc/yum.repos.d ; sudo wget https://repos.fedorapeople.org/dchen/zanata/epel-zanata.repo
sudo yum -y install zanata-cli-bin

2. Install package `zanata-cli-bin`
2. It should be done now. Run `zanata-cli --help` for the usage of the client.

sudo yum -y install zanata-cli-bin java-1.8.0-openjdk
3. To update zanata-cli, run:

sudo yum -y update zanata-cli-bin

3. It should be done now. Run `zanata-cli --help` for the usage of the client.

## Fedora
There are two ways to install zanata-client, via `0install` or `dnf`.

### With 0install
**Note: If you have previously installed `zanata-cli` with Ivy or yum, you need to uninstall it first**

**Note: If you have previously installed `zanata-cli` through 0install, please run this command to update your `zanata-cli`**

0install destroy zanata-cli | yes | 0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml

**Note: If you have previously installed `zanata-cli` with Ivy or dnf, you need to uninstall it first**
0. If you have not install 0install, or not sure, run following commands to install 0install
and other dependencies:

---
sudo yum -y install 0install java-1.8.0-openjdk unzip

1. Install 0install
1. To install zanata-cli, run:

sudo yum -y install 0install java-1.8.0-openjdk unzip
mkdir -p ~/bin
0install destroy zanata-cli
yes | 0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml
0install -c update zanata-cli

2. Use `zanata-cli` as alias:
2. It should be done now. Run `zanata-cli --help` for the usage of the client.

mkdir -p ~/bin | yes | 0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml
3. To update zanata-cli, run:

3. It should be done now. Run `zanata-cli --help` for the usage of the client.
0install -c update zanata-cli

---
### With dnf

**Note: If you have previously installed `zanata-cli` with Ivy or 0install, you need to uninstall it first**
`zanata-client`, the package that contains `zanata-cli`, is already in official Fedora repository.

---
**Note: If you have previously installed `zanata-cli` with Ivy or 0install, you need to uninstall it first**

1. Install `zanata-client`
1. To install `zanata-cli`, run:

sudo dnf -y install zanata-client

## Debian based distro
2. It should be done now. Run `zanata-cli --help` for the usage of the client.

**Note: If you have previously installed `zanata-cli` through 0install, please run this command to update your `zanata-cli`**
3. To update zanata-cli, run:

0install destroy zanata-cli | yes | 0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml
sudo dnf -y update zanata-client

**Note: If you have previously installed `zanata-cli` with Ivy or dnf, you need to uninstall it first**

---
## Debian Based Distributions

1. Install 0install
0. To install 0install and other dependencies, run:

sudo apt-get install zeroinstall-injector
sudo apt-get install zeroinstall-injector openjdk-8-jre

2. Install Java runtime:
1. To install zanata-cli, run:

sudo apt-get install openjdk-8-jre
mkdir -p ~/bin
0install destroy zanata-cli
yes | 0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml
0install -c update zanata-cli

3. Use `zanata-cli` as alias:
2. It should be done now. Run `zanata-cli --help` for the usage of the client.

mkdir -p ~/bin | yes | 0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml
3. To update zanata-cli, run:

0install -c update zanata-cli

4. It should be done now. Run `zanata-cli --help` for the usage of the client.

## Others
*Note: If you have installed `zanata-cli` previously through another method, you need to uninstall that for this to work.*

1. Follow 0Install in [0Install for Linux](http://0install.net/install-linux.html).
2. Install Java JRE (1.8 onwards) from [OpenJDK installation](http://openjdk.java.net/install/index.html)
3. Use `zanata-cli` as alias:
0. Follow 0Install in [0Install for Linux](http://0install.net/install-linux.html).
1. Install Java JRE (1.8 onwards) from [OpenJDK installation](http://openjdk.java.net/install/index.html)
2. To install zanata-cli, run:

mkdir -p ~/bin
0install destroy zanata-cli
yes | 0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml
0install -c update zanata-cli

3. It should be done now. Run `zanata-cli --help` for the usage of the client.

mkdir -p ~/bin | yes | 0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml
4. To update zanata-cli, run:

4. It should be done now. Run `zanata-cli --help` for the usage of the client.
0install -c update zanata-cli

## 0install Useful commands

Expand All @@ -178,6 +193,44 @@ There are two ways to install zanata-client, via `0install` or `dnf`.
0launch https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml {command}

* Update Zanata-CLI manually

0install update zanata-cli

* Set version of zanata-cli to 4.4.0

0install -c update zanata-cli --version=4.4.0

## Troubleshooting: Fedora dnf

#### The latest package is not in repository
It may still in updates-testing repository. Run:

sudo dnf -y --enablerepo=updates-testing update zanata-client

## Troubleshooting: RHEL yum

#### The latest package is not in repository
You local yum cache might not be updated. To refresh local yum cache,
run following command before you try again

sudo yum makecache

## Troubleshooting: 0install
#### 0launch URL works, but `zanata-cli` does not
Your `~/bin` might not be in path. Run:

grep $HOME/bin<<<$PATH || echo "$HOME/bin is not in PATH"

If `~/bin` is not in the path, then add following in both `~/.bashrc` and `~/.bash_profile`

PATH+=":$HOME/bin"


#### Downloaded package does not work
Your feed may be broken, to fix it, run:

mkdir -p ~/bin
0install destroy zanata-cli
yes | 0install -c add zanata-cli https://raw.githubusercontent.com/zanata/zanata.github.io/master/files/0install/zanata-cli.xml
0install -c update zanata-cli

71 changes: 71 additions & 0 deletions docs/release-notes.md
View file
@@ -1,10 +1,81 @@
## 4.4.3
##### Bug Fixes
* [ZNTA-2371](https://zanata.atlassian.net/browse/ZNTA-2371) - Few version setting options are getting hide if we have more than 2 versions

-----------------------

## 4.4.2
##### Bug Fixes
* [ZNTA-2375](https://zanata.atlassian.net/browse/ZNTA-2375) - Single project is shown multiple times on explore page.
* [ZNTA-2372](https://zanata.atlassian.net/browse/ZNTA-2372) - 400 bad request on TM merge Translations for poject version without document.

-----------------------

## 4.4.1
##### Bug Fixes
* [ZNTA-2374](https://zanata.atlassian.net/browse/ZNTA-2374) - SSO login with existing account only works on the second time

-----------------------

## 4.4.0
##### Infrastructure Changes
Zanata now requires a system property 'zanata.home' as the root for all its file system storage needs.
The property 'zanata.file.directory' is still supported, but if it is missing, a sub-directory of 'zanata.home' will be used.

##### Changes
* [ZNTA-2184](https://zanata.atlassian.net/browse/ZNTA-2225) - Define zanata.home system property and derive other properties from it
* [ZNTA-2326](https://zanata.atlassian.net/browse/ZNTA-2326) - Remove overlay
* [ZNTA-2308](https://zanata.atlassian.net/browse/ZNTA-2308) - Expand contents of frontend-storybook
* [ZNTA-2293](https://zanata.atlassian.net/browse/ZNTA-2293) - Changes to project version sidebar design
* [ZNTA-2280](https://zanata.atlassian.net/browse/ZNTA-2280) - Add descriptions to all waitFor instances in FT
* [ZNTA-2252](https://zanata.atlassian.net/browse/ZNTA-2252) - Prep for frontend/editor css merge
* [ZNTA-2233](https://zanata.atlassian.net/browse/ZNTA-2233) - Add more linting rules to stylelintrc
* [ZNTA-2231](https://zanata.atlassian.net/browse/ZNTA-2231) - Add a css linter to frontend
* [ZNTA-2230](https://zanata.atlassian.net/browse/ZNTA-2230) - Improve frontend caching
* [ZNTA-2225](https://zanata.atlassian.net/browse/ZNTA-2225) - Define zanata.home system property and derive other properties from it
* [ZNTA-2224](https://zanata.atlassian.net/browse/ZNTA-2224) - Tidy up editor css
* [ZNTA-2219](https://zanata.atlassian.net/browse/ZNTA-2219) - Nice-ify the glossary count in alpha editor
* [ZNTA-2216](https://zanata.atlassian.net/browse/ZNTA-2216) - Admin page to define review criteria
* [ZNTA-2215](https://zanata.atlassian.net/browse/ZNTA-2215) - Reject criteria in gwt editor
* [ZNTA-2197](https://zanata.atlassian.net/browse/ZNTA-2197) - Unmaintained Hibernate Search config for some entities
* [ZNTA-2176](https://zanata.atlassian.net/browse/ZNTA-2176) - Update project "invite only" to "private"
* [ZNTA-2174](https://zanata.atlassian.net/browse/ZNTA-2174) - Limit push/pull/download resources in private project
* [ZNTA-2173](https://zanata.atlassian.net/browse/ZNTA-2173) - Hide 'private' project
* [ZNTA-1952](https://zanata.atlassian.net/browse/ZNTA-1952) - More focused PR template
* [ZNTA-1694](https://zanata.atlassian.net/browse/ZNTA-1694) - Implement People frontend
* [ZNTA-1668](https://zanata.atlassian.net/browse/ZNTA-1668) - Translator should be able to see untranslated glossary entries
* [ZNTA-1227](https://zanata.atlassian.net/browse/ZNTA-1227) - Switch client/common code from hamcrest assert to assertj

##### Bug Fixes
* [ZNTA-2367](https://zanata.atlassian.net/browse/ZNTA-2367) - Lucene error
* [ZNTA-2363](https://zanata.atlassian.net/browse/ZNTA-2363) - Fix width of project version language list items
* [ZNTA-2362](https://zanata.atlassian.net/browse/ZNTA-2362) - TM creation date is not aligned properly.
* [ZNTA-2361](https://zanata.atlassian.net/browse/ZNTA-2361) - Review Criteria description field is a text area and not limited
* [ZNTA-2360](https://zanata.atlassian.net/browse/ZNTA-2360) - Review Criteria can be created without defined criteria, is unusable
* [ZNTA-2353](https://zanata.atlassian.net/browse/ZNTA-2353) - Cannot add a Yahoo/Fedora account to an existing account
* [ZNTA-2345](https://zanata.atlassian.net/browse/ZNTA-2345) - Request add version to group Send button permanently disabled
* [ZNTA-2344](https://zanata.atlassian.net/browse/ZNTA-2344) - GWT editor text size in target does not change with option
* [ZNTA-2342](https://zanata.atlassian.net/browse/ZNTA-2342) - React editor: filtering by state breaks keyboard navigation
* [ZNTA-2327](https://zanata.atlassian.net/browse/ZNTA-2327) - Yellowish glossary page.
* [ZNTA-2320](https://zanata.atlassian.net/browse/ZNTA-2320) - Frontend watch tasks failing
* [ZNTA-2317](https://zanata.atlassian.net/browse/ZNTA-2317) - [ERROR] "parseQuery() will be replaced with getOptions()" while zanata build.
* [ZNTA-2307](https://zanata.atlassian.net/browse/ZNTA-2307) - Fix translation count in alpha editor
* [ZNTA-2273](https://zanata.atlassian.net/browse/ZNTA-2273) - Zanata behind proxy may return incorrect url in REST response
* [ZNTA-2247](https://zanata.atlassian.net/browse/ZNTA-2247) - Glossary csv upload assumes column positions
* [ZNTA-2241](https://zanata.atlassian.net/browse/ZNTA-2241) - Translation Status Dropdown Button in Alpha Editor not working
* [ZNTA-2240](https://zanata.atlassian.net/browse/ZNTA-2240) - Alpha editor sidebar closes when any area is clicked
* [ZNTA-2214](https://zanata.atlassian.net/browse/ZNTA-2214) - Fix help redirects
* [ZNTA-2212](https://zanata.atlassian.net/browse/ZNTA-2212) - Consistency of headings, buttons and text in frontend
* [ZNTA-1375](https://zanata.atlassian.net/browse/ZNTA-1375) - Zanata allows invalid email address, fails to send verification email
* [ZNTA-1117](https://zanata.atlassian.net/browse/ZNTA-1117) - Zanata client help needs to be specific about command argument order
* [ZNTA-747](https://zanata.atlassian.net/browse/ZNTA-747) - RTL Support
* [ZNTA-166](https://zanata.atlassian.net/browse/ZNTA-166) - Client reports 405 error when pushing files with no basename
* [ZNTA-110](https://zanata.atlassian.net/browse/ZNTA-110) - Suggestion view should highlight matching text of results when diff view is turned off.
* [ZNTA-68](https://zanata.atlassian.net/browse/ZNTA-68) - Highlight words in text flows that match filter text.
* [ZNTA-53](https://zanata.atlassian.net/browse/ZNTA-53) - Add text flow history to activity panel.

-----------------------

## 4.3.3
##### Bug Fixes
* [ZNTA-2303](https://zanata.atlassian.net/browse/ZNTA-2303) - Single open id provider sign in shows 404 after sign in
Expand Down

0 comments on commit b3fc4d1

Please sign in to comment.