Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions _topic_maps/_topic_map.yml
Original file line number Diff line number Diff line change
Expand Up @@ -369,6 +369,8 @@ Topics:
File: installing-ibm-cloud-private
- Name: Installing a cluster on IBM Cloud in a disconnected environment
File: installing-ibm-cloud-restricted
- Name: Postinstallation configuration for a disconnected IBM Cloud cluster
File: installing-ibm-cloud-restricted-postinstallation-configuration
- Name: Installation configuration parameters for IBM Cloud
File: installation-config-parameters-ibm-cloud-vpc
- Name: Uninstalling a cluster on IBM Cloud
Expand Down
18 changes: 16 additions & 2 deletions installing/installing_ibm_cloud/installing-ibm-cloud-account.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -7,18 +7,32 @@ include::_attributes/common-attributes.adoc[]
toc::[]

[role="_abstract"]
Before you can install {product-title}, you must configure an {ibm-cloud-name} account.
Before you can install {product-title} on {ibm-cloud-name}, you must configure your account by setting up DNS, IAM policies, and an API key.

You must have an account with a subscription. You cannot install {product-title} on a free or trial {ibm-cloud-name} account.
You must have a subscription account; free or trial accounts are not supported.

include::modules/quotas-and-limits-ibm-cloud.adoc[leveloffset=+1]

include::modules/installation-ibm-cloud-dns-resolution-concept.adoc[leveloffset=+1]

include::modules/installation-cis-ibm-cloud.adoc[leveloffset=+2]

[role="_additional-resources"]
[id="additional-resources_installing-ibm-cloud-account-cis"]

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
[id="additional-resources_installing-ibm-cloud-account-cis"]

This type of "Additional resources" section does not use an anchor.

.Additional resources
* link:https://www.ibm.com/cloud/cli[{ibm-cloud-name} CLI ({ibm-cloud-name} documentation)]
* link:https://cloud.ibm.com/docs/dns?topic=dns-getting-started[{ibm-name} DNS documentation]
* link:https://cloud.ibm.com/catalog/services/internet-services[CIS web console ({ibm-cloud-name} documentation)]
* link:https://cloud.ibm.com/docs/cis?topic=cis-getting-started#configure-your-name-servers-with-the-registrar-or-existing-dns-provider[{ibm-cloud-name} documentation for configuring name servers]

include::modules/installation-dns-ibm-cloud.adoc[leveloffset=+2]

[role="_additional-resources"]
[id="additional-resources_installing-ibm-cloud-account-dns"]

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
[id="additional-resources_installing-ibm-cloud-account-dns"]

.Additional resources
* link:https://www.ibm.com/cloud/cli[{ibm-cloud-name} CLI ({ibm-cloud-name} documentation)]
* link:https://cloud.ibm.com/docs/dns?topic=dns-getting-started[{ibm-name} DNS documentation]

include::modules/installation-ibm-cloud-iam-policies-api-key.adoc[leveloffset=+1]

include::modules/installation-ibm-cloud-creating-api-key.adoc[leveloffset=+2]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,21 +6,22 @@ include::_attributes/common-attributes.adoc[]

toc::[]

In {product-title} version {product-version}, you can install a customized cluster
on {ibm-cloud-name} by using installer-provisioned infrastructure with customizations, including network configuration options. In each, you modify parameters in the `install-config.yaml` file before you install the cluster.
[role="_abstract"]
In {product-title} version {product-version}, you can install a customized cluster on {ibm-cloud-name} by using installer-provisioned infrastructure. Change parameters in the `install-config.yaml` file before you install the cluster.

By customizing your network configuration, your cluster can coexist with existing IP address allocations in your environment and integrate with existing MTU and VXLAN configurations.

You must set most of the network configuration parameters during installation, and you can modify only `kubeProxy` configuration parameters in a running cluster.
You must set most of the network configuration parameters during installation, and you can change only `kubeProxy` configuration parameters in a running cluster.

[id="prerequisites_installing-ibm-cloud-customizations"]
== Prerequisites
include::modules/prereqs-ibm-cloud-installer-provisioned.adoc[leveloffset=+1]

* You reviewed details about the xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes.
* You read the documentation on xref:../../installing/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users].
* You xref:../../installing/installing_ibm_cloud/installing-ibm-cloud-account.adoc#installing-ibm-cloud-account[configured an {ibm-cloud-name} account] to host the cluster.
* If you use a firewall, you xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[configured it to allow the sites] that your cluster requires access to.
* You configured the `ccoctl` utility before you installed the cluster. For more information, see xref:../../installing/installing_ibm_cloud/configuring-iam-ibm-cloud.adoc#configuring-iam-ibm-cloud[Configuring IAM for {ibm-cloud-name}].
[role="_additional-resources"]
.Additional resources
* xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update]
* xref:../../installing/overview/installing-preparing.adoc#installing-preparing[Selecting a cluster installation method and preparing it for users]
* xref:../../installing/installing_ibm_cloud/installing-ibm-cloud-account.adoc#installing-ibm-cloud-account[Configuring an {ibm-cloud-name} account]
* xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[Configuring your firewall]
* xref:../../installing/installing_ibm_cloud/configuring-iam-ibm-cloud.adoc#configuring-iam-ibm-cloud[Configuring IAM for {ibm-cloud-name}]

include::modules/cluster-entitlements.adoc[leveloffset=+1]

Expand Down Expand Up @@ -83,12 +84,7 @@ include::modules/cli-logging-in-kubeadmin.adoc[leveloffset=+1]
include::modules/cluster-telemetry.adoc[leveloffset=+1]

[role="_additional-resources"]
[id="additional-resources_installing-ibm-cloud-customizations-telemetry"]
.Additional resources
[id="additional-resources_installing-ibm-cloud-customizations"]
== Additional resources
* xref:../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster]
* xref:../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring]

[id="next-steps_installing-ibm-cloud-customizations"]
== Next steps
* xref:../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster].
* If necessary, you can
xref:../../support/remote_health_monitoring/remote-health-reporting.adoc#remote-health-reporting[Remote health reporting].

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this content not needed anymore? If I'm missing something, let me know. I can't tell from this PR why this file is being deleted.

This file was deleted.

28 changes: 13 additions & 15 deletions installing/installing_ibm_cloud/installing-ibm-cloud-private.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -6,16 +6,18 @@ include::_attributes/common-attributes.adoc[]

toc::[]

In {product-title} version {product-version}, you can install a private cluster into an existing VPC. The installation program provisions the rest of the required infrastructure, which you can further customize. To customize the installation, you modify parameters in the `install-config.yaml` file before you install the cluster.
[role="_abstract"]
In {product-title} version {product-version}, you can install a private cluster into an existing Virtual Private Cloud (VPC) on {ibm-cloud-name}. The installation program provisions the rest of the required infrastructure, which you can further customize.

[id="prerequisites_installing-ibm-cloud-private"]
== Prerequisites
include::modules/prereqs-ibm-cloud-installer-provisioned.adoc[leveloffset=+1]

* You reviewed details about the xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes.
* You read the documentation on xref:../../installing/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users].
* You xref:../../installing/installing_ibm_cloud/installing-ibm-cloud-account.adoc#installing-ibm-cloud-account[configured an {ibm-cloud-name} account] to host the cluster.
* If you use a firewall, you xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[configured it to allow the sites] that your cluster requires access to.
* You configured the `ccoctl` utility before you installed the cluster. For more information, see xref:../../installing/installing_ibm_cloud/configuring-iam-ibm-cloud.adoc#configuring-iam-ibm-cloud[Configuring IAM for {ibm-cloud-name}].
[role="_additional-resources"]
.Additional resources
* xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update]
* xref:../../installing/overview/installing-preparing.adoc#installing-preparing[Selecting a cluster installation method and preparing it for users]
* xref:../../installing/installing_ibm_cloud/installing-ibm-cloud-account.adoc#installing-ibm-cloud-account[Configuring an {ibm-cloud-name} account]
* xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[Configuring your firewall]
* xref:../../installing/installing_ibm_cloud/configuring-iam-ibm-cloud.adoc#configuring-iam-ibm-cloud[Configuring IAM for {ibm-cloud-name}]

include::modules/private-clusters-default.adoc[leveloffset=+1]

Expand Down Expand Up @@ -73,11 +75,7 @@ include::modules/cli-logging-in-kubeadmin.adoc[leveloffset=+1]
include::modules/cluster-telemetry.adoc[leveloffset=+1]

[role="_additional-resources"]
[id="additional-resources_installing-ibm-cloud-private-telemetry"]
.Additional resources
[id="additional-resources_installing-ibm-cloud-private"]
== Additional resources
* xref:../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster]
* xref:../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring]

[id="next-steps_installing-ibm-cloud-private"]
== Next steps
* xref:../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster].
* If necessary, you can xref:../../support/remote_health_monitoring/remote-health-reporting.adoc#remote-health-reporting[Remote health reporting].

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I assume this is already existing content that you are moving to its own assembly -- is that correct? If so, can you let me know where the content is coming from? If it's new content, it needs QE approval.

Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
:_mod-docs-content-type: ASSEMBLY
include::_attributes/common-attributes.adoc[]
[id="installing-ibm-cloud-restricted-postinstallation-configuration"]
= Postinstallation configuration for a disconnected {ibm-cloud-title} cluster
:context: installing-ibm-cloud-restricted-postinstallation-configuration

toc::[]

[role="_abstract"]
After you install a cluster on {ibm-cloud-name} in a disconnected environment, you must complete the postinstallation configuration steps to prepare the cluster for use.

include::modules/olm-restricted-networks-configuring-operatorhub.adoc[leveloffset=+1]

include::modules/oc-mirror-updating-restricted-cluster-manifests.adoc[leveloffset=+1]

include::modules/cluster-telemetry.adoc[leveloffset=+1]

[role="_additional-resources"]
[id="additional-resources_installing-ibm-cloud-restricted-postinstallation"]
== Additional resources

* xref:../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster]
* xref:../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring]
Loading