Skip to main content

Upgrade

Upgrade Planning​

Pre-Upgrade Checklist​

  • Review release notes and changelog

  • Test upgrade in staging environment

  • Create full system backup

  • Schedule maintenance window

  • Notify stakeholders

  • Prepare rollback plan

Upgrade Process (5.3.0 → 5.3.1)​

  1. Step 1: Preparation bash

# Create backup
./backup_tileserver.sh
# Download new version
wget https://releases.tileserver.com/v5.3.1/tileserver-5.3.1.tar.gz
tar -xzf tileserver-5.3.1.tar.gz
# Compare configurations
diff -u config/config.yml tileserver-5.3.1/config/config.example.yml
  1. Step 2: Upgrade Execution bash
# Stop services
docker-compose down
# Update Docker images
docker-compose pull
# Update configuration files
cp tileserver-5.3.1/config/config.example.yml config/config.yml.new
# Merge your custom settings
# Database migration (if required)
docker-compose run --rm tileserver npm run migrate
# Start services
docker-compose up -d
  1. Step 3: Verification bash

# Check service health
curl -I http://localhost:8080/health
# Verify tile serving
curl -I http://localhost:8080/tiles/1/0/0.png
# Check logs for errors
docker-compose logs -f tileserver
# Performance test
ab -n 1000 -c 10 http://localhost:8080/tiles/10/512/512.png
  1. Step 4: Post-Upgrade Tasks bash

# Clear cache
docker-compose exec redis redis-cli FLUSHALL
# Update monitoring dashboards
# Update documentation
# Notify stakeholders of completion

Rollback Procedure​

bash


# Emergency rollback
docker-compose down
docker tag tileserver:5.3.1 tileserver:5.3.1-backup
docker tag tileserver:5.3.0 tileserver:5.3.1
docker-compose up -d
# Restore database (if needed)
gunzip -c backup_YYYYMMDD.sql.gz | docker-compose exec -T postgres psql -U postgres -d tileserver
# Verify rollback
curl -I http://localhost:8080/health