ℹ️ Use version 0.2.0 for Opencast 16 and below.
This Ansible role installs and prepares OpenSearch for Opencast.
This role supports the following,
- Supports RHEL9, Debian and Ubuntu
- Install and configure OpenSearch from
elan.opencast_repository
- Install analysis-icu OpenSearch plugin (required by Opencast 17+)
- Disables the OpenSearch security plugin completely. Use a reverse proxy to secure OpenSearch with HTTP Basic Auth and TLS.
opencast_repository_identifiers
- List of repository identifiers to temporarily activate for integration
- Will usually be provided by the elan.opencast_repository role
opencast_opensearch_heap_size
- Memory configuration (default:
1g
) - Might make sense to set this to
2g
for larger installations.
- Memory configuration (default:
opencast_opensearch_api_host
- Defaults to
127.0.0.1
.
- Defaults to
opencast_opensearch_api_port
- Defaults to
9200
.
- Defaults to
opencast_opensearch_started
- By default, the OpenSearch service will (re)start if something has changed that requires the service to be restarted. This is done via the Ansible notification handler. However, if you expect the OpenSearch service to be running when you run this role, you can force the service to start by setting the value to
true
. - Defaults to
false
(make use of Ansible Handler to reach the state)
- By default, the OpenSearch service will (re)start if something has changed that requires the service to be restarted. This is done via the Ansible notification handler. However, if you expect the OpenSearch service to be running when you run this role, you can force the service to start by setting the value to
This role depends on elan.opencast_repository
.
Example of how to configure and use the role:
- hosts: servers
become: true
roles:
- role: elan.opencast_opensearch