From d6e9df5489606154a9728c441a9f0ffa700b9ab6 Mon Sep 17 00:00:00 2001 From: Daniela Merlo Date: Tue, 21 Jul 2026 14:46:12 -0300 Subject: [PATCH 01/19] W-23527202-4.2.1-dm W-23527202-4.2.1-dm --- modules/ROOT/pages/index.adoc | 4 +- modules/ROOT/pages/install-checklist.adoc | 40 ++++++++++-------- modules/ROOT/pages/install-openshift.adoc | 30 +++++++++++++- modules/ROOT/pages/install-workflow.adoc | 2 +- modules/ROOT/pages/verify-nfs.adoc | 50 +++++++++++------------ 5 files changed, 80 insertions(+), 46 deletions(-) diff --git a/modules/ROOT/pages/index.adoc b/modules/ROOT/pages/index.adoc index 26f612b6..6e29f14b 100644 --- a/modules/ROOT/pages/index.adoc +++ b/modules/ROOT/pages/index.adoc @@ -3,10 +3,10 @@ ifndef::env-site,env-github[] include::_attributes.adoc[] endif::[] -Run and manage Mule apps on your local servers following your security policies by using Anypoint Platform Private Cloud Edition (Anypoint Platform PCE). Anypoint Platform PCE offers local MuleSoft control plane functionality, with no external system interactions or internet connectivity required, maintaining all data storage, processing, and transmission. +Run and manage Mule apps on your local servers following your security policies by using Anypoint Platform Private Cloud Edition (Anypoint Platform PCE). Anypoint Platform PCE offers local MuleSoft control plane functionality, with no external system interactions or internet connectivity required, maintaining all data storage, processing, and transmission. Anypoint Platform PCE uses Kubernetes for built-in high availability and scalability. While you can install it without deep Kubernetes knowledge, understanding these tools is essential for management and troubleshooting. -Anypoint Platform PCE version 4.x runs on enterprise-ready Kubernetes Red Hat OpenShift, Amazon EKS Anywhere (EKS-A), and Rancher Kubernetes Engine (RKE2). Additionally, it supports Java 17, in addition to Java 8 and 11. +Anypoint Platform PCE version 4.x runs on enterprise-ready Kubernetes Red Hat OpenShift and Rancher Kubernetes Engine (RKE2). Additionally, it supports Java 17, in addition to Java 8 and 11. For information about a previous version of Anypoint Platform PCE, select the version in the documentation sidebar. diff --git a/modules/ROOT/pages/install-checklist.adoc b/modules/ROOT/pages/install-checklist.adoc index f48d7fb2..0b03004f 100644 --- a/modules/ROOT/pages/install-checklist.adoc +++ b/modules/ROOT/pages/install-checklist.adoc @@ -6,21 +6,20 @@ endif::[] You can install Anypoint Platform Private Cloud Edition (Anypoint Platform PCE) version 4.x and later in the Kubernetes (K8s) cluster that you provision and manage. -MuleSoft performed installations on popular K8s providers, which are listed in the following sections. The hardware and software requirements for installing Anypoint Platform PCE on your chosen provider are dictated by that provider, unless otherwise specified in this document. +MuleSoft performed installations on popular K8s providers, which are listed in the following sections. The hardware and software requirements for installing Anypoint Platform PCE on your chosen provider are dictated by that provider, unless otherwise specified in this document. Before you begin, make sure that your organization’s operations, networking, and security teams review the listed infrastructure prerequisites. These include the K8s cluster, hardware, software, networking, NFS storage, container registry, installer node, and storage requirements. [NOTE] -==== +==== Contact MuleSoft Professional Services prior to installing Anypoint Platform PCE, as they are involved with your installation. -Installing Anypoint Platform PCE requires specific versions of operating systems, NFS, and other software. Most issues experienced with Anypoint Platform PCE occur because the required environment was not set up prior to installing or upgrading. +Installing Anypoint Platform PCE requires specific versions of operating systems, NFS, and other software. Most issues experienced with Anypoint Platform PCE occur because the required environment was not set up prior to installing or upgrading. ==== == Kubernetes Cluster Requirements * Supported Kubernetes providers: + - ** Amazon EKS Anywhere ** Amazon EKS ** Rancher Kubernetes Engine (RKE2) ** Red Hat OpenShift @@ -33,7 +32,7 @@ Installing Anypoint Platform PCE requires specific versions of operating systems [NOTE] -Running Anypoint Platform PCE workloads on K8s control plane nodes can degrade both Anypoint Platform PCE and cluster performance. +Running Anypoint Platform PCE workloads on K8s control plane nodes can degrade both Anypoint Platform PCE and cluster performance. == Hardware Requirements @@ -92,7 +91,6 @@ For more information, see the provider specific requirements: * https://docs.aws.amazon.com/eks/latest/userguide/create-cluster.html[Amazon EKS] + AWS EKS is only tested with default networking add-ons. -* https://anywhere.eks.amazonaws.com/docs/getting-started/baremetal/bare-prereq/[Amazon EKS Anywhere (EKS-A)] * https://docs.rke2.io/install/requirements#hardware[Rancher Kubernetes Engine (RKE2) - Hardware] * https://docs.redhat.com/en/documentation/openshift_container_platform/4.16/html/installation_overview/ocp-installation-overview[Red Hat OpenShift] * https://techdocs.broadcom.com/us/en/vmware-cis/vcf/vsphere-supervisor-services-and-standalone-components/latest/managing-vsphere-kubernetes-service/running-tkg-service-clusters/tkg-service-components.html[vSphere Kubernetes Service (VKS)] @@ -107,7 +105,6 @@ These are the requirements: For more information, see the provider specific requirements: * https://docs.aws.amazon.com/eks/latest/userguide/create-cluster.html[Amazon EKS] -* https://anywhere.eks.amazonaws.com/docs/getting-started/baremetal/bare-prereq/[Amazon EKS Anywhere (EKS-A)] * https://docs.rke2.io/install/requirements#operating-systems[Rancher Kubernetes Engine (RKE2) - Software] * https://docs.redhat.com/en/documentation/openshift_container_platform/4.16/html/installation_overview/ocp-installation-overview[Red Hat OpenShift] @@ -121,11 +118,23 @@ Use these ports to communicate with Anypoint Platform PCE: [%header%autowidth.spread] |=== -|Protocol |Port / Range|Purpose | Source | Destination -|TCP | 30080 | HTTP public access |Load balancer | Anypoint Platform PCE nodes -|TCP | 30443| HTTPS public access |Load balancer | Anypoint Platform PCE nodes -|TCP | 30889| Mule Runtime Websocket |Load balancer | Anypoint Platform PCE nodes -|TCP | 30883| Mule Runtime Authentication Service (for certificate renewals) |Load balancer | Anypoint Platform PCE nodes +|Protocol |Port / Range |Purpose |Source |Destination +|TCP/UDP |53 |Internal cluster DNS |localhost |localhost +|TCP |2379, 2380, 4001, 7001 |etcd distributed database |Anypoint Platform PCE nodes |Anypoint Platform PCE nodes +|TCP |4242 |Installer |Anypoint Platform PCE nodes |Anypoint Platform PCE nodes +|TCP |6443 |Kubernetes API Server |Anypoint Platform PCE nodes |Anypoint Platform PCE nodes +|TCP |9443 |HAProxy to load balance Kubernetes API Server |Anypoint Platform PCE nodes |Anypoint Platform PCE nodes +|TCP |9100 |Prometheus node-exporter |Anypoint Platform PCE nodes |Anypoint Platform PCE nodes +|TCP |10248, 10250 |Kubernetes Kubelet |Anypoint Platform PCE nodes |Anypoint Platform PCE nodes +|TCP |10249 |Kubernetes kube-proxy |localhost |localhost +|TCP |10251-10252 |Kubernetes controller-manager and scheduler |Anypoint Platform PCE nodes |Anypoint Platform PCE nodes +|TCP |10257-10259 |Kubernetes controller-manager and scheduler (secure) |Anypoint Platform PCE nodes |Anypoint Platform PCE nodes +|TCP |30000-32767 |Internal services port range |Anypoint Platform PCE nodes |Anypoint Platform PCE nodes +|TCP |8472 |Overlay VXLAN network |Anypoint Platform PCE nodes |Anypoint Platform PCE nodes +|TCP |30080 |HTTP public access |Load balancer |Anypoint Platform PCE nodes +|TCP |30443 |HTTPS public access |Load balancer |Anypoint Platform PCE nodes +|TCP |30889 |Mule Runtime Websocket |Load balancer |Anypoint Platform PCE nodes +|TCP |30883 |Mule Runtime Authentication Service (for certificate renewals) |Load balancer |Anypoint Platform PCE nodes |=== Anypoint Platform PCE nodes need to hit the platform API address on the load balancer via HTTPS. @@ -133,7 +142,6 @@ Anypoint Platform PCE nodes need to hit the platform API address on the load bal For more information, see the provider specific requirements: * https://docs.aws.amazon.com/eks/latest/userguide/eks-networking.html[Amazon EKS - Networking] -* https://anywhere.eks.amazonaws.com/docs/clustermgmt/networking/networking-and-security/[Amazon EKS Anywhere (EKS-A) - Networking] * https://docs.rke2.io/install/requirements#operating-systems[Rancher Kubernetes Engine (RKE2) - Networking] * https://docs.redhat.com/en/documentation/openshift_container_platform/4.16/html/networking/understanding-networking[Red Hat OpenShift - Networking] @@ -169,9 +177,9 @@ Before executing the `pcectl` binary for Anypoint Platform PCE 4.2, make sure th * Use a Linux based operating system * Use glibc (GNU C library) version 2.28 or higher + -To check the glibc version, run this command: +To check the glibc version, run this command: + ----- +---- ldd --version ---- @@ -194,7 +202,7 @@ gpg --version These are the requirements: -In Anypoint Platform PCE version 4.2 and later, all the persistent data is stored in the Persistent Volume Claims (PVCs). Kubernetes Storage Class commands the PVCs. +In Anypoint Platform PCE version 4.2 and later, all the persistent data is stored in the Persistent Volume Claims (PVCs). Kubernetes Storage Class commands the PVCs. These services use PVCs with minimum and default storage size: diff --git a/modules/ROOT/pages/install-openshift.adoc b/modules/ROOT/pages/install-openshift.adoc index 47f6fd10..e59b24ef 100644 --- a/modules/ROOT/pages/install-openshift.adoc +++ b/modules/ROOT/pages/install-openshift.adoc @@ -7,7 +7,7 @@ You must have an operational OpenShift cluster prior to installing Anypoint Plat Contact MuleSoft Professional Services to perform the installation of Anypoint Platform PCE. -[NOTE] +[NOTE] Anypoint Platform PCE 4.2.0 is installed and validated on OpenShift 4.16. == Configure the Openshift Environment @@ -55,6 +55,7 @@ volumes: - downwardAPI - emptyDir - ephemeral + - persistentVolume - persistentVolumeClaim - projected - secret @@ -86,9 +87,30 @@ subjects: - kind: ServiceAccount name: default namespace: pce-core + - kind: ServiceAccount + name: anypoint + namespace: pce-core - kind: ServiceAccount name: anypoint-install namespace: pce-core + - kind: ServiceAccount + name: anypoint-install-anypoint-services + namespace: pce-core + - kind: ServiceAccount + name: anypoint-install-cluster-ssl + namespace: pce-core + - kind: ServiceAccount + name: anypoint-install-namespaces-job + namespace: pce-core + - kind: ServiceAccount + name: anypoint-install-seaweedfs + namespace: pce-core + - kind: ServiceAccount + name: anypoint-prometheus-install + namespace: pce-core + - kind: ServiceAccount + name: anypoint-grafana-install + namespace: pce-core - kind: ServiceAccount name: anypoint-install namespace: dias @@ -163,6 +185,9 @@ subjects: - kind: ServiceAccount name: default namespace: anypoint-flash + - kind: ServiceAccount + name: default + namespace: design-center --- @@ -200,6 +225,7 @@ volumes: - downwardAPI - emptyDir - ephemeral + - persistentVolume - persistentVolumeClaim - projected - secret @@ -209,7 +235,6 @@ apiVersion: rbac.authorization.k8s.io/v1 kind: ClusterRole metadata: name: anypoint-scc-privileged - namespace: pce-core rules: - apiGroups: [ "security.openshift.io" ] resourceNames: @@ -328,6 +353,7 @@ subjects: namespace: monitoring ---- + Save this file as `openshift-scc.yaml` and apply it to the OpenShift cluster: [source] diff --git a/modules/ROOT/pages/install-workflow.adoc b/modules/ROOT/pages/install-workflow.adoc index 7fe5bb43..02893f43 100644 --- a/modules/ROOT/pages/install-workflow.adoc +++ b/modules/ROOT/pages/install-workflow.adoc @@ -123,7 +123,7 @@ monitoringAppConfiguration: -== Install Anypoint Platform PCE +== Install Anypoint Platform PCE After your infrastructure is correctly set up and you performed a pre-installation verification, MuleSoft Professional Services will assist you with the installation of Anypoint Platform PCE. diff --git a/modules/ROOT/pages/verify-nfs.adoc b/modules/ROOT/pages/verify-nfs.adoc index e3569cfe..63036a6e 100644 --- a/modules/ROOT/pages/verify-nfs.adoc +++ b/modules/ROOT/pages/verify-nfs.adoc @@ -59,8 +59,8 @@ NFS 4.x does not use the `portmapper` service. == Verify Required Port Is Open The NFS server requires port 2049 to be open for TCP and UDP. - -On each node, use netcat or a similar utility to verify that the required port is open. Netcat is a computer networking utility used to read and write to network connections using TCP or UDP. + +On each node, use netcat or a similar utility to verify that the required port is open. Netcat is a computer networking utility used to read and write to network connections using TCP or UDP. On each node, run: `nc -zv 2049` @@ -78,7 +78,7 @@ Ncat: 0 bytes sent, 0 bytes received in 0.01 seconds. == Verify NFS Server Is Mounted -On each node, mount the NFS server in a temporary directory. +On each node, mount the NFS server in a temporary directory. . Switch to root: + `sudo su` @@ -93,7 +93,7 @@ Perform careful analysis of your environment, both from the client and server po * Testing the performance and latency of your NFS server. Specifically, these operations will transfer data from the client (Anypoint Platform PCE environment) to the NFS server and measure how long each transfer takes. * Using the command `time dd if=/dev/zero of=/mnt/home/ bs= count=` to test NFS server performance while transferring files and specifying the following parameters: + -** Names `` +** Names `` ** Block size and number of blocks in the transfer: `` and ``, respectively. * Validating how Anypoint Platform PCE handles NFS file transfers. Perform read and write operations with both large (128MB) and small (80KB) files. @@ -105,22 +105,22 @@ Perform the following read and write tests using large files: * File size: 128 MB * Block size: 4 KB -* Number of blocks: 32768 +* Number of blocks: 32768 While the tests are running, different files are generated (one file per test). -. Create a directory in which to mount the NFS server: +. Create a directory in which to mount the NFS server: + ---- sudo su mkdir -p /mnt/home ---- -. Mount the NFS server: -+ +. Mount the NFS server: ++ ---- mount -t nfs4 -o proto=tcp,port=2049 : /mnt/home/ ---- -. Perform writes (five files of 128 MB each) on the NFS server: +. Perform writes (five files of 128 MB each) on the NFS server: + ---- time for i in {1..5}; do dd if=/dev/zero of=/mnt/home/greatfile$i.test bs=4k count=32768; done @@ -141,21 +141,21 @@ user 0m0.034s sys 0m0.792s ---- + -The `real` parameter in the test output should be less than 15 seconds. +The `real` parameter in the test output should be less than 15 seconds. ==== Validate Read Performance -. Unmount the NFS server: +. Unmount the NFS server: + ---- umount /mnt/home ---- -. Remount the NFS server: +. Remount the NFS server: + ---- mount -t nfs4 -o proto=tcp,port=2049 : /mnt/home/ ---- -. Perform reads from the NFS server by running the following command: +. Perform reads from the NFS server by running the following command: + ---- time for i in {1..5}; do dd if=/mnt/home/greatfile$i.test of=/dev/null bs=4k; done @@ -163,7 +163,7 @@ time for i in {1..5}; do dd if=/mnt/home/greatfile$i.test of=/dev/null bs=4k; do + The `real` parameter in the test output should be less than 15 seconds. -==== Clear the Caches +==== Clear the Caches Unmount the NFS server to clear out any caches: @@ -175,18 +175,18 @@ umount /mnt/home Test small files as you did large files but with these sizes: - * File size: 80 KB + * File size: 80 KB * Block size: 4 KB * Number of blocks: 20 - + Before starting the test, verify that the `/mnt/home` directory from the previous test is created. -. Mount the NFS server: -+ +. Mount the NFS server: ++ ---- mount -t nfs4 -o proto=tcp,port=2049 : /mnt/home/ ---- -. Perform writes (five files of 80 KB each) on the NFS server: +. Perform writes (five files of 80 KB each) on the NFS server: + ---- time for i in {1..30}; do dd if=/dev/zero of=/mnt/home/smallfile$i.test bs=4k count=20; done @@ -196,17 +196,17 @@ The `real` parameter in the test output should be around 2 seconds. ==== Validate Read Performance -. Unmount the NFS server: +. Unmount the NFS server: + ---- umount ---- -. Remount the NFS server: +. Remount the NFS server: + ---- mount -t nfs4 -o proto=tcp,port=2049 : /mnt/home/ ---- -. Perform reads from the NFS server: +. Perform reads from the NFS server: + ---- time for i in {1..30}; do dd if=/mnt/home/smallfile$i.test of=/dev/null bs=4k; done @@ -216,14 +216,14 @@ The important parameter in the test output is the `real` parameter, which should ==== Delete the Test Files -When you finish the performance testing, delete the test files. +When you finish the performance testing, delete the test files. -. Remove all generated files by running: +. Remove all generated files by running: + ---- rm -f /mnt/home/*.test ---- -. Unmount the NFS server: +. Unmount the NFS server: + ---- umount /mnt/home From 929c60ac4ddda57c035e1f67f4cc10225ab80678 Mon Sep 17 00:00:00 2001 From: natesmith47 <104576867+natesmith47@users.noreply.github.com> Date: Fri, 24 Jul 2026 14:39:18 -0400 Subject: [PATCH 02/19] Update install-workflow.adoc --- modules/ROOT/pages/install-workflow.adoc | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/modules/ROOT/pages/install-workflow.adoc b/modules/ROOT/pages/install-workflow.adoc index 7fe5bb43..8124825e 100644 --- a/modules/ROOT/pages/install-workflow.adoc +++ b/modules/ROOT/pages/install-workflow.adoc @@ -1,14 +1,15 @@ -= Installing Anypoint Platform Private Cloud Edition (Anypoint Platform PCE) += Installing/Upgrading Anypoint Platform Private Cloud Edition (Anypoint Platform PCE) :page-aliases: prereq-gravity-check.adoc The process to install Anypoint Platform Private Cloud Edition (Anypoint Platform PCE), consist of the following steps: +. Obtaining your Anypoint PCE installation distribution . Setting up and verifying your infrastructure . Performing a pre-installation verification -. Installing Anypoint Platform PCE +. Installing/Upgrading Anypoint Platform PCE [NOTE] -Contact MuleSoft Professional Services before performing the pre-installation verification and installation of Anypoint Platform PCE because they are involved in these processes. +Contract Mulesoft Processional Services or your Anypoint PCE Certified Partner to obtain your Anypoint PCE installation distribution and before performing the pre-installation verification and installation or upgrade of the Anypoint PCE Platform to ensure they are involved in these procedures. [NOTE] To install Anypoint Platform PCE on OpenShift, see xref:install-openshift.adoc[Installing Anypoint Platform PCE on OpenShift]. @@ -125,12 +126,19 @@ monitoringAppConfiguration: == Install Anypoint Platform PCE -After your infrastructure is correctly set up and you performed a pre-installation verification, MuleSoft Professional Services will assist you with the installation of Anypoint Platform PCE. +After your infrastructure is correctly set up and you performed a pre-installation verification, MuleSoft Professional Services or your Anypoint PCE Certified Partner will assist you with the installation of Anypoint Platform PCE. To install Anypoint Platform PCE, run this command: `./pcectl install --input-file /path/to/input.yaml --license-file /path/to/license.lic` +== Upgrade Anypoint Platform PCE + +After you have completed a pre-installation/upgrade verification, MuleSoft Professional Services or your Anypoint PCE Certified Partner will assist you with the upgrade of Anypoint Platform PCE. + +To upgrade Anypoint Platform PCE, run this command: + +`./pcectl upgrade /path/to/input.yaml --license-file /path/to/license.lic` == See Also From 455a7a8078d21e492b8c85a593b56e1b7be2179c Mon Sep 17 00:00:00 2001 From: natesmith47 <104576867+natesmith47@users.noreply.github.com> Date: Fri, 24 Jul 2026 14:43:17 -0400 Subject: [PATCH 03/19] Update nav.adoc --- modules/ROOT/nav.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index 3a5d38b9..db327b1c 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -5,8 +5,8 @@ * xref:install-checklist.adoc[Anypoint Platform PCE Prerequisites] ** xref:verify-nfs.adoc[NFS Prerequisites] *** xref:troubleshoot-nfs.adoc[Troubleshoot NFS Errors] -* xref:install-workflow.adoc[Installing Anypoint Platform PCE] -** xref:install-openshift.adoc[Installing Anypoint Platform PCE on OpenShift] +* xref:install-workflow.adoc[Installing/Upgrading Anypoint Platform PCE] +** xref:install-openshift.adoc[Installing/Upgrading Anypoint Platform PCE on OpenShift] * xref:config-workflow.adoc[Configuring Anypoint Platform PCE] ** xref:install-disable-local-user.adoc[Deleting the Local User after Installing Anypoint Platform PCE] ** xref:install-config-ldap-pce.adoc[Configuring an External Identity Provider in Anypoint Platform PCE] From 29b08c4825909186a201975dac00cadb912b0d98 Mon Sep 17 00:00:00 2001 From: natesmith47 <104576867+natesmith47@users.noreply.github.com> Date: Fri, 24 Jul 2026 14:54:45 -0400 Subject: [PATCH 04/19] Update install-openshift.adoc --- modules/ROOT/pages/install-openshift.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/ROOT/pages/install-openshift.adoc b/modules/ROOT/pages/install-openshift.adoc index ba3df43c..e317f0db 100644 --- a/modules/ROOT/pages/install-openshift.adoc +++ b/modules/ROOT/pages/install-openshift.adoc @@ -5,10 +5,10 @@ Before installing Anypoint Platform Private Cloud Edition (Anypoint Platform PCE [NOTE] You must have an operational OpenShift cluster prior to installing Anypoint Platform PCE. If you do not have one set up, refer to the OpenShift documentation for setup instructions. -Contact MuleSoft Professional Services to perform the installation of Anypoint Platform PCE. +Contact MuleSoft Professional Services or your Anypoint PCE Certified Partner to perform the installation or upgrade of Anypoint Platform PCE. [NOTE] -Anypoint Platform PCE 4.2.0 is installed and validated on OpenShift 4.16. +Anypoint Platform PCE 4.2.1 is installed and validated on OpenShift 4.18 and 4.20. == Configure the Openshift Environment From 8d4766aa4d9d888ef0c58278de62d54ebada6f3e Mon Sep 17 00:00:00 2001 From: natesmith47 <104576867+natesmith47@users.noreply.github.com> Date: Fri, 24 Jul 2026 14:59:18 -0400 Subject: [PATCH 05/19] Update install-openshift.adoc --- modules/ROOT/pages/install-openshift.adoc | 3 +++ 1 file changed, 3 insertions(+) diff --git a/modules/ROOT/pages/install-openshift.adoc b/modules/ROOT/pages/install-openshift.adoc index e317f0db..caf90043 100644 --- a/modules/ROOT/pages/install-openshift.adoc +++ b/modules/ROOT/pages/install-openshift.adoc @@ -10,6 +10,9 @@ Contact MuleSoft Professional Services or your Anypoint PCE Certified Partner to [NOTE] Anypoint Platform PCE 4.2.1 is installed and validated on OpenShift 4.18 and 4.20. +[NOTE] +It is not supported to upgrade from an existing Openshift PCE 4.1.x cluster that's been installed with full admin privilege to 4.2.1 with no admin scope. + == Configure the Openshift Environment To configure the OpenShift Environment, configure Security Context Constraints (SCC) and roles for Prometheus. From 5d27670480c6fcd44f243fe5c31ae4930b04615c Mon Sep 17 00:00:00 2001 From: natesmith47 <104576867+natesmith47@users.noreply.github.com> Date: Fri, 24 Jul 2026 15:00:51 -0400 Subject: [PATCH 06/19] Update upgrade.adoc --- modules/ROOT/pages/upgrade.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/upgrade.adoc b/modules/ROOT/pages/upgrade.adoc index 0cca8b3d..ee69f71b 100644 --- a/modules/ROOT/pages/upgrade.adoc +++ b/modules/ROOT/pages/upgrade.adoc @@ -1,4 +1,4 @@ -= Upgrading Anypoint Platform PCE v3.X to v4.X += Migrating Anypoint Platform PCE v3.X to v4.X ifndef::env-site,env-github[] include::_attributes.adoc[] endif::[] From 0934c25c4cd5dcd1f9babf3d90ab4d0dcf77bc7b Mon Sep 17 00:00:00 2001 From: natesmith47 <104576867+natesmith47@users.noreply.github.com> Date: Fri, 24 Jul 2026 15:01:29 -0400 Subject: [PATCH 07/19] Update nav.adoc --- modules/ROOT/nav.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index db327b1c..5d5a57ab 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -24,4 +24,4 @@ ** xref:config-studio.adoc[Configuring Anypoint Studio for Anypoint Platform PCE] ** xref:register-server.adoc[Troubleshooting Mule Runtime Engine Registration] ** xref:restarting-a-node.adoc[Updating Nodes] -* xref:upgrade.adoc[Upgrading Anypoint Platform PCE to v4.0] +* xref:upgrade.adoc[Migrating Anypoint Platform PCE to v4.x] From 54d039532fa55c0fdc9baf8edb753e03ee9c8194 Mon Sep 17 00:00:00 2001 From: natesmith47 <104576867+natesmith47@users.noreply.github.com> Date: Fri, 24 Jul 2026 15:05:39 -0400 Subject: [PATCH 08/19] Update upgrade.adoc --- modules/ROOT/pages/upgrade.adoc | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/modules/ROOT/pages/upgrade.adoc b/modules/ROOT/pages/upgrade.adoc index ee69f71b..c0a57fdd 100644 --- a/modules/ROOT/pages/upgrade.adoc +++ b/modules/ROOT/pages/upgrade.adoc @@ -3,9 +3,15 @@ ifndef::env-site,env-github[] include::_attributes.adoc[] endif::[] +[NOTE] +This procedure is also applicable if you need to migrate from PCE 4.x to PCE 4.x instead of an in-place upgrade. Replace the 3.x system with your source PCE 4.x system in the below notes. + +[NOTE] +Migrations should be + To migrate an Anypoint Platform Private Cloud Edition (Anypoint Platform PCE) deployment from version 3.x to 4.x, perform a full state backup on your existing source cluster (Cluster 1) and restore that data onto a newly provisioned target cluster (Cluster 2) running Anypoint Platform PCE 4.x. -Before proceeding, make sure that in your Anypoint PCE 3.x cluster, you have `ssh` access to your cluster nodes and the necessary `kubectl` permissions for both environments. +Before proceeding, make sure that in your source Anypoint PCE 3.x cluster, you have `ssh` access to your cluster nodes and the necessary `kubectl` permissions for both environments. == Configure Environment and Security Before generating the backup files, you must correctly identify the platform via DNS and secure it with valid certificates. From df2ae5f93ced9a7fca0ec86b9467258ea5081b04 Mon Sep 17 00:00:00 2001 From: natesmith47 <104576867+natesmith47@users.noreply.github.com> Date: Fri, 24 Jul 2026 15:06:26 -0400 Subject: [PATCH 09/19] Update install-openshift.adoc --- modules/ROOT/pages/install-openshift.adoc | 1 + 1 file changed, 1 insertion(+) diff --git a/modules/ROOT/pages/install-openshift.adoc b/modules/ROOT/pages/install-openshift.adoc index caf90043..3b87e972 100644 --- a/modules/ROOT/pages/install-openshift.adoc +++ b/modules/ROOT/pages/install-openshift.adoc @@ -5,6 +5,7 @@ Before installing Anypoint Platform Private Cloud Edition (Anypoint Platform PCE [NOTE] You must have an operational OpenShift cluster prior to installing Anypoint Platform PCE. If you do not have one set up, refer to the OpenShift documentation for setup instructions. +[NOTE] Contact MuleSoft Professional Services or your Anypoint PCE Certified Partner to perform the installation or upgrade of Anypoint Platform PCE. [NOTE] From b7394510fc7ec6826e45ef58f1d1fd620c500882 Mon Sep 17 00:00:00 2001 From: natesmith47 <104576867+natesmith47@users.noreply.github.com> Date: Fri, 24 Jul 2026 15:07:12 -0400 Subject: [PATCH 10/19] Update upgrade.adoc --- modules/ROOT/pages/upgrade.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/upgrade.adoc b/modules/ROOT/pages/upgrade.adoc index c0a57fdd..f6ac1ce8 100644 --- a/modules/ROOT/pages/upgrade.adoc +++ b/modules/ROOT/pages/upgrade.adoc @@ -7,7 +7,7 @@ endif::[] This procedure is also applicable if you need to migrate from PCE 4.x to PCE 4.x instead of an in-place upgrade. Replace the 3.x system with your source PCE 4.x system in the below notes. [NOTE] -Migrations should be +Contact MuleSoft Professional Services or your Anypoint PCE Certified Partner to perform a migration of your Anypoint Platform PCE. To migrate an Anypoint Platform Private Cloud Edition (Anypoint Platform PCE) deployment from version 3.x to 4.x, perform a full state backup on your existing source cluster (Cluster 1) and restore that data onto a newly provisioned target cluster (Cluster 2) running Anypoint Platform PCE 4.x. From 4cd4587386e9c09bb9030af385851a99ca11559b Mon Sep 17 00:00:00 2001 From: natesmith47 <104576867+natesmith47@users.noreply.github.com> Date: Fri, 24 Jul 2026 15:08:40 -0400 Subject: [PATCH 11/19] Update install-openshift.adoc --- modules/ROOT/pages/install-openshift.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/install-openshift.adoc b/modules/ROOT/pages/install-openshift.adoc index 3b87e972..9698a311 100644 --- a/modules/ROOT/pages/install-openshift.adoc +++ b/modules/ROOT/pages/install-openshift.adoc @@ -12,7 +12,7 @@ Contact MuleSoft Professional Services or your Anypoint PCE Certified Partner to Anypoint Platform PCE 4.2.1 is installed and validated on OpenShift 4.18 and 4.20. [NOTE] -It is not supported to upgrade from an existing Openshift PCE 4.1.x cluster that's been installed with full admin privilege to 4.2.1 with no admin scope. +It is not supported to upgrade from an existing Openshift PCE 4.1.x cluster that's been installed with full admin privilege to 4.2.1 with no admin scope. If this is your case, consult the following * xref:upgrade.adoc[Migrating Anypoint Platform PCE to v4.x] == Configure the Openshift Environment From 1e73943419aaffd8e2e42f68e59e528790040df2 Mon Sep 17 00:00:00 2001 From: natesmith47 <104576867+natesmith47@users.noreply.github.com> Date: Fri, 24 Jul 2026 15:09:22 -0400 Subject: [PATCH 12/19] Update install-openshift.adoc --- modules/ROOT/pages/install-openshift.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/install-openshift.adoc b/modules/ROOT/pages/install-openshift.adoc index 9698a311..f8ce5986 100644 --- a/modules/ROOT/pages/install-openshift.adoc +++ b/modules/ROOT/pages/install-openshift.adoc @@ -12,7 +12,7 @@ Contact MuleSoft Professional Services or your Anypoint PCE Certified Partner to Anypoint Platform PCE 4.2.1 is installed and validated on OpenShift 4.18 and 4.20. [NOTE] -It is not supported to upgrade from an existing Openshift PCE 4.1.x cluster that's been installed with full admin privilege to 4.2.1 with no admin scope. If this is your case, consult the following * xref:upgrade.adoc[Migrating Anypoint Platform PCE to v4.x] +It is not supported to upgrade from an existing Openshift PCE 4.1.x cluster that's been installed with full admin privilege to 4.2.1 with no admin scope. If this is your case, consult xref:upgrade.adoc[Migrating Anypoint Platform PCE to v4.x] == Configure the Openshift Environment From 1a8c8614d6bd94062b3a9195077aa244237921bd Mon Sep 17 00:00:00 2001 From: natesmith47 <104576867+natesmith47@users.noreply.github.com> Date: Fri, 24 Jul 2026 15:09:36 -0400 Subject: [PATCH 13/19] Update install-openshift.adoc --- modules/ROOT/pages/install-openshift.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/install-openshift.adoc b/modules/ROOT/pages/install-openshift.adoc index f8ce5986..d3e05908 100644 --- a/modules/ROOT/pages/install-openshift.adoc +++ b/modules/ROOT/pages/install-openshift.adoc @@ -12,7 +12,7 @@ Contact MuleSoft Professional Services or your Anypoint PCE Certified Partner to Anypoint Platform PCE 4.2.1 is installed and validated on OpenShift 4.18 and 4.20. [NOTE] -It is not supported to upgrade from an existing Openshift PCE 4.1.x cluster that's been installed with full admin privilege to 4.2.1 with no admin scope. If this is your case, consult xref:upgrade.adoc[Migrating Anypoint Platform PCE to v4.x] +It is not supported to upgrade from an existing Openshift PCE 4.1.x cluster that's been installed with full admin privilege to 4.2.1 with no admin scope. If this is your case, consult xref:upgrade.adoc[Migrating Anypoint Platform PCE to v4.x]. == Configure the Openshift Environment From 1ab93e5410abb328c7fc67ee5c759356de61f10a Mon Sep 17 00:00:00 2001 From: natesmith47 <104576867+natesmith47@users.noreply.github.com> Date: Fri, 24 Jul 2026 15:10:34 -0400 Subject: [PATCH 14/19] Update install-openshift.adoc --- modules/ROOT/pages/install-openshift.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/modules/ROOT/pages/install-openshift.adoc b/modules/ROOT/pages/install-openshift.adoc index d3e05908..6d8168aa 100644 --- a/modules/ROOT/pages/install-openshift.adoc +++ b/modules/ROOT/pages/install-openshift.adoc @@ -3,16 +3,16 @@ Before installing Anypoint Platform Private Cloud Edition (Anypoint Platform PCE) on OpenShift configure Security Context Constraints (SCC) to grant the required permissions for pods and create roles for Prometheus, allowing it to collect metrics from the services. After these configurations are complete, proceed with installing Anypoint Platform PCE. [NOTE] -You must have an operational OpenShift cluster prior to installing Anypoint Platform PCE. If you do not have one set up, refer to the OpenShift documentation for setup instructions. +Contact MuleSoft Professional Services or your Anypoint PCE Certified Partner to perform the installation or upgrade of Anypoint Platform PCE. [NOTE] -Contact MuleSoft Professional Services or your Anypoint PCE Certified Partner to perform the installation or upgrade of Anypoint Platform PCE. +You must have an operational OpenShift cluster prior to installing Anypoint Platform PCE. If you do not have one set up, refer to the OpenShift documentation for setup instructions. [NOTE] Anypoint Platform PCE 4.2.1 is installed and validated on OpenShift 4.18 and 4.20. [NOTE] -It is not supported to upgrade from an existing Openshift PCE 4.1.x cluster that's been installed with full admin privilege to 4.2.1 with no admin scope. If this is your case, consult xref:upgrade.adoc[Migrating Anypoint Platform PCE to v4.x]. +It is not supported to in-place upgrade from an existing Openshift PCE 4.1.x cluster that's been installed with full admin privilege to 4.2.1 or higher with no admin scope. If this is your case, consult xref:upgrade.adoc[Migrating Anypoint Platform PCE to v4.x]. == Configure the Openshift Environment From acab55ae8591e5799ac03e31057e00fb5732913c Mon Sep 17 00:00:00 2001 From: natesmith47 <104576867+natesmith47@users.noreply.github.com> Date: Fri, 24 Jul 2026 15:11:02 -0400 Subject: [PATCH 15/19] Update upgrade.adoc --- modules/ROOT/pages/upgrade.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/upgrade.adoc b/modules/ROOT/pages/upgrade.adoc index f6ac1ce8..4d19a530 100644 --- a/modules/ROOT/pages/upgrade.adoc +++ b/modules/ROOT/pages/upgrade.adoc @@ -4,7 +4,7 @@ include::_attributes.adoc[] endif::[] [NOTE] -This procedure is also applicable if you need to migrate from PCE 4.x to PCE 4.x instead of an in-place upgrade. Replace the 3.x system with your source PCE 4.x system in the below notes. +This procedure is also applicable if you need to migrate from PCE 4.x to PCE 4.x instead of an in-place upgrade. Replace the 3.x system with your source PCE 4.x system in the procedure below. [NOTE] Contact MuleSoft Professional Services or your Anypoint PCE Certified Partner to perform a migration of your Anypoint Platform PCE. From c4c1ec652ffd85bd415399b6bed4be7f5f1dbaab Mon Sep 17 00:00:00 2001 From: Daniela Merlo <97902112+dmerlob@users.noreply.github.com> Date: Mon, 27 Jul 2026 15:30:47 -0300 Subject: [PATCH 16/19] Update modules/ROOT/pages/install-workflow.adoc --- modules/ROOT/pages/install-workflow.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/install-workflow.adoc b/modules/ROOT/pages/install-workflow.adoc index 4bc7448e..0cb8767f 100644 --- a/modules/ROOT/pages/install-workflow.adoc +++ b/modules/ROOT/pages/install-workflow.adoc @@ -1,4 +1,4 @@ -= Installing/Upgrading Anypoint Platform Private Cloud Edition (Anypoint Platform PCE) += Installing or Upgrading Anypoint Platform Private Cloud Edition (Anypoint Platform PCE) :page-aliases: prereq-gravity-check.adoc The process to install Anypoint Platform Private Cloud Edition (Anypoint Platform PCE), consist of the following steps: From 750376ce4845675a00347aac5c259303d739deb1 Mon Sep 17 00:00:00 2001 From: Daniela Merlo <97902112+dmerlob@users.noreply.github.com> Date: Mon, 27 Jul 2026 15:30:52 -0300 Subject: [PATCH 17/19] Update modules/ROOT/pages/install-workflow.adoc --- modules/ROOT/pages/install-workflow.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/install-workflow.adoc b/modules/ROOT/pages/install-workflow.adoc index 0cb8767f..f5191497 100644 --- a/modules/ROOT/pages/install-workflow.adoc +++ b/modules/ROOT/pages/install-workflow.adoc @@ -6,7 +6,7 @@ The process to install Anypoint Platform Private Cloud Edition (Anypoint Platfor . Obtaining your Anypoint PCE installation distribution . Setting up and verifying your infrastructure . Performing a pre-installation verification -. Installing/Upgrading Anypoint Platform PCE +. Installing or Upgrading Anypoint Platform PCE [NOTE] Contract Mulesoft Processional Services or your Anypoint PCE Certified Partner to obtain your Anypoint PCE installation distribution and before performing the pre-installation verification and installation or upgrade of the Anypoint PCE Platform to ensure they are involved in these procedures. From c3e01efbc72667c9e69b86158196aeee2827a63d Mon Sep 17 00:00:00 2001 From: Daniela Merlo <97902112+dmerlob@users.noreply.github.com> Date: Mon, 27 Jul 2026 15:30:57 -0300 Subject: [PATCH 18/19] Update modules/ROOT/nav.adoc --- modules/ROOT/nav.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index 5d5a57ab..db3aedd1 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -5,7 +5,7 @@ * xref:install-checklist.adoc[Anypoint Platform PCE Prerequisites] ** xref:verify-nfs.adoc[NFS Prerequisites] *** xref:troubleshoot-nfs.adoc[Troubleshoot NFS Errors] -* xref:install-workflow.adoc[Installing/Upgrading Anypoint Platform PCE] +* xref:install-workflow.adoc[Installing or Upgrading Anypoint Platform PCE] ** xref:install-openshift.adoc[Installing/Upgrading Anypoint Platform PCE on OpenShift] * xref:config-workflow.adoc[Configuring Anypoint Platform PCE] ** xref:install-disable-local-user.adoc[Deleting the Local User after Installing Anypoint Platform PCE] From 5f4d2740ea312f4dd711f337cdedc023b87535ce Mon Sep 17 00:00:00 2001 From: Daniela Merlo <97902112+dmerlob@users.noreply.github.com> Date: Mon, 27 Jul 2026 15:31:03 -0300 Subject: [PATCH 19/19] Update modules/ROOT/nav.adoc --- modules/ROOT/nav.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index db3aedd1..07bb28f5 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -6,7 +6,7 @@ ** xref:verify-nfs.adoc[NFS Prerequisites] *** xref:troubleshoot-nfs.adoc[Troubleshoot NFS Errors] * xref:install-workflow.adoc[Installing or Upgrading Anypoint Platform PCE] -** xref:install-openshift.adoc[Installing/Upgrading Anypoint Platform PCE on OpenShift] +** xref:install-openshift.adoc[Installing or Upgrading Anypoint Platform PCE on OpenShift] * xref:config-workflow.adoc[Configuring Anypoint Platform PCE] ** xref:install-disable-local-user.adoc[Deleting the Local User after Installing Anypoint Platform PCE] ** xref:install-config-ldap-pce.adoc[Configuring an External Identity Provider in Anypoint Platform PCE]