Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Troubleshooting the Starter Packs

Updated on October 12, 2022

The following article covers the errors you might encounter when using the starter packs, the reason for the error, the starter pack in which the error occurs, and the resolution to implement. For more information on troubleshooting Pega Platform-related errors, see Troubleshooting Pega services and Support Guide.

Error code/error messageStarter packReasonResolution
401AllMismatching authentication type between the Infinity server configuration and the starter pack application configuration.Ensure that the authentication type is set correctly. Follow the instructions in the configuration-related documentation in the starter pack.

500  

 

Failed to generate com.pegarules.generated.html_harness.ra_action_confirm 

AllThis is a DX API-related error and occurs when the application is not compliant with the DX API or has non-DX API UI. This error is most likely to occur in Submit-related screens.  

Ensure that the application is DX API compliant.  

You can override the portion of the OTB application rules that are not compliant with the DX API, or change application-specific UI.   

To debug DX API errors, follow the procedures outlined in Debugging DX API.  

For more information about features supported by the Starter Pack, see Supported Features

Assignment <assignment ID> cannot be openedAngularThe application is unable to open the specified assignment.
  • Ensure that the assignment is accessible by the application.
  • Ensure that the assignment is configured only with the supported features. For more information about supported features, see Supported features.
ERR_SSL_PROTOCOL_ERROR AllThis issue occurs when using the Google Chrome browser and the local front-end server is configured with HTTP. Due to Google Chrome’s domain security policies, the browser automatically redirects to the HTTPS protocol.

Modify Google Chrome’s domain security policies to ignore localhost: 

  1. Close all instances of Google Chrome, and then load chrome://net-internals/#hsts. The Domain Security Policy settings opens.  

  2. Navigate to the Delete domain security policies section. 

  3. Enter localhost in the section’s text box, and then click Delete

  1. (Optional). Clear the browser cache. 

Failed to compileReactIncompatible version of React scripts.

Set the version of React scripts to the version specified in the starter pack. The latest React starter pack is meant to be using 4.0.3.

Note: Invoking npm audit fix —force has been known to change the React version to an earlier or later version which also results in the error.
Incorrect passwordAllInvalid or incorrect password.
  • Ensure that you enter the correct password.
  • If you are using the default password in an imported application, check whether the password was changed after the first login. 
Network error (CORS error)

React

Vue

The endpoint URL (PEGAURL or BASEURL) path in the endpoint file is not configured correctly, typically missing the /api/v1 part.

The browser displays Network error only, open the browser's Network tab for the endpoint to view the exact error. 

Ensure that the PEGAURL or BASEURL path is in the correct format:

<pega server path to servlet>/api/v1

For example: https://server.domain.com:port/prweb/api/v1
Network error (blocked:mixed-content)

React

Vue

The endpoint URL (PEGAURL or BASEURL) in the endpoint file is configured to use http:.. but you are trying to start a local server instance using the npm run starthttps command.

The browser displays Network error only, open the browser's Network tab for the endpoint to view the exact error. 

Use the npm start command to start the local server instance.

Network error (failed)

React

Vue

The connection to the configured server is incorrect.

The browser displays Network error only, open the browser's Network tab for the endpoint to view the exact error. 

  • If you are using a VPN, ensure that the VPN is connected correctly.
  • Ensure that the server host address is correct.
No next action to go toAngularThe GetNext call did not return any action.Ensure that the GetNext call is correctly configured with a supported action.
Pega_API_022: Use of TLS/SSL is required

All

The endpoint URL (PEGAURL or BASEURL) path in the endpoint file is configured to use http:.. but the service package is configured to use TLS/SSL. 

Update the path to use https:.

Unsupported actionAngularThe action set is not supported.Ensure that the action set to use is supported by the starter pack. For more information about supported features, see Supported features.
Your account has been disabled, contact your system administratorAllApplication's operators are disabled.The imported application's operators are disabled by default. For more information to enable operators, see the Troubleshooting section in CableConnect (sample application).

 

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us