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:

    1. Stop the router.
      --apigee-service edge-router stop
    2. 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
    3. Configure the router.
      apigee-service edge-router configure
    4. Start the router.
      apigee-service edge-router start