Downgrade OpenResty Edge Offline

1. prepare the old offline package

If you don’t have the old offline package named Edge-Offline-VERSION.tar.gz, please login and download it at OpenResty Download Center using your email address.

tar xf Edge-Offline-VERSION.tar.gz
# Example: tar xf Edge-Offline-20210721.tar.gz

Usually the offline package will contain the following files:

  • openresty-postgresql.tar.gz
  • openresty-edge-admin.tar.gz
  • openresty-edge-node.tar.gz
  • openresty-edge-log-server.tar.gz
  • update-admin-db-VERSION.sh, use only when upgrading
  • update-log-server-db-VERSION.sh, use only when upgrading
  • init_admin_db_VERSION.sh, use only during installation
  • init_log_server_db_VERSION.sh, use only during installation

2. Downgrade Edge Admin

# Download the downgrade script
curl -O https://openresty.com/client/oredge/downgrade-edge-admin-offline.sh

# Place the script in the directory of the old Edge Admin offline installation package
cp downgrade-edge-admin-offline.sh <old-packages-dir>

# Run the downgrade script
sudo bash downgrade-edge-admin-offline.sh

# check
sudo rpm -qa | grep edge
# or
sudo dpkg -l | grep edge

3. Downgrade Edge Admin database

# Transfer the script to the machine where the Edge Admin database is located
# Example:bash downgrade-admin-db-217-180.sh
bash downgrade-admin-db-VERSION.sh

4. Recompile

Please recompile the application in the following order:

  1. Recompile a few applications that do not contain wildcard domains with less traffic first
  2. Recompile several high-traffic applications that do not contain wildcard domains
  3. Recompile all wildcard applications
  4. Recompile all applications
  5. Recompile global rules
cd /usr/local/oredge-admin/
# recompile the specified application (replace APP-ID with application ID)
sudo bash utils/recompile-apps.sh http APP-ID
# recompile all applications
sudo bash utils/recompile-apps.sh wildcard-http
sudo bash utils/recompile-apps.sh http
sudo bash utils/recompile-apps.sh http_proxy
sudo bash utils/recompile-apps.sh socks5_proxy
# recompile global rules
sudo bash utils/recompile-apps.sh global
# recompile waf rules
sudo bash utils/recompile-apps.sh waf
# recompile DNS applications
sudo bash utils/recompile-apps.sh dns
# recompile global actions
sudo bash utils/recompile-apps.sh global-action
# recompile gateway (may trigger OpenResty Edge Node reload)
sudo bash utils/recompile-apps.sh gateway

If the whole system behave normally, the downgrade is complete!

this step may take longer to compile when there are many HTTP/HTTPS applications.

sudo /bin/bash utils/recompile-apps.sh http

We recommend using another tool for concurrent compilation then. The following command will start 4 processes to compile.

sudo /bin/bash utils/parallel-recompile.sh

If it is not fast enough, you can also specify a larger concurrency, but not larger than 8, e.g.

sudo /bin/bash utils/parallel-recompile.sh 8

5. Downgrade Edge Node

Downgrade 1~2 Edge Nodes first, and then downgrade all Edge Node after there are no problems, please pay attention to the error log during the downgrade.

  • Cut away traffic. If you are using Edge’s DNS, follow these steps; otherwise, proceed as you see fit.

    • Take the Edge Node you want to downgrade offline.

      • Enter the [Gateway Clusters].
      • [Edit] The cluster where the node is located.
      • Modify the node’s [status] to [Disable DNS, disable caching cluster].
      • [Save]
    • Wait for the node to no longer have traffic. You could confirm by checking the access log:

      tail -f /usr/local/oredge-node/logs/access.log
      

      This process requires waiting for DNS to expire, which can be time-consuming.

  • Downgrade:

    # Download the downgrade script
    curl -O https://openresty.com/client/oredge/downgrade-edge-node-offline.sh
    
    # Place the script in the directory of the old Edge Node offline installation package
    cp downgrade-edge-node-offline.sh <old-packages-dir>
    
    # Run the downgrade script
    sudo bash downgrade-edge-node-offline.sh
    

6. Downgrade Log Server

# Download the downgrade script
curl -O https://openresty.com/client/oredge/downgrade-edge-log-server-offline.sh

# Place the script in the directory of the old Edge Log Server offline installation package
cp downgrade-edge-log-server-offline.sh <old-packages-dir>

# Run the downgrade script
sudo bash downgrade-edge-log-server-offline.sh

7. Downgrade Log Server Database

# Transfer the script to the machine where the Log Server database is located
bash downgrade-log-server-db-VERSION.sh

# Example:bash downgrade-log-server-db-49-41.sh

If you have any questions, please contact us.