Skip to content

Commit 1ce575d

Browse files
committed
add restricted lpar installation
1 parent ef9f9c2 commit 1ce575d

33 files changed

+420
-65
lines changed

_topic_maps/_topic_map.yml

+2
Original file line numberDiff line numberDiff line change
@@ -405,6 +405,8 @@ Topics:
405405
File: installing-restricted-networks-ibm-z-kvm
406406
- Name: Installing a cluster in an LPAR on IBM Z and IBM LinuxONE
407407
File: installing-ibm-z-lpar
408+
- Name: Restricted network IBM Z installation in an LPAR
409+
File: installing-restricted-networks-ibm-z-lpar
408410
- Name: Installation configuration parameters for IBM Z and IBM LinuxONE
409411
File: installation-config-parameters-ibm-z
410412
- Name: Installing on IBM Power
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,144 @@
1+
:_mod-docs-content-type: ASSEMBLY
2+
[id="installing-restricted-networks-ibm-z-lpar"]
3+
= Installing a cluster in an LPAR on {ibm-z-title} and {ibm-linuxone-title} in a restricted network
4+
include::_attributes/common-attributes.adoc[]
5+
:context: installing-restricted-networks-ibm-z-lpar
6+
7+
toc::[]
8+
9+
[role="_abstract"]
10+
In {product-title} version {product-version}, you can install a cluster in a logical partition (LPAR) on
11+
{ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision in a restricted network.
12+
13+
[NOTE]
14+
====
15+
While this document refers to only {ibm-z-name}, all information in it also applies to {ibm-linuxone-name}.
16+
====
17+
18+
[IMPORTANT]
19+
====
20+
Additional considerations exist for non-bare metal platforms. Review the information in the
21+
link:https://access.redhat.com/articles/4207611[guidelines for deploying {product-title} on non-tested platforms] before you install an {product-title} cluster.
22+
====
23+
24+
== Prerequisites
25+
26+
* You reviewed details about the xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes.
27+
* You read the documentation on xref:../../installing/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users].
28+
* You xref:../../installing/disconnected_install/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[created a mirror registry for installation in a restricted network] and obtained the `imageContentSources` data for your version of {product-title}.
29+
* Before you begin the installation process, you must move or remove any existing installation files. This ensures that the required installation files are created and updated during the installation process.
30+
+
31+
[IMPORTANT]
32+
====
33+
Ensure that installation steps are done from a machine with access to the installation media.
34+
====
35+
* You provisioned xref:../../storage/persistent_storage/persistent-storage-ocs.adoc#persistent-storage-ocs[persistent storage using {rh-storage}] or other supported storage protocols for your cluster. To deploy a private image registry, you must set up persistent storage with `ReadWriteMany` access.
36+
* If you use a firewall and plan to use the Telemetry service, you xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall[configured the firewall to allow the sites] that your cluster requires access to.
37+
+
38+
[NOTE]
39+
====
40+
Be sure to also review this site list if you are configuring a proxy.
41+
====
42+
43+
include::modules/installation-about-restricted-network.adoc[leveloffset=+1]
44+
45+
include::modules/cluster-entitlements.adoc[leveloffset=+1]
46+
47+
[id="installation-requirements-user-infra_{context}"]
48+
== Requirements for a cluster with user-provisioned infrastructure
49+
50+
For a cluster that contains user-provisioned infrastructure, you must deploy all
51+
of the required machines.
52+
53+
This section describes the requirements for deploying {product-title} on user-provisioned infrastructure.
54+
55+
include::modules/installation-machine-requirements.adoc[leveloffset=+2]
56+
include::modules/installation-minimum-resource-requirements.adoc[leveloffset=+2]
57+
58+
[role="_additional-resources"]
59+
.Additional resources
60+
61+
* xref:../../scalability_and_performance/optimization/optimizing-storage.adoc#optimizing-storage[Optimizing storage]
62+
63+
include::modules/minimum-ibm-z-system-requirements.adoc[leveloffset=+2]
64+
include::modules/preferred-ibm-z-system-requirements.adoc[leveloffset=+2]
65+
include::modules/csr-management.adoc[leveloffset=+2]
66+
include::modules/installation-network-user-infra.adoc[leveloffset=+2]
67+
68+
[role="_additional-resources"]
69+
.Additional resources
70+
71+
* xref:../../installing/install_config/installing-customizing.adoc#installation-special-config-chrony_installing-customizing[Configuring chrony time service]
72+
73+
include::modules/installation-dns-user-infra.adoc[leveloffset=+2]
74+
75+
include::modules/installation-load-balancing-user-infra.adoc[leveloffset=+2]
76+
77+
include::modules/installation-infrastructure-user-infra.adoc[leveloffset=+1]
78+
79+
include::modules/installation-user-provisioned-validating-dns.adoc[leveloffset=+1]
80+
81+
include::modules/ssh-agent-using.adoc[leveloffset=+1]
82+
83+
//You extract the installation program from the mirrored content.
84+
85+
//You install the CLI on the mirror host.
86+
87+
include::modules/installation-initializing-manual.adoc[leveloffset=+1]
88+
89+
[role="_additional-resources"]
90+
.Additional resources
91+
* xref:../../installing/installing_ibm_z/installation-config-parameters-ibm-z.adoc#installation-config-parameters-ibm-z[Installation configuration parameters for {ibm-z-name}]
92+
93+
include::modules/installation-bare-metal-config-yaml.adoc[leveloffset=+2]
94+
95+
include::modules/installation-configure-proxy.adoc[leveloffset=+2]
96+
97+
include::modules/installation-three-node-cluster.adoc[leveloffset=+2]
98+
99+
include::modules/nw-operator-cr.adoc[leveloffset=+1]
100+
101+
include::modules/installation-user-infra-generate-k8s-manifest-ignition.adoc[leveloffset=+1]
102+
103+
include::modules/ibmz-configure-nbde-with-static-ip.adoc[leveloffset=+1]
104+
105+
[role="_additional-resources"]
106+
[id="additional-resources_Configure-nbde-ibm-z-lpar-restricted"]
107+
.Additional resources
108+
109+
* xref:../../installing/install_config/installing-customizing.adoc#installation-special-config-butane_installing-customizing[Creating machine configs with Butane]
110+
111+
include::modules/installation-ibm-z-user-infra-machines-iso.adoc[leveloffset=+1]
112+
113+
include::modules/installation-user-infra-machines-static-network.adoc[leveloffset=+2]
114+
115+
include::modules/installation-installing-bare-metal.adoc[leveloffset=+1]
116+
117+
include::modules/cli-logging-in-kubeadmin.adoc[leveloffset=+1]
118+
119+
include::modules/installation-approve-csrs.adoc[leveloffset=+1]
120+
121+
include::modules/installation-operators-config.adoc[leveloffset=+1]
122+
123+
include::modules/olm-restricted-networks-configuring-operatorhub.adoc[leveloffset=+2]
124+
125+
include::modules/installation-registry-storage-config.adoc[leveloffset=+2]
126+
127+
include::modules/registry-configuring-storage-baremetal.adoc[leveloffset=+3]
128+
129+
include::modules/installation-registry-storage-non-production.adoc[leveloffset=+3]
130+
131+
include::modules/installation-complete-user-infra.adoc[leveloffset=+1]
132+
133+
[role="_additional-resources"]
134+
.Additional resources
135+
136+
* link:https://access.redhat.com/solutions/4387261[How to generate SOSREPORT within {product-title} version 4 nodes without SSH].
137+
138+
[id="next-steps_ibmz-lpar-restricted"]
139+
== Next steps
140+
141+
* xref:../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster].
142+
* If the mirror registry that you used to install your cluster has a trusted CA, add it to the cluster by xref:../../openshift_images/image-configuration.adoc#images-configuration-cas_image-configuration[configuring additional trust stores].
143+
* If necessary, you can xref:../../support/remote_health_monitoring/opting-out-of-remote-health-reporting.adoc#opting-out-remote-health-reporting_opting-out-remote-health-reporting[opt out of remote health reporting].
144+
* If necessary, see xref:../../support/remote_health_monitoring/opting-out-of-remote-health-reporting.adoc#insights-operator-register-disconnected-cluster_opting-out-remote-health-reporting[Registering your disconnected cluster]

installing/installing_ibm_z/preparing-to-install-on-ibm-z.adoc

+3-5
Original file line numberDiff line numberDiff line change
@@ -43,8 +43,8 @@ The {product-title} installation program offers the following methods for deploy
4343
|
4444

4545
|Restricted network {ibm-z-name} with z/VM
46-
|
4746
|✓
47+
|
4848
|xref:../../installing/installing_ibm_z/installing-restricted-networks-ibm-z.adoc#installing-restricted-networks-ibm-z[✓]
4949
|
5050

@@ -55,8 +55,8 @@ The {product-title} installation program offers the following methods for deploy
5555
|
5656

5757
|Restricted network {ibm-z-name} with {op-system-base} KVM
58-
|
5958
|✓
59+
|
6060
|xref:../../installing/installing_ibm_z/installing-restricted-networks-ibm-z-kvm.adoc#installing-restricted-networks-ibm-z-kvm[✓]
6161
|
6262

@@ -94,6 +94,4 @@ The steps for performing a user-provisioned infrastructure installation are prov
9494

9595
* **xref:../../installing/installing_ibm_z/installing-ibm-z-lpar.adoc#installing-ibm-z-lpar[Installing a cluster in an LPAR on {ibm-z-name} and {ibm-linuxone-name}]**: You can install {product-title} in a logical partition (LPAR) on {ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision.
9696

97-
// Add link when creating assembly
98-
// * **xref:../../installing/installing_ibm_z/installing-restricted-networks-ibm-z-lpar.adoc#installing-restricted-networks-ibm-z-lpar[Installing a cluster in an LPAR on {ibm-z-name} and {ibm-linuxone-name} in a restricted network]**:
99-
* **Installing a cluster in an LPAR on {ibm-z-name} and {ibm-linuxone-name} in a restricted network**: You can install {product-title} in an LPAR on {ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision in a restricted or disconnected network, by using an internal mirror of the installation release content. You can use this method to install a cluster that does not require an active internet connection to obtain the software components. You can also use this installation method to ensure that your clusters only use container images that satisfy your organizational controls on external content.
97+
* **xref:../../installing/installing_ibm_z/installing-restricted-networks-ibm-z-lpar.adoc#installing-restricted-networks-ibm-z-lpar[Installing a cluster in an LPAR on {ibm-z-name} and {ibm-linuxone-name} in a restricted network]**: You can install {product-title} in an LPAR on {ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision in a restricted or disconnected network, by using an internal mirror of the installation release content. You can use this method to install a cluster that does not require an active internet connection to obtain the software components. You can also use this installation method to ensure that your clusters only use container images that satisfy your organizational controls on external content.

modules/cli-logging-in-kubeadmin.adoc

+5
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,11 @@
4949
// * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc
5050
// * installing/installing_vsphere/installing-restricted-networks-installer-provisioned-vsphere.adoc
5151
// * installing/installing_ibm_z/installing-ibm-z.adoc
52+
// * installing/installing_ibm_z/installing-restricted-networks-ibm-z.adoc
53+
// * installing/installing_ibm_z/installing-ibm-z-kvm.adoc
54+
// * installing/installing_ibm_z/installing-restricted-networks-ibm-z-kvm.adoc
55+
// * installing/installing_ibm_z/installing-ibm-z-lpar.adoc
56+
// * installing/installing_ibm_z/installing-restricted-networks-ibm-z-lpar.adoc
5257
// * installing/installing-restricted-networks-azure-installer-provisioned.adoc
5358
// * installing/installing_azure/installing-restricted-networks-azure-user-provisioned.adoc
5459

modules/cluster-entitlements.adoc

+8
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,8 @@
2121
// * installing/installing_ibm_z/installing-ibm-z-kvm.adoc
2222
// * installing/installing_ibm_z/installing-restricted-networks-ibm-z.adoc
2323
// * installing/installing_ibm_z/installing-ibm-z.adoc
24+
// * installing/installing_ibm_z/installing-restricted-networks-ibm-z-lpar.adoc
25+
// * installing/installing_ibm_z/installing-ibm-z-lpar.adoc
2426
// * installing/installing_azure/installing-azure-vnet.adoc
2527
// * installing/installing_azure/installing-azure-user-infra.adoc
2628
// * installing/installing_azure_stack_hub/installing-azure-stack-hub-default.adoc
@@ -95,6 +97,9 @@ endif::[]
9597
ifeval::["{context}" == "installing-restricted-networks-ibm-z-kvm"]
9698
:restricted:
9799
endif::[]
100+
ifeval::["{context}" == "installing-restricted-networks-ibm-z-lpar"]
101+
:restricted:
102+
endif::[]
98103
ifeval::["{context}" == "installing-restricted-networks-ibm-power"]
99104
:restricted:
100105
endif::[]
@@ -166,6 +171,9 @@ endif::[]
166171
ifeval::["{context}" == "installing-restricted-networks-ibm-z-kvm"]
167172
:!restricted:
168173
endif::[]
174+
ifeval::["{context}" == "installing-restricted-networks-ibm-z-lpar"]
175+
:!restricted:
176+
endif::[]
169177
ifeval::["{context}" == "installing-restricted-networks-ibm-power"]
170178
:!restricted:
171179
endif::[]

modules/csr-management.adoc

+2
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@
1616
// installing/installing_ibm_z/installing-ibm-z.adoc
1717
// installing/installing_ibm_z/installing-restricted-networks-ibm-z-kvm.adoc
1818
// installing/installing_ibm_z/installing-restricted-networks-ibm-z.adoc
19+
// installing/installing_ibm_z/installing-ibm-z-lpar.adoc
20+
// installing/installing_ibm_z/installing-restricted-networks-ibm-z-lpar.adoc
1921
// installing/installing_platform_agnostic/installing-platform-agnostic.adoc
2022
// machine_management/adding-rhel-compute.adoc
2123
// machine_management/more-rhel-compute.adoc

modules/ibmz-configure-nbde-with-static-ip.adoc

+14
Original file line numberDiff line numberDiff line change
@@ -4,19 +4,27 @@
44
// * installing/installing_ibm_z/installing-restricted-networks-ibm-z.adoc
55
// * installing/installing_ibm_z/installing-ibm-z-kvm.adoc
66
// * installing/installing_ibm_z/installing-restricted-networks-ibm-z-kvm.adoc
7+
// * installing/installing_ibm_z/installing-ibm-z-lpar.adoc
8+
// * installing/installing_ibm_z/installing-restricted-networks-ibm-z-lpar.adoc
79

810
ifeval::["{context}" == "installing-ibm-z"]
911
:ibm-z:
1012
endif::[]
1113
ifeval::["{context}" == "installing-ibm-z-kvm"]
1214
:ibm-z-kvm:
1315
endif::[]
16+
ifeval::["{context}" == "installing-ibm-z-lpar"]
17+
:ibm-z:
18+
endif::[]
1419
ifeval::["{context}" == "installing-restricted-networks-ibm-z"]
1520
:ibm-z:
1621
endif::[]
1722
ifeval::["{context}" == "installing-restricted-networks-ibm-z-kvm"]
1823
:ibm-z-kvm:
1924
endif::[]
25+
ifeval::["{context}" == "installing-restricted-networks-ibm-z-lpar"]
26+
:ibm-z:
27+
endif::[]
2028

2129
:_mod-docs-content-type: PROCEDURE
2230
[id="configuring-nbde-static-ip-ibmz-linuxone-environment_{context}"]
@@ -154,9 +162,15 @@ endif::[]
154162
ifeval::["{context}" == "installing-ibm-z-kvm"]
155163
:!ibm-z-kvm:
156164
endif::[]
165+
ifeval::["{context}" == "installing-ibm-z-lpar"]
166+
:!ibm-z:
167+
endif::[]
157168
ifeval::["{context}" == "installing-restricted-networks-ibm-z"]
158169
:!ibm-z:
159170
endif::[]
160171
ifeval::["{context}" == "installing-restricted-networks-ibm-z-kvm"]
161172
:!ibm-z-kvm:
162173
endif::[]
174+
ifeval::["{context}" == "installing-restricted-networks-ibm-z-lpar"]
175+
:!ibm-z:
176+
endif::[]

modules/installation-approve-csrs.adoc

+10-1
Original file line numberDiff line numberDiff line change
@@ -11,15 +11,18 @@
1111
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
1212
// * installing/installing_vsphere/installing-vsphere.adoc
1313
// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
14-
// * installing/installing_ibm_z/installing-ibm-z.adoc
1514
// * machine_management/adding-rhel-compute.adoc
1615
// * machine_management/more-rhel-compute.adoc
1716
// * machine_management/user_provisioned/adding-aws-compute-user-infra.adoc
1817
// * machine_management/user_provisioned/adding-bare-metal-compute-user-infra.adoc
1918
// * machine_management/user_provisioned/adding-vsphere-compute-user-infra.adoc
2019
// * post_installation_configuration/node-tasks.adoc
20+
// * installing/installing_ibm_z/installing-ibm-z.adoc
2121
// * installing/installing_ibm_z/installing-restricted-networks-ibm-z.adoc
2222
// * installing/installing_ibm_z/installing-ibm-z-kvm.adoc
23+
// * installing/installing_ibm_z/installing-restricted-networks-ibm-z-kvm.adoc
24+
// * installing/installing_ibm_z/installing-ibm-z-lpar.adoc
25+
// * installing/installing_ibm_z/installing-restricted-networks-ibm-z-lpar.adoc
2326
// * installing/installing_ibm_z/installing-ibm-power.adoc
2427
// * installing/installing_ibm_z/installing-restricted-networks-ibm-power.adoc
2528
// * installing/installing_azure/installing-restricted-networks-azure-user-provisioned.adoc
@@ -29,6 +32,9 @@
2932
ifeval::["{context}" == "installing-ibm-z"]
3033
:ibm-z:
3134
endif::[]
35+
ifeval::["{context}" == "installing-ibm-z-lpar"]
36+
:ibm-z:
37+
endif::[]
3238
ifeval::["{context}" == "installing-ibm-z-kvm"]
3339
:ibm-z-kvm:
3440
endif::[]
@@ -219,6 +225,9 @@ endif::[]
219225
ifeval::["{context}" == "installing-ibm-z-kvm"]
220226
:!ibm-z-kvm:
221227
endif::[]
228+
ifeval::["{context}" == "installing-ibm-z-lpar"]
229+
:!ibm-z:
230+
endif::[]
222231
ifeval::["{context}" == "creating-multi-arch-compute-nodes-ibm-power"]
223232
:!ibm-power:
224233
endif::[]

0 commit comments

Comments
 (0)