Getting started
What’s New
Roadmap
Octeth Training Program
Installation & Setup
Requirements
Architecture
Server Setup
Oempro Installation
Community Edition Install
SSL Certificates
Version Upgrade
Troubleshooting
Administration
Quick Walkthrough
Security
Sub Admin Accounts
Settings
Delivery Servers
Global Segments
Global Custom Fields
Bounce Processing
Spam Complaints
Suppression List
Plug-Ins
Delivery Report
User Management
Maintenance
Audience Management
Introduction
Subscriber Lists
Custom Fields
Segments
Subscribers
Webhooks
Email Marketing
Introduction
Auto Responders
Email Campaigns
Sender Domain Man.
Journeys (Automation)
Bounce Processing
Email Personalization
FBL Processing
Email Builder Integrations
Email Deliverability
Sender Domain Management
Plug-Ins & Add-Ons
AI Plug-In
Bounce Catcher Add-On
Link Proxy Add-On
Developers
Introduction
Single Sign On
API
Plug-In Development
Database
Integrations
IPMonitor
Installation
Advanced
Reverse Proxy
Cookbook
Help
Troubleshooting
Contact Us
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
From Oempro v4.14.4+
From Oempro v4.10.0+
From Oempro v4.8.0+
Oempro v4.7.0 and Older Versions
©Copyright Octeth, Inc. All rights reserved.