Management Tasks for Cloud Connectors

After you add Cloud Connectors to Oracle Enterprise Communications Platform (Oracle ECP), you may need to manage their operations. Oracle ECP provides access to such management tasks through the actions menu on the Inventory page.

Edit a Cloud Connector

When you want to edit the description, location, or other details about one of your Oracle Enterprise Communications Platform (Oracle ECP) Cloud Connectors, you can do so from the Edge Nodes Inventory page.

Context

In the Edit Edge Node drawer, Oracle ECP displays the requirements for the data you can enter when you click the field.

Procedure

  1. Go to the Inventory page, select Edge Nodes from the drop-down list, and select the check box in the row of the Cloud Connector you want to update.
  2. On the Edge Nodes Inventory page, select an Edge Node, and click Edit.
    Oracle ECP displays the Edit Edge Node drawer.
  3. Edit the following fields. (The others are Read-Only.)
  4. Click Update.
    Oracle ECP displays any error messages in the drawer. Upon success, Oracle ECP displays a toast message in the parent window.

Reboot a Cloud Connector

When you need to reboot a Cloud Connector, you can do so from the Oracle Enterprise Communications Platform (Oracle ECP) Edge Nodes Inventory page.

Before You Begin
  • On the Edge Nodes Inventory page, confirm that the target Cloud Connector is the Active Lifecycle State and is in the Connected Connectivity State.
Procedure
  1. Access the Inventory page, select Edge Nodes from the drop-down list, and select the check box in the row of the Cloud Connector you want to reboot.
  2. From the Actions drop-down list, click Reboot.
    Oracle ECP displays a confirmation dialog.
  3. In the confirmation dialog, click Reboot Edge.
    Oracle ECP begins the reboot immediately and displays a success status message.

Cloud Connector Platform Management

Oracle Enterprise Communications Platform (Oracle ECP) uses a group of components called a platform to operate Cloud Connectors and provides the Platform Manager tool on the User Interface to help you manage and coordinate the platform components. Oracle installs the platform on the Cloud Connectors initially, but you may periodically need to update the versions of the platform components.

The platform includes the Platform Manager, the Operating System, the Global Business Unit (GBU) component, and some drivers. To use the Platform Manager, select a Cloud Connector on the Edge Nodes Inventory page that is in the Supported state and click Manage Platform on the Actions menu. Oracle ECP opens the Manage Platform drawer where you can select different versions of the components to deploy on the Cloud Connectors. The drawer displays following information about the currently available platforms.
  • Edge ID—The ID number of the selected Cloud Connector. Valid values: 5 to 100 alphanumeric characters. Can include the underscore and hyphen characters. The edge ID must be unique for the tenant.
  • Serial Number—The serial number of the selected Cloud Connector. Valid values: 5 to 100 alphanumeric characters. Can include the underscore and hyphen characters.
  • MAC Address—The MAC address of the selected Cloud Connector. Valid values: Hexadecimal 0-9, A-F, and a-f. Format: XX:XX:XX:XX:XX:XX or XX-XX-XX-XX-XX-XX or XXXX.XXXX.XXXX .
  • Model—The model name of the selected Cloud Connector. Valid values: 0-100 alphanumeric characters. Only the underscore, hyphen, and space special characters allowed. The model must start with an alphanumeric character.
  • Current Platform—The names of the currently installed platform packages.
  • Version—The version of each platform currently installed.
In the Manage Platform drawer, when you click the Select a new package for deployment drop-down list, Oracle ECP displays a list of all available platform packages with the following information:
  • Package Name—The names and versions of the available packages.
  • Creator—The name of the person or entity that created the application. (Optional—May or may not display a name.)
  • Creation Date—The date when the version of the package was created.
  • Expiration Date—The date when the version of the package expires.
In the Manage Platform drawer, when you select a platform, Oracle ECP displays the following information about the platform:
  • Creation Date—The date when the version of the package was created.
  • Expiration Date—The date when the version of the package expires.
  • Documentation—The link to the package Release Notes or other documentation, if available.
  • Package Contents—The description of each component in the selected package.
  • Version—The version of each component in the selected package.

The Manage Platform drawer shows the deployment options below the selected package. The only supported choice at this time is Immediate, which deploys the package right away when you click Deploy.

See Update the Cloud Connector Platform.

Update the Cloud Connector Platform

Periodically you may need to update the version of the Oracle Enterprise Communications Platform (Oracle ECP) platform running on a Cloud Connector. The platform is the operating system. Oracle delivers the platform software in a package,which you deploy onto the Cloud Connector.

Before You Begin
  • On the Edge Nodes Inventory page, confirm that the target Cloud Connector is in the Active Lifecycle State and is in the Connected Connectivity State.
Procedure
Use the following procedure to install or update a platform.
  1. Access the Inventory page, select Edge Nodes from the drop-down list, and select the check box in the row of the Cloud Connector you want to update.
  2. From the Actions drop-down list, click Manage Platform.
    Oracle ECP displays the Manage Platform drawer, listing all the current platforms.
  3. In the Manage Platform drawer click the Select a new package for deployment drop-down list, scroll through the platforms, and select the one you want to install.
    Oracle ECP displays the Package Name, Creator, Creation Date, and Expiration Date, and a link to the package Release Notes or other platform documentation when available.
  4. In the Manage Platform drawer under Deployment, Immediate is the only supported choice at this time.
    • Click Immediate—Default. The only supported choice at this time is Immediate, which deploys the package right away when you click Deploy.
    • Click Scheduled—(Reserved for future use.)
  5. Click Deploy.
    Oracle ECP displays a message with the success state of the deployment. The message includes a link to the Edge Platform Deployment tab where you can view the details of the deployed package and link to more information about the Cloud Connector.

Get Platform Logs

When you want to view your Oracle Enterprise Communications Platform (Oracle ECP) Cloud Connector platform logs, access the Inventory page to generate and download the platform log files. Any user with an Oracle ECP Administrator role can generate and download the log files.

Before You Begin
  • Confirm that the target Cloud Connector Life Cycle State is "Active" and the Connectivity State is "Connected".
Context

Oracle ECP lets you collect logs data for a platform on the date of your choice for a period of time that interests you. On the Logs tab, you can click the down arrow in the right pane and choose Platform to list the newly generated logs of that type. Note that Oracle ECP displays the log creation time stamp in Coordinated Universal Time (UTC), but you use your local time in the date picker. In the following procedure, the maximum time span you can specify is the last twenty-four hours.

Procedure
  1. Access the Inventory page and select Edge Nodes on the Inventory context drop-down List.
  2. In the Edge Nodes table, click the Name of the target Cloud Connector.
  3. On the Edge Nodes details page, open the Actions menu, and click Get Platform Logs.
    Oracle ECP displays the Get Platform Logs drawer with the time and date picker open.
  4. On the date picker, pick the calendar date for which you want to collect logs data, then click Done.
    Oracle ECP displays the Select logs duration slider.
  5. Click the knob on the slider track and drag it right to set the hours of log data collection at 1-24 hours.
  6. Click Get Logs to process the logs request.
    Oracle ECP displays an acknowledgment message and increments the O-tag when the log file is transferred which can take several minutes.
  7. Click the Logs tab, locate the target log file in the Platforms section, and click the download icon.

Cloud Connector Application Management

Cloud Connectors rely on applications to perform their operations and Oracle Enterprise Communications Platform (Oracle ECP) provides the minimum set of applications required to run the system. You can install and manage other applications to meet the needs of your deployment with the tools Oracle ECP provides.

Oracle ECP provides the Cloud Connector management tools by way of the Actions drop-down list on the Inventory tab. When you select an Active and Connected Cloud Connector on the Edge Nodes Inventory page and click Manage Application on the Actions drop-down list, Oracle ECP displays the Manage Application drawer with the following information about the currently installed applications.

Note:

You cannot stop or remove system applications.
In the Manage Application drawer, when you click the Select a new package for deployment drop-down list, Oracle ECP displays a list of all available applications with the following information:
In the Manage Application drawer, when you select a package Oracle ECP displays the following information about the package:

The Manage Platform drawer shows the deployment options below the selected package. The only supported choice at this time is Immediate, which deploys the package right away when you click Deploy.

To see more details about the applications on a particular Cloud Connector, click the name of the Cloud Connector on the Cloud Connector Inventory page to go to the Edge Node Details page. On the Edge Node Details page, click the Applications tab. In the Applications drop-down list, click the application you want to know about.

See Install or Update a Cloud Connector Application.

Install or Update a Cloud Connector Application

Periodically you may need to update the version of an application running on an Oracle Enterprise Communications Platform (Oracle ECP) Cloud Connector or install a new one. Oracle delivers application software in a package, which you deploy onto the Cloud Connector from the Manage Application drawer on the Edge Nodes Inventory page.

Before You Begin
  • On the Edge Nodes Inventory page, confirm that the target Cloud Connector is in the Active Activation State and is in the Connected Connectivity State.
Context

Use the following procedure to install or update an application.

Procedure
  1. Access the Inventory page, select Edge Nodes from the drop-down list, and select the check box in the row of the Cloud Connector you want to update.
  2. From the Actions drop-down list, click Manage Application.
    Oracle ECP opens the Manage Application drawer. At the top is a list of the applications installed on the Cloud Connector that includes helpful information such as application version and installation date.
  3. In the Manage Application drawer click the Select a new package for deployment drop-down list, scroll through the applications, and select the package you want to deploy.
    Oracle ECP displays the Package Name, Creation Date, Expiration Date, Package Contents and Version. The Documentation column includes a link to the package Release Notes or other application documentation when available for your selected package.
  4. Click a value to indicate the timing for the deployment of the selected package. Under Deployment, "Immediate" is the only supported choice at this time.
    • Immediate—Default. The only supported choice at this time is Immediate, which deploys the package right away when you click Deploy.
    • Scheduled—(Reserved for future use.)
  5. Click Deploy.
    Upon successful start up, Oracle ECP displays a message at the bottom of the age to confirm that deployment of the selected application is in progress. The message includes a link to the Edge Application Deployment page where you can view the percentage of deployment complete (top left), along with details of the selected hardware and package contents. The Selected Hardware section includes a link in the Name column that you can click to navigate to the Edge Node Details page.

Get Application Logs

When you want to view your Oracle Enterprise Communications Platform (Oracle ECP) Cloud Connector application logs, access the Inventory page to generate and download the application log files. Any user with an Oracle ECP Administrator role can generate and download the log files.

Before You Begin
  • Confirm that the target Cloud Connector Life Cycle State is "Active" and the Connectivity State is "Connected".
Context

When you go to the Logs tab, you can find the newly generated logs for applications in the Application Logs table. Note that Oracle ECP displays the log creation time stamp in Coordinated Universal Time (UTC), but you use your local time in the date picker. In the following procedure, the maximum time span you can specify is the last twenty-four hours.

Procedure
  1. Access the Inventory page and select Edge Nodes on the Inventory context drop-down List.
  2. In the Edge Nodes table, click the Name of the target Cloud Connector.
  3. On the Edge Nodes details page , click the Applications tab.
  4. On the Applications tab, locate the application running on the target Cloud Connector and click the three dots in the Actions column.
    Oracle ECP displays the Actions menu.
  5. In the Actions menu, click Get Application Logs.
    Oracle ECP displays the Get Application Logs drawer with the time and date picker.
  6. In the date picker, click the Start Time field.
    Oracle ECP displays the time and date picker with the current twenty-four hour date range and the local time.
  7. In the Start Time picker, do the following:
    • Date—Click one of the dates.
    • Time—Click the time stamp, set the start time, and click Done.
  8. In the End Time picker, do the following:
    • Date—Click one of the dates.
    • Time—Click the time stamp, set the end time, and click Done.
  9. Click Get Logs.
    Oracle ECP displays an acknowledgment message and increments the O-tag when the log file is transferred which can take several minutes.
  10. Click the Logs tab, locate the target log file in the Applications section, and click the download icon.
    When the list of log files fills the center pane, you can scroll to view more logs in the list.

Change APN (MNO) from Cloud Connector

Oracle Enterprise Communications Platform (Oracle ECP) lets you change the Access Point Name (APNs) that a Subscriber Identity Module (SIM) card in Oracle ECP Inventory uses to access the Mobile Network Operator (MNO) by way of the Update APN action on the Edge Nodes Inventory page or the Edge Node Details page.

Context

The following steps let you update the APN toward the MNO for one or more SIM cards providing cellular connectivity to Cloud Connectors.

Procedure
  1. Go to the Inventory Page.
  2. On the Inventory page, select Edge Nodes from the context drop-down menu.
  3. (Optional) On the Edge Nodes 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 update the APN for SIM cards in multiple Cloud Connectors, select Cloud Connectors for which the SIM cards are associated with the same MNO. To change the APN for multiple Cloud Connectors that use AT&T connectivity services, the SIM cards must have the same MNO Account and data plan.
  4. On the Edge Nodes Inventory page, identify the Cloud Connectors you want to update and select the corresponding check boxes on the Edge Nodes Inventory page.
  5. Click the Actions menu and select Change APN (MNO).
  6. In the Update APN drawer, click the Access Point Network drop-down and select the APN you want to use from the list of APNs that the MNO allows the SIM card to use.
  7. Click Change APN.

    Note:

    When you change the APN for a Cloud Connector 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 service profile for the SIM card and may affect connectivity service. If you are unsure about the change, you can cancel the action. Otherwise, click Update APN on the dialog box.
    Oracle ECP closes the Update APN drawer and displays a message at the bottom of the screen: Update APN request submitted successfully. Make sure to update and match the new APN on the devices. If there are issues, Oracle ECP displays related information at the top of the page. After a few seconds you can check the rows for the Cloud Connectors with SIM updates to see the APN you selected in the APN column for each.

Change the Country Code for a Cloud Connector Associated with a Starlink Terminal

When you want to relocate an Oracle Enterprise Communications Platform (Oracle ECP) Cloud Connector associated with a Starlink terminal to a different country, you must use the following process.

The process includes the following steps:
  1. Confirm that you have a Starlink account for the country where you want to locate the Cloud Connector already onboarded and present in Oracle ECP. About Starlink Accounts.
  2. Decommission a Cloud Connector—Decommission the target Cloud Connector (which breaks the association with the Starlink terminal).
  3. Onboard the Cloud Connector with the Onboard Edge Nodes Manually procedure. In the procedure you must choose Satellite as a secondary connectivity method, enter the Starlink user terminal identifier, and set the country code you want along with other details.
  4. (Optional) Go to The Edge Nodes Inventory Page and confirm the target Cloud Connector displays the correct country. If the Country column is not displayed, click the Show-Hide icon and click Country.

Change the Satellite Service Plan

When you want to change the satellite service plan in use with an Oracle Enterprise Communications Platform (Oracle ECP) Cloud Connector, you can do so from the Edge Nodes Details page.

Context

In the following procedure you can select a satellite service plan, set the quantity for each Data Block size and toggle Additional Priority on and off. The list of service plans comes from the vendor during the discovery process.

Procedure
  1. Access the Edge Nodes Inventory page and click the name of the Cloud Connector using the satellite service you want to change.
    Oracle ECP displays the Edge Nodes Details page.
  2. On the Edge Nodes Details page, click the three ellipses in the left panel to expand the actions menu, and click Change Service Plan (Satellite).
  3. In the Change Satellite Service Plan drawer, you can do the following:
    • Toggle Additional Priority on and off.
    • Select a plan from the Service Plan drop-down list.
    • Set the quantity for each Data Block size.
  4. Click Apply.
    Oracle ECP displays a message to acknowledge whether the action is successful or not.

Decommission a Cloud Connector

When you no longer want to use a Cloud Connector with Oracle Enterprise Communications Platform (Oracle ECP), you can remove it from your inventory with the following procedure. Oracle ECP retains historical information about the decommissioned Cloud Connector in the database after decommissioning.

Note:

Decommissioning a Cloud Connector is a final action. Once decommissioned, it can no longer re-onboard it to Oracle ECP. The Cloud Connector must be returned to Oracle before the hardware can be reused.
Before You Begin
Context

When you decommission an Cloud Connector with a satellite connection, Oracle ECP deactivates the satellite service line and removes the terminal from service. The terminal becomes available for assignment to another Cloud Connector.

Procedure
  1. Access the Inventory page, select Edge Nodes from the context drop-down list, and select the check box in the row of the Cloud Connector you want to decommission.
  2. From the Actions drop-down list, click Decommission.
    Oracle ECP displays the Decommission Edge Node drawer.
  3. In the Decommission Edge Node drawer, do one of the following:
    • Decommission Edge button is enabled—With no devices connected to the selected Cloud Connector, Oracle ECP enables the Decommission button. Click the button to decommission the Cloud Connector.
    • Decommission Edge button is disabled—With devices connected to the target Cloud Connector, Oracle ECP disables the Decommission Edge button until you disconnect them all. Click View Details to go to the Edge Node Details tab and disconnect all connected devices by clicking the trash can icon one-by-one. Return to the Decommission Edge Node drawer and decommission the target Cloud Connector.
    Oracle ECP displays a status message with the name of the decommissioned Cloud Connector.
Next Steps

Download a Cloud Connector Inventory Report

From the Oracle Enterprise Communications Platform (Oracle ECP) Edge Nodes Inventory page, you can download a .csv file after you apply filters that lists all your Cloud Connectors 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 Cloud Connectors in your inventory after filters are applied, regardless of any selections you make in the table.

Procedure
  1. Access the Inventory page and select Edge Nodes.
  2. Click the Export button (download icon) located in the upper right corner of the Cloud Connector Inventory table, next to the Columns button..
    Oracle ECP downloads .csv file to your desktop.

Activate a SIM Card on a Cloud Connector

You may find it easier to activate a SIM card from the Oracle Enterprise Communications Platform (Oracle ECP) Edge Node Details page than from the SIM Card Details page. For example, you do not need to know the name of the SIM card to activate directly from an Cloud Connector.

Before You Begin
  • Confirm the target SIM card is assigned to the selected Cloud Connector and the SIM card state is "deactivated".
Context

After you successfully perform the following procedure, the Cloud Connector using the activated SIM card can use cellular services. This procedure does not affect Wi-Fi or Ethernet services.

Procedure
  1. Access the Edge Nodes Inventory page and click the name of the Cloud Connector you want to affect.
  2. On the Cloud Connector Details page, click the three ellipses in the left pane.Oracle ECP displays the Actions menu.
  3. On the Actions menu, click Manage SIM Activation State.
  4. In the Manage SIM Activation State panel (displayed on the right), locate the SIM you wish to manage. Select the Activate checkbox.
  5. Click Activate SIM.
    Oracle ECP displays a success message.
  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.

Deactivate a SIM Card on a Cloud Connector

You may find it easier to deactivate a SIM card from the Oracle Enterprise Communications Platform (Oracle ECP) Edge Node Details page than from the SIM Card Details page. For example, you do not need to know the name of the SIM card to deactivate directly from an Cloud Connector.

Before You Begin
  • Confirm the target SIM card is Activated.
Context

After you successfully perform the following procedure, the Cloud Connector using the deactivated SIM card can no longer use cellular services. The procedure does not affect Wi-Fi or Ethernet services.

Procedure
  1. Access the Edge Nodes Inventory page and click the name of the Cloud Connector you want to affect.
    Oracle ECP displays the Edge Nodes Details page.
  2. On the Cloud Connector Details page, click the three ellipses in the left pane.Oracle ECP displays the actions menu.
  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 Deactivate checkbox.
  6. In the actions menu, click Deactivate SIM.
    Oracle ECP displays a confirmation dialog.
  7. Click Update to apply your changes.
    In a few moments, Oracle ECP displays a success message and changes the SIM Activation State to Deactivated.

Manage Devices on a Wireless Network

Oracle Enterprise Communications Platform (Oracle ECP) lets you manage devices connected to two different Wi-Fi LAN networks of the Cloud Connector.

Before You Begin
  • Identify by name the Cloud Connector that includes the wireless network interface that the Devices you are interested in managing use for Internet connectivity. You must also note the names of any Devices that need to be blocked from connecting on the wireless network. Confirm that you have a static IP address for each Device that you want to allow on the wireless network.
Context
Any onboarded Device that uses Wi-Fi connectivity can use the SSID and password to connect to the Oracle ECP-managed wireless networks provided by Cloud Connectors. You can manage Device access to the wireless networks from the Network tab of the Edge Node Details page.

Note:

If you choose to block an MDM-managed device with the Customer Managed Device device type, you must enter the MAC address manually.
Procedure
  1. From the Edge Nodes Inventory page, identify a Cloud Connector with a wireless network interface and click the Name column to drill down to that Cloud Connector's details page.
  2. Click the Network tab, then click the drop-down arrow on the right pane to choose the wireless interface (wlan0 or wlan1) of the wireless network on which you want to manage Devices.
  3. On the right pane, click the Action menu (…) and choose Manage Devices.
    The Manage LAN Devices drawer opens.
  4. To allow a Device on the managed wireless network:
    1. Click Add device to add a blank row to the drawer.
    2. Click the Device Name drop-down and select the device that you want to allow on the wireless network.
    3. In the Static IP field enter an available static IP address on your network in dotted-decimal format.
    4. Click the check icon to process the changes on the row.
  5. To block a Device currently allowed on the managed wireless network:
    1. Choose the row for the Device and click the pencil icon.
    2. Click the check box in the Block MAC Address column header to enable blocking the device from the wireless network.
    3. Click the check icon to process the changes on the row.
  6. To block a Device not currently using the managed wireless network:
    1. Click Add device to add a blank row to the drawer.
    2. Click the Device Name drop-down and select a Device that you want to block from accessing the wireless network. Oracle ECP provides the MAC address for the Device you selected.
    3. Click the check box in the Block MAC Address column header to enable blocking the device from the wireless network.
    4. Click the check icon to process the changes on the row.
  7. To remove the block for a Device and admit it to the wireless network:
    • Choose the row for the Device and click the pencil icon.
    • Click the check box in the Block MAC Address column header to clear the block.
    • Click Static IP and enter an available static IP address.
    • Click the check icon to process the changes on the row.
  8. Click Update to save the changes made.