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.
In the Edit Edge Node drawer, Oracle ECP displays the requirements for the data you can enter when you click the field.
Procedure
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.
- On the Edge Nodes Inventory page, confirm that the target Cloud Connector is the Active Lifecycle State and is in the Connected Connectivity State.
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.
- 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.
- 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.
- 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.
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.
- 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.
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.
- Confirm that the target Cloud Connector Life Cycle State is "Active" and the Connectivity State is "Connected".
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.
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.
| Edge ID | The ID number of the selected Cloud Connector. The ID number of the selected Cloud Connector. Valid values: 5 to 100 alphanumeric characters with only the underscore and hyphen special characters allowed. The edge ID must be unique for the tenant. |
| Serial Number | The serial number of the selected Cloud Connector. The serial number of the selected Cloud Connector. Valid values: 5 to 100 alphanumeric characters with only the underscore and hyphen special characters allowed. |
| 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 with only the underscore, hyphen, and space special characters allowed.. The model must start with an alphanumeric character. |
| Application | The name of the application. |
| Version | The version of each application currently installed. |
| Installed | The date when the current version of the software was installed. |
| Type | The type of application. |
| Status | The current state of the application. Active | Created | Running | Paused | Exited | Unknown. |
Note:
You cannot stop or remove system applications.| 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. |
| 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.
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.
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.
- 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.
Use the following procedure to install or update an application.
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.
- Confirm that the target Cloud Connector Life Cycle State is "Active" and the Connectivity State is "Connected".
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.
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.
The following steps let you update the APN toward the MNO for one or more SIM cards providing cellular connectivity to Cloud Connectors.
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.
- 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.
- Decommission a Cloud Connector—Decommission the target Cloud Connector (which breaks the association with the Starlink terminal).
- 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.
- (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.
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.
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.- You must disconnect all devices associated with the target Cloud Connector before you can decommission the Cloud Connector. Disconnect Devices From a Cloud Connector
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.
- Review Offboarding Requests on the Requests screen to monitor as this process completes.
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.
- Add or remove any filters. Oracle ECP applies the selected filters when generating the report.
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.
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.
- Confirm the target SIM card is assigned to the selected Cloud Connector and the SIM card state is "deactivated".
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.
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.
- Confirm the target SIM card is Activated.
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.
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.
- 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.
Note:
If you choose to block an MDM-managed device with the Customer Managed Device device type, you must enter the MAC address manually.