📘 Oempro Upgrade (v4.14.5+, Docker)

Knowledge Base Installation & Upgrade
#1

If you are going to upgrade your Oempro v4.14.4 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_mysql_env

  11. Paste the following content into the .env file:

    HOSTNAME=oempro_mysql
MYSQL_ROOT_PASSWORD=set_a_password_here

  12. Pull latest Docker updates:

    docker-compose pull

  13. Build Docker containers:

    docker-compose build

  14. Start the Docker compose:

    docker-compose up -d

  15. 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

  16. 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

  17. Exit to the host machine

  18. 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

  19. 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/

  20. 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