DOC: 51d: Updated git URL and instructions for getting Hash Trie data files.

Use branch, not tag for download URL, and recommend switching to Hash Trie.
This commit is contained in:
Ben51Degrees 2017-10-05 19:54:18 +01:00 committed by Willy Tarreau
parent 16586e635b
commit 636e6afcfa

View File

@ -23,18 +23,20 @@ official git repository :
updates and supports a new Hash Trie algorithm, but which is not updates and supports a new Hash Trie algorithm, but which is not
compatible with older Trie databases : compatible with older Trie databases :
git clone https://github.com/51Degrees/Device-Detection.git -b 3.2.12.12 git clone https://github.com/51Degrees/Device-Detection.git -b v3.2.12
then run 'make' with USE_51DEGREES and 51DEGREES_SRC set. Both 51DEGREES_INC then run 'make' with USE_51DEGREES and 51DEGREES_SRC set. Both 51DEGREES_INC
and 51DEGREES_LIB may additionally be used to force specific different paths and 51DEGREES_LIB may additionally be used to force specific different paths
for .o and .h, but will default to 51DEGREES_SRC. Make sure to replace for .o and .h, but will default to 51DEGREES_SRC. Make sure to replace
'51D_REPO_PATH' with the path to the 51Degrees repository. '51D_REPO_PATH' with the path to the 51Degrees repository.
51Degrees provide 2 different detection algorithms: 51Degrees provide 3 different detection algorithms:
1. Pattern - balances main memory usage and CPU. 1. Pattern - balances main memory usage and CPU.
2. Trie - a very high performance detection solution which uses more main 2. Trie - a very high performance detection solution which uses more main
memory than Pattern. memory than Pattern.
3. Hash Trie - replaces Trie, 3x faster, 80% lower memory consumption and
tuning options.
To make with 51Degrees Pattern algorithm use the following command line. To make with 51Degrees Pattern algorithm use the following command line.
@ -48,7 +50,9 @@ A data file containing information about devices, browsers, operating systems
and their associated signatures is then needed. 51Degrees provide a free and their associated signatures is then needed. 51Degrees provide a free
database with Github repo for this purpose. These free data files are located database with Github repo for this purpose. These free data files are located
in '51D_REPO_PATH'/data with the extensions .dat for Pattern data and .trie for in '51D_REPO_PATH'/data with the extensions .dat for Pattern data and .trie for
Trie data. Trie data. Free Hash Trie data file can be obtained by signing up for a licence
key at https://51degrees.com/products/store/on-premise-device-detection.
The configuration file needs to set the following parameters: The configuration file needs to set the following parameters: