Onboard Devices Manually

Onboard a device to Oracle Enterprise Communications Platform (Oracle ECP) to allow monitoring the device and ingestion of device telemetry data to ECP Cloud.

Before You Begin

• Gather the necessary Device information as described in About Preparing to Add Hardware.

  Note:

  Refer to the User Input Requirements topic for the onboarding form field data requirements and validations.

Context

Oracle ECP lets you create a request for onboarding one type of device at a time when you click Add Hardware. Device Types cannot be combined within a single Add Hardware request. Within the work flow, you may change the Device Type even after filling in some or all of the fields. When you do so, Oracle ECP displays the Change device type dialog. When you click Change device type, Oracle ECP clears all fields and you must enter information for the newly selected device type. You must onboard each type of device in a separate Add Hardware request.

Note:

When you click Cancel in the Change device type dialog, Oracle ECP leaves the fields as they were.

Procedure

1. Access the Inventory page, and click Add Hardware to start the guided process for onboarding hardware.
2. Click Start in the first panel (#01) to begin specifying the device.
   Oracle ECP displays the step number and action for each step of the process in the right pane.
3. For Hardware Type, click Devices.
4. For Onboarding Method, click Manually add devices.
5. For Device Type, click the appropriate Device Type in the drop-down list.
   Oracle ECP displays some or all of the following configuration fields according to the device type.
6. For the fields in the Overview, Authentication, and Registration Address sections, review or type values as follows:

   Enable MDM (for MDM Devices only) Note: Check Enable MDM when you plan to use Oracle ECP with the external MDM for a single-pane view and streamlined operation of the managed devices on both platforms.	Click to onboard Mobile Device Management (MDM) enabled devices to ECP and enable easy onboarding to the external Ivanti Neurons for MDM Solution after you review the onboarding requests. Note: When the Enable MDM check box is selected, the Device OS Type field displays each supported device operating system (OS) and the Connectivity Type drop-down displays each supported Connectivity Type for MDM-enabled device onboarding.
   Device OS Type (for MDM Devices only)	Displays when you click the Enable MDM check box. Click the drop-down and select the operating system type for the MDM-enabled devices to be onboarded. Valid values: Android iOS Windows Note: Onboarding supports a single Device OS Type per onboarding form session. If you specify a second Device OS Type, a validation error displays at the top of the page.
   Name (Required)	Type a friendly name for the Device as follows: Must be unique for the tenant. Must start with alphanumeric characters. Allowed characters: alphanumeric characters, underscore, hyphen, and space. Allowed character length: 2-100.
   Serial Number	Type the serial number of the device. Allowed character length: 1-100.
   Make	Type the name of the manufacturer of the device as follows: Must start with an alphanumeric character. Allowed characters: Alphanumeric characters along with underscore, hyphen, and space. Allowed character length: 0-100.
   Model	Type the model name the manufacturer uses to identify the device as follows: Must start with an alphanumeric character. Allowed characters: Alphanumeric characters along with underscore, hyphen, and space. Allowed character length: 0-100.
   Device ID	Type the device identifier as follows: Must be unique for the tenant. Allowed characters: Alphanumeric characters, exclamatory mark ( ! ), at the rate of (@), Pound (#), Dollar ($), Percentage (%), Caret (^), Ampersand (&), Asterisk (*), Brackets (), Minus ( - ), underscore ( _ ), Equals (=), Plus ( + ), square brackets ([]), curly brackets ({}), backward slash ( \ ), Pipe (|), Semi Colon ( ; ), Single quote ('), Double Quote ("), Comma ( , ), Angular brackets (<>), , Period (.), Question mark ( ? ), Tilde (~), back tick(`). Cannot be a snowflake ID where validation is on numerals 0-9 or upper case letters A-Z, excluding I, L, O, and U must be 10-13 characters in length. Allowed character length: 1-100. Note Oracle ECP generates an identifier automatically if you do not specify one.
   MAC	Enter the 12 characters of the Media Access Control (MAC) address that will serve as the physical address for this Device in one of the following formats: XX:XX:XX:XX:XX:XX XX-XX-XX-XX-XX-XX XXXX.XXXX.XXXX
   Connectivity Type (Required)	Click a connectivity type in the drop-down list to specify how you want the device to connect to the Internet. Valid values: Cellular (Adds the SIM 1 ICCID, IMEI 1, SIM 2 ICCID, fields and the Activate button.) Wi-Fi Ethernet Customer Managed Connectivity
   Organization (for MDM Devices only)	Select an organization from the drop-down list.
   SIM 1 ICCID (Required for a cellular connection.)	This field displays when you choose Cellular connectivity. Enter the 19-20 digit Integrated Circuit Card ID (ICCID).
   IMEI 1	This field displays when you choose Cellular connectivity. IMEI 1 is required for MDM devices and optional for non-MDM devices. Enter the 14-17 digit International Mobile Equipment Identity (IMEI) number that identifies the device associated with a SIM card.
   Activate	(Optional) Use the toggle to activate the SIM card during onboarding.
   SIM 2 ICCID (Required for a second cellular connection.)	This field displays when you choose Cellular connectivity. Use when you want to add a second SIM card. Enter the 19-20 digit Integrated Circuit Card ID (ICCID).
   IMEI 2 (Optional)	This field displays when you choose Cellular connectivity. Optional to use when you want to add a second SIM card. Enter the 14-17 digit International Mobile Equipment Identity (IMEI) number that identifies the device associated with a SIM card.
   Activate	(Optional) Use the toggle to activate the SIM card during onboarding.
   Description	Enter additional details about the device. Allowed character length: 0-100.
   Authentication (Required)	Select a method for how you want the device to authenticate before connecting to the Cloud. Client Secret (Default) Must include at least 1 lowercase, 1 uppercase, and 1 numeral. Allowed characters include Alphanumeric characters, exclamatory mark ( ! ), at the rate of (@), Pound (#), Dollar($), Percentage (%), Ampersand (&), Equals (=), Question mark ( ? ), underscore ( _ ), Period (.), Comma ( , ), Colon ( : ), Semi Colon ( ; ), Plus ( + ), Minus ( - ), Forward slash ( / ), backward slash ( \ ), Angular brackets (< & >) Allowed character length: 8-40. No Authentication—No additional information is required. Note: Oracle ECP does not support telemetry data ingestion to cloud for a device configured for no authentication.
   Device will be moving	Select this if the device will be in motion (for example, installed in a moving vehicle). This value provides information only and has no associated functionality.
   Country	Click to select the country where the device will be installed. When you choose United States (the), Oracle ECP requires entries for the remaining address fields. When you choose a country other than the United States, Oracle ECP requires only the Street Address.
   Street Address	Enter the street address for the building where the device will be installed. When the selected country is the United States, Oracle ECP requires the street address. Must start with alphanumeric character. Allows alphanumeric characters along with spaces and dots. Allowed character length: 0-100.
   City/Town	Enter the city or town in which the device will be installed. When the selected country is the United States, Oracle ECP requires the city or town. Allowed character length: 0-100.
   State/Region/Province	Click to select the state in which the device will be installed. Required when the selected country is the United States. For other countries, enter the region or province. Allowed character length: 1-100.
   Zip/Postal Code	Enter the zip code or postal code for the city in which the device will be installed. When the selected country is the United States, the zip or postal code field allows five numeric characters. The four-digit extension is optional and must follow a hyphen. Allowed characters: Digits and hyphen. When you select a country other than the United States, the postal code is optional. Allowed character length: 1-20.

7. (Optional) Click the + character opposite <Device Type> 1 to display another set of empty specification fields to onboard another device. You can onboard up to five devices at a time this way. Note: You cannot add other device types in this step. All additions must be Devices.
   After you specify values for all required fields, Oracle ECP activates the Continue button.
8. Click Continue to move to the final step of the Add Hardware process.
   A progress bar moves across the bottom of the page as Oracle ECP processes the values for each field. After Oracle ECP successfully validates fields and confirms that processing is complete, the Review Hardware screen summarizes the onboarding activities for each device specified.
9. Click Submit to upload the hardware information to Inventory.
   The Requests page displays summary information. For rows that include the View button, click to display more details.

Review Onboarding Requests