πŸ“˜ Oempro Upgrade (v4.14.4+, Docker)

If you are going to upgrade your Oempro v4.10.0+ Docker version to the most recent version, please follow these instructions:

  1. First, upload the latest Oempro version zip file to your server. (/opt/oempro/)

  2. Backup your MySQL database

  3. Backup your Oempro directory (/opt/oempro/)

  4. Change current directory into Oempro:

     cd /opt/oempro/
    
  5. Stop Docker containers:

    docker-compose kill
    
  6. Take a backup of _dockerfiles directory. Especially, haproxy.cfg file as it may include modified SSL certificate directives.

    cp /opt/oempro/_dockerfiles/haproxy.cfg /opt/oempro/_dockerfiles/haproxy.cfg.bck
    
  7. Take a backup of the config file:

    cp /opt/oempro/data/config.inc.php /opt/oempro/data/config.inc.php.bck
    
  8. Unzip the Oempro zip package. ZIP may ask you what to do for existing files. Choose β€œReplace All” option.

  9. Copy the SSL certificate directory from the _dockerfiles/haproxy.cfg.bck file to the _dockerfiles/haproxy.cfg file:

    # Enable these two lines if you have activated LetsEncrypt SSL
    bind *:443 ssl crt /etc/letsencrypt/live/yourdomain.com/yourdomain.com.pem
    redirect scheme https if !{ ssl_fc }
    
  10. Create the following environment file inside /opt/oempro/ directory:

    touch /opt/oempro/.oempro_rabbitmq_env
    
  11. Paste the following content into the .env file:

    HOSTNAME=oempro_rmq
    RABBITMQ_ERLANG_COOKIE=oempro-rmq
    RABBITMQ_VM_MEMORY_HIGH_WATERMARK=1024MiB
    RABBITMQ_DEFAULT_USER=oempro
    RABBITMQ_DEFAULT_PASS=set_a_password_here
    RABBITMQ_DEFAULT_VHOST=oempro_rmq_vhost
    
  12. Create the following environment file inside /opt/oempro/ directory:

    touch /opt/oempro/.oempro_redis_env
    
  13. Paste the following content into the .env file:

    HOSTNAME=oempro_redis
    
  14. Pull latest Docker updates:

    docker-compose pull
    
  15. Build Docker containers:

    docker-compose build
    
  16. Start the Docker compose:

    docker-compose up -d
    
  17. Open your web browser and go to the upgrade utility to perform the last upgrade task. The upgrade tool can be executed via the following URL:

    https://app.yourdomain.com/install/upgrade.php
    
  18. This step should be done if Oempro is already installed. Skip this step if there’s no update on the .env file. SSH into oempro_system container to perform a pre-upgrade process:

    docker exec -ti oempro_system bash
    cd /var/www/html/install/
    php phing.phar -f install.xml
    
  19. Exit to the host machine

  20. Restart supervisor processes in containers:

    docker exec -ti oempro_app supervisorctl restart all
    docker exec -ti oempro_system supervisorctl restart all
    docker exec -ti oempro_bounce supervisorctl restart all
    
  21. Set file permissions just to be sure:

    chmod -R 0777 /opt/oempro/data/
    chmod -R 0777 /opt/oempro/system/storage/
    chmod -R 0777 /opt/oempro/system/bootstrap/cache/
    
  22. Edit /opt/oempro/system/.env file and set the values. The values can be found under /opt/oempro/.oempro_rabbitmq_env file.

OEMPRO_RABBITMQ_USERNAME=
OEMPRO_RABBITMQ_PASSWORD=

And run this command:

docker exec -ti oempro_system php /var/www/html/system/artisan config:clear
docker exec -ti oempro_app supervisorctl restart all
docker exec -ti oempro_system supervisorctl restart all
docker exec -ti oempro_bounce supervisorctl restart all
  1. Lastly, delete the install directory to make sure that it cannot be reached later on:
rm -rf /opt/oempro/install

If you need help or stuck, feel free to contact us via support@octeth.com

  • The article was helpful
  • The article was not helpful

0 voters