forked from pivotal-cf/docs-pcf-install
-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathvsphere.html.md.erb
163 lines (108 loc) · 7.37 KB
/
vsphere.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
---
breadcrumb: Pivotal Cloud Foundry® Documentation
title: Installing Pivotal Cloud Foundry® on vSphere and vCloud Air
owner: Ops Manager
---
<strong><%= modified_date %></strong>
This guide describes how to install [Pivotal Cloud Foundry®](https://network.pivotal.io/products/pivotal-cf) (PCF) on vSphere and vCloud Air.
It will walk you through how to deploy the installation virtual machine known as Ops Manager, configure your vSphere settings, and install PCF Elastic Runtime.
If you experience a problem while following the steps below, check the [Known Issues](../pcf-release-notes/index.html), or refer to the [Pivotal Cloud Foundry® Troubleshooting Guide](./troubleshooting.html).
Once you have completed the steps in this guide, explore the documentation on
[docs.pivotal.io](http://docs.pivotal.io) to learn more about [Pivotal Cloud Foundry®](https://network.pivotal.io/products/pivotal-cf) (PCF)
and the Pivotal product suite.
<p class="note"><b>Note</b>: If you are performing an upgrade from PCF 1.5 to 1.6, see <a href="upgrading-pcf.html#pcf16upgrade">Upgrading Ops Manager</a> for critical upgrade information.</p>
## <a id='system'></a>Step 1: Confirm System Requirements ##
Before you begin your PCF deployment, ensure that your system meets the
minimum requirements.
The requirements include capacity for the virtual machines necessary for the
deployment, a supported version of the cf command line interface tool, and
certain user privileges.
Refer to the [Prerequisites to Deploying Operations Manager and Elastic Runtime](./requirements.html) topic for the complete list.
## <a id='deploy'></a>Step 2: Deploy PCF Ops Manager ##
1. Log in to [Pivotal Network](https://network.pivotal.io) and download the Ops
Manager virtual appliance file that matches your infrastructure.
1. Deploy Ops Manager using the procedure that corresponds to the VMware environment that you use:
* [Deploying Operations Manager to vSphere](./deploying-vm.html)
* [Deploying Operations Manager to vCloud Air and vCloud](./pcf-vchs-vcloud.html)
## <a id='paas'></a>Step 3: Configure and Install PCF ##
**Goal**: Configure and install Ops Manager Director (included), Elastic
Runtime, and MySQL for PCF.
Skip the import steps for Elastic Runtime or MySQL for PCF if you do not
want to import these products.
1. When Ops Manager boots for the first time, you must choose one of the following:
* <strong>[Use an Identity Provider](#idp)</strong>: If you use an Identity Provider, an external identity server maintains your user database.
* <strong>[Internal Authentication](#internal)</strong>: If you use Internal Authentication, PCF maintains your user database.
<%= image_tag("select-authentication.png") %>
### <a id='idp'></a>Use an Identity Provider ###
1. When redirected to the **Use an Identity Provider** page, you must:
* Retrieve the metadata URL from your Identity Provider and copy it into the **Use an Identity Provider** area.
* Create a passphrase. The passphrase you entered is a shared secret to encrypt Ops Manager data at rest.
* Read the **End User License Agreement**, and select the checkbox to accept the terms.
* Click **Setup Authentication**.
<%= image_tag("meta-url.png") %>
1. Your Identity Provider login page appears. Enter your username and password. Click **Login**.
### <a id='internal'></a>Internal Authentication ###
1. When redirected to the **Internal Authentication** page, you must:
* Enter a **Username** and **Admin password**.
* Enter a **Decryption passphrase**. This passphrase encrypts the Ops Manager datastore, and is not recoverable if forgotten.
* Read the **End User License Agreement**, and select the checkbox to accept the terms.
<%= image_tag("om-login.png") %>
1. Log in to Ops Manager with the Admin username and password you created on the initial setup page.
<%= image_tag("cf-login.png") %>
<p class="note"><strong>Note</strong>: On your first login attempt, an error
message that the connection is untrusted appears because you are attempting
to connect securely to a website with a self-signed certificate. Add Ops
Manager as an exception to bypass this message on subsequent logins. </p>
### <a id='import-tiles'></a>Import Products ###
1. Download Elastic Runtime and MySQL for PCF at [Pivotal Network](https://network.pivotal.io).
* Elastic Runtime: Click the **Pivotal Cloud Foundry®** banner to access the PCF product page. Use the drop-down menu to select an Elastic Runtime release.
* MySQL for PCF: Select the **All Products** tab to view available products. Search for "MySQL for PCF" and select a release.
1. From the Available Products view, click **Import a Product**.
<%= image_tag("guide/import-prod.png") %>
1. Select the Elastic Runtime .pivotal file that you downloaded from Pivotal
Network and click **Open**.
After the import completes, Elastic Runtime appears in the Available Products
view.
1. Repeat the previous step for MySQL for PCF.
1. In the Available Products view, hover over Elastic Runtime and click **Add**.
Repeat this step for MySQL for PCF.
<%= image_tag("guide/add-products.png") %>
### <a id='configure-vmware'></a>Configure Ops Manager Director ###
Your Ops Manager download includes a tile for the version of Ops Manager
Director that corresponds to your IaaS.
Refer to one of the following topics for help configuring your Ops Manager
Director product tile:
* [Configuring Ops Manager Director for VMware vSphere](./vsphere-config.html)
* [Configuring Ops Manager Director for vCloud Air and vCloud](./vchs-vcloud-config.html)
### <a id='configure-er'></a>Configure Elastic Runtime ###
See [Configuring Elastic Runtime for vSphere and vCloud Air](./config-er-vmware.html).
### <a id='configure-mysql'></a>Configure MySQL ###
1. Click the **MySQL Dev** tile.
1. Configure the MySQL Service Plan, Lifecycle Errands, and resource sizes.
Assign Availability Zones and an Ops Manager network, then click **Save**.
1. Click the **Installation Dashboard** link to return to the Installation
Dashboard.
### <a id='install'></a>Install Products ###
1. Click **Install**.
<%= image_tag("guide/install.png") %>
1. Your updated PCF installation begins deploying.
<%= image_tag("guide/deploy-progress.png") %>
1. When the deployment is finished, a success message appears.
<p class="note"><strong>Note</strong>: On the recommended hardware
infrastructure, deployment should take less than one hour and require no
user intervention.</p>
You now have a fully functional installation of PCF and Pivotal MySQL
Service.
## <a id='new-users'></a>Step 4: Create New User Accounts ##
Once you have successfully deployed PCF, add users to your account.
Refer to the [Creating New Elastic Runtime User Accounts](./creating-account.html) topic for more information.
## <a id='target'></a>Step 5: Target Elastic Runtime ##
The next step is to use the cf CLI tool to target your Elastic Runtime
installation.
Make sure that you have [installed the cf CLI tool](../cf-cli/install-go-cli.html).
Refer to the PCF documentation for more information about [using the cf
command line tool](../cf-cli/getting-started.html).
<p class="note"><strong>Note</strong>: In Pivotal Ops Manager, refer to
<strong>Elastic Runtime > Credentials</strong> for the UAA admin name and
password. You can also use the user that you created in Apps Manager, or
create another user with the <code>create-user</code> command.</p>