Upgrading GROWI to v3.4.x

v3.4 uses different versions about Node.js and middlewares as below.

GROWI <= v3.3.x v3.4.x
Node.js v8 v10
MongoDB 3.4 3.6
Elasticsearch 5.3 6.6

Also, the docker image that is used by growi-docker-compose (opens new window) is modified to the image that provided by official docker.elastic.co (opens new window) instead of docker-library/elasticsearch (opens new window).

The case using on premise

Upgrade Node.js

  1. Upgrade Node.js to v10

Upgrade MongoDB

  1. Upgrade MongoDB 3.6 or above
  2. You do not need to migrate data

Upgrade Elasticsearch

  1. Upgrade Elasticsearch 6.6 or above and install plugins that were required so far
    • Since index data can be rebuilt from GROWI's management screen, it can be discarded.

The case using growi-docker-compose (opens new window)

  1. Remove existing containers

    # Remove MongoDB, Elasticsearch containers
    docker-compose rm mongodb elasticsearch
    
  2. Remove Elasticsearch volumes

    WARNING

    Please check the actual volume name with docker volume ls

    docker volume rm growi_es_data
    docker volume rm growi_es_plugins
    
  3. Launch

After launching GROWI

  1. Re-build index on "Full Text Search management" page (/admin/search)