Downgrading Apigee Components and NGINX

You're viewing Apigee Edge documentation.
Go to the Apigee X documentation. info

March 2021 patch release

The RPMs for the March 2021 patch release of Edge for Private Cloud, which were pushed to the Apigee production repository, had an unintended dependency update for apigee-nginx-1.18. As a result, we have removed the RPMs from the repository and replaced them with correct RPMs. The invalid RPMs were in the repository on March 25, 2021 from 08:45 AM to 03:45 PM PST. If you downloaded and installed Edge RPMs on that date, you may need to downgrade the following Apigee components to previous versions:

edge-gateway
edge-management-server
edge-message-processor
edge-postgres-server
edge-qpid-server
edge-router
nginx

The following sections describe how to check whether you need to downgrade, and how to downgrade Apigee components, if necessary.

Checking whether you need to downgrade

To see whether you need to downgrade Apigee components or NGINX, do one of the following procedures, depending on whether you are using Edge for Private Cloud 4.50.00 or 4.19.06.

Procedure for Edge 4.50.00

On each node, enter the following to find your Gateway version:

-- apigee-service edge-gateway version

If the version number for edge-gateway is:

Less than 20113, you don't need to take any further action.
Equal to 20113, you need to downgrade Apigee components and NGINX.
Greater than 20113, find your NGINX version by entering the following:
```
-- sudo yum list installed apigee-nginx
```
Here is some sample output from the command:
```
Installed Packages
apigee-nginx.x86_64 1.18.0-1.el7
@apigee-thirdparty
```
If the NGINX version is apigee-nginx.x86_64 1.18.0-XXX, you only need to downgrade NGINX.

Procedure for Edge 4.19.06

On each node, enter the following to find your Gateway version:

-- apigee-service edge-gateway version

If the version number for edge-gateway is:

Less than 20114, you don't need to take any further action.
Equal to 20114, you need to downgrade Apigee components and downgrade NGINX.

Greater than 20114, find your NGINX version by entering the following:

-- sudo yum list installed apigee-nginx

Here is some sample output from the command:

Installed Packages
apigee-nginx.x86_64 1.18.0-1.el7
@apigee-thirdparty

If the NGINX version is apigee-nginx.x86_64 1.18.0-XXX, you only need to downgrade NGINX.

Components to downgrade

If you have installed any of the RPMs on the following lists, you need to downgrade to the previous version of these RPMs.

Components to downgrade for Edge for Private Cloud 4.50.00

edge-gateway-4.50.00-0.0.20113.noarch.rpm
edge-management-server-4.50.00-0.0.20113.noarch.rpm
edge-message-processor-4.50.00-0.0.20113.noarch.rpm
edge-postgres-server-4.50.00-0.0.20113.noarch.rpm
edge-qpid-server-4.50.00-0.0.20113.noarch.rpm
edge-router-4.50.00-0.0.20113.noarch.rpm

Components to downgrade for Edge for Private Cloud 4.19.06

edge-gateway-4.19.06-0.0.20114.noarch.rpm
edge-management-server-4.19.06-0.0.20114.noarch.rpm
edge-message-processor-4.19.06-0.0.20114.noarch.rpm
edge-postgres-server-4.19.06-0.0.20114.noarch.rpm
edge-qpid-server-4.19.06-0.0.20114.noarch.rpm
edge-router-4.19.06-0.0.20114.noarch.rpm

To check whether these RPMs are installed, on each node where any of the components in the appropriate list above are installed, enter the following command for each component:

-- apigee-service component version

Downgrade Apigee components

To downgrade Apigee components, use the following procedure.

On each node that has any of the following components installed:

edge-gateway
edge-management-server
edge-message-processor
edge-postgres-server
edge-qpid-server
edge-router

Stop the component by entering

--apigee-service component stop

Then downgrade the components:

-- sudo yum downgrade

Here are some examples:

If gateway and edge-message-processor are installed:

-- sudo yum downgrade edge-gateway edge-message-processor

If gateway and edge-router installed:

-- sudo yum downgrade edge-gateway edge-router

If AIO setup :

-- sudo yum downgrade edge-gateway edge-postgres-server edge-router edge-management-server edge-message-processor edge-qpid-server

Once you are done downgrading, run configure for each component and re-start it.

--apigee-service  component configure
--apigee-service  component start

The correct version of RPMs that you would have after downgrading are shown below.

Edge for Private Cloud 4.50.00

edge-gateway-4.50.00-0.0.20110
Edge-management-server-4.50.00-0.0.20110
edge-message-processor-4.50.00-0.0.20110
edge-postgres-server-4.50.00-0.0.20110
edge-qpid-server-4.50.00-0.0.20110
edge-router-4.50.00-0.0.20110

Edge for Private Cloud 4.19.06

edge-gateway-4.19.06-0.0.20112
Edge-management-server-4.19.06-0.0.20112
edge-message-processor-4.19.06-0.0.20112
edge-postgres-server-4.19.06-0.0.20112
edge-qpid-server-4.19.06-0.0.20112
edge-router-4.19.06-0.0.20112

Downgrade NGINX

To downgrade apigee-nginx, do the following steps for Edge router, one node at a time:

Stop the router.
```
--apigee-service edge-router stop
```

Downgrade apigee-ngix.

 -- sudo yum downgrade apigee-nginx

Expected apigee-nginx version after downgrade:

-- yum list installed apigee-nginx
apigee-nginx.x86_64 -1.16.1-6.el7

Configure the router.
```
apigee-service edge-router configure
```
Start the router.
```
apigee-service edge-router start
```