-
Notifications
You must be signed in to change notification settings - Fork 8
/
index.html.md.erb
194 lines (126 loc) · 10.8 KB
/
index.html.md.erb
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
---
title: Apigee Edge Installer for Pivotal Platform
owner: Partners
---
***Note: Apigee Edge Installer for Pivotal Platform will be deprecated on December 31, 2019***
In this topic:
- [Overview](https://docs.pivotal.io/partners/edge-installer/index.html#overview)
- [Product Snapshot](https://docs.pivotal.io/partners/edge-installer/index.html#snapshot)
- [New Features for Edge v4.19.01](https://docs.pivotal.io/partners/edge-installer/index.html#new)
- [Retirements for Edge v14.19.01](https://docs.pivotal.io/partners/edge-installer/index.html#new)
- [Deprecations for Edge v14.19.01](https://docs.pivotal.io/partners/edge-installer/index.html#new)
- [Bug Fixes for Edge v4.19.01](https://docs.pivotal.io/partners/edge-installer/index.html#new)
- [Known Issues for Edge v14.19.01](https://docs.pivotal.io/partners/edge-installer/index.html#new)
- [Requirements](https://docs.pivotal.io/partners/edge-installer/index.html#reqs)
- [Differences between Edge Interactive Install and Apigee Edge Installer for Pivotal Platform](https://docs.pivotal.io/partners/edge-installer/index.html#compare)
- [Ops Manager, BOSH, and Pivotal Platform Tiles](https://docs.pivotal.io/partners/edge-installer/index.html#bosh)
- [Feedback](https://docs.pivotal.io/partners/edge-installer/index.html#feedback)
- [License](https://docs.pivotal.io/partners/edge-installer/index.html#license)
<p class="note warning"><strong> WARNING:</strong>
Apigee Edge Installer for Pivotal Platform requires CentOS stemcells. CentOS stemcells are not supported by Pivotal. Apigee is responsible for updating the Edge Installer for Pivotal Platform to the current major line of the CentOS stemcell.
If there is a CVE for the CentOS stemcell, your environment could be at risk.<br>
<b>Recommended Action:</b> Find the current major line of CentOS, see <a href="https://bosh.io/stemcells/">https://bosh.io/stemcells/</a>.
And, find the version of the CentOS stemcell used by the Apigee Edge Installer for Pivotal Platform, see <a href="https://docs.pivotal.io/partners/edge-installer">https://docs.pivotal.io/partners/edge-installer</a>.
If the versions are not the same, contact Apigee.
</p>
This documentation describes Apigee Edge Installer for Pivotal Platform, which installs the API management service [Apigee Edge for Private Cloud v4.19.01](https://docs.apigee.com/private-cloud/v4.19.01/overview) (Edge) on Pivotal Platform.
Pivotal Platform Operators [download](https://network.pivotal.io/) and install the Apigee Edge Installer for Pivotal Platform tile to expose the [Apigee Edge](http://docs.apigee.com/api-services/content/what-apigee-edge) API management platform in the Marketplace. Developers can then use Edge by creating instances of the service and binding them to their apps from Apps Manager or the Cloud Foundry Command Line Interface (cf CLI).
### Overview
Edge manages API complexity and risk in a multi- and hybrid-cloud world by ensuring security, visibility, and performance across the entire API landscape. For more information, see [What is Edge](http://docs.apigee.com/api-services/content/what-apigee-edge).
Edge for Private Cloud lets customers run Edge on-premises. A deployment environment for Edge for Private Cloud typically consists of at least nine separate servers, and more commonly 13 or more. In addition, you can install optional Edge components that require more servers:
- The Developer Services portal requires an additional server.
- Monetization is an add-on to the Management Server and Message Processor and does not require additional servers.
You can install Edge and its optional additional components in two ways:
<ul>
<li style="margin-bottom: 6px;">Interactive installation from the command line requires you to predefine and preconfigure each server individually, then install Edge components on each server in a specific order.</li>
<li>The <b>Apigee Edge Installer for Pivotal Platform</b> tile in Ops Manager presents a graphical web interface that installs and manages pre-configured products and components in a uniform way across multiple IaaSes: AWS, Azure, GCP, OpenStack, and vSphere.</li>
</ul>
The [Differences between Edge Interactive Install and Apigee Edge Installer for Pivotal Platform](https://docs.pivotal.io/partners/edge-installer/index.html#compare) section below compares these two installation methods in greater detail.
### Product Snapshot
<table>
<tr>
<th>Element</th>
<th>Details</th>
</tr>
<tr>
<td>Version</td>
<td>v4.19.01</td>
</tr>
<tr>
<td>Release date</td>
<td>March 13, 2019</td>
</tr>
<tr>
<td>Compatible Ops Manager version(s)</td>
<td>v2.3.x and v2.4.x</td>
</tr>
<tr>
<td>Compatible Pivotal Application Service version(s)</td>
<td>v2.3.x and v2.4.x</td>
</tr>
<tr>
<td>IaaS support</td>
<td>AWS, Azure, GCP, OpenStack, and vSphere</td>
</tr>
</table>
### New Features for Edge v4.19.01
This release of Edge contains the following new features:
* General Availability (GA) release of the New Edge experience
* General Availability (GA) release of Monetization in the New Edge experience
* <code style="color: #222222; background-color: #e6e6e6; padding: 1px 2px;">apigee-monit</code> adds self-healing and monitoring services
* Edge UI has new TLS configuration properties
* The possibility to create, edit, and delete virtual hosts in the New Edge experience
* OpenAPI v3 support added
* Support for RedHat Enterprise Linux (RHEL) and CentOS 7.6
* Oracle Linux 7.5 support added
### Retirements for Edge v4.19.01
There are no retirements included in this release.
### Deprecations for Edge v4.19.01
Apigee Edge for Private Cloud version 4.17.09 is no longer supported (deprecated). For more information, see [Apigee deprecations, retirements, and CPS changes](https://docs.apigee.com/release/deprecated-features).
### Bug Fixes for Edge v4.19.01
In this release, the following bugs were fixed:
* Zookeeper was not stopped by backup script (122694069)
* 'No organizations' landing page added (120993451)
* Deleting custom reports (120682369)
* Geomap tab in New Edge experience (120681592)
* Zookeeper JVM options (120624977)
* Undefined errors occurred on tooltips (80187407)
* Creating reverse proxies via OpenAPI (79949124)
* Resetting passwords not sending links (77515655)
* Incorrect headers for reset password links (72799769)
* Using WSDLs to create API Proxies (69550284)
### Known Issues for Edge v4.19.01
In this release, the following issues were detected:
* Message Processor backup not backing up the correct set of files (121095148)
* <code style="color: #222222; background-color: #e6e6e6; padding: 1px 2px;">apigee-monit</code> not supported on Amazon Linux 1 (122370980)
* Session tokens not invalidated (115278838)
* Cassandra operations not working when JMX auth is enabled (113342838)
* HEAD requests to Node.js targets hang (79993247)
* Hostnames not resolving (79757554)
* MessageLogging policy including extra information in the log message (68722102)
* Resetting system admin password fails (65737520)
### Requirements
Apigee Edge Installer for Pivotal Platform has the following requirements:
<ul>
<li style="margin-bottom: 6px;"><b>VMs:</b> Virtual machines (VMs) for Edge must meet system requirements for memory, CPU, and disk space as defined in <a href="http://docs.apigee.com/private-cloud/latest/installation-requirements">Installation Requirements</a>.</li>
<li><b>Load Balancers:</b> Configure load balancers to control access to Edge servers. The load balancer defines the domain name and port of the Edge access point, optionally enables TLS, and forwards requests to the appropriate port on an Edge component. For more information, see <a href="https://docs.apigee.com/private-cloud/v4.18.05/installing-edge-using-ops-manager#prerequisites-configureloadbalancers">Configure load balancers</a>.</li>
</ul>
### Differences between Edge Interactive Install and Apigee Edge Installer for Pivotal Platform
Apigee Edge Installer for Pivotal Platform streamlines the Edge for Private Cloud installation process and differs from interactive installation using the command line in the following ways:
- <b>No config files needed.</b> You use Ops Manager to specify installation and configuration information, and do not have to create separate config files.
- <b>Enable Monetization only after installing Edge.</b> You must install Edge first, and then enable Monetization and apply that change to the Edge installation. You cannot enable Monetization at the same time that you install Edge.
- <b>Enable Edge SSO only after installing Edge.</b> Install Edge first and then ensure that Edge is working correctly before enabling Edge SSO to support SAML. You cannot enable Edge SSO at the same time that you install Edge.
- <b>No need to enable Cassandra authentication.</b> The Cassandra servers created during the install are not publicly accessible and therefore do not require you to enable authentication.
- <b>The two Postgres servers are configured as master/standby servers.</b> You must use Postgres master/standby configuration in this release.
- <b>Do not have to open specific ports on the servers.</b> In an interactive Edge installation, you have to ensure that the necessary ports are open on each server as described in Edge port requirements.
- <b>Multiple data centers not supported.</b> The release supports the installation of a single data center only.
- <b>You can only specify the number of servers for the Router and Message Processor components.</b> This release configures Edge to create two Router servers and two Message Processor servers by default. However, you can increase or decrease those numbers at install time or later.
For more information, see [Differences between Operations Manager and interactive Edge installs](https://docs.apigee.com/private-cloud/v4.18.05/differences-between-operations-manager-and-interactive-edge-installs).
### Ops Manager, BOSH, and Pivotal Platform Tiles
Behind the Ops Manager interface, the open-source tool [BOSH](http://bosh.io/) handles deploying, running, and managing distributed software systems on all Pivotal Platform-supported cloud infrastructures. Ops Manager provides a uniform graphical, forms-based interface that hides the complexity of generating the cloud-specific deployment manifests and configurations that BOSH requires.
Ops Manager supports graphical configuration, deployment, and management of any software product packaged in [Pivotal Platform Tile](http://docs.pivotal.io/tiledev) structure.
### Feedback
Please contact [Apigee Support](https://community.apigee.com/content/apigee-customer-support) for any bugs, feature requests, or questions.
You can also tap into the knowledge and experience of Apigee customers and employees by posting a new question to the [Apigee Community](https://community.apigee.com/index.html).
### License
Each installation of Edge requires a unique license file that you obtain from Apigee. If license file is valid, the management server validates the expiry and allowed Message Processor (MP) count.