Troubleshooting

Use troubleshooting information to identify and address common issues that can occur when working with your Internet of Things (IoT) Platform.

Make sure you have the required permissions. An administrator grants access by creating the required policies. For more information, see Prerequisites and Policy Details for the Internet of Things (IoT) Platform.

Update your passwords

You may need to reset your database password when connecting to the database using APEX, or when connecting directly to the database using the Identity domain group.

Cause: If you are using APEX and you need to reset your password

If you configure access to view your IoT data in APEX, then two different users are created, a database user and an APEX Workspace Administrator user. These are two different users with the same user name and the same initial password. You can update the passwords for each user.

Remedy: Update your APEX database password

  1. Only an APEX workspace administrator can change the database user's password. Initially, the APEX workspace administrator uses your APEX database password to log in, and then follows these steps to change the database password.

    In APEX, log in to the IoT domain's Workspace as an administrator, using the following as the workspace name and database user name, with your current APEX database password.
    Note

    Use only capital letters for the <domain-short-id-from-device-host> and notice the two underscores.
    <domain-short-id-from-device-host>__WKSP
  2. Go to SQL Workshop, select SQL Commands.
  3. Confirm the <iot-domain-short-id-from-device-host>__WKSP schema is selected from the top right schema drop-down menu. Notice the schema contains two underscores.
  4. Use this SQL ALTER USER statement and the required REPLACE clause to change your database user's password:
    ALTER USER <workspace-administrator-user-name> IDENTIFIED BY "<new-password>" REPLACE "<old-password>";
  5. Select Run.
  6. Example results showing the password update:
    User altered.
    
    0.24 seconds

Remedy: Update your APEX password

To change your APEX password:
  • As an APEX workspace administrator, you can change the workspace admin password. After logging into APEX as an administrator, select the Set APEX Account Password option. For more information, see Resetting your password in APEX.
  • As an APEX user, when you log in to the APEX application for the first time, you will be prompted to change your APEX password. After your initial log in, you can reset your password on the APEX log in page.

Cause: Missing authorization when connecting directly to the database

If you establish a direct connection to the database using the following CLI command, and you don't have authorization to connect directly to the database, then you can create a new database password for the Identity domain group to connect.

For example, when you use the oci iot domain configure-direct-data-access command and the required parameters to configure an IoT domain's authentication to establish a direct database connection and you can not connect.

oci iot domain configure-direct-data-access --iot-domain-id <iot-domain-OCID> --db-allow-listed-identity-group-names '["<tenancy-OCID:<identity-domain-name>/<identity-group-name>"]'

or if you use this format:

oci iot domain configure-direct-data-access --iot-domain-id <iot-domain-OCID> --db-allow-listed-identity-group-names '["<tenancy-OCID:<identity-group-name>"]'

Remedy: Update the database password for the Identity domain user

Update your IAM Identity domain user's database password. To do that, log in to your IoT tenancy, and complete the following steps:
  1. Open the navigation menu, go to Identity & Management, select domains.
  2. On the domain list page, select the Identity domain that you want to work with and connect to an IoT domain.
  3. Select the User Management tab, select the user you want to update the password for. Select the Database Passwords tab, to update the password delete your current IAM database password and create a new IAM database password.

Use DTDL Specifications v3

Cause: Creating a digital twin model results in error

When you create a digital twin model if you get an error, confirm you are using only DTDL v3 specifications that are supported.

Remedy: Use only supported v3 DTDL specifications

When you define the digital twin model all DTDL v3 specifications are supported, except MQTT extensions and writable properties.

If a writable property is included in the digital twin model, it must be set to false.

Service Limits Exceeded

Troubleshoot IoT domain or IoT domain group resource service limits per region.

Cause: IoT resources limits per region

Internet of Things (IoT) Platform has limits on the number of resources per region.

If you try to create more than 2 IoT domains or more in an IoT domain group, then you may see the following error. For more information, see create an IoT domain or an IoT domain group.

The following service limits were exceeded: <resource-count>. Request a service limit increase from the service limits page in the console.

Note

Oracle restricts creating up to 2 IoT domains in each IoT domain group. The maximum number of IoT domain groups is 5 and maximum number IoT domains is 10 per region in your tenancy. To create an IoT domain your user must have read access for the associated IoT domain group.

Remedy: Upgrade and increase the limits

See Service Limits to review the limits for IoT resources. If you need to increase the limits, you can request a service limit increase.