forked from pivotal-cf/docs-pcf-install
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathaws-om-upgrade.html.md.erb
79 lines (54 loc) · 4.8 KB
/
aws-om-upgrade.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
---
title: Upgrading Ops Manager Director on AWS
owner: Ops Manager
---
This topic describes how to upgrade Ops Manager Director for Pivotal Cloud Foundry (PCF) on Amazon Web Services (AWS). It corresponds to [Step 2: Deploy Ops Manager](./upgrading-pcf.html#upgrade) in the _Upgrading Pivotal Cloud Foundry_ topic.
In this procedure, you create a new Ops Manager VM instance that hosts the new version of Ops Manager. To upgrade, you export your existing Ops Manager installation into this new VM.
##<a id='pcfaws-om-ami'></a> Retrieve the Ops Manager AMI ID ##
To retrieve the Amazon Machine Image (AMI) ID for Ops Manager, perform the following steps:
1. Navigate to the **Pivotal Cloud Foundry Operations Manager** section of [Pivotal Network](https://network.pivotal.io/products/ops-manager).
1. Select the version of PCF you want to install from the **Releases** dropdown.
1. In the **Release Download Files**, click the file named **Pivotal Cloud Foundry Ops Manager for AWS** to download a PDF.
1. Open the PDF and record the AMI ID for your region.
##<a id='pcfaws-om-ami'></a> Launch the AMI ##
To launch the AMI ID for Ops Manager, perform the following steps:
1. Navigate to your EC2 Dashboard.
1. Click **AMIs** from the **Images** menu.
1. Select **Public images** from the drop-down filter that says **Owned by me**.
1. Paste the AMI ID for your region into the search bar and press enter.
<p class="note"><strong>Note</strong>: There is a different AMI for each region. If you cannot locate the AMI for your region, verify that you have set your AWS Management Console to your desired region. If you still cannot locate the AMI, log in to the <a href="https://network.pivotal.io">Pivotal Network</a> and file a support ticket.</p>
<%= image_tag("pcfaws/pcf_aws_ami.png") %>
1. (Optional) If you want to encrypt the VM that runs Ops Manager with AWS Key Management Service (KMS), perform the following additional steps:
1. Right click the row that lists your AMI and click **Copy AMI**.
1. Select your **Destination region**.
1. Enable **Encryption**. For more information about AMI encryption, see [Encryption and AMI Copy](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/CopyingAMIs.html#ami-copy-encryption) from the *Copying an AMI* topic in the AWS documentation.
1. Select your **Master Key**. To create a new custom key, see [Creating Keys](https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html) in the AWS documentation.
1. Click **Copy AMI**. You can use the new AMI you copied for the following steps.
1. Select the row that lists your Ops Manager AMI and click **Launch**.
1. Choose **m5.large** for your instance type and click **Next: Configure Instance Details**.
<%= image_tag("pcfaws/aws_ami_m5large.png") %>
1. Configure the following for your instance:
* **Network**: Select the VPC that you created.
* **Subnet**: Select `pcf-public-subnet-az0`.
* **Auto-assign for Public IP**: Select **Enable**.
* **IAM role**: Select the IAM role associated with your pcf-user profile. If you have not created one, click **Create new IAM role** and follow the [Guidelines for Creating User Roles on AWS](./aws-iaas-user-roles.html).
* For all other fields, accept the default values.
<%= image_tag("pcfaws/pcf_aws_configure_instance.png") %>
1. Click **Next: Add Storage** and adjust the **Size (GiB)** value.
The default persistent disk value is 50 GB. Pivotal recommends increasing this value to a minimum of 100 GB.
<%= image_tag("pcfaws/pcf_aws_add_storage.png") %>
1. Click **Next: Tag Instance**
1. On the **Add Tags** page, add a tag with the key `Name` and value `pcf-ops-manager`.
1. Click **Next: Configure Security Group**.
1. Select the `pcf-ops-manager-security-group` that you created in [Step 5: Configure a Security Group for Ops Manager](../om/aws/prepare-env-manual.html#pcfaws-om-secgrp).
1. Click **Review and Launch** and confirm the instance launch details.
1. Click **Launch**.
1. Select the `pcf-ops-manager-key` key pair, confirm that you have access to the private key file, and click **Launch Instances**. You use this key pair to access the Ops Manager VM.
<%= image_tag("pcfaws/select_pcfpem_keypair.png") %>
##<a id='dns'></a> Edit the Ops Manager DNS A Record ##
1. Click **View Instances** to access the **Instances** page on the EC2 Dashboard.
1. Select the VM that you created in the previous section.
1. Locate the **IPv4 Public IP** value in the instance **Description** tab, and record this value for use in the next step.
1. In your DNS provider, edit the **A** record for `pcf.YOUR-SYSTEM-DOMAIN` to point to the IP address recorded in the previous step.
##<a id='continue'></a> Continue Upgrading PCF ##
Continue to [Step 3: Import Previous Ops Manager Installation](./upgrading-pcf.html#upgrade) in the _Upgrading Pivotal Cloud Foundry_ topic.