Oracle IoT Cloud Service — How to Provision an IoT Enterprise Service Instance
This tutorial shows the quick steps required to provision an Oracle IoT Cloud Service instance.
It uses the Cloud Stack approach that’s a great and easy way to provide all the services and dependencies you may need for your Oracle IoT Cloud Service instance.
The Cloud Stack approach is interesting because it provides several standard out-of-the-box templates that accelerate your task as well as hide you from all the underlying complexities.
Templates transparently isolate you from the dependencies and required version matches that you would need to check and guarantee in order to have the proper services instances along their proper versions provisioned.
In case you want to learn more about the Oracle Cloud Stack approach and the available templates, please check this Oracle by Example quick guide — Getting Started with Oracle Cloud Stack.
So without further ado, let’s create our IoT Cloud Service instance.
- Sign in to Oracle Cloud:
- Open the subscription notification email sent by Oracle. Typically, this email includes the subject line Welcome to Oracle Cloud.
- Right-click the URL displayed in the My Services URL field and select Open in new tab.
- Copy the user name displayed in the Username field and then paste it into the User Name field.
- Copy the password displayed in the Temporary Password field and then paste it into the Password field.
- Click Sign In.
- If this is your first time accessing Oracle Cloud, create a new password and provide challenge questions to verify your access credentials. Click Submit after you create your password and provide your challenge questions.
- Click Continue if a welcome dialog appears.
From the main screen, select the hamburger user interface component at the top right corner of your screen (the one inside the red square below). You will see the right side actions bar with Dashboard option as the default, selected menu option.
Click on Services and scroll down until you see the IoT Enterprise menu list option and then select it.
You will see the Oracle Internet of Things Cloud — Enterprise page with the instances list (it’s still empty, no IoT service instances yet).
Here as quickly explained before, we have the option to create the IoT instance and provide all its dependencies manually one by one, or use the Oracle Cloud Stack approach, which is the easiest and less error prone way.
So let’s select the Oracle Cloud Stack option. Click on the tiny hamburguer user interface (UI) component on the top right corner (besides the Welcome! label, you will see the expanded drop down menu as shown below:
Scroll down to its last option, Cloud Stack, and select it. You will be taken to our Oracle Cloud Stack page.
Select the Templates tab, type IoT in the search input field and click the search icon or hit ENTER to find the IoT stack template.
You will see the results as below. Click the Oracle-IoT-Enterprise option from the results list just to see its contents.
Then you can see the compositions of our IoT-Enterprise stack with both the IoT Service topology (and its dependencies) as well as the IoT Enterprise stack template specification in YAML format.
YAML is a human-readable data serialization language. It is commonly used for configuration files.
In case you do not know what YAML is want to learn more you can check its site and documentation here.
You can export / save the specification in case you want, just click export for that. Anyway, that’s just to provide more clarify regarding the Oracle Cloud services that are part of our IoT Enterprise stack.
Let’s resume with the IoT instance provisioning process. Click Done and the previous templates list page will be shown again.
Select the (+) icon on the far right at the end of the Oracle-IoT-Enterprise option in order to start the effective instance creation steps based on our selected template.
- Enter the details as below in order to create your instance.
- Name: OracleIoTCSDemo
- Description: Any description or IoT CS demo as in the screen
- Template: Oracle-IoT-Enteprise (already selected)
- Notification email: your email address
- Tags: Any tags to group the services / resources, I used oracle as the grouping tag
- On Failure Retain Resources: In case there’s a failure and you want to retain the resources in order to accelerate the next try
- Installation Type: Development or Production
- Username for Cloud Services: The user ID for the related cloud services that will be created, including the IoT Cloud Service
- Password (to access all services in Stack): The password to access the services along the user ID above
- Confirm Password (to access all services in Stack): previous password confirmation
- SSH Public Key: your public key so that you can remotely SSH in order to access the environment
- Cloud Storage Container: The information for your Cloud Storage Container, it can be provided now with no previous creation. As an example I provided iotcs-OracleSampleSC as the container name, resulting in the URL https://uscom-east-1.storage.oraclecloud.com/v1/Storage-gse00014235/OracleSampleSC
- Cloud Storage Username: the user ID for this container, juarez.admin in the example
- Cloud Storage Password: the related password for the user ID just above
- Import private key: here you need to provide your private key file
- Create spare JCS instance: in case you want a spare JCS (Java Cloud Service) as shown in the previous topology diagram
- Enable IoT Device Simulator: check to enable the out-of-the-box IoT device simulator
- Content Storage Container: the same as above, you can reuse the previous one: https://uscom-east-1.storage.oraclecloud.com/v1/Storage-gse00014235/OracleSampleSC
- Use same credentials as Cloud Storage Container: to reuse the same credentials, that is, juarez.admin in the example
Now you can click Next.
You will see the confirmation page.
It is a lightweight data-interchange format that’s easy for humans to read and write as well as also easy for machines to parse and generate. It’s becoming one of the de-facto standards for modern architectures, solutions and MicroServices. You can check more about JSON here.
Just click the icon with the arrow down as shown above and the JSON file will be downloaded.
Now you can just click the Confirm button and your instance creation process will be started as shown below.
That’s it! Now you know how easy it is to provision an instance of our IoT Service! I hope you can build great things with the Oracle IoT Cloud Service!
Give it a try! Get Started with Oracle Cloud for Free!