Skip to main content
Documentation Hub

RainMaker Deployment Related Issues

I have completed the deployment of RainMaker Services but have not received any email regarding the deployment details. What should I do?​

  1. Check your junk folder. Verify whether the deployment details email has been filtered into your junk folder.

  2. Verify email sending configuration. If the email is not in your junk folder, further investigation is required: Ensure that you have correctly configured the email-sending service for the RainMaker region(s). Refer to the guide: Configure Simple Email Service.

  3. Confirm successful deployment. Verify that all required RainMaker components have been successfully deployed using the CloudFormation dashboard, as outlined in the deployment guide: Verification of Backend Deployment.

  4. Reset Superadmin password if necessary. If all required stacks are deployed successfully, you can reset the Superadmin password from the RainMaker dashboard.

    Steps to Reset the Password:

    1. Go to the RainMaker dashboard login page and click Forgot Password.

    2. Enter the registered Superadmin email ID. You will receive a verification code via email.

    3. Enter the verification code along with a new password.

    4. You can now log in to the RainMaker dashboard with your new credentials.

Getting the RainMaker API URL (Base URL)​

  1. Log in to the RainMaker dashboard using your admin credentials.

  2. Go to the Deployment Settings tab.

    Deployment details dashboard

  3. Identify the API Gateway type:

    1. REST gateway: The default, legacy gateway used for all deployments.

    2. HTTP gateway: A newly introduced, cost-effective gateway (about 70% cheaper).

    Note: This requires migrating users to a new pool. Follow the steps in the User Pool Migration Guide.

    caution

    The ESP API Rate Limiter add-on is not available when using the HTTP gateway. This may expose your API to intentional overload attacks by malicious users.

    For OAuth-only RainMaker, only the HTTP gateway is supported.

  4. Select your preferred API Endpoint.

  5. For any further inquiries, contact ESP RainMaker Support at esp-rainmaker-support@espressif.com.

ESP-RainMaker-Core deployment fails. What should I do?​

deployment_error_1

  1. Log in to the AWS console.

  2. In the AWS console, search for CloudFormation and select serverlessrepo-ESP-RainMaker-Core.

  3. Navigate to the Resources tab, search for espstatsinfo and click the associated stack link.

    deployment_error_2

  4. Open the Events tab and search for CREATE_FAILED status.

    deployment_error_3

  5. If the error matches the example above, the issue is related to lambda concurrency limits. You may need to raise a support ticket with AWS to resolve it.

Below are the steps for raising a Support ticket:

  1. Go to your AWS console and search for Support.

    support_1

  2. Click Create case.

    support_1a

  3. Select Service limit increase and then choose Lambda as Limit type, as shown below:

    support_2

  4. Fill in the case details:

    support_3

  5. Specify the request details:

    1. Select your deployment region
    2. Limit: Concurrent Requests (Expected Duration × Expected Requests per Second)
    3. New Limit Value: 1000

    support_4

  6. Add a Case Description.

    We are trying to deploy our product: https://rainmaker.espressif.com/. Since the current limit for concurrency is set to 10, we are not able to proceed with the deployment. Can you please set the concurrency limit to 1000?

  7. Submit the request.

I am not able to find the ESP-RainMaker-Base-API stack in CloudFormation.​

Answer

  • The ESP-RainMaker-Base-API stack is disabled after the initial deployment of RainMaker.
  • If you are cleaning up and redeploying the RainMaker, please contact the Espressif RainMaker team at esp-rainmaker-support@espressif.com to request access to the ESP-RainMaker-Base-API stack.
  • There is no need to upgrade the ESP-RainMaker-Base-API stack if you are only upgrading Rainmaker.

How to confirm if system is functional after the downtime for v3.1.0 upgrade.​

Answer

  1. Login to Aws management console
  2. Navigate to IoT Core AWS service
  3. From left hand menu, expand Security and click on Policies and then choose esp-rainmaker-iot-policy

esp-rainmaker-iot-policy

  1. If your Active Policy looks something like

this

then it means that your System is Working As Expected, there is No MQTT downtime and your devices are connected.

  1. If your Active Policy looks something like Connect only policy

this

then check which other Inactive version which looks like

this

Select that Inactive version and click on Set as Active

active

On this page