Instalación de Solr

Resumen

Este rol:

• Instala Solr en modo independiente en Centos 7, Ubuntu o Windows.
• Configura SSL para Solr 7.x y 8.x.
• Configura la autenticación para Solr 7.x y 8.x.
• Configura Solr.
• Versiones de Solr soportadas: 6.x - 8.x. La última probada es 8.0.0.

Para configuraciones adicionales, como modo maestro o esclavo, usa los roles:

• solr-master (lean-delivery.ansible-role-solr-master)
• solr-slave (lean-delivery.ansible-role-solr-slave)
• solr-cloud (lean-delivery.ansible-role-solr-cloud)
• para integrar SAP-Hybris y Solr con extras de Hybris (lean-delivery.ansible-role-solr-hybris-config)

Requisitos

• Versión mínima de Ansible para la instalación: 2.7.
• Java 8
• Sistemas Operativos soportados:
  • CentOS
    • 7
  • Ubuntu
  • Debian
  • Windows
    • "Windows Server 2008"
    • "Windows Server 2008 R2"
    • "Windows Server 2012"
    • "Windows Server 2012 R2"
    • "Windows Server 2016"
    • "Windows Server 2019"
    • "Windows 7"
    • "Windows 8.1"
    • "Windows 10"

Sistema Windows Preparado

Variables del Rol

• solr_version - Version disponible en https://archive.apache.org/dist/lucene/solr/. Versiones probadas 6.x-8.x

  por defecto: 8.0.0

• solr_use_java_version_8 - si es True Solr se instala en Java versión 8 y anteriores. Si se usa versiones posteriores - establecer en False.

  por defecto: True

• solr_url - URL raíz para descargar Solr.

  por defecto: http://archive.apache.org/dist/lucene/solr

• solr_distr_url - URL al archivo zip.

  por defecto: {{ solr_url }}/{{ solr_version }}/solr-{{ solr_version }}.zip

• solr_host - nombre del servidor Solr.

  por defecto: {{ ansible_fqdn }}

• solr_dest_main_path - directorio raíz para almacenar la carpeta de Solr.

  por defecto: /opt para Linux.

  por defecto: C:\Solr para Windows.

• solr_dest_path - ruta de la carpeta Solr.

  por defecto: {{ solr_dest_main_path }}/solr-{{ solr_version }}

• solr_change_default_password - para cambiar la contraseña predeterminada del usuario de Solr (será solr_auth_pass).

  por defecto: True

• solr_auth_configure - Habilitar autenticación.

  por defecto: True

• solr_auth_type - tipo de autenticación.

  por defecto: basic

• solr_auth_user - usuario predeterminado de Solr.

  por defecto: solrserver

• solr_auth_pass - contraseña del usuario predeterminado de Solr.

  por defecto: server123

• solr_default_auth_user - usuario predeterminado de Solr.

  por defecto: solr

• solr_default_auth_pass - contraseña del usuario predeterminado de Solr.

  por defecto: SolrRocks

• solr_authentication_opts - opciones de autenticación de Solr.

  por defecto: -Dbasicauth={{ solr_auth_user }}:{{ solr_auth_pass }}

• solr_insh_default - carpeta in.sh de Solr.

  por defecto: /etc/default/solr.in.sh

• solr_java_xms - tamaño del montón.

  por defecto: 512m

• solr_java_xmx - tamaño del montón.

  por defecto: 512m

• solr_master_enable_jmx - habilitar jmx en Solr.

  por defecto: false

• solr_additional_opts - opciones adicionales de Solr.

  por defecto: -Xss256k

• solr_user - usuario del sistema operativo para ejecutar el servicio Solr.

  por defecto: solr

• solr_group - grupo del sistema operativo para el usuario.

  por defecto: solr

• solr_port - puerto para iniciar Solr.

  por defecto: 8983

• solr_service_name - nombre del servicio Solr.

  por defecto: solr

• solr_base_path - ruta a la base de Solr.

  por defecto: /var/solr

• solr_home - ruta a SOLR_HOME.

  por defecto: {{ solr_base_path }}/data

• solr_with_systemd - para ejecutar Solr como un servicio.

  por defecto: True

• solr_logs_dir - ruta para almacenar registros.

  por defecto: {{ solr_base_path }}/logs

• solr_wait_for_zk - tiempo de espera para reconectarse a Zookeeper (en segundos).

  por defecto: 30

• solr_client_timeout - tiempo de espera del cliente de ZooKeeper (para modo SolrCloud).

  por defecto: 15000

• solr_timezone - zona horaria para el servidor Solr.

  por defecto: UTC

• solr_service_restart - opción para reiniciar el servicio Solr.

  por defecto: always

• solr_service_start - para iniciar el servicio Solr al final del rol/Playbook.

  por defecto: True

• solr_service_autostart - Agregar el servicio Solr para que se inicie automáticamente.

  por defecto: True

• solr_copy_default_configsets - copiar conjuntos de configuración OOTB a {{ solr_home }}/configsets

  por defecto: False

https://lucene.apache.org/solr/guide/7_1/enabling-ssl.html

• solr_local_keystore - si es True - buscar keystore en el host de Ansible en {{ solr_local_keystore_path }}. Si es False - verificar el keystore en el host remoto.

  por defecto: True

• solr_local_keystore_path - ruta al archivo keystore local (para no crear un certificado autofirmado).

  por defecto: {{ role_path }}/files/{{ solr_ssl_key_store_name }}

• solr_ssl_configure - configurar SSL.

  por defecto: True

• solr_ssl_key_size - tamaño de clave del certificado.

  por defecto: 4096

• solr_ssl_key_store_path - directorio para almacenar keystore.

  por defecto: {{ solr_dest_path }}/server/solr

• solr_ssl_key_store_name - nombre del keystore. Si existe un archivo con este nombre en la carpeta del rol/archivos, se utilizará como keystore.

  por defecto: solr-ssl.keystore.jks

• solr_ssl_key_store - ruta al keystore de Solr.

  por defecto: {{ solr_ssl_key_store_path }}/{{ solr_ssl_key_store_name }}

• solr_ssl_key_store_password - contraseña del keystore.

  por defecto: 123456

• solr_ssl_trust_store - ruta al keystore de confianza.

  por defecto: {{ solr_ssl_key_store_path }}/{{ solr_ssl_key_store_name }}

• solr_ssl_trust_store_password - contraseña del keystore de confianza.

  por defecto: 123456

• solr_ssl_need_client_auth - Configuración de autenticación del cliente.

  por defecto: false

• solr_ssl_want_client_auth - Configuración de autenticación del cliente.

  por defecto: false

• solr_ssl_key_store_type - tipo de keystore.

  por defecto: JKS

• solr_ssl_trust_store_type - tipo de keystore de confianza.

  por defecto: JKS

• solr_ssl_check_peer_name - Establecer esto en false puede ser útil para deshabilitar estas verificaciones al reutilizar un certificado en muchos hosts.

  por defecto: true

• solr_ssl_certificate_provider - solo para sistemas operativos Linux. https://docs.ansible.com/ansible/latest/openssl_certificate_module.html

  por defecto: selfsigned

• solr_ca_domain - nombre de dominio del certificado.

  por defecto: example.com

• local_cert_file_path - ruta al certificado privado.

  por defecto: /etc/pki/tls/private para sistemas basados en RHEL.

  por defecto: /etc/ssl/private para sistemas basados en Debian.

• solr_local_pkey_file_name - nombre del certificado privado.

  por defecto: {{ ansible_hostname }}.ca-pkey.pem

• local_cert_file_path - ruta al certificado público.

  por defecto: /etc/pki/tls/certs para sistemas basados en RHEL.

  por defecto: /etc/ssl/certs para sistemas basados en Debian.

• solr_local_cert_file_name - nombre del certificado público.

  por defecto: {{ ansible_hostname }}.ca-cert.pem

• solr_set_limits - establecer límites.

  por defecto: True

• solr_open_files_limit - valor límite de archivos abiertos en Linux.

  por defecto: 65000

• solr_max_processes_limit - valor límite de procesos máximos en Linux.

  por defecto: 65000

Variables para Windows

• solr_win_temp_dir - directorio temporal.

  por defecto: C:\Windows\Temp

• solr_win_ssl_subj - Sujeto CSR.

  por defecto: /C=BY/ST=Minsk/L=Minsk/O=O/OU=IT/CN={{ solr_ca_domain }}

Ejemplo de Inventario

[solr]
solr.example.com

[solrwin]
solrwin.example.com

[solrwin:vars]
ansible_user=admin
ansible_password=password
ansible_connection=winrm
ansible_winrm_server_cert_validation=ignore

Ejemplo de Playbook

- name: Instalar y Configurar Solr
  hosts: solr
  vars:
    solr_change_default_password: False
  roles:
    - role: lean_delivery.java
    - role: lean_delivery.solr_standalone

Licencia

Apache

Información del Autor

autores:

• Lean Delivery Team team@lean-delivery.com