Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: rebranded Caringo to DataCore / Swarm

Elasticsearch 2.3.3 includes advances in speed, security, scalability, and hardware efficiency and supports compatibility with Linux standards and newer tool releases. Elasticsearch 2.3.3 is a fundamental leap from 1.7.1, so much so that upgrading is actually a migration.

...

Migration CheckElasticsearch 2.x has many breaking changes. In particular, if a custom metadata field name includes a period/dot (x-sample-meta-bad.field.name), your existing data cannot be upgraded. Elasticsearch recommends that you run its migration plugin to check for problems:
  1. Install the migration checker: https://github.com/elastic/elasticsearch-migration/tree/1.x
  2. Browse to http://{Elasticsearch-domain-endpoint}/_plugin/migration/
  3. Select Run checks now.
  4. If problems are found, work with Caringo DataCore Support to fix your data.
Swarm Requirements
  1. If your cluster is not running Elasticsearch 1.7.1 on Swarm 7.5 or later, upgrade to Swarm 8.2.2 before proceeding with this upgrade.
  2. Complete the upgrade of Swarm to 9.0. Swarm 9.0 can work with Elasticsearch 1.7.1 and your existing indices/feeds, but new features in Swarm 9.0 will unavailable until you complete the Elasticsearch upgrade. Upgrading to Swarm 9.0 can be done as a rolling upgrade, without cluster downtime.

    Info
    titleNote

    Because of requirements for Elasticsearch 2.3.3, the legacy metering feature in Gateway (CSMeter) is incompatible with Swarm 9.0 and higher.


  3. Case-sensitivity - If you enable case-insensitive searching in SCSP (search.caseInsensitive = 1) , Content Gateway still lets S3 perform the case-sensitive operations it needs. However, if you are upgrading your ES 1.7.1 data, be sure to keep the data consistent by disabling search.caseInsensitive.

  4. Do not upgrade CloudScaler until this migration is complete. The new Content Gateway requires Elasticsearch 2.3.3.
New ES Cluster
  • Provision a new set of ES servers (machines or VMs) on which to install Elasticsearch 2.3.3.
  • Ensure that every Elasticsearch node meets the hardware, network, and software requirements, including Java 8.

See Hardware Requirements for Elasticsearch.

See Preparing the Search Cluster.

...