Getting started
Installation & Setup
Administration
Audience Management
Email Marketing
Plug-Ins & Add-Ons
Developers
Advanced
Help
Version Upgrade
From Oempro v4.14.5+
This article contains version upgrade instructions for Oempro v4.14.5 and higher Docker based versions.
If you are going to upgrade your Oempro v4.14.4 Docker version to the most recent version, please follow these instructions:
- First, upload the latest Oempro version zip file to your server. (
/opt/oempro/
) - Backup your MySQL database
- Backup your Oempro directory (
/opt/oempro/
) - Change current directory into Oempro:
- Stop Docker containers:
- Take a backup of
_dockerfiles
directory. Especially,haproxy.cfg
file as it may include modified SSL certificate directives. - Take a backup of the config file:
- Unzip the Oempro zip package. ZIP may ask you what to do for existing files. Choose “Replace All” option.
- Copy the SSL certificate directory from the
_dockerfiles/haproxy.cfg.bck
file to the_dockerfiles/haproxy.cfg
file: - Create the following environment file inside
/opt/oempro/
directory: - Paste the following content into the .env file:
- Pull latest Docker updates:
- Build Docker containers:
- Start the Docker compose:
- 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:
- 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: - Exit to the host machine
- Restart supervisor processes in containers:
- Set file permissions just to be sure:
- Edit
/opt/oempro/system/.env
file and set the values. The values can be found under/opt/oempro/.oempro_rabbitmq_env
file. - Run these commands:
- Lastly, delete the install directory to make sure that it cannot be reached later on:
cd /opt/oempro/
docker-compose kill
cp /opt/oempro/_dockerfiles/haproxy.cfg /opt/oempro/_dockerfiles/haproxy.cfg.bck
cp /opt/oempro/data/config.inc.php /opt/oempro/data/config.inc.php.bck
# 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 }
touch /opt/oempro/.oempro_mysql_env
HOSTNAME=oempro_mysql
MYSQL_ROOT_PASSWORD=set_a_password_here
docker-compose pull
docker-compose build
docker-compose up -d
https://app.yourdomain.com/install/upgrade.php
docker exec -ti oempro_system bash
cd /var/www/html/install/
php phing.phar -f install.xml
docker exec -ti oempro_app supervisorctl restart all
docker exec -ti oempro_system supervisorctl restart all
docker exec -ti oempro_bounce supervisorctl restart all
chmod -R 0777 /opt/oempro/data/
chmod -R 0777 /opt/oempro/system/storage/
chmod -R 0777 /opt/oempro/system/bootstrap/cache/
OEMPRO_RABBITMQ_USERNAME=
OEMPRO_RABBITMQ_PASSWORD=
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
rm -rf /opt/oempro/install