Skip to content

Commit b4964fb

Browse files
author
Bob
committed
Update after PR27394 to re-add bootstrap file hosting on webserver
1 parent c25d862 commit b4964fb

File tree

1 file changed

+42
-10
lines changed

1 file changed

+42
-10
lines changed

modules/installation-vsphere-machines.adoc

Lines changed: 42 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -14,13 +14,49 @@ To install {product-title} on user-provisioned infrastructure on VMware vSphere,
1414

1515
.Prerequisites
1616

17-
* Obtain the Ignition config files for your cluster.
18-
* Create a link:https://docs.vmware.com/en/VMware-vSphere/6.0/com.vmware.vsphere.vcenterhost.doc/GUID-B1018F28-3F14-4DFE-9B4B-F48BBDB72C10.html[vSphere cluster].
17+
* You have obtained the Ignition config files for your cluster.
18+
* You have access to an HTTP server that you can access from your computer and that the machines that you create can access.
19+
* You have created a link:https://docs.vmware.com/en/VMware-vSphere/6.0/com.vmware.vsphere.vcenterhost.doc/GUID-B1018F28-3F14-4DFE-9B4B-F48BBDB72C10.html[vSphere cluster].
1920

2021
.Procedure
2122

22-
. Convert the control plane, compute, and bootstrap Ignition config files to Base64 encoding.
23-
23+
. Upload the bootstrap Ignition config file, which is named `<installation_directory>/bootstrap.ign`, that the installation program created to your HTTP server. Note the URL of this file.
24+
+
25+
. Save the following secondary Ignition config file for your bootstrap node to your computer as `<installation_directory>/merge-bootstrap.ign`:
26+
+
27+
[source,text]
28+
----
29+
{
30+
"ignition": {
31+
"config": {
32+
"merge": [
33+
{
34+
"source": "<bootstrap_ignition_config_url>", <1>
35+
"verification": {}
36+
}
37+
]
38+
},
39+
"timeouts": {},
40+
"version": "3.2.0"
41+
},
42+
"networkd": {},
43+
"passwd": {},
44+
"storage": {},
45+
"systemd": {}
46+
}
47+
----
48+
+
49+
<1> Specify the URL of the bootstrap Ignition config file that you hosted.
50+
+
51+
When you create the virtual machine (VM) for the bootstrap machine, you use this Ignition config file.
52+
+
53+
. Locate the following Ignition config files that the installation program created:
54+
+
55+
* `<installation_directory>/master.ign`
56+
* `<installation_directory>/worker.ign`
57+
* `<installation_directory>/merge-bootstrap.ign`
58+
+
59+
. Convert the Ignition config files to Base64 encoding. Later in this procedure, you must add these files to the extra configuration parameter `guestinfo.ignition.config.data` in your VM.
2460
+
2561
For example, if you use a Linux operating system, you can use the `base64` command to encode the files.
2662
+
@@ -36,7 +72,7 @@ $ base64 -w0 <installation_directory>/worker.ign > <installation_directory>/work
3672
+
3773
[source,terminal]
3874
----
39-
$ base64 -w0 <installation_directory>/bootstrap.ign > <installation_directory>/bootstrap.64
75+
$ base64 -w0 <installation_directory>/merge-bootstrap.ign > <installation_directory>/merge-bootstrap.64
4076
----
4177
+
4278
[IMPORTANT]
@@ -129,13 +165,9 @@ $ govc vm.change -vm "<vm_name>" -e "guestinfo.afterburn.initrd.network-kargs=${
129165
+
130166
*** Optional: In the event of cluster performance issues, from the *Latency Sensitivity* list, select *High*.
131167
*** Click *Edit Configuration*, and on the *Configuration Parameters* window, click *Add Configuration Params*. Define the following parameter names and values:
132-
**** `guestinfo.ignition.config.data`: Paste the contents of the base64-encoded Ignition config file for this machine type. Note for the bootstrap node, the Ignition config file must be provided in `guestinfo.ignition.config.data` in the *Configuration Parameters* window. This is due to a restriction in the maximum size of data that can be provided in a vApp property.
168+
**** `guestinfo.ignition.config.data`: Locate the base-64 encoded files that you created previously in this procedure, and paste the contents of the base64-encoded Ignition config file for this machine type.
133169
**** `guestinfo.ignition.config.data.encoding`: Specify `base64`.
134170
**** `disk.EnableUUID`: Specify `TRUE`.
135-
*** Alternatively, prior to powering on the virtual machine, use vApp properties to:
136-
**** Navigate to a virtual machine from the vCenter Server inventory.
137-
**** On the *Configure* tab, expand *Settings* and select *vApp options.*
138-
**** Scroll down and under *Properties*, apply the configurations that you just edited.
139171
.. In the *Virtual Hardware* panel of the *Customize hardware* tab, modify the specified values as required. Ensure that the amount of RAM, CPU, and disk storage meets the minimum requirements for the
140172
machine type.
141173
.. Complete the configuration and power on the VM.

0 commit comments

Comments
 (0)