Merge pull request #136 from opendistro/1.2.1

Preparing for 1.2.1

Author: alolita

README.md

@@ -49,6 +49,25 @@ This repository contains the documentation for Open Distro for Elasticsearch, a
 1. Push your changes, and submit a pull request.
 
 
+## New releases
+
+1. Branch.
+1. Run a find and replace for `:x.y.z` and `-x.y.z` and replace with the new version string.
+1. Run a find for the underlying Elasticsearch version and update it as necessary (probably just `docs/install/deb.md`).
+1. Start up a new cluster using the updated Docker Compose file in `docs/install/docker.md`.
+1. Update the version table in `version-history.md`.
+
+   Use `curl -XGET https://localhost:9200 -u admin:admin -k` to verify the Elasticsearch version.
+
+1. Update the plugin compatibility table in `docs/install/plugin.md`.
+
+   Use `curl -XGET https://localhost:9200/_cat/plugins -u admin:admin -k` to get the correct version strings.
+
+1. Verify that the individual plugin download links in `docs/install/plugins.md` and `docs/kibana/plugins.md` work.
+1. Run a build and look for any warnings or errors you introduced.
+1. Submit a PR.
+
+
 ## Content guidelines
 
 1. Try to stay consistent with existing content.

docs/elasticsearch/snapshot-restore.md

@@ -101,7 +101,7 @@ readonly | Whether the repository is read-only. Useful when migrating from one c
    If you're using the Docker installation, see [Run with custom plugins](../../install/docker/#run-with-custom-plugins). Your `Dockerfile` should look something like this:
 
    ```
-   FROM amazon/opendistro-for-elasticsearch:1.2.0
+   FROM amazon/opendistro-for-elasticsearch:1.2.1
 
    ENV AWS_ACCESS_KEY_ID <access-key>
    ENV AWS_SECRET_ACCESS_KEY <secret-key>

docs/install/deb.md

@@ -37,8 +37,8 @@ These steps assume you're using Ubuntu 18.04.
 1. Install Elasticsearch OSS:
 
    ```bash
-   wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-oss-7.2.0-amd64.deb
-   sudo dpkg -i elasticsearch-oss-7.2.0-amd64.deb
+   wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-oss-7.2.1-amd64.deb
+   sudo dpkg -i elasticsearch-oss-7.2.1-amd64.deb
    ```
 
 1. Install the latest version of Open Distro for Elasticsearch:

docs/install/docker-security.md

@@ -16,7 +16,7 @@ Before deploying to a production environment, you should replace the demo securi
 version: '3'
 services:
   odfe-node1:
-    image: amazon/opendistro-for-elasticsearch:1.2.0
+    image: amazon/opendistro-for-elasticsearch:1.2.1
     container_name: odfe-node1
     environment:
       - cluster.name=odfe-cluster
@@ -52,7 +52,7 @@ services:
     networks:
       - odfe-net
   odfe-node2:
-    image: amazon/opendistro-for-elasticsearch:1.2.0
+    image: amazon/opendistro-for-elasticsearch:1.2.1
     container_name: odfe-node2
     environment:
       - cluster.name=odfe-cluster
@@ -85,7 +85,7 @@ services:
     networks:
       - odfe-net
   kibana:
-    image: amazon/opendistro-for-elasticsearch-kibana:1.2.0
+    image: amazon/opendistro-for-elasticsearch-kibana:1.2.1
     container_name: odfe-kibana
     ports:
       - 5601:5601

docs/install/docker.md

@@ -10,8 +10,8 @@ nav_order: 1
 You can pull the Open Distro for Elasticsearch Docker image just like any other image:
 
 ```bash
-docker pull amazon/opendistro-for-elasticsearch:1.2.0
-docker pull amazon/opendistro-for-elasticsearch-kibana:1.2.0
+docker pull amazon/opendistro-for-elasticsearch:1.2.1
+docker pull amazon/opendistro-for-elasticsearch-kibana:1.2.1
 ```
 
 To check available versions, see [Docker Hub](https://hub.docker.com/r/amazon/opendistro-for-elasticsearch/tags).
@@ -33,7 +33,7 @@ Open Distro for Elasticsearch images use `centos:7` as the base image. If you ru
 To run the image for local development:
 
 ```bash
-docker run -p 9200:9200 -p 9600:9600 -e "discovery.type=single-node" amazon/opendistro-for-elasticsearch:1.2.0
+docker run -p 9200:9200 -p 9600:9600 -e "discovery.type=single-node" amazon/opendistro-for-elasticsearch:1.2.1
 ```
 
 Then send requests to the server to verify that Elasticsearch is up and running:
@@ -86,7 +86,7 @@ This sample file starts two data nodes and Kibana.
 version: '3'
 services:
   odfe-node1:
-    image: amazon/opendistro-for-elasticsearch:1.2.0
+    image: amazon/opendistro-for-elasticsearch:1.2.1
     container_name: odfe-node1
     environment:
       - cluster.name=odfe-cluster
@@ -110,7 +110,7 @@ services:
     networks:
       - odfe-net
   odfe-node2:
-    image: amazon/opendistro-for-elasticsearch:1.2.0
+    image: amazon/opendistro-for-elasticsearch:1.2.1
     container_name: odfe-node2
     environment:
       - cluster.name=odfe-cluster
@@ -131,7 +131,7 @@ services:
     networks:
       - odfe-net
   kibana:
-    image: amazon/opendistro-for-elasticsearch-kibana:1.2.0
+    image: amazon/opendistro-for-elasticsearch-kibana:1.2.1
     container_name: odfe-kibana
     ports:
       - 5601:5601
@@ -164,7 +164,7 @@ docker run \
 -p 9200:9200 -p 9600:9600 \
 -e "discovery.type=single-node" \
 -v /<full-path-to>/custom-elasticsearch.yml:/usr/share/elasticsearch/config/elasticsearch.yml \
-amazon/opendistro-for-elasticsearch:1.2.0
+amazon/opendistro-for-elasticsearch:1.2.1
 ```
 
 You can perform the same operation in `docker-compose.yml` using a relative path:
@@ -220,7 +220,7 @@ The `docker-compose.yml` file above also contains several key settings: `bootstr
 To run the image with a custom plugin, first create a [`Dockerfile`](https://docs.docker.com/engine/reference/builder/):
 
 ```
-FROM amazon/opendistro-for-elasticsearch:1.2.0
+FROM amazon/opendistro-for-elasticsearch:1.2.1
 RUN /usr/share/elasticsearch/bin/elasticsearch-plugin install --batch <plugin-name-or-url>
 ```
 
@@ -234,7 +234,7 @@ docker run -p 9200:9200 -p 9600:9600 -v /usr/share/elasticsearch/data odfe-custo
 You can also use a `Dockerfile` to pass your own certificates for use with the [Security](../../security-configuration/) plugin, similar to the `-v` argument in [Configure Elasticsearch](#configure-elasticsearch):
 
 ```
-FROM amazon/opendistro-for-elasticsearch:1.2.0
+FROM amazon/opendistro-for-elasticsearch:1.2.1
 COPY --chown=elasticsearch:elasticsearch elasticsearch.yml /usr/share/elasticsearch/config/
 COPY --chown=elasticsearch:elasticsearch my-key-file.pem /usr/share/elasticsearch/config/
 COPY --chown=elasticsearch:elasticsearch my-certificate-chain.pem /usr/share/elasticsearch/config/

docs/install/plugins.md

@@ -29,6 +29,16 @@ If you don't want to use the all-in-one Open Distro for Elasticsearch installati
     </tr>
   </thead>
   <tbody>
+  <tr>
+    <td>7.2.1</td>
+    <td>
+      <pre>opendistro-job-scheduler        1.2.1
+opendistro_alerting             1.2.1.0
+opendistro_performance_analyzer 1.2.1.0
+opendistro_security             1.2.1.0
+opendistro_sql                  1.2.1.0</pre>
+    </td>
+  </tr>
     <tr>
       <td>7.2.0</td>
       <td>
@@ -119,7 +129,7 @@ Navigate to the Elasticsearch home directory (most likely, it is `/usr/share/ela
 ### Security
 
 ```bash
-sudo bin/elasticsearch-plugin install https://d3g5vo6xdbdb9a.cloudfront.net/downloads/elasticsearch-plugins/opendistro-security/opendistro_security-1.2.0.0.zip
+sudo bin/elasticsearch-plugin install https://d3g5vo6xdbdb9a.cloudfront.net/downloads/elasticsearch-plugins/opendistro-security/opendistro_security-1.2.1.0.zip
 ```
 
 After installing the Security plugin, you can run `sudo sh /usr/share/elasticsearch/plugins/opendistro_security/tools/install_demo_configuration.sh` to quickly get started with demo certificates. Otherwise, you must configure it manually and run [securityadmin.sh](../../security-configuration/security-admin/).
@@ -130,7 +140,7 @@ Security has a corresponding [Kibana plugin](../../kibana/plugins) that you prob
 ### Alerting
 
 ```bash
-sudo bin/elasticsearch-plugin install https://d3g5vo6xdbdb9a.cloudfront.net/downloads/elasticsearch-plugins/opendistro-alerting/opendistro_alerting-1.2.0.0.zip
+sudo bin/elasticsearch-plugin install https://d3g5vo6xdbdb9a.cloudfront.net/downloads/elasticsearch-plugins/opendistro-alerting/opendistro_alerting-1.2.1.0.zip
 ```
 
 Alerting has a corresponding [Kibana plugin](../../kibana/plugins) that you probably want to install as well.
@@ -139,7 +149,7 @@ Alerting has a corresponding [Kibana plugin](../../kibana/plugins) that you prob
 ### SQL
 
 ```bash
-sudo bin/elasticsearch-plugin install https://d3g5vo6xdbdb9a.cloudfront.net/downloads/elasticsearch-plugins/opendistro-sql/opendistro_sql-1.2.0.0.zip
+sudo bin/elasticsearch-plugin install https://d3g5vo6xdbdb9a.cloudfront.net/downloads/elasticsearch-plugins/opendistro-sql/opendistro_sql-1.2.1.0.zip
 ```
 
 ### Index State Management
@@ -162,7 +172,7 @@ To test this plugin, clone [the anomaly detection repository](https://github.com
 ### Performance Analyzer
 
 ```bash
-sudo bin/elasticsearch-plugin install https://d3g5vo6xdbdb9a.cloudfront.net/downloads/elasticsearch-plugins/performance-analyzer/opendistro_performance_analyzer-1.2.0.0.zip
+sudo bin/elasticsearch-plugin install https://d3g5vo6xdbdb9a.cloudfront.net/downloads/elasticsearch-plugins/performance-analyzer/opendistro_performance_analyzer-1.2.1.0.zip
 ```
 
 Performance Analyzer requires some manual configuration after installing the plugin:

docs/install/rpm.md

@@ -35,7 +35,7 @@ Installing and running Open Distro for Elasticsearch from an RPM package is a mo
 1. Choose the version you'd like and install it:
 
    ```bash
-   sudo yum install opendistroforelasticsearch-1.2.0
+   sudo yum install opendistroforelasticsearch-1.2.1
    ```
 
 1. **If you installed Java 8**, run the following command:

docs/install/tar.md

@@ -14,19 +14,19 @@ The tarball supports CentOS 7, Amazon Linux 2, Ubuntu 18.04, and most other Linu
 1. Download the tarball:
 
    ```bash
-   curl https://d3g5vo6xdbdb9a.cloudfront.net/tarball/opendistro-elasticsearch/opendistroforelasticsearch-1.2.0.tar.gz -o opendistroforelasticsearch-1.2.0.tar.gz
+   curl https://d3g5vo6xdbdb9a.cloudfront.net/tarball/opendistro-elasticsearch/opendistroforelasticsearch-1.2.1.tar.gz -o opendistroforelasticsearch-1.2.1.tar.gz
    ```
 
 1. Download the checksum:
 
    ```bash
-   curl https://d3g5vo6xdbdb9a.cloudfront.net/tarball/opendistro-elasticsearch/opendistroforelasticsearch-1.2.0.tar.gz.sha512 -o opendistroforelasticsearch-1.2.0.tar.gz.sha512
+   curl https://d3g5vo6xdbdb9a.cloudfront.net/tarball/opendistro-elasticsearch/opendistroforelasticsearch-1.2.1.tar.gz.sha512 -o opendistroforelasticsearch-1.2.1.tar.gz.sha512
    ```
 
 1. Verify the tarball against the checksum:
 
    ```bash
-   shasum -a 512 -c opendistroforelasticsearch-1.2.0.tar.gz.sha512
+   shasum -a 512 -c opendistroforelasticsearch-1.2.1.tar.gz.sha512
    ```
 
    On CentOS, you might not have `shasum`. Install this package:
@@ -38,8 +38,8 @@ The tarball supports CentOS 7, Amazon Linux 2, Ubuntu 18.04, and most other Linu
 1. Extract the TAR file to a directory and change to that directory:
 
    ```bash
-   tar -zxf opendistroforelasticsearch-1.2.0.tar.gz
-   cd opendistroforelasticsearch-1.2.0
+   tar -zxf opendistroforelasticsearch-1.2.1.tar.gz
+   cd opendistroforelasticsearch-1.2.1
    ```
 
 1. Run Open Distro for Elasticsearch:

docs/kibana/index.md

@@ -15,7 +15,7 @@ Kibana is the default visualization tool for data in Elasticsearch. It also serv
 
 You *can* start Kibana using `docker run` after [creating a Docker network](https://docs.docker.com/engine/reference/commandline/network_create/) and starting Elasticsearch, but the process of connecting Kibana to Elasticsearch is significantly easier with a Docker Compose file.
 
-1. Run `docker pull amazon/opendistro-for-elasticsearch-kibana:1.2.0`.
+1. Run `docker pull amazon/opendistro-for-elasticsearch-kibana:1.2.1`.
 
 1. Create a [`docker-compose.yml`](https://docs.docker.com/compose/compose-file/) file appropriate for your environment. A sample file that includes Kibana is available on the Open Distro for Elasticsearch [Docker installation page](../install/docker/#sample-docker-compose-file).
 
@@ -59,19 +59,19 @@ You can also modify the values in `/etc/kibana/kibana.yml`.
 1. Download the tarball:
 
    ```bash
-   curl https://d3g5vo6xdbdb9a.cloudfront.net/tarball/opendistroforelasticsearch-kibana/opendistroforelasticsearch-kibana-1.2.0.tar.gz -o opendistroforelasticsearch-kibana-1.2.0.tar.gz
+   curl https://d3g5vo6xdbdb9a.cloudfront.net/tarball/opendistroforelasticsearch-kibana/opendistroforelasticsearch-kibana-1.2.1.tar.gz -o opendistroforelasticsearch-kibana-1.2.1.tar.gz
    ```
 
 1. Download the checksum:
 
    ```bash
-   curl https://d3g5vo6xdbdb9a.cloudfront.net/tarball/opendistroforelasticsearch-kibana/opendistroforelasticsearch-kibana-1.2.0.tar.gz.sha512 -o opendistroforelasticsearch-kibana-1.2.0.tar.gz.sha512
+   curl https://d3g5vo6xdbdb9a.cloudfront.net/tarball/opendistroforelasticsearch-kibana/opendistroforelasticsearch-kibana-1.2.1.tar.gz.sha512 -o opendistroforelasticsearch-kibana-1.2.1.tar.gz.sha512
    ```
 
 1. Verify the tarball against the checksum:
 
    ```bash
-   shasum -a 512 -c opendistroforelasticsearch-kibana-1.2.0.tar.gz.sha512
+   shasum -a 512 -c opendistroforelasticsearch-kibana-1.2.1.tar.gz.sha512
    ```
 
    On CentOS, you might not have `shasum`. Install this package:
@@ -83,7 +83,7 @@ You can also modify the values in `/etc/kibana/kibana.yml`.
 1. Extract the TAR file to a directory and change to that directory:
 
    ```bash
-   tar -zxf opendistroforelasticsearch-kibana-1.2.0.tar.gz
+   tar -zxf opendistroforelasticsearch-kibana-1.2.1.tar.gz
    cd opendistroforelasticsearch-kibana
    ```
 

docs/kibana/plugins.md

@@ -25,7 +25,7 @@ Navigate to the Kibana home directory (likely `/usr/share/kibana`) and run the i
 #### Security
 
 ```bash
-sudo bin/kibana-plugin install https://d3g5vo6xdbdb9a.cloudfront.net/downloads/kibana-plugins/opendistro-security/opendistro_security_kibana_plugin-1.2.0.0.zip
+sudo bin/kibana-plugin install https://d3g5vo6xdbdb9a.cloudfront.net/downloads/kibana-plugins/opendistro-security/opendistro_security_kibana_plugin-1.2.1.0.zip
 ```
 
 This plugin provides a user interface for managing users, roles, mappings, action groups, and tenants.
@@ -34,7 +34,7 @@ This plugin provides a user interface for managing users, roles, mappings, actio
 #### Alerting
 
 ```bash
-sudo bin/kibana-plugin install https://d3g5vo6xdbdb9a.cloudfront.net/downloads/kibana-plugins/opendistro-alerting/opendistro-alerting-1.2.0.0.zip
+sudo bin/kibana-plugin install https://d3g5vo6xdbdb9a.cloudfront.net/downloads/kibana-plugins/opendistro-alerting/opendistro-alerting-1.2.1.0.zip
 ```
 
 This plugin provides a user interface for creating monitors and managing alerts.