You're viewing **Apigee Edge** documentation.  
[Go to the
**Apigee X** documentation](http://cloud.google.com/apigee/docs). info

On Tuesday, October 25, 2016, we released a new version of Apigee Edge for Private Cloud.

> [!NOTE]
> **Note:** **Questions or issues?** Contact [Apigee Edge Support](https://docs.apigee.com/api-platform/troubleshoot/support).
>
> **Release notifications** : See [Get Apigee Edge release notifications](https://docs.apigee.com/release/get-release-notifications).
>
> [Release notes home page](https://docs.apigee.com/release/notes/apigee-release-notes)

## Update procedure

To update your installation, perform the following procedure:

1. On all Edge nodes, clean Yum repos:  

   \> sudo yum clean all

2. On all Edge nodes, update apigee-setup:  

   \> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

3. On all Cassandra nodes, update apigee-cassandra:  

   \>/opt/apigee/apigee-setup/bin/update.sh -c cs -f ***configFile***  

   <br />


   where ***configFile*** specifies the config file you used to install
   Edge.

4. On all Edge nodes, update edge-gateway:  
   \>/opt/apigee/apigee-setup/bin/update.sh -c edge -f ***configFile***
5. On all Edge UI nodes, update edge-ui:  

   \>/opt/apigee/apigee-setup/bin/update.sh -c ui -f ***configFile***  

   <br />


   This update includes the fix for EdgeUI-675. After you perform this update, you can configure
   the Edge UI to allow OpenAPI specs to define requests to private IP addresses as described at
   [Allowing
   the Edge UI Access to Local IP Addresses](https://docs.apigee.com/private-cloud/v4.16.05/allowing-trace-tool-access-local-ip-addresses).

6. **If you have installed Edge Monetization services only,** apply the patch
   for DEVRT-3098:  

   \> /opt/apigee/apigee-service/bin/apigee-service edge-mint-management-server add-missing-notification-templates -f ***configFile***  

   <br />


   where ***configFile*** specifies the config file you used to install
   Edge.

## Bugs fixed

The following bugs are fixed in this release.

> [!NOTE]
> **Note:** The build number in the table specifies the earliest version of the component that contains the fix. Use that build number to determine if you already have the fix installed, or if you need to perform an update. The apigee-service utility displays the build number of the currently installed component:
>
> ```
> /opt/apigee/apigee-service/bin/apigee-service comp version
> ```
>
> where ***comp*** is the name of the component without the build number
> extension. For example:
>
> ```
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup version
> ```
>
> or get the build number of all components:
>
> ```
> /opt/apigee/apigee-service/bin/apigee-all version
> ```

| Issue ID | Description | Build number |
|---|---|---|
| APIRT-1144 | **XML to JSON policy enhancements** The XML to JSON policy has been enhanced with the following capabilities. You can configure the policy to: - Treat some XML elements as arrays during conversion, which puts the values in square brackets '\[ \]' in the JSON document. - Strip or eliminate levels of the XML document hierarchy in the final JSON document. For more information, see [XML to JSON policy](https://docs.apigee.com/api-platform/reference/policies/xml-json-policy) | edge-gateway-4.16.05-0.0.778 |
| APIRT-3389 | **Error uploading Node.js payloads over 25KB** You can now upload Node.js payloads larger than 25KB. | edge-gateway-4.16.05-0.0.761 |
| DBS-1234 | **Cassandra logs directory named "{T}conf_logback.logdir{"** Fixed a configuration issue where a directory for the Cassandra logs was named "{T}conf_logback.logdir{". | apigee-cassandra-2.1.13-0.0.954 |
| DEVRT-2834 | **Monetization now allows generation of billing docs with no activity** In previous releases, trying generate billing docs when there was no activity cused an error. | edge-mint-gateway-4.16.05-0.0.562 |
| DEVRT-3098 | **Error encountered when setting up** **Monetization** **notification templates using the UI** An error is raised when setting up Monetization notification templates using the UI, as described in [Set up notifications using notification templates](https://docs.apigee.com/api-platform/monetization/set-up-notification-templates). | edge-mint-gateway-4.16.05-0.0.562 |
| DEVRT-3266 | **Notification failing for Monetization when you enable developer sign up for new rate plan** | edge-mint-gateway-4.16.05-0.0.562 |
| EDGEUI-675 | **Allow OpenAPI specs to access private IP Addresses** By default, Edge prevents OpenAPI specs from referencing private IP addresses. You can now enable access to private IP addresses as described in [Allowing the Edge UI Access to Local IP Addresses](https://docs.apigee.com/private-cloud/v4.16.05/allowing-trace-tool-access-local-ip-addresses). | edge-sap-ui-4.16.05-0.0.3692 |

## Known issues

This release has the following known issues.

| Issue ID | Description |
|---|---|
| APIRT-2978 | **Router fails to start Nginx or Router fails to start** If the Edge Router fails to start Nginx or fails to start at all, as shown in the /opt/apigee/var/log/edge-router/logs/system.log file, then delete all files in the /opt/nginx/conf.d directory, and restart the router: ``` > rm -f /opt/nginx/conf.d/* > /opt/apigee/apigee-service/bin/apigee-service edge-router restart ``` |
| APIRT-3364 | **Message Processor does DNS lookup on IPv4 and IPv6** If you have installed and enabled NSCD (Name Service Cache Daemon) you might notice that Message Processors make two DNS lookups: one for IPv4 and one for IPv6. To disable the DNS lookup on IPv6: 1. On every Message Processor node, edit /etc/nscd.conf. 2. Set the following property: enable-cache hosts no |
| PRC-1118 | **Error when running "apigee-service apigee-postgresql pg-data-purge" command** If you run the "apigee-service apigee-postgresql pg-data-purge" command and see an error in the form: **ERROR: must be owner of relation** Edit /opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge and set the following property to 'apigee': POSTGRES_USER=apigee |
| DOC-1687 | **Due to a known package dependency conflict, the Katello agent used in Satellite Server 6 will not install properly on Apigee Edge hosts running the Qpid daemon.** |