Solrインストール

概要

この役割は以下を行います：

• CentOS 7、Ubuntu、またはWindowsホストにSolrスタンドアロンをインストールします。
• Solr 7.xと8.xのSSLを設定します。
• Solr 7.xと8.xの認証を設定します。
• Solrを設定します。
• サポートされているSolrバージョン：6.x - 8.x。最新のテストバージョンは8.0.0です。

マスタまたはスレーブモードなどの追加設定が必要な場合は、以下の役割を使用してください：

• solr-master (lean-delivery.ansible-role-solr-master)
• solr-slave (lean-delivery.ansible-role-solr-slave)
• solr-cloud (lean-delivery.ansible-role-solr-cloud)
• SAP-HybrisとSolrをHybris Extrasと統合するための役割 (lean-delivery.ansible-role-solr-hybris-config)

要件

• インストールに必要なAnsibleの最小バージョン：2.7
• Java 8
• サポートされているOS：
  • 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"

準備されたWindowsシステム

役割変数

• solr_version - https://archive.apache.org/dist/lucene/solr/ にある利用可能なバージョンと一致します。テスト済みのバージョンは6.x-8.xです。

  デフォルト: 8.0.0

• solr_use_java_version_8 - Trueの場合、Javaバージョン8およびそれ以前でSolrがインストールされます。それ以降のバージョンを使用する場合は、Falseに設定します。

  デフォルト: True

• solr_url - SolrをダウンロードするためのルートURL

  デフォルト: http://archive.apache.org/dist/lucene/solr

• solr_distr_url - zipファイルのURL

  デフォルト: {{ solr_url }}/{{ solr_version }}/solr-{{ solr_version }}.zip

• solr_host - Solrサーバーの名前

  デフォルト: {{ ansible_fqdn }}

• solr_dest_main_path - Solrフォルダーを保存するためのルートディレクトリ

  Linux OSの場合のデフォルト: /opt

  Windows OSの場合のデフォルト: C:\Solr

• solr_dest_path - Solrフォルダーのパス

  デフォルト: {{ solr_dest_main_path }}/solr-{{ solr_version }}

• solr_change_default_password - Solrユーザーのデフォルトパスワードを変更します（solr_auth_passになります）。

  デフォルト: True

• solr_auth_configure - 認証を有効にします。

  デフォルト: True

• solr_auth_type - 認証タイプ

  デフォルト: basic

• solr_auth_user - デフォルトのSolrユーザー

  デフォルト: solrserver

• solr_auth_pass - デフォルトのSolrユーザーパスワード

  デフォルト: server123

• solr_default_auth_user - デフォルトのSolrユーザー

  デフォルト: solr

• solr_default_auth_pass - デフォルトのSolrユーザーパスワード

  デフォルト: SolrRocks

• solr_authentication_opts - Solrの認証オプション

  デフォルト: -Dbasicauth={{ solr_auth_user }}:{{ solr_auth_pass }}

• solr_insh_default - Solrのin.shフォルダー

  デフォルト: /etc/default/solr.in.sh

• solr_java_xms - ヒープサイズ

  デフォルト: 512m

• solr_java_xmx - ヒープサイズ

  デフォルト: 512m

• solr_master_enable_jmx - SolrでJMXを有効にします。

  デフォルト: false

• solr_additional_opts - Solrのオプション

  デフォルト: -Xss256k

• solr_user - Solrサービスを実行するOSユーザー

  デフォルト: solr

• solr_group - ユーザーのOSグループ

  デフォルト: solr

• solr_port - Solr起動用ポート

  デフォルト: 8983

• solr_service_name - Solrサービス名

  デフォルト: solr

• solr_base_path - Solrベースへのパス

  デフォルト: /var/solr

• solr_home - SOLR_HOMEへのパス

  デフォルト: {{ solr_base_path }}/data

• solr_with_systemd - Solrをサービスとして実行する場合

  デフォルト: True

• solr_logs_dir - ログを保存するパス

  デフォルト: {{ solr_base_path }}/logs

• solr_wait_for_zk - ZooKeeperに再接続するタイムアウト（秒単位）

  デフォルト: 30

• solr_client_timeout - ZooKeeperクライアントタイムアウト（SolrCloudモード用）

  デフォルト: 15000

• solr_timezone - Solrサーバーのタイムゾーン

  デフォルト: UTC

• solr_service_restart - Solrサービス再起動オプション

  デフォルト: always

• solr_service_start - 役割/Playbookの最後にSolrサービスを開始します。

  デフォルト: True

• solr_service_autostart - Solrサービスを自動的に開始するように追加します。

  デフォルト: True

• solr_copy_default_configsets - OOTB configsetsを{{ solr_home }}/configsetsフォルダーにコピーします。

  デフォルト: False

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

• solr_local_keystore - Trueの場合、{{ solr_local_keystore_path }}にAnsibleホスト上でキーストアを検索します。Falseの場合、リモートホスト上のキーストアを確認します。

  デフォルト: True

• solr_local_keystore_path - ローカルキーストアファイルへのパス（自己署名を作成しないように）

  デフォルト: {{ role_path }}/files/{{ solr_ssl_key_store_name }}

• solr_ssl_configure - SSLを設定します。

  デフォルト: True

• solr_ssl_key_size - 証明書のキーハッシュサイズ

  デフォルト: 4096

• solr_ssl_key_store_path - キーストアを保存するディレクトリ

  デフォルト: {{ solr_dest_path }}/server/solr

• solr_ssl_key_store_name - キーストア名。この名前のファイルが役割フォルダー/filesに存在する場合、それがキーストアとして使用されます。

  デフォルト: solr-ssl.keystore.jks

• solr_ssl_key_store - Solrキーストアへのパス。

  デフォルト: {{ solr_ssl_key_store_path }}/{{ solr_ssl_key_store_name }}

• solr_ssl_key_store_password - キーストアパスワード

  デフォルト: 123456

• solr_ssl_trust_store - トラストキーストアへのパス

  デフォルト: {{ solr_ssl_key_store_path }}/{{ solr_ssl_key_store_name }}

• solr_ssl_trust_store_password - 信頼されたキーストアのパスワード

  デフォルト: 123456

• solr_ssl_need_client_auth - クライアント認証設定

  デフォルト: false

• solr_ssl_want_client_auth - クライアント認証設定

  デフォルト: false

• solr_ssl_key_store_type - キーストアのタイプ

  デフォルト: JKS

• solr_ssl_trust_store_type - 信頼されたキーストアのタイプ

  デフォルト: JKS

• solr_ssl_check_peer_name - これをfalseに設定すると、複数のホストで証明書を再利用する際のチェックを無効にできます。

  デフォルト: true

• solr_ssl_certificate_provider - Linux OS専用。https://docs.ansible.com/ansible/latest/openssl_certificate_module.html

  デフォルト: selfsigned

• solr_ca_domain - 証明書のドメイン名

  デフォルト: example.com

• local_cert_file_path - プライベート証明書のパス

  RHELベースの場合のデフォルト: /etc/pki/tls/private

  Debianベースの場合のデフォルト: /etc/ssl/private

• solr_local_pkey_file_name - プライベート証明書名

  デフォルト: {{ ansible_hostname }}.ca-pkey.pem

• local_cert_file_path - 公開証明書のパス

  RHELベースの場合のデフォルト: /etc/pki/tls/certs

  Debianベースの場合のデフォルト: /etc/ssl/certs

• solr_local_cert_file_name - 公開証明書名

  デフォルト: {{ ansible_hostname }}.ca-cert.pem

• solr_set_limits - 制限を設定します。

  デフォルト: True

• solr_open_files_limit - Linuxのオープンファイル制限値

  デフォルト: 65000

• solr_max_processes_limit - Linuxの最大プロセス制限値

  デフォルト: 65000

Windows変数

• solr_win_temp_dir - 一時ディレクトリ

  デフォルト: C:\Windows\Temp

• solr_win_ssl_subj - CSRの件名

  デフォルト: /C=BY/ST=Minsk/L=Minsk/O=O/OU=IT/CN={{ solr_ca_domain }}

インベントリの例

[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

Playbookの例

- name: Solrをインストールして設定する
  hosts: solr
  vars:
    solr_change_default_password: False
  roles:
    - role: lean_delivery.java
    - role: lean_delivery.solr_standalone

ライセンス

Apache

著者情報

著者：

• Lean Deliveryチーム team@lean-delivery.com