thevar1able/ClickHouse
1
0
Fork 0
mirror of https://github.com/ClickHouse/ClickHouse.git synced 2024-11-26 01:22:04 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #249 from hatarist/reference_improvements

Browse Source 
Reference improvements
This commit is contained in:
alexey-milovidov 2016-12-13 23:07:32 +04:00 committed by GitHub
commit aa6de1bf0b
3 changed files with 42 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
doc/build.md
View File

@ -81,8 +81,8 @@ git clone -b stable git@github.com:yandex/ClickHouse.git
cd ClickHouse cd ClickHouse
``` ```
For development, switch to `master` branch. For development, switch to the `master` branch.
For latest release candidate, switch to `testing` branch. For latest release candidate, switch to the `testing` branch.
# Build ClickHouse # Build ClickHouse
@ -96,7 +96,7 @@ sudo apt-get install devscripts dupload fakeroot debhelper
### Install recent version of clang. ### Install recent version of clang.
Clang is embedded into ClickHouse package and used at runtime. Minimal version is 3.8.0. It is optional. Clang is embedded into ClickHouse package and used at runtime. Minimum version is 3.8.0. It is optional.
There are two variants: There are two variants:
#### 1. Build clang from sources. #### 1. Build clang from sources.

11
doc/build_osx.md
View File

@ -35,15 +35,18 @@ brew install readline
# Checkout ClickHouse sources # Checkout ClickHouse sources
To get the latest stable version:
``` ```
git clone git@github.com:yandex/ClickHouse.git git clone -b stable git@github.com:yandex/ClickHouse.git
# or: git clone https://github.com/yandex/ClickHouse.git # or: git clone -b stable https://github.com/yandex/ClickHouse.git
cd ClickHouse cd ClickHouse
``` ```
Note that master branch is not stable. For development, switch to the `master` branch.
For stable version, switch to some release branch. For the latest release candidate, switch to the `testing` branch.
## Use GCC 6 for builds ## Use GCC 6 for builds

32
doc/developers/tests.md Normal file
View File

@ -0,0 +1,32 @@
# How to run tests
The **clickhouse-test** utility that is used for functional testing is written using Python 2.x.
It also requires you to have some third-party packages:
```
$ pip install lxml termcolor
```
## In a nutshell:
- Put the `clickhouse` program to `/usr/bin` (or `PATH`)
- Create a `clickhouse-client` symlink in `/usr/bin` pointing to `clickhouse`
- Start the `clickhouse` server
- `cd dbms/tests/`
- Run `./clickhouse-test`
## Example usage
Run `./clickhouse-test --help` to see available options.
To run tests without having to create a symlink or mess with `PATH`:
```
./clickhouse-test -c "../../build/dbms/src/Server/clickhouse --client"
```
To run a single test, i.e. `00395_nullable`:
```
./clickhouse-test 00395
```