mulesoft / docs-mule-runtime

Contributions Welcome

Before creating a pull request review the following:

• LICENSE.txt

• SECURITY.adoc

• CODE_OF_CONDUCT.adoc

When you submit your pull request, you are asked to sign a contributor license agreement (CLA) if we don’t have one on file for you.

docs-mule-runtime's Issues

Getting delta in output while using mule test console

%dw 2.0
import * from dw::core::Arrays
output application/json
var arr = [0,1,3,2,1]

arr dropWhile $ <= 3

Tried the above using the online dataweave : http://34.205.75.56:8081/
compiler 2.3.0
Output:
[
]

In the doc : https://docs.mulesoft.com/mule-runtime/4.3/dw-arrays-functions-dropwhile

Output:
[
3,
2,
1
]
Please check the same.
Regards,
Manuel George

DOCS-8713: Unable to include expression in Until successful Block[Max retries and Milliseconds between retries]

Hi ,
I have downloaded the latest anypoint 7.5 with 4.3.0 mule runtime.

I'm unable to put expression in the parameters of Until Successful block as it is throwing the error

"Expressions are not allowed in this field"

PFB the screenshot

Please let me know if any more plugin has to be added with the anypoint 7.5 download.
** I have kept both versions(7.4 and 7.5) in different drives..
Regards,
Manuel George

DOCS-10710 Predefined variable app.home is not docuemented

${app.home} does not appear on https://github.com/mulesoft/docs-mule-runtime/blob/v4.3/modules/ROOT/pages/dataweave-variables-context.adoc besides it works properly and it's a very used one.

Typo in `docs-mule-runtime/modules/ROOT/pages/studio-update-sites.adoc`

Typo in this doc

Firewal should be => Firewall

Secure-Configuration-Properties.jar does not exist

Attempting to download the secure-configuration-properties.jar file from the website yields a "resource not found".
Link to the article: https://docs.mulesoft.com/mule-runtime/4.4/secure-configuration-properties
Link to the download: https://docs.mulesoft.com/downloads/mule-runtime/4.2/secure-properties-tool.jar

"Edit on github" button doesn't appear in all pages

While trying to update https://docs.mulesoft.com/mule-runtime/4.1/until-successful-scope I looked for that button, which doesn't appear.

While loading the page, it seems to be there. After loading is finished, it disappeared.

Corrupted secure-properties-tool.jar file

Hi Team,

This document https://docs.mulesoft.com/mule-runtime/4.3/secure-configuration-properties leads the users to a corrupted version of secure-properties-tool.jar file.

** Corrupted. If you try to execute this one, you will get "no main manifest attribute".
https://docs.mulesoft.com/downloads/mule-runtime/4.2/secure-properties-tool.jar

** Good, but older, version.
https://docs.mulesoft.com/downloads/mule-runtime/4.1/secure-properties-tool.jar

Best Regards,

DOCS-8720: Add mule 4 section for reusable component

For studio 6 we have it in our docs how to share configuration fragments.

• https://docs.mulesoft.com/mule-runtime/3.9/sharing-custom-configuration-fragments
• https://docs.mulesoft.com/mule-runtime/3.9/sharing-custom-code
  It is a bit vague in some areas and doesn't show the users all the steps

But for studio 7, the only article about it is a document in the support site:

• https://support.mulesoft.com/s/article/How-to-add-a-call-to-an-external-flow-in-Mule-4
  This is one is much more detailed and shows step by step what needs to be done

We should have this content inside our documentation

Reconnection strategy doc should elaborate on flow sources

I read the modules/ROOT/pages/reconnection-strategy-about.adoc doc to find out how to configure reconnection strategies for a on-new-or-updated SFTP connector flow source.

The connector stops triggering after connection is lost instead of retrying on schedule.
I want the processing to be retried on each schedule. Can I accomplish this with reconnection strategy ? How ?

Can you update the documentation to elaborate on such cases ?

Mule Runtime Single Process Security

Mule runtime is capable of hosting multiple APIs in a single process by design.

It appears to me that if Java process is compromised an attacker can gain access to all data that Java process normally has access to. This includes access to configuration file that contains key used to decrypt encrypted properties files. An attacker potentially gains access to all of memory used by said compromised process.

How does MuleSoft runtime mitigate process compromise issue when multiple MuleSoft applications are co-located in the same environment?

The following is a specific example of a risk of single process impact on security of the system.

Let's say I have System level API as recommended by MuleSoft architectural diagrams. This system level API has access to Cosmos DB master key. Its one and only purpose is to query Cosmos DB for permission tokens. Process and Experience level APIs request resource tokens from System level API.

If the same Java process hosts Experience level API and System Level API, then if attacker successfully compromises Experience level API such attacker automatically compromises System level API due to the fact that it is the same Java process.

As far as I know standard mitigation practice is defense in depth. If system level API is implemented in another application, executed by another user and is possibly located on a different machine, then attacker does not automatically gain access to Cosmos Master Key after penetrating 1st API level (experience level API).

When I apply this strategy to MuleSoft it means that I have to deploy several MuleSoft cluster environments in production. These environments would have to be separated by security boundaries, which do seem to align well with Experience, Process and System APIs. That in tern means that we have to deploy 3 separate cluster environments in production. Am I correct or am I missing something?

Or is MuleSoft runtime somehow guarantees that co-located APIs don't get all compromised when Java process is compromised? Am I missing something?

I certainly would like to know what the security guarantees of MuleSoft product are and where the silver line is.

Thank you

Improve dataweave-memory-management

Hello,

I develop an API handling large amounts of data and tried to use features described in the following page without success:
dataweave-memory-management

Can you add usage examples ?
e.g. should com.mulesoft.dw.buffersize have a value of 123000 or 123m ?
What should we place in property com.mulesoft.dw.buffer.memory.monitoring ? enabled ?

Thank you,
Best regards,
Jonathan

DOCS-8706: Javadoc for Mule 4.3

I am looking for Javadoc for Mule 4.3, The only one available for a very long while is 4.1.1

Can someone please update the page?

Idempotent Message Validator parameters' table is not proportional

at the mentioned doc, the description has more space for default value than description, although it's set to have 35% of space (tried to modify this but having same results)

DOCS-10709 There is no "third example"

This doc references a "third example" (https://docs.mulesoft.com/mule-runtime/4.3/streaming-about#example_3) but #example_3 does not seem to exist.

DOCS-8427: wrong default value on "disallowConcurrentExecution" attribute on Scheduler endpoint

The default value in the docs is "true", however the actual default value is "false".

"disallowConcurrentExecution" is also incorrectly spelled.

Missing reference to Path Rewrite in CH2.0 mule-maven-plugin deployment options

In https://docs.mulesoft.com/mule-runtime/4.4/deploy-to-cloudhub-2#deployment-settings, the parameter to customize the https://docs.mulesoft.com/cloudhub-2/ch2-config-endpoints-paths#configure-different-paths i.e. Path Rewrite is missing.

However the same can be provided via pom.xml using the pathRewrite tag under deploymentSettings. Sample code below:

<deploymentSettings>
	<http>
		<inbound>
			<publicUrl>...</publicUrl>
			<pathRewrite>/api</pathRewrite>
			<forwardSslSession>false</forwardSslSession>
			<lastMileSecurity>false</lastMileSecurity>
		</inbound>
	</http>
</deploymentSettings>

Can the parameter be added to official docs as well given that its a crucial feature while migrating CH1.0 DLB url rewrites to CH2.0 ingress settings?

W-12213016 deploy-to-cloudhub missing "disableCloudHubLogs" flag

This PR introduced the disableCloudHubLogs flag, but it is not documented on the "Deploy Applications to CloudHub Using the Mule Maven Plugin"

mulesoft/mule-maven-plugin#607

AdoptOpenJDK is now Eclipse Temurin

Documentation should be updated to direct users to the Eclipse Temurin Java releases.

The AdoptOpenJDK project has moved to the Eclipse Foundation and rebranded as Adoptium.

Users of AdoptOpenJDK should now be directed to use Eclipse Adoptium (ref) to stay up to date with the latest security and functional fixes.

This is a supported Java runtime in Mule core, and is a drop-in replacement for the old AdoptOpenJDK.

DOCS-8702: Please add configuration example for MuleSoft’s Enterprise Repositories

Mule 3.9 doc has it at https://docs.mulesoft.com/mule-runtime/3.9/configuring-maven-to-work-with-mule-esb#referencing-mulesofts-enterprise-repositories

It works with Mule 4.2.2, but I want to have it in the official 4.2 doc.

DOCS-8719: Improve the indexOf documentation

docs-mule-runtime/modules/ROOT/pages/dw-arrays-functions-indexof.adoc

The documentation should state what indexOf returns if the toFind element is not in the array.

DOCS-6373: Documentation enhancements for slice, indexOf, and indexWhere functions (in DW Epic)

slice

Both drop and take describe what happens when a client provides numeric input that is outside of the bounds of the array. slice doesn't have this in its documentation.

Here's a draft I've put together for a blog I'm writing that describes this functionality. Assuming arr = [1,2,3,4,5]:

You may ask yourself what the rules are if you specify indexes that are out-of-bounds. For example, what happens if we take the arr defined above, but try to slice up to index 20?

slice(arr, 1, 20)
// Returns: [2,3,4,5]

So slice doesn't choke on that. Instead, it exhibits the same behavior as take.

What happens if we take the arr defined above, but try to begin the slice with a negative index?

slice(arr, -5, 3)
// Returns: [1,2,3]

So slice won't choke on that, either, exhibiting the same behavior as drop.

Finally, what happens if we completely mix up the inputs, so that the first index we provide is greater than the second index?

slice(arr, 10, 1)
// Returns: []

In this case, we get an empty Array.

indexOf and indexWhere

The documentation of these functions does not disclose what the client should expect if there is no match at all. A brief test showed that if there is no match found, both indexOf and indexWhere will return -1.

No example project, dead links everywhere

https://github.com/mulesoft/docs-mule-runtime/blob/2d0c4f59a037e5c36fbf41920d92d7df5fccd78c/modules/ROOT/pages/cache-scope.adoc contains a reference to Cache Scope with Salesforce Contacts. The project does not exist in anypoint exchange.

Instead or additionally, there exists a project Cache Scope with Fibonacci. The project contains an invalid file structure and cannot be checked out in the latest Anypoint Studio. https://eu1.anypoint.mulesoft.com/exchange/org.mule.examples/cache-scope-with-fibonacci/minor/1.4/

At the bottom of the page is a link to https://github.com/mulesoft/library-examples/blob/v1.4.0/cache-scope-with-fibonacci/README.md. Not even the repository exists anymore, let alone any project files.

DOCS-8714: In flat file schemas RecordType not specified in referenced elements

In dataWeave flat file schemas in referenced vs inline module.

While refering to elements segment specifier RecordType is not defined, which leads to ambiguity whether we are supposed to specify RecordType while refering or not.
Here is the snap where for segment RQH and RQF no RecordType is specified.

requires more clarity on explanation

https://docs.mulesoft.com/mule-runtime/4.5/setting-environment-variables
A more detailed description of using environment variables should be documented. for example on how to use the dev, test prod etc

DOCS-8708: No format examples for DataWeave Number Type

There are many examples about formatting dates and strings, but it would be great to see more documentation under the Number type.

Example, in DW 1.0, you could do as :number {format: "#.##"} to have the integer and 2 decimals.

Can you please add more examples about manipulating types, in this case, formatting? Thanks!

W-13623867: Deploy Applications to CloudHub | CloudHub Deployment Reference | objectStoreV2 - parameter available for which version of plugin

The doc

• Deploy Applications to CloudHub Using the Mule Maven Plugin | MuleSoft Documentation

Could have the text explaining after which version of plugin it's available to use property objectStoreV2, like the example from businessGroupId

https://docs.mulesoft.com/mule-runtime/latest/deploy-to-cloudhub#cloudhub-deploy-reference:~:text=This%20parameter%20is%20available%20in%20plugin%20version%203.2.7%20and%20later.

Reference for which version:

• Application deployment using maven fails with "Cannot find 'objectStoreV2' in class org.mule.tools.model.anypoint.CloudHubDeployment" error when using objectStoreV2 property in pom.xml | MuleSoft Help Center (help.mulesoft.com)

DOCS-11234: Missing example on The scheduler component can trigger only one flow at any given time

I have multiple jobs on my API that have currently the same schedule.
We use a scheduler for each job to be able to change the schedule whenever desired or deactivate a job temporarily.

Does "The scheduler component can trigger only one flow at any given time." mean I should space them ?

I believe examples would help to understand that sentence. Can you add some please ?

DOCS-8710: Possible suggestion for Async Scope

In case of https://github.com/mulesoft/docs-mule-runtime/blob/v4.2/modules/ROOT/pages/async-scope-reference.adoc

Suggestion to add any difference that it may have between Async scope on Mule 3 and 4.

Add Mule 4 syntax for exception types

the exception type examples in catch-exception-strategy.adoc throw errors in Mule 4

W-13623896: Deploy Applications to CloudHub | CloudHub Deployment Reference | disableCloudHubLogs - parameter available for which version of plugin

The doc

• Deploy Applications to CloudHub Using the Mule Maven Plugin | MuleSoft Documentation

Could have the text explaining after which version of plugin it's available to use property disableCloudHubLogs, like the example from businessGroupId

https://docs.mulesoft.com/mule-runtime/latest/deploy-to-cloudhub#cloudhub-deploy-reference:~:text=This%20parameter%20is%20available%20in%20plugin%20version%203.2.7%20and%20later.

Reference for which version:

• Mule Maven Plugin 3.8.1 Release Notes | MuleSoft Documentation (docs.mulesoft.com)