Table of Content
2. Adopting your Node/EdgeCaster into Cloud Control
6. Control Streaming on a Device
1. Authentication
To be able to log into Cloud Control for the first time, you will require an invite from an Admin within your organization. If you are the designated Admin, you should be receiving an invite from Videon.
Once you receive an invite in your inbox to join a particular organization in Cloud Control, you can create an account with that email, login to Cloud Control, and manage your preference of either joining the organization you have been invited to, or decline it. New accounts will have to verify their email address the first time they log in.
By design, each Cloud Control user has one account, and this account can join multiple organizations.
Step 1 : Look out for an email invite from noreply@videoncloud.com to join the organization you have been invited to within Cloud Control
Step 2 : Clicking on the link in the email will redirect you the login page. You can create your account here with the email address on which you received the invite. If you already have an account, you can simply login from here. If your email is managed by a Google GSuite account, you can use SSO to sign into Cloud Control.
Step 3 : If you created a new account, you will receive an email from.
no-reply@verificationemail.com to verify your email for Cloud Control. Once you verify this, you are set to log into Cloud Control from the link you received in the invitation email.
Step 4 : When you log in to Cloud Control, you will see all the pending requests from the organizations that have invited you to join.
Once you accept the invite, you will be taken to the dashboard of that organization and can get started.
2. Adopting your Node/EdgeCaster into Cloud Control
Step 1 : Note Down the Serial Number of your Node/EdgeCaster. You can find it on the back of the unit along with its MAC Address.
Step 2 : On Cloud Control, navigate to Devices > All Devices. This will show you the list of all devices already available in your organization. To adopt your new device into this organization select the "Adopt" button on the right of the search bar.
Step 3 : Next, you will see a dialogue box asking you to enter the serial number of the device you wish to adopt. Use the number you noted down in Step 1 here.
Step 4 : Select "Adopt" You should now be able to see your device within the list.
3. Fleets
Fleets are a group of Nodes/EdgeCasters engaged in the same activity or under the same ownership. A device can belong to multiple fleets within an organization. To create a new fleet:
Step 1 : Select Devices > Fleets.
Step 2 : Click on the "Create Fleet" button on the top right.
Step 3 : Name the fleet.
Step 4 : Select the devices that you want to add to the fleet from the list.
Greyed out items are devices that are already enrolled in the fleet. Red items are those who have a current alert.
Once your fleet has been created, you can click into it to see a detailed view of all devices within it along with a log of their events as shown below.
To remove devices from the fleet, select them with the checkbox on the left side first, then a contextual menu will appear at the bottom of the devices list.
4. Monitor a Device
Step 1 : Navigate to Devices > All Devices in the menu.
Step 2 : Select the Device name, and you will be taken to the page providing a detailed view of that device. If you cycle through the tabs, you can come back here through the "DEVICE INFO" tab.
Step 3 : You can get more health information by clicking a graph, like the temperature graph shown below. Also, when a firmware upgrade is available, you can see it from this screen (and click on the corresponding information to initiate an upgrade).
You can also see the graph in more details, or compare the status across multiple devices, by clicking on "OPEN IN METRICS EXPLORER' button on the top right of the modal window.
5. Configure a Device
Step 1 : Select the device you want to configure.
Step 2 : Click on the "CONFIGURATION" tab of the device. You will have access to most configuration parameters you have from the local GUI of a Node/EdgeCaster, or the local REST API. A couple of restrictions at the time or writing:
- No input preview image is available in Cloud Control yet
- You can't upload graphic overlay images from Cloud Control yet
- There is no secure storage for passwords on Cloud Control yet, which means you won't be able to pass a password for RTMPs, SRT or FTP upload.
Step 3 : Once the configuration is done on Cloud Control, you can push it to the device by clicking "save" and you can "FORCE SYNC" a device with the button on the right side. The same way, you can retrieve the current configuration on your local Node/EdgeCaster by clicking the "RELOAD" button.
6. Control Streaming on a Device
Step 1 :Select the device you want to configure.
Step 2 : Click on "OUTPUT CONTROL" in the upper right corner of the window, to select which ouputs you want to start or stop on your device. A device is shown as "streaming" when you have at least one output activat. You can only start streaming on outputs that have been previously configured.
7. Dashboard
The dashboard aggregates the near real time status of the user’s devices. With one glance, you can check the overall status of all your devices, see all active alerts, and a log of the events that occurred in the last 24 hours.
The dashboard is also a convenient way to tell if some of your devices need a firmware update (see he blue icons in the screenshot below, for "active streams").
As described above, you can select any device from the "Active Streams" to get a detailed view of their current status.
8. Alerts
When a device hits certain criteria, emails will be sent to a defined group of users and/or email addresses. Typical criteria include health and system metrics of the devices
Setting up alerts
Step 1 : Navigate to Alerts > Settings from the menu
Step 2 : Select the alerts you want to receive alerts for
Step 3 : Select the users on the organization that should receive alerts via email
Step 4 : Add any additional email that might not be present in the list to be alerted - this can typically used to trigger automated systems downstream
Step 5 : Click on "Update"
View and Manage Alerts
Silencing an Alert - By silencing an alert, we opt out of receiving any further notifications about that alert.
Resolving an Alert - By resolving an alert, we acknowledge the fact that the alert has been processed and platform is cleared out for normal operations.
If an alert has been resolved it can be re-triggered immediately.
If an alert has been silenced, it is never un-silenced automatically and has to be manually brought back from being silenced.
Step 1 : Navigate to Alerts > Alerts from the menu.
Step 2 : You can see the active alerts here and can choose to silence or resolve them if you want to let people know it has been looked into or if it is not crucial.
Step 1 : By clicking on an alert, you will have a new modal window to offer you the ability to silence or resolve/close an alert.
The Alert will stay open until the conditions go back to normal and the state is resolved or until a user decides to manually close an alert.
9. Reporting
Events
Step 1 : Navigate to Reporting > Events.
Step 2 : Choose the period for which you wish to see events.
You can see the logs for the selected period containing information such as device name, event timestamps, event name and event description.
Metrics
Step 1 : Navigate to Reporting > Metrics.
Step 2 : Select the device/s that you wish to see the metrics for.
Step 3 : Select the type of metrics you wish to see for the selected device/devices.
Step 4 : Select the time period for which you want to see metrics of the device.
You will see the graph of the devices selected with the metrics you chose, and the color code is shown in the device selection.
You can also click on the "DATA" tab and you will have access to the raw data that is presented in the graph, with the ability to download it as a .CSV file.
10. Organization Management
Organization : An organization can have multiple fleets within it. Users can be part of multiple organizations but a particular device cannot belong to more than one organization.
Step 1 : Navigate to the top right corner of the page and click on Settings.
Step 2 : Select "Switch Organization" from the options.
Step 3 : Select and organization from the list of organizations, or browse for an organization if it is not present in the list.
Manage Organizations
Step 1 : Navigate to the top right corner of the page and click on Settings.
Step 2 : Select "My Organizations" from the options.
Step 3 : If you are the Admin, you can edit the organization settings by clicking on "Edit". Here you can choose to invite people to join the organization, change the access levels of existing users in the organization, and remove people from an organization.
Step 4 : If you are the Admin, You can also create a new organization by clicking on the "CREATE ORG" button
Step 5 : If you are looking to obtain your Organization's org guid for any reason, including to obtain a list of devices adopted into your org:
- Navigate to Settings
- Click My Organizations
- Click your organization of concern
- Find the org guid in the URL listed as https://videoncloud.com/orgs/org_guid
11. Cloud API
You can refer to the API Documentation for Cloud Control here : Videon Cloud Control API Documentation
Step 1 : Make sure you have an account on the Cloud Control Web UI
Step 2 : Select "Manage Account" from the options.
Step 3 : Click on the "Create Token" button in the Access Token section
Step 4 : Provide a name to identify the token and select "Generate Token"
Step 5 : Download the access token for future reference.
NOTE : Make sure you store your access token in a secure password protected folder.
Step 6 : Use any REST API clients such as Postman to make API calls using the credentials referring to the API Guide
Step 7 : If you are looking to obtain your Organization's org guid for any reason, including to obtain a list of devices adopted into your org, please reference this example from our Cloud Control API Documentation.