Management Tasks for Devices

After you add devices to Oracle Enterprise Communications Platform (Oracle ECP), you may need to manage their operations. Oracle ECP provides access to such tasks through the Inventory page and from each Device details page.

Ways to View Devices Connected to a Cloud Connector

When you want to view a list of devices connected to an Oracle Enterprise Communications Platform (Oracle ECP) Cloud Connector, use the following method.

If you are in the process of decommissioning an Cloud Connector with connected devices, you can get a list of connected devices directly from the decommissioning drawer instead of using the preceding procedure. The decommissioning drawer displays links to Download Device Details and View Details. You can download a list of connected devices or view the list online. When you view the list online, you can click the name an Cloud Connector and go directly the Edge Node Details page where you can disconnect devices.

View Details of Devices Connected to Cloud Connectors

Before you can decommission a Cloud Connector used with the Oracle Enterprise Communications Platform (Oracle ECP), you must disconnect all devices from the target Cloud Connector. You can either view the list of connected devices online or download a spreadsheet.

Context

The following procedure explains how to view the details of connected devices from the Devices tab on the Decommission Edge Node drawer.

Procedure

1. Access the Inventory page and select Edge Nodes from the context drop-down list.
2. On the Edge Nodes Inventory page, select the row of the target Cloud Connector.
3. In the Actions drop-down list, click Decommission.
   Oracle ECP displays the Decommission Edge Node drawer.
4. In the Decommission Edge Node drawer, click View Details.
   Oracle ECP displays a list of all devices connected to the selected Cloud Connector.

Next Steps

• Disconnect Devices From a Cloud Connector
• Decommission a Cloud Connector

Edit a Device

When you want to edit the details about one of your Oracle Enterprise Communications Platform (Oracle ECP) devices, you can do so from the Devices Inventory page.

Context

In the Update Device dialog, Oracle ECP displays the requirements for the data you can enter when you click the field.

Procedure

1. Access the Inventory page, select Devices from the drop-down list, and select the check box for the device you want to edit.
2. In the Actions menu, click Edit.
   Oracle ECP displays the Edit Device drawer.
3. Edit any of the following fields, except those that are Read-Only.

   Authentication Method (Read-Only)	N/A
   Description (Optional)	Valid values: 0-255 alphanumeric characters. Can include underscore, hyphen, comma, and space characters.
   Device will be moving	Used for troubleshooting. Default: Deselected. Valid values: Deselected | Selected.
   Country (Optional)	Choose from the drop-down list. When you choose the United States of America, you must complete the Street Address, City-Town, State, and Zip Code fields.
   Street Address	Required when you select Country. Must be an address in the United States when you select United States for Country. Valid values: Alphanumeric characters. Can include special characters. Allows one space between words and does not allow leading or trailing spaces.
   City | Town	Required only for United States addresses. Valid values: 0-100 alphanumeric characters. Can include special characters. Allows one space between words and does not allow leading or trailing spaces. Must begin with an alphabetical character.
   State | Region | Province	Required only for United States addresses. Alphanumeric characters. Can include special characters. Allows one space between words and does not allow leading or trailing spaces.
   Zip | Postal Code	Required only for United States addresses. Valid values for U.S. addresses: 5 digits minimum. You can append the Plus-4 digits. Valid values for non-U.S. addresses: 0-20 alphanumeric characters. Can include hyphen and underscore characters.
   Type (Read-only)	N/A
   Make	N/A
   Serial Number	N/A
   Protocol (Read-only)	N/A
   Connectivity Type (Read-only)	N/A
   ICCID 1(Read-Only)	N/A
   IMEI 1	The International Mobile Equipment Identity (IMEI) identifies the device associated with a SIM card. Two IMEI fields display when two SIM cards are associated with the device. Default: None. Required for MDM-enrolled devices using cellular connectivity. Not a required field for non-MDM devices requiring cellular connectivity.
   ICCID 2	SIM #2's ICCID
   IMEI 2	SIM #2's IMEI

4. Click Update Device.
   Oracle ECP displays a success status message. Upon success, the updates take effect.

Activate a Device

When you need to activate a device with Oracle Enterprise Communications Platform (Oracle ECP) other than during onboarding, you must perform the activation procedure before the device can communicate with a mobile network or the Oracle ECP cloud.

Before You Begin

• On the Devices Inventory page, confirm that the inactive device you want to activate is in the In Service or Pending Install life cycle state.

Context

You can select only one device at a time on the device table for the following procedure.

Procedure

1. Access the Inventory page, select Devices from the drop-down list, and select the check box for the device you want to activate.
2. Click the Actions menu and click Activate.
   Oracle ECP displays a confirmation dialog.
3. Click Activate Device.
   Oracle ECP displays a success status message. Upon success, cellular devices begin connecting to the mobile network and Wi-Fi devices begin connecting to Oracle ECP.

Deactivate a Device

When you need to temporarily remove a device from active service with Oracle Enterprise Communications Platform (Oracle ECP), you can deactivate the device.

Before You Begin

• On the Devices Inventory page, confirm that the target device is in the Active Lifecycle State.

Context

The result of the following procedure is immediate and deactivates both the device and the associated SIM card, as well.

You can select only one device at a time on the devices table for the following procedure.

Procedure

1. Access the Inventory page, select Devices from the drop-down list, and select the check box for the device you want to deactivate.
2. From the Actions drop-down list, click Deactivate.
   Oracle ECP displays a confirmation dialog.
3. Click Deactivate Device.

   Oracle ECP displays a success status message. Upon success, the device stops sending and receiving data in the network, but remains in your inventory.

Message a Device

When you want to debug connections to a device, you can message the device from the Oracle Enterprise Communications Platform (Oracle ECP) Inventory page with AT commands.

Before You Begin

• On the Devices Inventory page, confirm that the device Connectivity Type is Cellular. You cannot message a device connected by Wi-Fi.

Procedure

1. Go to the Inventory page, select Devices from the drop-down list, and select the check box for the device you want to message.
2. On the Inventory page, click the three ellipses (next to Deactivate) to open the actions menu.
3. On the Actions menu, click Message Device.
   Oracle ECP opens the Message Device drawer.
4. In the Message Device drawer, select the SIM card you want to message.
5. In the Message Device drawer, enter the AT command in the Enter Command field and click the Send arrow. Valid values: 1-160 characters.
   Oracle ECP displays any warnings.

   Note:

   Messaging is asynchronous, which means responses may take some time to return. Allow time to get a response. You can optionally return to the message device drawer to check on status at a later time or to send another message.
6. Close the Message Device drawer.

Next Steps

• (Optional) Go to the Actions menu and click Message Device to view the response from the device or to send another message.

Activate a SIM Card from the Device Details Page

When you want to activate a Subscriber Identity Module (SIM) card for use with a device you use with Oracle Enterprise Communications Platform (Oracle ECP), you can do so from the SIM Card Device Details page.

Context

After performing the following procedure, an activated device using the activated SIM card can connect to cellular services.

Procedure

1. Access the Inventory page and click Devices on the context drop-down list.
2. On the Devices Inventory page, click the name of the cellular Device you want to affect.
   Oracle ECP displays the corresponding Device Details Page.
3. On the Device Details page, click the ellipses at the top of the left pane to display the Actions menu.
4. On the Actions menu, click Manage SIM Activation State.
5. In the Manage SIM Activation State panel (displayed on the right), locate the SIM you wish to manage. Select the Activate checkbox.
6. Click Update to apply your changes.
   In a few moments, Oracle ECP displays a success message and changes the SIM Activation State to Active.

Manage the SIM Activation State

When you want to activate or deactivate SIM cards assigned to a device, you can toggle them on and off by selecting the device and opening the Manage SIM Activation State drawer. The drawer lists the SIM cards and provides a toggle for each one.

Context

The following procedure applies to both Cloud Connectors and Devices with cellular connectivity.

Before You Begin

• Confirm the SIM card you want to activate or deactivate is assigned to a device.

Procedure

1. Go to the Inventory page and select Devices from the drop-down list.
2. On the Devices Inventory page, click the name of the device associated with the SIM cards you want to activate or deactivate.
   Oracle ECP displays the Device Inventory details page.
3. On the Device Inventory details page, click the three ellipses in the left pane to open the actions menu.
4. On the Actions menu, click Manage SIM Activation State.
   Oracle ECP displays the Manage SIMs Activation State drawer.
5. In the Manage SIMs Activation State drawer, use the toggle to activate or deactivate the SIM card.
6. Click Update.
   Oracle ECP displays a success message.

Change the APN for Devices

To change the Access Point Names (APN) that a Subscriber Identity Module (SIM) card in Oracle Enterprise Communications Platform (Oracle ECP) inventory uses to access the Mobile Network Operator (MNO), use the Change APN action from the Devices Inventory page.

Context

Use the following procedure to update the APN for one or more devices that use SIM cards. To update the APN for SIM cards in multiple devices, select the devices for which the SIM cards are associated with the same MNO. To change the APN for multiple devices using AT&T SIM cards, the SIM cards must have the same MNO Account and rate plan.

If you change the APN for a device that uses a Vodafone SIM card, Oracle ECP displays a dialog box to inform you that a changing to a different Access Point Name changes the Customer Service Profile for the SIM card and may have an impact on connectivity service. To prevent unexpected changes, check your Vodafone Customer Service Profile details to confirm that only acceptable changes occur when you update the APN.

Procedure

1. Go to the Inventory page and select Devices from the drop-down list.
2. (Optional) On the Inventory page, click the Hide or Show Columns icon (top of table, right) to add the column headings for APN, MNO, and MNO Account, if they are not already displayed to help you find your targets.
3. On the Inventory page, select one or more devices and click the three ellipses (next to Deactivate) to open the actions menu.
4. On the actions menu, click Change APN.
   Oracle ECP opens the Change APN drawer.
5. In the Change APN drawer, do the following:
   • From the MNO Account drop-down list, select the MNO account you want to affect.
   • From the Access Point Network drop-down list, either select the APN you want or enter the new APN you want to use.
6. Click Change APN.
   Oracle ECP returns to the Devices Inventory page and displays the message Update APN request submitted successfully. After a few seconds you can see the APN you selected in the APN column for each device selected for the APN update of its SIM card.

Decommission a Device

When you no longer want to use a device with Oracle Enterprise Communications Platform (Oracle ECP), you can remove it from your inventory. Note that Oracle ECP does not retain any information about the device in the database after decommissioning.

Context

You can select multiple devices for the following procedure.

Note:

When you want to take an device offline temporarily, rather than permanently, see Deactivate a Device.

Procedure

1. Access the Devices Inventory page, select each device that you no longer want to use with Oracle ECP.
   If you decommission a Mobile Device Management-enabled device in Oracle ECP, the device is also removed from the MDM platform. Devices can be re-onboarded to the MDM and to Oracle ECP.
2. From the Actions drop-down list, click Decommission.
   Oracle ECP displays a confirmation dialog.
3. In the confirmation dialog, click Decommission Device.
   Oracle ECP displays a success status message with the name of the decommissioned device.

Next Steps

• You may now Review Offboarding Requests on the Requests screen to monitor as this process completes.

Disconnect Devices From a Cloud Connector

When you want to disconnect a device from a Cloud Connector, you must decommission the device from service with Oracle Enterprise Communications Platform (Oracle ECP).

Procedure

1. Access the Inventory page, select Edge Nodes from the context drop-down list, and click the name in the row of the target Cloud Connector.
   Oracle ECP displays the Edge Nodes Details page.
2. On the Edge Nodes Details page, click the Devices tab.
   Oracle ECP displays a list of all devices connected to the target Cloud Connector.
3. Click the Decomission button icon in the Actions column for an device.
   Oracle ECP displays a confirmation dialog.
4. Click Decommission Device.
5. Repeat steps 3 and 4 for each connected device.

Next Steps

• Decommission a Cloud Connector

Download Digital Twin Report

From the Oracle Enterprise Communications Platform (Oracle ECP) Inventory page, you can download a spreadsheet that lists all your digital twins with detailed information about each one. You might want the report to share with others or to save as a record.

Procedure

1. Access the Inventory page and select Devices from the context menu.
2. On the Devices page, click the name of the target device.
   Oracle ECP displays the Device Details page.
3. On the Device Details page, open the Actions menu and click Download DT Details.
   Oracle ECP downloads a .json file to your browser.

Download a Device Inventory Report

From the Oracle Enterprise Communications Platform (Oracle ECP) Inventory page, you can download a spreadsheet that lists all your devices with detailed information about each one. You might want the report to share with others or to save as a record of your inventory at a point in time.

Before You Begin

• Add or remove any filters. Oracle ECP applies the selected filters when generating the report.

Context

The report Oracle ECP generates includes all devices in your inventory, regardless of any selections you make in the table.

Procedure

1. Access the Inventory page and select Devices form the context drop-down list.
2. Click the Export button (download icon) located in the upper right corner of the Devices Inventory table, next to the Columns button..
   Oracle ECP immediately downloads a .csv file containing the device inventory data to your local machine.

   Note:

   Some spreadsheet applications automatically change long numbers in the cells of a Comma-Separated Value file (.csv) to exponential notation format. For long fields such as the ICCID identifier, be sure to change the cell format (for example, from General to Number) to see the value as originally specified. You will have to repeat the format change to see the original value for long fields in future sessions when the file is saved in .csv format.

Download a List of Devices Connected to Cloud Connectors

Before you can decommission an Cloud Connector used with the Oracle Enterprise Communications Platform (Oracle ECP), you must disconnect all devices from the target Cloud Connector. You can either view the list of connected devices online or download a spreadsheet.

Context

The following procedure explains how to download a spreadsheet of connected devices from the Decommission Edge Node drawer.

Procedure

1. Access the Inventory page and select Edge Nodes from the context drop-down list.
2. On the Edge Nodes Inventory page, select the row of the target Cloud Connector.
3. Above the table, click the More Actions button (ellipses). In the menu that appears, select Decommission.
   Oracle ECP displays the Decommission Edge Node drawer.
4. In the Decommission Edge Node drawer, click Download.
   Oracle ECP downloads a .csv file to your browser.
5. Open the spreadsheet to see the names and other information about all of the Devices connected to the target Cloud Connector.

Next Steps

• Disconnect Devices From a Cloud Connector
• Decommission a Cloud Connector