How to connect to and use search engine through Search Shell - Lindorm

Search Shell est un outil de gestion de base de données en ligne de commande destiné à Lindorm. Installez-le sur votre machine locale ou sur une instance Elastic Compute Service (ECS) afin de vous connecter à LindormSearch et de gérer les collections, les index ainsi que les jeux de configuration depuis la ligne de commande.

Remarque

Search Shell ne permet pas de se connecter aux instances Lindorm mono-nœud. Si votre instance est mono-nœud, utilisez SQL pour vous connecter à LindormSearch et l'utiliser à la place.

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

Java Development Kit (JDK) version 1.8 ou ultérieure. Pour vérifier votre version, exécutez :
```
java -version
```
LindormSearch activé
L'adresse IP de votre client ajoutée à la liste d'autorisation Lindorm

Installer et configurer Search Shell

Utilisez les identifiants d'un utilisateur non root sur l'instance ECS pour effectuer ces étapes.

Connectez-vous à l'instance ECS et téléchargez le package Search Shell :

wget https://hbaseuepublic.oss-cn-beijing.aliyuncs.com/lindorm-search-cli.tar.gz

Extrayez le package :
```
tar -xzvf lindorm-search-cli.tar.gz
```
Ouvrez le fichier bin/search.in.sh et définissez ZK_HOST avec l'endpoint LindormSearch pour Solr. Vous trouverez cet endpoint dans la section Solr Compatibility Address de la console Lindorm. Pour plus d'informations, consultez la rubrique Afficher les endpoints.
```
ZK_HOST="host:port"
```

Exécuter des commandes

Toutes les commandes Search Shell s'exécutent depuis le répertoire lindorm-search-cli/bin. Accédez-y d'abord :

cd lindorm-search-cli/bin

Pour afficher toutes les commandes disponibles, exécutez :

./search-cli

Gérer les collections

Créer une collection

./search-cli create_collection -c <collection-name> -n <configset-name> -shards <shard-count>

Paramètre	Obligatoire	Description	Exemple
`-c`	Oui	Nom de la collection à créer	`testIndex`
`-n`	Oui	Nom du jeu de configuration à utiliser	`_indexer_default`
`-shards`	Oui	Nombre de shards dans lesquels diviser la collection	`2`

Exemple : Créez une collection nommée testIndex en utilisant le jeu de configuration par défaut avec 2 shards :

./search-cli create_collection -c testIndex -n _indexer_default -shards 2

Lister les collections

./search-cli list_collections

Gérer les jeux de configuration

Search Shell prend en charge les sous-commandes ZooKeeper (zk) suivantes pour la gestion des jeux de configuration :

./search-cli zk downconfig -d <local-dir> -n <configset-name>
./search-cli zk upconfig  -d <local-dir> -n <configset-name>
./search-cli zk ls <zk-path>

Télécharger un jeu de configuration

Téléchargez un jeu de configuration depuis ZooKeeper vers un répertoire local :

./search-cli zk downconfig -d . -n _indexer_default

Cette opération télécharge le jeu de configuration par défaut _indexer_default dans un sous-dossier conf du répertoire courant. Utilisez les fichiers contenus dans conf comme point de départ pour vos jeux de configuration personnalisés.

Téléverser un jeu de configuration

Après avoir modifié vos fichiers de configuration, téléversez-les à nouveau vers ZooKeeper :

./search-cli zk upconfig -d conf -n myConf

Remplacez myConf par le nom de votre jeu de configuration personnalisé.

Lister les jeux de configuration

./search-cli zk ls /configs

Créer un index avec un jeu de configuration personnalisé

Une fois le jeu de configuration personnalisé téléversé, créez une collection qui l'utilise :

./search-cli create_collection -c myIndex -n myConf -shards 2

Lindorm:Use Search Shell to connect to and use LindormSearch