If starting with a clean installation, there is nothing to do. If updating an installation of API Management, follow the steps listed on Updating API Management and pay attention to the following changes:

  • The Docker settings file .env has changed:

    NewTo Do
    ELASTICSEARCH_JAVA_MEMORYNewly added. You need to provide the amount of memory that Elasticsearch can allocate.
    Refer to Installing API Management > Step 2: Configure the Installation Settings for more information on this variable.
  • The docker image for Elasticsearch has changed from 5.6.9 to 5.6.12. Refer to the Elasticsearch pages for more information on the new version.

  • To store files in the elasticsearch_data volume, the old Elasticsearch container uses a user with id 100; the new container uses a user elasticsearch with id 1000.
    You need to change the ownership for your Elasticsearch data volume, default name apimgmt_elasticsearch_data. You can lookup the name of the volume with docker volume ls.
    To change the owner, use the following command:

    docker run --rm -v apimgmt_elasticsearch_data:/usr/share/elasticsearch/data alpine ash -c "chown -R 1000.1000 /usr/share/elasticsearch/data"

  • No labels