Applies to Pega Mobile Client versions 7.1 through 8
Prevent Mobile Build Service (MBS) failure by performing simple checks for connectivity, network, and firewall factors. Learn how to resolve MBS failure if it occurs.
Prerequisites
Checkpoints
When MBS fails
Invalid credentials
Related Content
Prerequisites
- Your Pega Mobile Build Service (MBS) account is ready.
- The URL for MBS in your Pega Platform DSS pega/mobilebuild/baseurl is set to
https://mobilebuildserver.pega.com/buildserver.
Checkpoints
Perform the following checks to ensure the success of the Mobile Build Service:
- Open the HTTPS traffic (port 443) for the domains mobilebuildserver.pega.com and s3.*.amazonaws.com.
The IP address that mobilebuildserver.pega.com is using might change and is not guaranteed.
Connectivity to an IP address must be enabled if not already opened.
To check the current IP address of the MBS use the following command:
dig +short mobilebuildserver.pega.com | grep -e "^[0-9]" - Verify that the connection from the Pega Platform to the MBS works and is not blocked by a firewall.
- Verify that the connection from Pega Platform to AWS S3 works and is not blocked by a firewall.
Use the following command inside the machine where Pega Platform returns no error:
curl -i https://s3.eu-north-1.amazonaws.com
Currently the service is using eu-north-1 region, but this might change in the future.
To retrieve the IP range of S3, use the following command:
curl https://ip-ranges.amazonaws.com/ip-ranges.json | jq -r '.prefixes[] | select(.region=="eu-north-1") | select(.service=="S3") | .ip_prefix'
For more information, see How can I find the IP address ranges used by Amazon S3?
- Make sure that the AWS certificate is trusted.
- Check for invalid credentials.
When MBS fails
If your MBS does not start or starts but fails after a few minutes or seconds, browse the mobility/pega logs section in the Pega Platform Dev Studio and read the logs. See Viewing logs.
The logs will likely indicate that the connection to MBS is blocked somewhere. Look for the following log error or similar error:
com.pega.pegarules.integration.mobile.internal.build.client.BuildServerConnectionException: Can't connect to build server because of i/o error
To resolve this error, perform the actions listed in Checkpoints.
Invalid credentials
If you specify invalid credentials in Admin Studio or have an incorrect configuration of the MobileBuildServerAuthentication authentication profile rule, you see the error message Incorrect Build Server authentication credentials in a mobile channel.
Confirm that credentials configured in Pega Platform are correct:
- Go to Admin Studio, click and check the provided account name and API key.
(This Admin Studio landing page is available for Pega Platform version 8.4 and later releases.) - If Step 1 does not resolve the credentials problem, open Dev Studio and click and open the MobileBuildServerAuthentication rule.
- Verify that the rule contains the following values for username and password:
For username: =D_pzMobileBuildServerAuthentication.pyUserName
For password: =D_pzMobileBuildServerAuthentication.pyPassword - If the MobileBuildServerAuthentication rule specifies the wrong username and password values, replace them with the correct values and save the rule.