Administering Oracle Internet of Things Cloud Service

Oracle® Cloud
Administering Oracle Internet of Things Cloud

Service
19.1.5
E80978-21
March 2019
Oracle Cloud Administering Oracle Internet of Things Cloud Service, 19.1.5
E80978-21
Copyright © 2017, 2019, Oracle and/or its affiliates. All rights reserved.
Primary Author: Oracle Corporation
This software and related documentation are provided under a license agreement containing restrictions on
use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your
license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify,
license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means.
Reverse engineering, disassembly, or decompilation of this software, unless required by law for
interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If
you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on
behalf of the U.S. Government, then the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software,
any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are
"commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-
specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the
programs, including any operating system, integrated software, any programs installed on the hardware,
and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.
No other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications.
It is not developed or intended for use in any inherently dangerous applications, including applications that
may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you
shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its
safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this
software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of
their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are
used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron,
the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro
Devices. UNIX is a registered trademark of The Open Group.
This software or hardware and documentation may provide access to or information about content, products,
and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly
disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise
set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be
responsible for any loss, costs, or damages incurred due to your access to or use of third-party content,
products, or services, except as set forth in an applicable agreement between you and Oracle.
Contents
Preface
Audience v
Documentation Accessibility v
Related Documents v
Conventions vi
1 Set Up Your Cloud Service Instance

Before You Use the Cloud Service 1-1
Using the ssh-keygen Utility to Generate an SSH Key Pair 1-2
Using the PuTTYgen Program to Generate an SSH Key Pair 1-2
Workflow for Implementing the Oracle Internet of Things Cloud Service 1-3
Create an Oracle Internet of Things Cloud Service Instance 1-4
Create an Oracle Internet of Things Cloud Service Instance with Analytics 1-7
Delete an Oracle Internet of Things Cloud Service Instance 1-9
Secure Your Data 1-10
Register a Custom Domain Name with a Third-Party Registration Vendor 1-10
Updating Your Application Environment to Use a Custom Domain Name 1-11
Getting an SSL Certificate from a Certificate Authority 1-12
Creating a Self-Signed SSL Certificate 1-14
Installing an SSL Certificate Provided by a Certificate Authority 1-15
Access the Management Console 1-16
2 Activating Oracle Internet of Things Cloud Service SaaS

Applications
Create an Oracle IoT Asset Monitoring Cloud Service Instance 2-1
Create an Oracle IoT Asset Monitoring CX Cloud Service Instance 2-4
Create an Oracle IoT Production Monitoring Cloud Service Instance 2-7
Create an Oracle IoT Fleet Monitoring Cloud Service Instance 2-10
Create an Oracle IoT Connected Worker Cloud Service Instance 2-13
Delete an Oracle Internet of Things Cloud Service SaaS Application 2-15
iii
3 Managing Users
Understand Oracle Internet of Things Cloud Service User Roles 3-1
Add a User Account 3-1
Edit a User Account 3-2
Reset a User Password 3-3
Search for a User Account 3-4
Remove a User Account 3-4
4 Manage Cloud Service Settings

Set the Date and Time Display to UTC 4-1
Set the Command Notification Timeout Value 4-1
Set the Storage Retention Period for Messages and Data 4-2
Remove Messages from Message Storage 4-2
Set the Management Console Timeout Interval 4-3
Set the OAuth Access Token Lifetime 4-3
Set the Cross Origin Resource Sharing Value 4-3
Add a Defined Host Name Suffix 4-4
Add an Allowed Host for Syndicated Widgets 4-4
Delegate Device Management to a Third Party 4-4
Manage Analytics Resource Allocation 4-4
5 Troubleshoot Oracle Internet of Things Cloud Service

RSA Key Size Should be 1024 Bits 5-1
Unable to Delete Oracle Internet of Things Cloud Service Instance 5-1
Unable to Receive Data when Using an Apache Spark Cluster and the Kafka
Handler 5-4
How to Get Support 5-4
iv
Preface
Administering Oracle Internet of Things Cloud Service provides information and
procedures for implementing Oracle Internet of Things Cloud Service. Oracle Internet
of Things Cloud Service lets you connect, analyze, and integrate device data into you
business processes and applications, enabling your business to deliver innovative new
services faster and with less risk.
Topics:
• Audience
• Documentation Accessibility
• Related Documents
• Conventions
Audience
Administering Oracle Internet of Things Cloud Service is intended for system
administrators who are responsible for implementing Oracle Internet of Things Cloud
Service.
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle
Accessibility Program website at http://www.oracle.com/pls/topic/lookup?
ctx=acc&id=docacc.
Access to Oracle Support

Oracle customers that have purchased support have access to electronic support
through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/
lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?
ctx=acc&id=trs if you are hearing impaired.
Related Documents
For more information, see these Oracle resources:
• Oracle Cloud at http://cloud.oracle.com
• Getting Started with Oracle Cloud
• Using Oracle Business Intelligence Cloud Service
• Getting Started with Oracle Stream Explorer
v
Preface
Conventions
The following text conventions are used in this document:
Convention Meaning
boldface Boldface type indicates graphical user interface elements associated
with an action, or terms defined in text or the glossary.
italic Italic type indicates book titles, emphasis, or placeholder variables for
which you supply particular values.
monospace Monospace type indicates commands within a paragraph, URLs, code
in examples, text that appears on the screen, or text that you enter.
vi
1
Set Up Your Cloud Service Instance
To set up a new cloud service, complete the procedures in the order they’re
presented. You’ll need to do this when you purchase a new subscription.
Topics
• Before You Use the Cloud Service
• Workflow for Implementing the Oracle Internet of Things Cloud Service
• Create an Oracle Internet of Things Cloud Service Instance
• Create an Oracle Internet of Things Cloud Service Instance with Analytics
• Delete an Oracle Internet of Things Cloud Service Instance
• Secure Your Data
• Access the Management Console
Before You Use the Cloud Service

Before you use Oracle Internet of Things Cloud Service for the first time:
• Purchase a subscription to Database Cloud Service. See Buying a Metered
Subscription to an Oracle Cloud Service.
• Purchase a subscription to Oracle Java Cloud Service. See Buying a Metered
Subscription to an Oracle Cloud Service or Buying a Non-Metered Subscription to
an Oracle Cloud Service.
• Purchase a subscription to Oracle Internet of Things Cloud Service. See Buying a
Metered Subscription to an Oracle Cloud Service.
• (Optional) Purchase a subscription to Oracle Big Data Cloud Service - Compute
Edition and Oracle Event Hub Cloud Service. These services are required for
analytics functionality. See Buying a Metered Subscription to an Oracle Cloud
Service or Buying a Non-Metered Subscription to an Oracle Cloud Service.
• Create an 1024 bit SSH public/private key pair for Oracle Java Cloud Service. The
SSH public key is used for authentication of the Oracle Internet of Things Cloud
Service instance. When you create the Oracle Internet of Things Cloud Service
instance, you must provide a Oracle Java Cloud Service private key that matches
the Oracle Java Cloud Service public key. See Using the ssh-keygen Utility to
Generate an SSH Key Pair or Using the PuTTYgen Program to Generate an SSH
Key Pair. When creating the SSH public/private key pair, do not use a a
passphrase.
1-1
Chapter 1
Before You Use the Cloud Service
Using the ssh-keygen Utility to Generate an SSH Key Pair

An SSH public key is used for authentication when you use an SSH client to connect
to the Database Cloud Service instance. These procedures are specific to UNIX and
UNIX-like operating systems.
For procedures that are specific to the Microsoft Windows operating system, see
Using the PuTTYgen Program to Generate an SSH Key Pair.
1. Open a command prompt and run the cd $HOME command to browse to your home
directory.
2. Run this command to create the SSH public key:
ssh-keygen -b 1024 -t rsa -f filename
Replace filename with a unique filename for your SSH public key.
3. Enter the file to which the key pair should be saved when the Enter file in
which to save the key prompt appears.
4. Leave the Enter passphrase (empty for no passphrase) and Enter the same
passphrase again prompts empty.
This message appears:
Your identification has been saved in filename.

Your public key has been saved in filename.pub.
The key fingerprint is:
<fingerprint code>
The key's randomart image is:
<randomart image>
Using the PuTTYgen Program to Generate an SSH Key Pair

An SSH public key is used for authentication when you use an SSH client to connect
to the Database Cloud Service instance. These procedures are specific to the
Microsoft Windows operating system.
For procedures that are specific to UNIX and UNIX-like operating systems, see Using
the ssh-keygen Utility to Generate an SSH Key Pair.
1. Download and install PuTTY from http://www.putty.org/.
2. On you computer, click Start, All Programs, PuTTY, and then PuTTYgen.
3. Select SSH-2 RSA in the Parameters area.
4. Enter 1024 in the Number of bits in a generated key field.
5. Click Generate and then move the cursor around the blank area of the Key area
to generate the random characters that create a unique key.
6. Leave the Key passphrase and Confirm passphrase fields empty.
7. Export the SSH private key:
a. Click Conversions and then Export OpenSSH key.
1-2
Chapter 1
Workflow for Implementing the Oracle Internet of Things Cloud Service
b. Click Yes when the PuTTYgen Warning dialog appears.

c. Enter a name for the SSH private key file, change the file extension
to .openssh, and then click Save.
8. Select and copy all of the characters in the Public key for pasting into OpenSSH
authorized_keys file area.
9. Open a text editor and paste the text you copied in step 8.
10. Save the SSH public key file in the same location as the SSH private key.
11. Enter a name for the SSH public key file, change the file extension to .pub, and
then click Save.
Workflow for Implementing the Oracle Internet of Things

Cloud Service
To implement Oracle Internet of Things Cloud Service, complete the tasks listed in the
table.
This image represents the workflow for implementing Oracle Internet of Things Cloud
Service:
Task Description More Information

Complete the prerequisite tasks. Complete the prerequisite tasks to Before You Use the Cloud Service
successfully complete the
implementation.
Create the Oracle Internet of Things Create the Oracle Internet of Things Create an Oracle Internet of Things
Cloud Service instance. Cloud Service instance to manage Cloud Service Instance or Create an
and monitor devices and gateways. Oracle Internet of Things Cloud
Service Instance with Analytics
(Optional) Create the Oracle Internet Create the optional cloud service Activating Oracle Internet of Things
of Things Applications instances. A subscription is required Cloud Service SaaS Applications
to create each application.
1-3
Chapter 1
Create an Oracle Internet of Things Cloud Service Instance

Create a Oracle Internet of Things Cloud Service to manage and monitor devices and
gateways.
Note:
When using Oracle Cloud Stack Manager to create Oracle cloud service
instances, the cloud service instances cannot be used individually. For
example, if Oracle Cloud Stack Manager is used to create the Database
Cloud Service, Oracle Java Cloud Service, and Oracle Internet of Things
Cloud Service instances, you cannot associate a standalone Oracle Internet
of Things Cloud Service instance with a Oracle Java Cloud Service instance
created with Oracle Cloud Stack Manager.
1. Sign in to Oracle Cloud:

a. Open the subscription notification email sent by Oracle. Typically, this email
includes the subject line Welcome to Oracle Cloud.
b. Right-click the URL displayed in the My Services URL field and select Open
in new tab.
c. Copy the user name displayed in the Username field and then paste it into the
User Name field.
d. Copy the password displayed in the Temporary Password field and then
paste it into the Password field.
e. Click Sign In.
f. 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.
g. Click Continue if a welcome dialog appears.
2. Set the storage replication policy:
a. Click Customize Dashboard, scroll down to Storage Classic, and then select
Show.
b. Close the Customize Dashboard dialog.
c. Click the Storage Classic Menu ( ) and then select Open Service
Console.
If you have not previously set the storage replication policy, the Guidelines for
Selecting a Replication Policy dialog appears.
d. Select the default georeplication policy in the list at the bottom of the
Guidelines for Selecting a Replication Policy dialog.
e. Click Set Policy.
3. Locate and copy the Oracle Storage Cloud Service REST endpoint URL. This URL
forms part of the name for the Cloud Storage Container and Content Storage
Container fields that you complete later in this procedure.
1-4
Chapter 1
a. Click Storage Classic on the dashboard.

b. Copy the URL displayed in the REST Endpoint field and paste it into a text
editor or word processing application.
c. Click Menu ( ) next to Oracle CLOUD My services, and then click
Dashboard.
4. Click Menu ( ) next to Oracle CLOUD My services, and then click Oracle Cloud
Stack.
5. Click Create Stack.
6. Complete these fields in the Stack Details area:
• Name: Enter a unique name for the Oracle Internet of Things Cloud Service
instance.
• Description: (Optional) Enter a description for the Oracle Internet of Things
Cloud Service instance.
• Template: Select Oracle-IoT-Enterprise.
• Notification Email: (Optional) Enter an mail address for status update
messages.
• On Failure Retain Resources: Select this option to retain the settings for the
stack in case of failure.
7. Complete these fields in the Service Details area:
• Installation Type: Select Production to create a production instance, or
select Development to create a development instance.
• Username for Cloud Services: Accept the default value.
• Password (to access all services in Stack): Enter a password.
• Confirm Password (to access all services in Stack): Enter the password
you entered in the Password field.
• SSH Public Key: Click Edit and upload a SSH public key file or enter the SSH
public key value used for Oracle Internet of Things Cloud Service
authentication.
Note:
Do not select Create a New Key to auto-generate a SSH public/
private key pair. The auto-generated key pair is 2048 bits and cannot
be used for Oracle Internet of Things Cloud Service authentication.
To manually create a SSH public/private key pair, see Using the ssh-
keygen Utility to Generate an SSH Key Pair or Using the PuTTYgen
Program to Generate an SSH Key Pair. When creating the SSH
public/private key pair, do not use a a passphrase.
8. Complete these fields in the Backup and Recovery Configuration area:

• Cloud Storage Container: Enter the REST endpoint URL you copied in step
2 and append it with a storage container name. For example, <REST endpoint
URL>/mybackup.
• Cloud Storage Username: Enter the user name you used to sign in to Oracle
Cloud in step 1.
1-5
Chapter 1
• Cloud Storage Password: Enter the password you used to sign in to Oracle
Cloud in step 1.
9. Complete these fields in the Content Storage Container area:
• Content Storage Container: Enter the REST endpoint URL you copied in
step 2 and append it with a storage container name. For example, <REST
endpoint URL>/mybackupcontainer.
• Use same credentials as Cloud Storage Container: Select true to use the
credentials you specified in step 7 to access content storage, or select false to
provide different access credentials.
• Content Storage Username: (Optional) If you selected false in the Use same
credentials as Cloud Storage Container field, enter a user name for Cloud
Storage Container access.
• Content Storage Password: (Optional) If you selected false in the Use same
credentials as Cloud Storage Container field, enter the password used to
access the Cloud Storage Container.
10. Complete these fields in the Oracle Internet of Things - Enterprise area:
• Import private key: Click Browse and then select the private key that
matches the public key you uploaded in the Service Details area.
• Create spare JCS instance: Select true to create an additional Oracle Java
Cloud Service instance, or select false if you do not want to create an
additional Oracle Java Cloud Service instance.
• Enable IoT Device Simulator: Select true to create an Oracle Internet of
Things Cloud Service device simulator, or select false if you do not want to
create an Oracle Internet of Things Cloud Service device simulator. A device
simulator can help you test communications between devices and your Oracle
Internet of Things Cloud Service instance.
11. Click Next.
12. Click Confirm.
It can take 30 minutes or longer to activate the Oracle Internet of Things Cloud
Service instance.
1-6
Chapter 1
Create an Oracle Internet of Things Cloud Service Instance with Analytics

with Analytics
Create an Oracle Internet of Things Cloud Service instance to manage and monitor
devices and gateways. Activate analytics to access predictive analytics functionality.
Note:

in new tab.
User Name field.
e. Click Sign In.
Show.
c. Click Storage Classic on the dashboard.
d. Copy the URL displayed in the REST Endpoint field and paste it into a text
3. Click the Menu ( ) icon next to Oracle CLOUD My services, and then click Oracle
Cloud Stack.
1-7
Chapter 1
Create an Oracle Internet of Things Cloud Service Instance with Analytics
• Name: Enter a unique name for the Oracle Internet of Things Cloud Service
instance.
• Description: (Optional) Enter a description for the Oracle Internet of Things
messages.
• Template: Select Oracle-IoT-Enterprise-Analytics.
authentication.
Note:

URL>/mybackup.
Cloud in step 1.
Cloud in step 1.
1-8
Chapter 1
Delete an Oracle Internet of Things Cloud Service Instance
8. Complete these fields in the Oracle Internet of Things Cloud Analytics area:
• PSM URL: Copy the Oracle PaaS Service Manager URL from the address
field of your web browser and then paste it into this field with the default port
value for the Oracle PaaS Service Manager instance. Typically, the format is
https://<Oracle PaaS Service Manager instance URL>:443. The
default port value is 443. Entering a different port value could cause
provisioning to fail.
• MyServices Username: Enter the user name you used to sign in to Oracle
Cloud in step 1.
• MyServices Password: Enter the password you used to sign in to Oracle
Cloud in step 1.
9. Click Next.
10. Click Confirm.
Service instance.
Delete an Oracle Internet of Things Cloud Service Instance

Delete an Oracle Internet of Things Cloud Service instance when it is no longer
required. Deleting instances saves resources and reduces costs.
a. Open a web browser and browse to http://cloud.oracle.com.
b. Click Sign In.
c. Select the data center where your services are located in the Select Data
Center list.
d. Click My Services.
e. Enter the identity domain provided in your welcome email and then click Go.
f. Enter your user name and your password and then click Sign In.
1-9
Chapter 1
Secure Your Data
Cloud Stack.
3. Click Menu ( ) for an Oracle Internet of Things Cloud Service instance and then
select Delete.
4. (Optional) Select Force service deletion to use the force option and ignore PaaS
script failures.
5. Enter sys in the Database Administrator Username field.
6. Enter the database password in the Database Administrator Password field.
7. Click Delete.
Secure Your Data

To make sure the data sent and received by your devices remains secure, Oracle
recommends using the Secure Socket Layer (SSL) security protocol. To use an SSL
certificate to secure your application data, you configure SSL between the device and
the load balancer. The installation of an SSL certificate provided by a Certificate
Authority is recommended for production deployments, and is mandatory if you are
using the Oracle IoT Asset Monitoring Mobile Application or the Oracle IoT Fleet
Monitoring Mobile Application. For development and testing, you can use a self-signed
SSL certificate.
Note:
Before you can implement SSL, make sure that you have registered your
custom domain name and activated the load balancer in the Oracle Java
Cloud Service. To activate the load balancer, see Disabling or Enabling the
Load Balancer for an Oracle Java Cloud Service Instance. To register your
custom domain name, see Register a Custom Domain Name with a Third-
Party Registration Vendor.
Topics
• Register a Custom Domain Name with a Third-Party Registration Vendor
• Updating Your Application Environment to Use a Custom Domain Name
• Getting an SSL Certificate from a Certificate Authority
• Creating a Self-Signed SSL Certificate
• Installing an SSL Certificate Provided by a Certificate Authority
Register a Custom Domain Name with a Third-Party Registration

Vendor
If you want to access your applications with a custom Uniform Resource Locator
(URL) instead of a public Internet Protocol (IP) address, you register and then
associate a custom “vanity” domain name with your application environment.
1-10
Chapter 1
Secure Your Data
1. Create the Oracle Internet of Things Cloud Service instance. See Create an
Oracle Internet of Things Cloud Service Instance or Create an Oracle Internet of
Things Cloud Service Instance with Analytics.
2. Record the load balancer public IP address. To view the public IP address:
b. Click Sign In.
Center list.
e. Enter the identity domain provided and then click Go.
g. Click the Menu ( ) icon next to Oracle Cloud My Services and then select
Oracle Java Cloud Service.
h. Click a service in the Services list.
i. Expand Load Balancer.
The public IP address for the load balancer appears in the Content endpoint
field.
3. Register your custom domain name through a third-party domain registration
vendor.
4. Resolve your domain name to the IP address of the Oracle Java Cloud Service
load balancer, using the third-party domain registration vendor console.
For more information, refer to the third-party domain registration documentation.
Updating Your Application Environment to Use a Custom Domain

Name
You update the application to use the custom domain name after registering a custom
domain name. Using a custom domain name lets users access your applications with
a custom Uniform Resource Locator (URL) such as example.com.
Note:
By default, access to the administration consoles is disabled. If you did not
enable console access when you set up your Oracle Java Cloud Service
instance, see Enabling Console Access in an Oracle Java Cloud Service
Instance.
1. Open a web browser and browse to http://cloud.oracle.com.

2. Click Sign In.
3. Select the data center where your services are located in the Select Data Center
list.
4. Click My Services.
1-11
Chapter 1
Secure Your Data
5. Enter the identity domain provided and then click Go.

6. Enter your user name and your password and then click Sign In.
7. Click the Menu ( ) icon next to Oracle Cloud My Services and then select
8. Click the Menu ( ) icon for a service in the Services list and then select Open
Load Balancer Console.
If the server is protected with a self-signed certificate, you will be warned that this
certificate is not trusted.
9. Accept the certificate if prompted and choose one of these options:
• If you are using Firefox, click Advanced , click Add Exception and then click
Confirm Security Exception.
• If you are using Chrome, click Advanced and then click Proceed.
10. Log in to the load balancer console using the credentials you used when you
provisioned your Oracle Java Cloud Service instance.
If you created your Oracle Java Cloud Service instance using the Oracle Java
Cloud Service console, the user name and password default to the Oracle
WebLogic Server Administration Console user name and password.
11. Click the Target Navigation ( ) icon.

12. Expand Traffic Director in the left pane.
13. Click the virtual server name. For example, opc-config.
14. Click Virtual Servers in the left pane.
15. Click the virtual server in the Name column in the right pane. For example, opc-
config.
16. Expand General Settings and enter the custom domain name (for example,
example.com) in the Hosts field.
If there are multiple entries, separate each by a comma.
17. Click Apply.
Getting an SSL Certificate from a Certificate Authority

Use a SSL certificate issued by a Certificate Authority to encrypt the data that is sent
and received by your devices. To obtain an SSL certificate from a Certificate Authority,
you create a Certificate Signing Request (CSR) and then submit the CSR to the
Certificate Authority vendor. The CSR includes the public key and other information
that the Certificate Authority vendor needs to verify the identity of the load balancer
server on which you want to enable SSL. The implementation of an SSL Certificate
Authority certificate is recommended for production deployments and is mandatory if
you are using the Oracle IoT Asset Monitoring Mobile Application or the Oracle IoT
Fleet Monitoring Mobile Application.
1. Log in to the Oracle Java Cloud Service:
1-12
Chapter 1
Secure Your Data
b. Click Sign In.

Center list.

8. Click the Traffic Director Configuration menu in the top left, select Security, and
then Manage Certificates.
9. Select an alias in the Alias list.
10. Click Generate CSR .
11. Click Export CSR and save the CSR file as a .txt file.
12. Click Close.
13. Send the CSR to your Certificate Authority vendor and request a new SSL
certificate. Include this information with your request:
• Your custom domain name.
• Public information associated with the domain confirming you as the owner.
• Email address associated with the custom domain for verification.
• The load balancer public IP address. To locate the load balancer public IP
address, see Register a Custom Domain Name with a Third-Party Registration
Vendor.
1-13
Chapter 1
Secure Your Data
• The fully qualified domain name (FQDN) for the load balancer. To identify the
FQDN, open an SSH client, connect to the load balancer, and then run the
hostname —f command.
For more information about submitting the CSR, refer to the documentation
provided by your Certificate Authority vendor.
Creating a Self-Signed SSL Certificate

Use a self-signed SSL certificate to encrypt the data that is sent and received by your
devices. The implementation of a self-signed SSL certificate is recommended for
development and testing. The implementation of an SSL certificate provided by a
Certificate Authority is recommended for production deployments and is mandatory if
b. Click Sign In.
Center list.

1-14
Chapter 1
Secure Your Data

10. Click Generate Keypair .
11. Complete the mandatory and optional fields for the key pair and then click OK.
Installing an SSL Certificate Provided by a Certificate Authority

Use a self-signed SSL certificate to encrypt the data that is sent and received by your
devices. The implementation of a self-signed SSL certificate is recommended for
development and testing. The implementation of an SSL certificate provided by a
Certificate Authority is recommended for production deployments and is mandatory if
b. Click Sign In.
Center list.

1-15
Chapter 1
Access the Management Console
10. Import the trusted certificate:
a. Click Import .
b. Select Trusted Certificate in the Certificate Type list.
c. Enter a name for the SSL certificate in the Alias field.
d. Select Select a file that contains the Certificate or Certificate Chain.
e. Click Browse and browse to the location of the SSL certificate provided by the
Certificate Authority.
f. Select the SSL certificate and then click Open.
g. Click OK.
Access the Management Console

Access the Oracle Internet of Things Cloud Service management console to manage
your Oracle Internet of Things Cloud Service instance. This procedure assumes that
you have created your Oracle Internet of Things Cloud Service instance.
b. Click Sign In.
c. In the Cloud Account section, select Cloud Account with Identity Cloud
Service or Traditional Cloud Account.
d. Enter the name of your cloud account in the Cloud Account Name field, or
select the data center where your services are located in the Select Data
Center list.
e. Click Next.
f. Enter the identity domain provided in your welcome email and then click Go.
g. Enter your user name and your password and then click Sign In.
2. If you have not previously customized your dashboard to display IoT Enterprise:
a. Click Customize Dashboard, scroll down to IoT Enterprise, and then select
Show.
3. On the IoT Enterprise page, click the IoT instance name, and then expand
Associations.
4. Click the instance name that has Oracle Internet Of Things Cloud - Web as the
Service Type .
5. On the IoT instance page, click Menu and select IoT Management Console.
The format of your IoT management console URL is, <iotinstancename>jls-
<user-id>.<domain name>.oraclecloud.com/ui/index.html. For example:
https://myiotcsiotjls-agallardo.uscom-central-1.oraclecloud.com/ui/
index.html.
1-16
2
Activating Oracle Internet of Things Cloud
Service SaaS Applications
Follow these procedures to create the optional Oracle Internet of Things Cloud Service
Software as a Service (SaaS) applications. A subscription is required to create each
application.
Topics
• Create an Oracle IoT Asset Monitoring Cloud Service Instance
• Create an Oracle IoT Asset Monitoring CX Cloud Service Instance
• Create an Oracle IoT Production Monitoring Cloud Service Instance
• Create an Oracle IoT Fleet Monitoring Cloud Service Instance
• Create an Oracle IoT Connected Worker Cloud Service Instance
• Delete an Oracle Internet of Things Cloud Service SaaS Application
Create an Oracle IoT Asset Monitoring Cloud Service

Instance
If you have subscribed to Oracle IoT Asset Monitoring Cloud Service, use this
procedure to create the application.
Note:

in new tab.
User Name field.
2-1
Chapter 2
Create an Oracle IoT Asset Monitoring Cloud Service Instance
e. Click Sign In.

Show.
Cloud Stack.
• Name: Enter a unique name for the Oracle IoT Asset Monitoring Cloud
Service instance.
• Description: (Optional) Enter a description for the Oracle IoT Asset
Monitoring Cloud Service instance.
• Template: Select Oracle-IoT-Asset-Monitoring.
messages.
authentication.
2-2
Chapter 2
Create an Oracle IoT Asset Monitoring Cloud Service Instance
Note:

URL>/mybackup.
Cloud in step 1.
Cloud in step 1.
8. Complete these fields in the Oracle IoT Asset Monitoring Cloud Service area:
Cloud in step 1.
Cloud in step 1.
2-3
Chapter 2
Create an Oracle IoT Asset Monitoring CX Cloud Service Instance

9. Click Next.
10. Click Confirm.
Service instance.
Create an Oracle IoT Asset Monitoring CX Cloud Service

Instance
If you have subscribed to Oracle IoT Asset Monitoring CX Cloud Service, use this
Note:

in new tab.
User Name field.
e. Click Sign In.
Show.
2-4
Chapter 2

Cloud Stack.
• Name: Enter a unique name for the Oracle IoT Asset Monitoring Cloud
Service instance.
• Description: (Optional) Enter a description for the Oracle IoT Asset
messages.
• Template: Select Oracle-IoT-Asset-Monitoring-CX.
you entered in the Password field..
authentication.
Note:

URL>/mybackup.
Cloud in step 1.
Cloud in step 1.
2-5
Chapter 2

8. Complete these fields in the Oracle IoT Asset Monitoring CX Cloud Service
area:
Cloud in step 1.
Cloud in step 1.
9. Click Next.
10. Click Confirm.
Service instance.
2-6
Chapter 2
Create an Oracle IoT Production Monitoring Cloud Service Instance
Create an Oracle IoT Production Monitoring Cloud Service

Instance
If you have subscribed to Oracle IoT Production Monitoring Cloud Service, use this
Note:

in new tab.
User Name field.
e. Click Sign In.
Show.
Cloud Stack.
2-7
Chapter 2
• Name: Enter a unique name for the Oracle IoT Production Monitoring Cloud
Service instance.
• Description: (Optional) Enter a description for the Oracle IoT Production
• Template: Select Oracle-IoT-Production-Monitoring.
messages.
• Username for Cloud Services: Enter a password.
• Password (to access all services in Stack): Enter the password you entered
in the Password field.
used to access the Database Cloud Service instance.
authentication.
Note:

URL>/mybackup.
Cloud in step 1.
Cloud in step 1.
2-8
Chapter 2
8. Complete these fields in the Oracle IoT Production Monitoring Cloud Service
area:
Cloud in step 1.
Cloud in step 1.
9. Click Next.
10. Click Confirm.
Service instance.
2-9
Chapter 2
Create an Oracle IoT Fleet Monitoring Cloud Service Instance
Create an Oracle IoT Fleet Monitoring Cloud Service

Instance
If you have subscribed to Oracle IoT Fleet Monitoring Cloud Service, use this
Note:

in new tab.
User Name field.
e. Click Sign In.
Show.
Cloud Stack.
2-10
Chapter 2
• Name: Enter a unique name for the Oracle IoT Fleet Monitoring Cloud Service
instance.
• Description: (Optional) Enter a description for the Oracle IoT Fleet Monitoring
• Template: Select Oracle-IoT-Fleet-Monitoring.
messages.
authentication.
Note:

URL>/mybackup.
Cloud in step 1.
Cloud in step 1.
2-11
Chapter 2
8. Complete these fields in the Oracle IoT Fleet Monitoring Cloud Service area:
Cloud in step 1.
Cloud in step 1.
9. Click Next.
10. Click Confirm.
Service instance.
2-12
Chapter 2
Create an Oracle IoT Connected Worker Cloud Service Instance
Create an Oracle IoT Connected Worker Cloud Service

Instance
If you have subscribed to Oracle IoT Connected Worker Cloud Service, use this
Note:

in new tab.
User Name field.
e. Click Sign In.
Show.
Cloud Stack.
2-13
Chapter 2
Create an Oracle IoT Connected Worker Cloud Service Instance
• Name: Enter a unique name for the Oracle IoT Fleet Monitoring Cloud Service
instance.
• Description: (Optional) Enter a description for the Oracle IoT Fleet Monitoring
• Template: Select Oracle-IoT-Connected-Worker.
messages.
authentication.
Note:

URL>/mybackup.
Cloud in step 1.
Cloud in step 1.
2-14
Chapter 2
Delete an Oracle Internet of Things Cloud Service SaaS Application
8. Complete these fields in the Oracle IoT Connected Worker Cloud Service area:
Cloud in step 1.
Cloud in step 1.
9. Click Next.
10. Click Confirm.
Service instance.
Delete an Oracle Internet of Things Cloud Service SaaS

Application
Delete an Oracle Internet of Things Cloud Service Software as a Service (SaaS)
application when it is no longer required. Deleting unused or obsolete applications
saves resources and reduces costs.
b. Click Sign In.
Center list.
2-15
Chapter 2
Delete an Oracle Internet of Things Cloud Service SaaS Application
e. Enter the identity domain provided in your welcome email and then click Go.
Cloud Stack.
3. Click Menu ( ) for the SaaS application and then select Delete.
4. (Optional) Select Force service deletion to use the force option and ignore PaaS
script failures.
5. Enter sys in the Database Administrator Username field.
6. Enter the database password in the Database Administrator Password field.
7. (Optional) Select Delete backup files to delete all backup files when the SaaS
application is deleted.
8. Click Delete.
2-16
3
Managing Users
Add user accounts to assign access privileges to your Oracle Internet of Things Cloud
Service instance. Remove a user account when it is no longer required.
Topics
• Understand Oracle Internet of Things Cloud Service User Roles
• Add a User Account
• Edit a User Account
• Remove a User Account
Understand Oracle Internet of Things Cloud Service User

Roles
Access to Oracle Internet of Things Cloud Service functionality is determined by roles.
To let users access specific functionality, assign the user to a role that allows access
to this functionality. For example, a user cannot create device models unless they are
assigned an Administrator (IoTAdministrator) role.
Currently, there are three roles available to restrict access to Oracle Internet of Things
Cloud Service functionality. The Administrator (IoTAdministrator) role is automatically
assigned to the user who created the Oracle Internet of Things Cloud Service
instance. The Operator role (IoTOperator) is assigned to users after the Oracle
Internet of Things Cloud Service instance is created and provides the user with
operator privileges. The User (IoTUsers) role is assigned to users after the Oracle
Internet of Things Cloud Service instance is created and provides the user with user
privileges.
Role Name Description

Administrator (IoTAdministrator) A 'super-user' role that grants access to all Oracle Internet
of Things Cloud Service management console functionality
including create, view, edit, and delete operations.
Operator (IoTOperator) Grants access to most Oracle Internet of Things Cloud
Service management console functionality including view,
edit, and delete operations.
User (IotUsers) Grants limited access to Oracle Internet of Things Cloud
Service management console functionality. Users are
typically restricted to view operations.
Add a User Account

Add a user account to assign a user Oracle Internet of Things Cloud Service access
privileges.
3-1
Chapter 3
Edit a User Account
1. In a web browser, find your Oracle Internet of Things Cloud Service instance.
Typically, the URL format is http://server host name/ui/login/login.html.
2. Enter your user name and password and click Sign In.
3. Click Menu and click Users.
4. Click Create User .

5. Select one or more of these roles in the ROLES area:
• Administrator: Grants access to all Oracle Internet of Things Cloud Service
management console functionality including create, view, edit, and delete
operations..
• Operator: Grants access to most Oracle Internet of Things Cloud Service
management console functionality including view, edit, and delete operations.
• User: Grants limited access to Oracle Internet of Things Cloud Service
management console functionality. Users are typically restricted to view
operations.
6. Complete these fields in the NAME area:
• First Name: Enter the first name of the user.
• Last Name: Enter the last name of the user.
• Username: Enter a user name for the user account.
7. Complete these fields in the EMAIL area:
• Work: Enter the work email address for the user.
• Home: (Optional) Enter the home email address for the user.
• Recovery: (Optional) Enter the recovery email address for the user. This
email address is used to help the user regain access to their account if they
forget their password or are locked out.
• Other: (Optional) Enter an additional email address for the user.
8. (Optional) Complete these fields in the TELEPHONE area:
• Work: Enter the work phone number for the user.
• Home: Enter the home phone number for the user.
• Recovery: Enter the recovery phone number for the user. This phone number
is used to help the user regain access to their account if they forget their
password or are locked out.
• Other: Enter an additional phone number for the user.
• Mobile: Enter the mobile phone number for the user.
9. Click Save.
10. Click Back to return to the Users list.
Edit a User Account

Edit a user account to add or change the account description, change the account
password, or add or remove access or privileges.
3-2
Chapter 3
Reset a User Password
4. Select a user in the Users list and click Edit .

5. (Optional) Select one or more of these roles in the ROLES area:
• Administrator: Select this role to assign the user administrator privileges.
• Driver: Select this role to assign the user driver privileges.
• Shipper: Select this role to assign the user shipper privileges.
• Integrator: Select this role to assign the user integrator privileges.
6. (Optional) Edit these fields in the NAME area:
• First Name: Enter the first name of the user.
• Last Name: Enter the last name of the user.
• Username: Enter a user name for the user account.
7. (Optional) Edit these fields in the EMAIL area:
• Work: Enter the work email address for the user.
• Home: (Optional) Enter the home email address for the user.
• Recovery: (Optional) Enter the recovery email address for the user. This
email address is used to help the user regain access to their account if they
forget their password or are locked out.
• Other: (Optional) Enter an additional email address for the user.
8. (Optional) Edit these fields in the TELEPHONE area:
• Work: Enter the work phone number for the user.
• Home: Enter the home phone number for the user.
• Recovery: Enter the recovery phone number for the user. This phone number
is used to help the user regain access to their account if they forget their
password or are locked out.
• Other: Enter an additional phone number for the user.
• Mobile: Enter the mobile phone number for the user.
9. Click Save.
10. Click Back to return to the Users list.
Reset a User Password

Reset a user password when a user forgets their password or you think their account
has been compromised.
3-3
Chapter 3
Search for a User Account
4. Select a user in the Users list and click Reset Password .

5. Click Yes.
Search for a User Account

Use the search function to locate a specific user account or user accounts matching
specific search criteria.
4. Click Filter List .

5. Select one of these options in the Show All Users list:
• First Name: Select this option to search for a user account by the user’s first
name.
• Last Name: Select this option to search for a user account by the user’s last
name.
• Username: Select this option to search for a user account by user name.
• Email: Select this option to search for a user account by email address.
• Roles: Select this option to search for a user account by role(s).
6. Select one of these options in the second list:
• contains text: Select this option to search for a user account using a full or
partial search phrase. For example, you can locate the user Tom Jones by
searching for T, To, or Tom.
• matches: Select this option to search for a user account using an exact
match. For example, to locate the user Tom Jones, enter Tom Jones in the
search field.
• does not match: Select this option to search for a user account by excluding
the search criteria you enter. For example, entering Tom Jones returns all
users except Tom Jones.
7. Enter your search criteria in the field and press Enter.
8. (Optional) Click Add to add additional search criteria.
9. (Optional) Click Remove to remove search criteria.

10. (Optional) Click Clear Filter to clear your search criteria.
Remove a User Account

Remove a user when you no longer want them to have Oracle Internet of Things
Cloud Service access or privileges.
3-4
Chapter 3
Remove a User Account
4. Select a user in the Users list and click Delete .

5. Click Yes.
3-5
4
Manage Cloud Service Settings
Use the Settings tab in the Oracle Internet of Things Cloud Service Management
Console to set the storage configuration for all the messages, how long the OAuth
access token is valid for the devices, and what date and time display format to use
system wide, including for messages.
Topics
• Set the Date and Time Display to UTC
• Set the Command Notification Timeout Value
• Set the Storage Retention Period for Messages and Data
• Remove Messages from Message Storage
• Set the Management Console Timeout Interval
• Set the OAuth Access Token Lifetime
• Set the Cross Origin Resource Sharing Value
• Add a Defined Host Name Suffix
• Add an Allowed Host for Syndicated Widgets
• Delegate Device Management to a Third Party
• Manage Analytics Resource Allocation
Set the Date and Time Display to UTC

By default, the Oracle IoT Cloud Service Management Console uses local time for the
system’s date and time format. This includes the timestamps of the messages and
alerts that are being displayed in the Data page.
1. Open the Oracle Internet of Things Cloud Service Management Console. See
Accessing the Cloud Service.
2. Click the Menu ( ) icon, and then click Settings.
3. Select UTC in the Date & Time Display list in the UI area.
Set the Command Notification Timeout Value

Change the command notification timeout value to change the display duration for
successful command execution notifications. The default is 5 seconds.
3. Select a duration in the Dismiss Notification Banner list in the UI area.
4-1
Chapter 4
Set the Storage Retention Period for Messages and Data
Set the Storage Retention Period for Messages and Data

The message storage retention period defines how long messages and data are
retained before deletion. A longer retention period requires additional storage space.
Messages older than the specified storage period are automatically deleted.
2. Click Menu and Settings.
3. Set these retention periods in the Retention Period area:
• Data Message: Select a retention period for data messages or select Custom
and create a custom retention period.
• Alert Message: Expand Alert Message, select Set duration per severity to
set the retention period for alert messages by severity, and then select a
retention period for data messages or select Custom and create a custom
retention period.
• Analyzed Message: Select a retention period for analyzed messages or
select Custom and create a custom retention period.
• Request/Response Message: Select a retention period for request and
response messages or select Custom and create a custom retention period.
• Other Message: Select a retention period for other messages or select
Custom: and create a custom retention period.
• User Data: Select a retention period for user data or select Custom and
create a custom retention period.
• Metric Data: Select a retention period for metric data or select Custom and
• Sensor Data: Select a retention period for metric data or select Custom and
Remove Messages from Message Storage

If the Storage Usage indicator on the Settings dashboard is indicating 90% or
greater, remove messages from message storage to create additional storage space.
3. Expand Storage Cleanup.
4. In the Date Range list, select a date range for stored messages or select Custom
and specify a custom date range.
5. Select one of these options in the Message Selection field:
• All Messages: Select this option to remove all messages for the selected
period from message storage.
4-2
Chapter 4
Set the Management Console Timeout Interval
• Messages for specific IoT Application: Select this option and select an
application to remove specific application messages for the selected period
from message storage.
6. Click Start Cleanup Process and click Yes.
Set the Management Console Timeout Interval

You can set the duration that the Management Console remains connected. The
default is an hour. If your devices send messages every few seconds, consider setting
the timeout interval to an hour. If your devices send messages every few hours and
sending the message takes a few seconds, consider setting the timeout interval to a
minute.
3. Select a duration in the Device Connectivity Timeout list in the Communication
area.
Set the OAuth Access Token Lifetime

By default, the OAuth access token that is assigned to any activated device or
enterprise application expires after one hour of inactivity.
3. Select a duration in the Device OAuth Access Token Lifetime list in the
Security area.
Set the Cross Origin Resource Sharing Value

The cross origin resource sharing setting specifies if the system that is hosting a web
application is allowed to access Oracle IoT Cloud Service resources. The assumption
is that the web application is running in a browser that is also implementing the CORS
specification. Any browser based JavaScript client running on the specified host can
access Oracle IoT REST APIs. However they will need to follow the Oracle IoT REST
API authorization process to run any operations.
For more information about cross origin resource sharing, see Cross-Origin Resource
Sharing
3. Enter the host name in the Allowed Hosts for Cross-Origin Resource Sharing
field in the Security area.
4-3
Chapter 4
Add a Defined Host Name Suffix
Add a Defined Host Name Suffix

Add a host name suffix to identify the suffix that can be accepted when an external
application submits a WildCard SSL certificate.
3. Enter the host name in the Trusted CN field in the Security area.
Add an Allowed Host for Syndicated Widgets

The host name identifies the URL used by Oracle Internet of Things Cloud Service to
access an external syndicated widget.
3. Enter the syndicated widget URL in the Allowed Hosts for Syndicated Widgets
field in the Security area and press Enter.
Delegate Device Management to a Third Party

Delegate device management to a third party when you want to allow external
applications to create and manage devices.
3. Select Enable Device Management through a Third Party in the Security area
and then complete the entries in the Third Party Device Management table.
Manage Analytics Resource Allocation

To conserve computational resources, you can reduce the amount of resources that
are allocated to application or worksheet analytic calculations.
3. Move the slider in the Adjust column for applications or worksheets in the
Analytics Resource Allocation area.
4-4
5
Troubleshoot Oracle Internet of Things
Cloud Service
Review the following topics to resolve issues with Oracle Internet of Things Cloud
Service.
Topics:
• RSA Key Size Should be 1024 Bits
• Unable to Delete Oracle Internet of Things Cloud Service Instance
• Unable to Receive Data when Using an Apache Spark Cluster and the Kafka
Handler
• How to Get Support
RSA Key Size Should be 1024 Bits

The error message RSA key size should be 1024 bits appears when the SSH key
length exceeds 1024 bits. This error message typically appears when entering the
private key for the Oracle Java Cloud Service instance on the Oracle Internet of
Things Cloud Service Service Details page. This issue can be caused when an auto-
generated key pair is used for authentication. The auto-generated key pair is 2048 bits
and cannot be used for Oracle Internet of Things Cloud Service authentication.
To manually create a 1024 bit SSH public/private key pair, see Using the ssh-keygen
Utility to Generate an SSH Key Pair or Using the PuTTYgen Program to Generate an
SSH Key Pair.
Unable to Delete Oracle Internet of Things Cloud Service

Instance
When you attempt to delete an Oracle Internet of Things Cloud Service instance, the
instance is not deleted and the error message Last Activity DELETE_SERVICE <date
and time> failed. See Activity Log for Details appears in Oracle Cloud
Service. The cause of this issue is the removal of the installiot folder in Oracle
Java Cloud Service.
To resolve this issue, reinstall the installiot folder and then delete the Oracle
Internet of Things Cloud Service instance again.
1. Log in to Oracle Cloud Service:
in new tab.
5-1
Chapter 5
Unable to Delete Oracle Internet of Things Cloud Service Instance
c. Enter your user name and password.

d. Click Sign In.
2. Click the Menu ( ) icon, and then click Oracle Java Cloud Service.
3. Click the Oracle Java Cloud Service instance associated with the Oracle Internet
of Things Cloud Service instance.
4. Record the host name and IP address for the Oracle Java Cloud Service instance.
5. On UNIX and UNIX-like platforms, use the standard OpenSSH command (ssh ) to
connect to the Oracle Java Cloud Service instance as the opc user.
Provide the following:
• The path to the private key corresponding to the public key used at the time of
provisioning.
• The Administration Server public IP address.
• The Managed Server host name.
in this format:
ssh -i path_to_private_key -o ProxyCommand="ssh -W %h:%p -i

path_to_private_key opc@admin_server_IP_address"
opc@managed_server_host_name
For example:
ssh -i /home/myuser/id_rsa -o ProxyCommand="ssh -W %h:%p -i /home/

myuser/id_rsa opc@111.111.111.111" opc@myjcs-wls-2
6. On Windows, use PuTTY or a similar SSH client, to connect to the Oracle Java
Cloud Service instance as the opc user:
To download PuTTY, go to http://www.putty.org/ and click the You can download
PuTTY here link.
a. Launch PuTTY. If your private key was defined with a passphrase, then you
must use the pageant utility to launch PuTTY:
pageant "path to private key" -c "path to putty"
For example:
c:\PuTTY\pageant "c:\oracle\rsa.ppk" -c "c:\PuTTY\putty"
b. If you used pageant to start PuTTY, enter the passphrase for the private key.
c. In the Host Name (or IP address) field, enter the host name of the Managed
Server.
d. Expand Connection in the Category pane and then click Data.
e. Enter opc in the Auto-login username field.
f. Select Prompt in the When username is not specified field.
g. Click Proxy below Connection in the Category pane.
5-2
Chapter 5
Unable to Delete Oracle Internet of Things Cloud Service Instance
h. Select Local in the Proxy type area.

i. Enter the IP address of the Administration Server in the Proxy hostname
field.
j. Enter 22 in the Port field.
k. Enter this value in the Telnet command or local proxy command field :
plink -i "path to private key" opc@%proxyhost -nc %host:%port
For example:
plink -i "c:\\oracle\\rsa.ppk" opc@%proxyhost -nc %host:%port
l. Expand SSH below Connection in the Category pane and then click Auth.
m. Click Browse in the Private key file for authentication field.
n. Browse to the location of your private key file, select it, and then click Open.
Note:
The .ppk file extension indicates that the private key is in PuTTY's
proprietary format. You must use a key of this format when using
PuTTY. If you have to use a key saved in a different format, see the
PuTTY documentation.
o. Click Open to open the connection to the Oracle Java Cloud Service instance.
Note:
You can optionally save this session configuration by navigating to
the Session panel and clicking Save. When you open PuTTY the
next time, you can load this configuration by selecting it and
clicking Load.
7. Open a command prompt and run this command to copy the private key on the
host computer: - vi id_rsa.
8. Run this command to paste the content of the private key to the host computer: -
chmod 400 id_rsa.
9. Run this command:ssh -i id_rsa opc@<IoT OEP host>.
10. Run this command: sudo cd /u01/app/oracle/tools/ieas/OEP/vm-scripts/.
11. Run this command: vi setup/iot-setup.sh.
12. Add this comment:// $JAVA_HOME/bin/java $@

weblogic.WLST $CONFIGURE_DEPLOY_PY $DEPLOY_MODE $iota_enable $DOMAIN_H
OME sh ./installiot.sh.
13. Delete the Oracle Internet of Things Cloud Service instance:
a. Repeat step 1 to log in to Oracle Cloud Service.
5-3
Chapter 5
Unable to Receive Data when Using an Apache Spark Cluster and the Kafka Handler
b. Click the Menu ( ) icon, and then click Oracle Internet of Things Cloud
Service.
c. Click Delete .
Unable to Receive Data when Using an Apache Spark

Cluster and the Kafka Handler
If you are using an Apache Spark Cluster and the Kafka handler, data cannot be sent
to an Oracle Internet of Things Cloud Service instance with analytics enabled.
To resolve this issue, create a custom Oracle Event Hub Cloud Service access rule.
1. Log in to Oracle Cloud Service:
in new tab.
c. Enter your user name and password.
d. Click Sign In.
2. Click the Menu ( ) icon, and then click Oracle Event Hub Cloud Service.
3. Select the Kafka instance to which you want to add the access rule.
4. Click the Menu ( ) icon and then select Access Rules.

5. Click Create Rule.
6. Complete these fields:
• Rule Name: Enter a name for the access rule.
• Description: (Optional) Enter a description for the access rule.
• Source: Enter PUBLIC-INTERNET.
• Destination: Enter kafka_KAFKA_SERVER
• Destination Port(s): Enter 6667
• Protocol: Enter TCP.
7. Click Create.
8. Confirm the access rule appears in the Access Rules list. If it does not, repeat
steps 5 to 7.
How to Get Support

Use these resources to resolve problems:
• Review Troubleshoot Oracle Internet of Things Cloud Service.
• Click the Contact Us ( ) icon in the Oracle My Services management console

and then select a support option.
5-4
Chapter 5
How to Get Support
• Visit the Oracle Help Center at http://docs.oracle.com/en/.

• If you’re an Oracle Premier Support Customer, then visit My Oracle Support.
• Contact Oracle Technical Support. See Contacting Oracle Support in Getting
Started with Oracle Cloud.
5-5

Administering Oracle Internet of Things Cloud Service

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Administering Oracle Internet of Things Cloud Service

Uploaded by

Copyright:

Available Formats

Oracle® Cloud

Administering Oracle Internet of Things Cloud

Primary Author: Oracle Corporation

1 Set Up Your Cloud Service Instance

2 Activating Oracle Internet of Things Cloud Service SaaS

4 Manage Cloud Service Settings

5 Troubleshoot Oracle Internet of Things Cloud Service

Access to Oracle Support

Before You Use the Cloud Service

Using the ssh-keygen Utility to Generate an SSH Key Pair

ssh-keygen -b 1024 -t rsa -f filename

Your identification has been saved in filename.

Using the PuTTYgen Program to Generate an SSH Key Pair

b. Click Yes when the PuTTYgen Warning dialog appears.

Workflow for Implementing the Oracle Internet of Things

Task Description More Information

Create an Oracle Internet of Things Cloud Service Instance

1. Sign in to Oracle Cloud:

a. Click Storage Classic on the dashboard.

8. Complete these fields in the Backup and Recovery Configuration area:

12. Click Confirm.

Create an Oracle Internet of Things Cloud Service Instance

1. Sign in to Oracle Cloud:

6. Complete these fields in the Backup and Recovery Configuration area:

Delete an Oracle Internet of Things Cloud Service Instance

Secure Your Data

Register a Custom Domain Name with a Third-Party Registration

Updating Your Application Environment to Use a Custom Domain

1. Open a web browser and browse to http://cloud.oracle.com.

5. Enter the identity domain provided and then click Go.

11. Click the Target Navigation ( ) icon.

13. Click the virtual server name. For example, opc-config.

14. Click Virtual Servers in the left pane.

Getting an SSL Certificate from a Certificate Authority

b. Click Sign In.

5. Click the Target Navigation ( ) icon.

12. Click Close.

Creating a Self-Signed SSL Certificate

5. Click the Target Navigation ( ) icon.

9. Select an alias in the Alias list.

Installing an SSL Certificate Provided by a Certificate Authority

5. Click the Target Navigation ( ) icon.

10. Import the trusted certificate:

Access the Management Console

Create an Oracle IoT Asset Monitoring Cloud Service

1. Sign in to Oracle Cloud:

e. Click Sign In.

6. Complete these fields in the Backup and Recovery Configuration area:

• Enable IoT Device Simulator: Select true to create an Oracle Internet of

Create an Oracle IoT Asset Monitoring CX Cloud Service

1. Sign in to Oracle Cloud:

b. Close the Customize Dashboard dialog.

6. Complete these fields in the Backup and Recovery Configuration area:

7. Complete these fields in the Content Storage Container area:

Create an Oracle IoT Production Monitoring Cloud Service

1. Sign in to Oracle Cloud:

6. Complete these fields in the Backup and Recovery Configuration area:

Create an Oracle IoT Fleet Monitoring Cloud Service

1. Sign in to Oracle Cloud:

6. Complete these fields in the Backup and Recovery Configuration area:

Create an Oracle IoT Connected Worker Cloud Service

1. Sign in to Oracle Cloud:

6. Complete these fields in the Backup and Recovery Configuration area: