4.15.07.01 - Apigee Edge for Private Cloud release notes

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

On Thursday, October 22, 2015, we released a new patch for Apigee Edge for Private Cloud.

Upgrade order for a two Data Center installation

If you are upgrading an installation with two Data Centers, then upgrade the components in the following order:

1. Qpid Data Center 1
2. Qpid Data Center 2
3. Postgres Data Center 1
4. Postgres Data Center 2
5. Management Server Data Center 1
6. Management Server Data Center 2
7. Router/Message Processor Data Center 1
8. Router/Message Processor Data Center 2

Removing the extra "gateway" pod on upgrade to 4.15.07.00

This release includes a script that fixes issue OPDK-1878. For that issue, if your previous installation of Edge changed the name of the gateway pod from the default value of "gateway", then the 4.15.07.00 upgrade script automatically added a new pod called "gateway" to your installation, along with the pod that you created.

Determining if you are affected

This issue is most likely to have occurred in an environment with multiple data centers, where you created gateway pods with different names in each data center, such as "gateway-1" and "gateway-2". If you used the default name of the gateway pod, "gateway", then you will not be affected by this issue.

To determine the pods in a region, use the following cURL command:

> curl -u sysAdminEmail:PW http://<ms_IP>:8080/v1/regions/dc-1/pods

where ms_IP is the IP address or DNS name of the Edge Management Server, and dc-1 is the name of the region. This command returns an array containing all pod names in the region.

If you run this command before the upgrade, and you renamed the "gateway" pod, you will see results in the form:

[ "gateway-1", "analytics", "central" ]

If you run this command after upgrading to 4.15.07.00, the results now include the "gateway" pod:

[ "gateway-1", "gateway", "analytics", "central" ]

If you do not know the names of your regions, use the command:

> curl -u sysAdminEmail:PW http://<ms_IP>:8080/v1/regions

Applying the patch script

The 4.15.07.01 patch includes the delete-gw-pod.sh script that removes the extra pod created by the 4.15.07.00 upgrade.

The delete-gw-pod.sh script:

• Removes all Edge components from the "gateway" pod, or the pod you specify.
• Disassociates any organizations from the pod.
• Deletes the pod.

To run this script:

1. Install the 4.15.07.01 patch.
2. Backup all ZooKeeper nodes. See the Edge Operations Guide for more information.
3. On any Management Server node, run the delete-gw-pod.sh script to delete the "gateway" pod created by the 4.15.07.00 upgrader:
   
   > /<instal_dir>/apigee4/bin/delete-gw-pod.sh
   
   The script prompts you for the system admin password.
   
   If you do not specify any command-line options to the script, it loops through all regions to identify any multiples of the gateway pod. It then prompts you to delete one, defaulting to the "gateway" pod.
   
   You can pass command-line options to the delete-gw-pod.sh script. For example, if you pass a pod name and region, it deletes just that pod in that region. It then asks if you want to check all regions.

You can pass the following parameters to the delete-gw-pod.sh script:

• -P <System admin password>
• -a <Admin email, defaults to the value of ADMIN_EMAIL in apigee_env.sh>
• -H <Management Server host, defaults to the value of MSIP in apigee_env.sh>
• -r <Region to search for the "gateway" pod>
• -p <Gateway pod name. Defaults to "gateway">
• -y <Suppress warning>

Bugs fixed

The following bugs are fixed in this release.