Configuring an Application in Oracle Internet of Things Cloud Service

Oracle by Example brandingConfiguring an Application in Oracle Internet of Things Cloud Service

section 0Before You Begin

This tutorial shows you how to configure an application in Oracle Internet of Things (IoT) Cloud Service. This tutorial takes approximately 15 minutes to complete.

Background

As you progress through this tutorial, you'll collect configuration data and use it in this tutorial, as well as in other tutorials that refer to this tutorial. The first time that configuration data appears, it's marked with an asterisk and a number. Subsequent references are marked only with the corresponding number. Use this spreadsheet to keep track of your data.

What Do You Need?

  • Access to an instance of Oracle IoT Cloud Service
  • A computer running Windows 7 or later, Apple macOS 10.9 or later, or Linux with a web browser
  • Familiarity with basic Oracle IoT Cloud Service management console operations

section 1Access Your Oracle IoT Cloud Service Instance

When you purchased your subscription to an Oracle IoT Cloud Service instance, you received an email that contained the URL, user name, and password to access the instance.

  1. In a web browser, enter the URL*1 for your Oracle IoT Cloud Service instance's management console. Typically, this URL has the following form: https://myinstance-myidentitydomain.iot.us.oraclecloud.com/ui.
  2. Enter your user name, password, and click Sign In.

section 2Create a Device Model

  1. On the Oracle IoT Cloud Service home page, under Applications, click Oracle IoT Asset Monitoring Cloud Service.
  2. Click Menu Action menu and then click Device Model.
  3. On the Device Model page, from the icon bar, click Add Add button.
  4. In the New Device Model page, enter the following values in the Details section:
    • Name: HelloWorld-DeviceModel
    • Description: Device model for the HelloWorld application
    • URN: urn:test:helloworld*2
    Device Model details
    Description of the illustration device_model_details.png
  5. In the Custom Attributes section, click Add Add button, and enter the following values:
    • Name: message*3
    • Description: This attribute stores the Hello World message
    • Type: String
    • Writable: Selected
    Custom attribute form
    Description of the illustration custom_attribute_form.png
  6. Click OK and then click Save.
    The attribute is saved and the Device Model page appears.

section 3Register a Device

  1. Click Menu Action menu, then beside Oracle IoT Asset Monitoring Application, click Previous,
  2. Beside Applications, click Previous, and then from the left menu bar, click Devices.
  3. From the Devices menu, click Registration, and then from the Single Registration section, click Register Single Device.
  4. On the Register Single Device page, enter the following values, and click Register:
    • Activation ID: HELLO-WORLD
    • Activation Secret: MySecret
    • Name: HelloWorldDevice
    • Manufacturer: Message Factory
    • Serial Number: 123456789
    • Model Number: M-12345
    Single Device Registration details page
    Description of the illustration single_device_details.png
    Note: You can leave the Activation Secret field blank for it to be automatically generated.
  5. Enter a password for the provisioning file in File Protection Password and confirm your password in Confirm Password, then click Download Provisioning File and save the file in your host system.
    Single Device Registration confirmation page
    Description of the illustration single_device_confirmation.png

    Take note of the Activation ID*4 which is the same as the Provisioning File Name and the File Protection Password*5 because you'll need these values to activate the device.
  6. Click Finish.

more informationWant to Learn More?