mulesoft · dukesphere · Mar 24, 2022 · Oct 2, 2023 · Oct 2, 2023 · Oct 5, 2023
@@ -1,2 +1,2 @@
 #GUSINFO:MS CX Engineering,MS CX (DOCS)
-* @dukesphere @mulesoft/team-docs
+* @dmerlob @mulesoft/team-docs
@@ -4,3 +4,6 @@ version: '4.4'
 display_version: '4.4'
 nav:
 - modules/ROOT/nav.adoc
+asciidoc:
+  attributes:
+    supportStatus: extendedSupportVersion
@@ -1,6 +1,6 @@
-.xref:index.adoc[Mule Overview]
+.xref:index.adoc[Mule Runtime]
 * xref:whats-new-in-mule.adoc[What's New in Mule]
-* xref:index.adoc[Mule Overview]
+* xref:index.adoc[Overview]
 ** xref:mule-components.adoc[Mule Components]
 ** xref:about-flows.adoc[Flows and Subflows]
 ** xref:about-mule-configuration.adoc[Mule Configuration File]
@@ -31,7 +31,7 @@ include::partial$nav-app-dev.adoc[]
      *** xref:tuning-backend-server.adoc[Backend Server Response Time]
      *** xref:tuning-caching.adoc[Caching]
      *** xref:tuning-pooling-profiles.adoc[Pooling Profiles]
-     *** xref:tuning-domains.adoc[Domains]
+     *** xref:shared-resources.adoc[Domains]
      *** xref:tuning-logging.adoc[Logging]
      *** xref:tuning-batch-processing.adoc[Batch Processing]
      *** xref:tuning-app-design.adoc[App Design]
@@ -55,12 +55,6 @@ include::partial$nav-app-dev.adoc[]
  ** xref:maven-reference.adoc[Maven Reference]
 * xref:securing.adoc[Security]
  ** xref:secure-configuration-properties.adoc[Secure Configuration Properties]
- ** xref:cryptography.adoc[Cryptography Module]
-  *** xref:cryptography-pgp.adoc[PGP]
-  *** xref:cryptography-xml.adoc[XML]
-  *** xref:cryptography-jce.adoc[JCE]
-  *** xref:cryptography-reference.adoc[General Operations]
-  *** xref:cryptography-troubleshooting.adoc[Troubleshoot Cryptography Module]
  ** xref:fips-140-2-compliance-support.adoc[FIPS 140-2 Compliance Support]
  ** xref:setting-up-ldap-provider-for-spring-security.adoc[Configure LDAP Provider for Spring Security]
  ** xref:component-authorization-using-spring-security.adoc[Component Authorization Using Spring Security]

@@ -87,6 +87,27 @@ From the command line in your project's folder, package the application and exec
 mvn clean deploy -DmuleDeploy
 ----
 
+To deploy the artifact without rebuilding it, run:
+
+[source,bash,linenums]
+----
+mvn mule:deploy
+----
+
+=== Exchange Snapshot Assets
+
+You can also deploy Exchange snapshot assets into CloudHub 2.0. 
+
+By using `SNAPSHOT` version assets in Anypoint Exchange during the development and testing phase, you can avoid incrementing your application's version number for small changes. After your `SNAPSHOT` version application has been overwritten in Anypoint Exchange, you can redeploy your `SNAPSHOT` version application to CloudHub 2.0 via the Mule Maven plugin to deploy the latest changes.
+
+To learn more about publishing snapshot assets to Anypoint Exchange, see xref:exchange::to-publish-assets-maven.adoc#asset-lifecycle-state[Asset Lifecycle State].
+
+[NOTE]
+====
+Each time you update your application's snapshot, redeploy the application to refresh it with the latest snapshot binaries. 
+Because snapshot assets can change after deployment, avoid deploying them into your production environment.
+====
+
 == Redeploy to CloudHub 2.0
 
 To redeploy the application, run the same command as you did to deploy. +
@@ -126,7 +147,7 @@ Example values: `4.3.0`, `4.2.2-hf4` | Yes
 !===
 .2+! `scopeLoggingConfiguration`
 ! `scope` ! The package of the logging library to use.
-! `logLevel` ! The log level. Accepted values: `NONE`, `ERROR`, `WARN`, `INFO`, `DEBUG`, `TRACE`.
+! `logLevel` ! The log level. Accepted values: `INFO`, `DEBUG`, `WARN`, `ERROR`, `FATAL`.
 !===
 
 Configuration example:
@@ -145,8 +166,8 @@ Configuration example:
 ----
 | No
 | `target` | The CloudHub 2.0 target name to deploy the app to. +
-Specify either a shared space or a private space available in your Deployment Target values in CloudHub 2.0. See xref:cloudhub-2::ch2-features.adoc[Features of CloudHub 2.0] for a detailed description on shared and private spaces. Use a value from the xref:cloudhub-2::ch2-architecture.adoc#regions-and-dns-records[list of regions].| Yes
-| `provider` | Set to `MC`, for CloudHub 2.0. | Yes
+Specify either a shared space or a private space available in your Deployment Target values in CloudHub 2.0. See xref:cloudhub-2::ch2-features.adoc[Features of CloudHub 2.0] for a detailed description on shared and private spaces. Use a target name value from the xref:cloudhub-2::ch2-architecture.adoc#regions-and-dns-records[list of regions]. For example, `Cloudhub-US-East-1`. | Yes
+| `provider` | Provider MC (MuleSoft Control Plane) indicates that the deployment is managed through Anypoint Runtime Manager. Set to `MC` for CloudHub 2.0. | Yes
 | `environment` | Target Anypoint Platform environment. +
 This value must match an environment configured in your Anypoint Platform account, as shown here: +
 [source,xml,linenums]
@@ -158,7 +179,7 @@ This value must match an environment configured in your Anypoint Platform accoun
 | `vCores` | The size of each replica specified in vCores. Accepted values: `0.1`, `0.2`, `0.5`, `1`, `1.5`, `2`, `2.5`, `3`, `3.5`, `4`.
 See xref:cloudhub-2::ch2-architecture.adoc#cloudhub-2-replicas[CloudHub 2.0 Replicas] for a detailed description of available vCore sizes and their assigned hardware resources.
 
-| No
+| Yes (Only when `instanceType` isn't configured.)
 include::mule-runtime::partial$mmp-concept.adoc[tag=businessGroupParameterDescription]
 include::mule-runtime::partial$mmp-concept.adoc[tag=businessGroupIdParameterDescription]
 include::mule-runtime::partial$mmp-concept.adoc[tag=deploymentTimeoutParameterDescription]
@@ -204,7 +225,8 @@ Configuration example:
 [%header%autowidth.spread,cols=".^a,.^a"]
 |===
 |Parameter | Description
-| `enforceDeployingReplicasAcrossNodes` | Enforces the deployment of replicas across different nodes. The default value is `false`.
+| `enforceDeployingReplicasAcrossNodes` | Enforces the deployment of replicas across different nodes. The default value is `false`. +
+For high availability, set this value to `true`.
 
 Configuration example:
 [source,xml,linenums]
@@ -249,8 +271,8 @@ Configuration example:
 [cols=".^1,.^1,.^3"]
 !===
 .3+! `inbound`
-//  ! `pathRewrite` ! TBC.
-  ! `publicURL` ! URL of the deployed application.
+  ! `publicURL` ! URL of the deployed application. You can add multiple comma-separated values.
+  ! `pathRewrite` ! Supplies the base path expected by the HTTP listener in your application. This value must begin with `/`. This parameter is used only for applications that are deployed to xref:cloudhub-2::ch2-private-space-about.adoc[private space].
   ! `lastMileSecurity` ! Enable Last-Mile security to forward HTTPS connections to be decrypted by this application. This requires an SSL certificate to be included in the Mule application, and also requires more CPU resources. The default value is `false`.
   ! `forwardSslSession` ! Enables SSL forwarding during a session. The default value is `false`.
 !===
@@ -261,6 +283,7 @@ Configuration example:
   <http>
     <inbound>
       <publicUrl>https://myapp.anypoint.com</publicUrl>
+      <pathRewrite>/api</pathRewrite>
       <lastMileSecurity>true</lastMileSecurity>
       <forwardSslSession>true</forwardSslSession>
     </inbound>

@@ -99,6 +99,20 @@ From the command line in your project's folder, package the application and exec
 mvn clean deploy -DmuleDeploy
 ----
 
+=== Exchange Snapshot Assets
+
+You can also deploy Exchange snapshot assets into Runtime Fabric. 
+
+By using `SNAPSHOT` version assets in Anypoint Exchange during the development and testing phase, you can avoid incrementing your application's version number for small changes. After your `SNAPSHOT` version application has been overwritten in Anypoint Exchange, you can redeploy your `SNAPSHOT` version application to Runtime Fabric via the Mule Maven plugin to deploy the latest changes.
+
+To learn more about publishing snapshot assets to Anypoint Exchange, see xref:exchange::to-publish-assets-maven.adoc#asset-lifecycle-state[Asset Lifecycle State].
+
+[NOTE]
+====
+Each time you update your application's snapshot, redeploy the application to refresh it with the latest snapshot binaries. 
+Because snapshot assets can change after deployment, avoid deploying them into your production environment.
+====
+
 == Redeploy to Runtime Fabric
 
 To redeploy the application, run the same command as you did to deploy. +
@@ -129,11 +143,13 @@ If not set, defaults to +https://anypoint.mulesoft.com+. | No
 | `muleVersion` | The Mule runtime engine version to run in your Runtime Fabric instance.  +
 Ensure that this value is equal to or higher than the earliest required Mule version of your application. +
 Example values: `4.3.0`, `4.2.2-hf4` | Yes
+| `releaseChannel`| Set the name of the release channel used to select the Mule image. Supported values are `NONE`, `EDGE`, and `LTS`. By default, the value is set to `EDGE`. If the selected release channel doesn't exist, an error occurs. | No
+| `javaVersion` | Set the Java version used in the deploy. Supported values are `8` and `17`. By default, the value is set to `8`. If the selected Java version doesn't exist, an error occurs. | No
 | `username` | Your Anypoint Platform username | Only when using Anypoint Platform credentials to login.
 | `password` | Your Anypoint Platform password | Only when using Anypoint Platform credentials to login.
 | `applicationName` | The application name displayed in Runtime Manager after the app deploys. | Yes
 | `target` | The Runtime Fabric target name where to deploy the app. | Yes
-| `provider` | Set to `MC`, for Runtime Fabric. | Yes
+| `provider` | Provider MC (MuleSoft Control Plane) indicates that the deployment is managed through Anypoint Runtime Manager. Set to `MC` for Runtime Fabric. | Yes
 | `environment` | Target Anypoint Platform environment. +
 This value must match an environment configured in your Anypoint Platform account, as shown here: +
 [source,xml,linenums]
@@ -230,6 +246,7 @@ Configuration example:
   If a `reserved` configuration is present, ensure that this value is equal or higher.
 .2+! `memory`
   ! `reserved` ! Specifies the amount of memory to allocate for each application replica. The default value is 700 MB.
+  ! `limit` ! Specifies the maximum memory allocated per application replica. If a `reserved` configuration is present, ensure that this value is equal or higher.
 !===
 Configuration example:
 [source,xml,linenums]
@@ -299,6 +316,8 @@ Configuration example:
 
 | `generateDefaultPublicUrl` | When this parameter is set to true, Runtime Fabric generates a public URL for the deployed application.
 
+| `disableAmLogForwarding` | Disables the application-level log forwarding to Anypoint Monitoring. By default, it is set to `false`.
+
 |===
 // end::rtfDeploymentSettingsReference[]
 

@@ -1,6 +1,6 @@
 * xref:mule-app-dev.adoc[Develop Mule Applications]
-** xref:mule-app-dev-hellomule.adoc[Hello Mule Tutorial]
-** xref:mule-app-tutorial.adoc[Mule App Development Tutorial]
+** xref:mule-app-dev-hellomule.adoc[Tutorial: Create a "Hello World" Mule app]
+** xref:mule-app-tutorial.adoc[Tutorial: Create a Mule app that uses the Database Connector and DataWeave]
 ** xref:about-components.adoc[Core Components]
  *** xref:async-scope-reference.adoc[Async Scope]
  *** xref:batch-processing-concept.adoc[]
@@ -53,6 +53,7 @@
  *** xref:until-successful-scope.adoc[Until Successful Scope]
 ** xref:build-application-from-api.adoc[Build an Application from an API]
 ** xref:build-an-https-service.adoc[Build an HTTPS Service]
+** xref:http-connection-handling.adoc[Understand HTTP Connection Handling During Mule Runtime Shutdown]
 ** xref:global-elements.adoc[Configure Global Elements]
 ** xref:global-settings-configuration.adoc[Configure Global Settings]
 ** xref:configuring-properties.adoc[Configure Properties]

@@ -5,6 +5,8 @@
 // tag::BeforeYouBegin[]
 
 * xref:release-notes::mule-upgrade-tool/mule-upgrade-tool.adoc[The latest available version of Mule upgrade tool] so that the tool runs with the latest fixes and security enhancements.
++
+Download the Mule upgrade tool from the https://help.mulesoft.com/s/[Help Center^].
 * A currently operational Mule 4 instance in _stopped_ status to prepare for the upgrade.
 +
 For upgrades of Mule versions between 4.1.1 and 4.1.4 with the Mule upgrade tool, you must upgrade from any patch update released after January 20, 2022. Releases of versions 4.1.1 through 4.1.4 _before_ January 20, 2022 are not supported by the tool, and attempts to upgrade them produce an error message stating that the Mule version cannot be upgraded without first upgrading to a supported version (see xref:release-notes::mule-runtime/upgrade-update-mule.adoc[]).
@@ -15,6 +17,7 @@ The Mule upgrade tool requires the full distribution of the Mule runtime. Ensure
 Download Mule runtime distributions from the https://help.mulesoft.com/s/[Help Center^].
 * At least 2 GB of available disk space on the file system and access privileges to install the new Mule distribution.
 * (For Windows environments) The execution policy for Powershell scripts set to *Unrestricted*.
+* If Anypoint Monitoring agent is installed, uninstall it prior to the upgrade.
 // end::BeforeYouBegin[]
 
 // Upgrade Or Update Mule

@@ -124,7 +124,7 @@ All dependencies (JAR files, for example) declared in the application's `pom.xml
 
 Consider an application that uses Anypoint Connector for Java, and the connector needs to use a class that is part of a JAR dependency declared in the application's `pom.xml` file. However, this is not possible, because the connector's class loader is not able to find that class. To make this class visible to the connector, you must declare the dependency that contains the class as a shared library in the Mule Maven plugin configuration of your application's `pom.xml` file.
 
-If you use Anypoint Studio or Flow Designer to configure a connector that uses external libraries, the dependencies are automatically added as shared libraries. For example, if you add Anypoint Connector for Database to your application and then configure the connection driver using Anypoint Studio, the driver is automatically added as a shared library in your project's `pom.xml` file.
+If you use Anypoint Studio to configure a connector that uses external libraries, the dependencies are automatically added as shared libraries. For example, if you add Anypoint Connector for Database to your application and then configure the connection driver using Anypoint Studio, the driver is automatically added as a shared library in your project's `pom.xml` file.
 
 See xref:mmp-concept.adoc#configure-shared-libraries[Configure Shared Libraries] for configuration instructions.
 
@@ -144,5 +144,4 @@ See xref:mmp-concept.adoc#configure-plugin-dependencies[Configure Plugin Depende
 
 == See Also
 
-* xref:3.9@mule-runtime::classloader-control-in-mule.adoc[Mule 3 Class-loading]
-* xref:1.1@mule-sdk::isolation.adoc[Mule SDK - About Class-loading Isolation]
+* xref:mule-sdk::isolation.adoc[Mule SDK - About Class-loading Isolation]
@@ -8,21 +8,12 @@ building blocks of flows in a Mule app. Core components provide the logic
 for processing a Mule event as it travels in a series of linked steps through
 the app. Examples include the Scheduler, For Each, and Logger components.
 
-* In Studio, Mule components are accessible by clicking *Core* from the Mule palette.
+In Studio, Mule components are accessible by clicking *Core* from the Mule palette.
 +
 image::components-core-studio.png[Core Components in Studio]
 +
 Notice that the components are subdivided into types, including Batch,
 Error Handling, and Flow Control.
-+
-* In Design Center, when you are building a Mule app, you can find Mule
-components listed among *Modules* in the *Select a Component* dialog.
-+
-image::components-core-fd.png[Core Components in Design Center]
-+
-Design Center provides many of the Core components described below. Though the
-Design Center UI does not subdivide components into the types you see in the
-Studio UI, it can help to conceptualize them by those types.
 
 == Batch
 
@@ -55,7 +46,7 @@ data to a new output structure or format.
 
 == Endpoints
 
-Endpoints (sometimes called Sources in Studio or Triggers in Design Center) include 
+Endpoints (sometimes called Sources in Studio) include 
 components that initiate (or trigger) processing in a Mule flow. The 
 xref:scheduler-concept.adoc[Scheduler] is an endpoint. It triggers a flow to start 
 at a configurable interval.

@@ -12,7 +12,7 @@ An app can consist of a single flow, or it can break up processing into
 discrete flows and subflows that you add to the app and connect together. Mule
 apps in production environments typically use multiple flows and subflows
 to divide the app into functional modules or for
-<<error_handling, error-handling>> purposes. For example, one flow might
+<<error_handling, error handling>> purposes. For example, one flow might
 receive a record and transform data into a given format that another
 flow processes in some special way.
 
@@ -51,6 +51,7 @@ Because the contents of a subflow replace each Flow Reference component that ref
 
 For example, configuring a batch job inside a subflow causes the application to fail during deployment if the subflow is referenced from more than one Flow Reference component. The application fails to deploy because multiple instances of a batch job with the same job instance ID exist, which is not allowed.
 
+[[error_handling]]
 == Error Handling
 
 Each flow (but not subflow) can have its own error handling. One reason for

@@ -23,8 +23,8 @@ Global settings, such as the default transaction time-out, that apply to the ent
 Configuration Properties, message properties, and system properties.
 * xref:about-flows.adoc[Flows] +
 Combine components to define a message flow.
-* xref:about-components#_endpoints[Sources (Endpoints or Triggers)] +
-Trigger a flow. Sources are sometimes called Endpoints in Studio and Triggers in Flow Designer.
+* xref:about-components#_endpoints[Sources (Endpoints)] +
+Trigger a flow. Sources are sometimes called Endpoints in Studio.
 * xref:connectors::index.adoc[Connectors and Modules Configurations] +
 Declare configurations for any connectors and modules components used.
 * xref:about-components.adoc#_flow_control_routers[Routers] +

@@ -115,14 +115,19 @@ By default, Mule's batch jobs follow the first error handling strategy which hal
 
 [%header,cols="40a,30a,30a"]
 |===
-|Failed Record Handling Option 2+^|Batch Job
-| | *Attribute* | *Value*
-| Stop processing when a failed record is found.
-| `maxFailedRecords`|`0`
-| Continue processing indefinitely, regardless of the number of failed records.
-| `maxFailedRecords` |`-1`
-| Continue processing until reaching maximum number of failed records.
-| `maxFailedRecords` | `integer`
+|Failed Record Handling Option |Batch Job Attribute |Value
+
+|Stops processing when a failed record is found
+|`maxFailedRecords`
+|`0`
+
+|Continues processing indefinitely, regardless of the number of failed records
+|`maxFailedRecords`
+|`-1`
+
+|Continues processing until reaching the maximum number of failed records
+|`maxFailedRecords`
+|`integer`
 |===
 
 [source,xml,linenums]

@@ -76,7 +76,7 @@ Use this method if you want to start a project by either importing an existing R
 . In *API Implementation*, select *Specify API Definition File Location or URL*.
 . In *Location*, do one of the following:
 * If you created an `api.raml` file in Design Center, select *Design Center* . Login to Anypoint Platform if necessary, and select `api.raml`.
-* If you didn’t create a RAML file in Design Center, select *Browse Files* and select the RAML or WSDL file that you created in a text editor. For a WSDL file, select a service and port from the drop-down menus or accept the defaults.
+* If you didn't create a RAML file in Design Center, select *Browse Files* and select the RAML or WSDL file that you created in a text editor. For a WSDL file, select a service and port from the drop-down menus or accept the defaults.
 
 [start=6]
 . Accept the Location default options, and click *Finish*.