Configuração do mecanismo de pesquisa
Esta seção discute as configurações mínimas que você deve escolher para testar o Elasticsearch ou o OpenSearch com implantações locais do Adobe Commerce.
Quando o suporte para o Elasticsearch 8.x foi introduzido na versão 2.4.6, novos rótulos foram criados para distinguir entre configurações Elasticsearch e OpenSearch.
Para obter detalhes adicionais sobre a configuração do mecanismo de pesquisa, consulte o Guia do Usuário.
Configurar o mecanismo de pesquisa no Admin
Para configurar seu sistema para usar o Elasticsearch ou o OpenSearch:
-
Faça logon no Admin como administrador.
-
Clique em Stores > Settings > Configuration > Catalog > Catalog > Catalog Search.
-
Na lista Search Engine, selecione a versão correspondente do mecanismo de pesquisa.
A tabela a seguir lista as opções necessárias para configurar e testar a conexão com o Commerce. A menos que você tenha alterado as configurações do servidor do mecanismo de pesquisa, os padrões deverão funcionar. Vá para a próxima etapa.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 Opção Descrição Server Hostname Insira o nome de host ou endereço IP totalmente qualificado da máquina que executa o Elasticsearch ou o OpenSearch.
Adobe Commerce na infraestrutura em nuvem: obtenha esse valor do seu sistema de integração.Server Port Insira a porta do proxy do servidor Web. O padrão é 9200
Adobe Commerce na infraestrutura em nuvem: obtenha esse valor do seu sistema de integração.Index Prefix Insira o prefixo de índice do mecanismo de pesquisa. Se você usar uma única instância para mais de uma instalação do Commerce (ambientes de Preparo e Produção), deverá especificar um prefixo exclusivo para cada instalação. Caso contrário, você poderá usar o prefixo padrão magento2. Enable HTTP Auth Clique em Yes somente se você tiver habilitado a autenticação para o servidor do mecanismo de pesquisa. Em caso afirmativo, forneça um nome de usuário e senha nos campos fornecidos. Server Timeout Insira o tempo (em segundos) de espera ao tentar estabelecer uma conexão com o servidor Elasticsearch ou OpenSearch. -
Clique em Test Connection.
Exemplo de resposta:
Continuar com:
- Configurar o Apache para seu mecanismo de pesquisa
- Configurar o nginx para seu mecanismo de pesquisa
ou você verá:
Em caso afirmativo, tente o seguinte:
-
Verifique se o servidor do mecanismo de pesquisa está em execução.
-
Se o servidor estiver em um host diferente do Commerce, faça logon no servidor do Commerce e execute ping no host do mecanismo de pesquisa. Resolva os problemas de conectividade de rede e teste a conexão novamente.
-
Examine a janela de comando na qual você iniciou o Elasticsearch ou o OpenSearch para rastreamentos e exceções de pilha. Você deve resolvê-los antes de continuar. Especificamente, certifique-se de ter iniciado seu mecanismo de pesquisa como um usuário com privilégios
root. -
Verifique se o firewall UNIX e o SELinux estão desabilitados ou configure regras para permitir que o mecanismo de pesquisa e o Commerce se comuniquem entre si.
-
Verifique o valor do campo Server Hostname. Verifique se o servidor está disponível. Em vez disso, você pode tentar o endereço IP do servidor.
-
Use o comando
netstat -an | grep <listen-port>para verificar se a porta especificada no campo Server Port não está sendo usada por outro processo.Por exemplo, para ver se o mecanismo de pesquisa está em execução na porta padrão, use o seguinte comando:
code language-bash netstat -an | grep 9200Se estiver sendo executado na porta 9200, será exibido de modo semelhante ao seguinte:
code language-none `tcp 0 0 :::9200 :::- LISTEN`
Reindexe a pesquisa de catálogo e atualize o cache de página inteira
Depois de alterar a configuração do mecanismo de pesquisa, você deve reindexar o índice de pesquisa do catálogo e atualizar o cache da página inteira usando a linha de comando Admin ou.
Para atualizar o cache usando o Administrador:
-
No Admin, clique em System > Cache Management.
-
Marque a caixa de seleção ao lado de Page Cache.
-
Na lista Actions, no canto superior direito, clique em Atualizar.
Para limpar o cache usando a linha de comando: bin/magento cache:clean
Para reindexar usando a linha de comando:
-
Faça logon no servidor Commerce como ou alterne para o proprietário do sistema de arquivos.
-
Digite qualquer um dos comandos a seguir:
Informe o seguinte comando para reindexar somente o índice de pesquisa do catálogo:
code language-bash bin/magento indexer:reindex catalogsearch_fulltextDigite o seguinte comando para reindexar todos os indexadores:
code language-bash bin/magento indexer:reindex -
Aguarde até que a reindexação seja concluída.
note info INFO Diferentemente do cache, os indexadores são atualizados por um trabalho cron. Verifique se o cron está habilitado antes de começar a usar o mecanismo de pesquisa.