Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

added matomo upgrade instructions #2271

Closed
wants to merge 1 commit into from
Closed

added matomo upgrade instructions #2271

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 34 additions & 1 deletion docs/installation/docker-maintain-isle.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -106,11 +106,44 @@ You can run this from your isle directory with
docker compose exec mariadb mariadb-upgrade
```

#### Matomo

Matomo needs it's volume recreated when upgrading to a new version. The only file that needs to be preserved is /var/www/matomo/config/config.ini.php, so you should be able to recreate the volume with the following commands:

Copy the config file from the container to your local machine
```
docker compose cp matomo:/var/www/matomo/config/config.ini.php .
```

Stop your containers and delete the Matomo volume. Replace {COMPOSE_PROJECT_NAME} with the value of that variable in your .env file. You can also find the volume name by running `docker volume ls`
```
make down
docker volume rm {COMPOSE_PROJECT_NAME}_matomo-config-data
```

Start you containers to recreate the Matomo volume
```
make up
```

Copy the config file back into your new volume and set it's ownership to nginx
```
docker compose cp config.ini.php matomo:/var/www/matomo/config/
docker compose exec matomo chown nginx:nginx /var/www/matomo/config/config.ini.php
```

Restart your Matomo container
```
docker compose restart matomo
```

Log in to your Matomo dashboard and check if you database needs updates. If so, follow the instructions on screen to update it.

### Specific Update Notes

#### Version 1.x to 2.x

Upgrading ISLE from 1.x to the next major version requires the TAG be set to 2.0.5 or higher. Once you create your containers
you will need to follow the above instructions for Mariadb, Solr, and Drupal.
you will need to follow the above instructions for Mariadb, Solr, Matomo, and Drupal.

ISLE 2.0 bumps PHP up to version 8.1, which allows you to upgrade to Drupal 10.