Version Upgrade

From Oempro v4.14.5+

This article contains version upgrade instructions for Oempro v4.14.5 and higher Docker based versions.

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 SSLbind *: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=

21. Run these commands:

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

22. Lastly, delete the install directory to make sure that it cannot be reached later on:

rm -rf /opt/oempro/install

From Oempro v4.14.4+

From Oempro v4.10.0+

From Oempro v4.8.0+

Oempro v4.7.0 and Older Versions

• Version Upgrade
• From Oempro v4.14.5+
• From Oempro v4.14.4+
• From Oempro v4.10.0+
• From Oempro v4.8.0+
• Oempro v4.7.0 and Older Versions