...

• Device Manager has a support for health check feature.
• It empowers the testers and other users to do health check on the devices before executing any test cases.
• User can easily get the list of devices which are in good state and bring up the devices which are in bad statefilter out good and bad devices and this data will be helpful in bringing up the devices manually before testing.
• It reduces the tester time for verifying and getting the devices which are in good state.

Automatic Device Manager Components

• Device Manager UI - UI 
  • Provides UI interface to config
  device details
  • health check parameters and schedule health check for list of devices.
  Device Manager -
  • Health Check execution status can be seen on the dashboard.
  • UI Support to update or delete the devices to the already scheduled executions is provided.
  • User is provided with option to cancel the execution in scheduled state.

• Device Manager 
  • Manages scheduled details request and
  trigger executions.
• Automatic Properties - Provides UI Interface to configure device related configurations.

...

• • update it to DB if the provided request details are valid.
  • List of devices added for each scheduled are restricting to 20 considering the jenkins cannot hold more logs and JVM memory assigned for each jenkins job
  • Handles jenkins requests that need to be triggered on the scheduled execution date and time.
  • Provides the APIs implementation which are required for updating the execution details after each execution from the partner implementation.
• Health Check Partner Implementation -

Manages Health check validation for the selected devices based on the defined health check steps and update the results to the Device manager.

Basic Health Check implementation project is open sourced which provide the support to check device state in good or bad based on SSH connection validation. If SSH connection got failed then device status is updated to bad otherwise set to good on successful connection. Support is provided to read the device connection credentials from the server-config.xml file  

Basic Health partner implementation repo url : https://code.rdkcentral.com/r/c/rdk/tools/device-manager-healthCheck-partnerImpl

Partner can provide there own custom health check implementation  which supports health check executions and update the executions results to device manager . List of APIS that need to be invoked as a part of health check implementation so once the executions are done on the jenkins job results can be updated to the device manager. Please refer the Device manager API documentation for more details.

Following diagram shows interaction of Automatics components and Partner components in a deployed environment

Design for Device Health Check Feature in Device manager

...

Health Check Partner Implementation

...

New Device Manager Setup

Device Manger Setup 

For a partner to setup device manager newly that can be done in either of the ways as mentioned below

Manual Deployment

Partner can deploy the device manager in local setup manually by referring Device Manager Deployment.

Automated Deployment

Automatics Automated Deployment make use of use of Jenkins scripts for creating pipeline jobs to build Automatics projects. Device Manager will also be deployed as a part of Automatics projects. Refer Automatics Automated Deployment

Device Manager UI

For a partner to setup Device Manager UI newly that can be done in either of the ways as mentioned below.

Manual Deployment

Partner can deploy the Device Manager UI in local setup manually by referring Device Manager UI Deployment. 

Automated Deployment

Automatics Automated Deployment make use of use of Jenkins scripts for creating pipeline jobs to build Automatics projects. Device Manager UI will also be deployed as a part of Automatics projects. Refer Automatics Automated Deployment

Upgrade Device Manager to support Health Check execution

...

1. Upgrade Device Manager to v1.0.2 or above since it contains the latest code changes for Health Check execution. Pull the latest code of Device Manager.
2. Run the SQL scripts from Device_Manager_DB.sql file present in the Automatics Orchestration Device Manager starting from line number 335. These scripts will help in creating all the new tables that are required for health check execution.
3. Once after the above changes generate a WAR file of Device Manager  and deploy it in the tomcat server. Deployment can also be done using Device Manager Deployment. 
4. Verify whether the deployment is done and updated to 1.0.2 version.

Device Manager UI

For a partner to upgrade the health check support in Device Manager UI Please follow below steps.

1. Upgrade Device Manager UI to v1.13 or above since it contains the latest code changes for Health Check execution. Pull the latest code of Device Manager UI.
2. Once after the above changes generate a WAR file of Device Manager  and deploy it in the tomcat server. Deployment can also be done using Device Manager UI Deployment. 
3. Verify whether the deployment is done and updated to 1.13 version.

Setup Jenkins Job For Health Check

For a partner to setup health check job in jenkins Please refer Jenkins job is getting used in the device manager to execute health check steps and update the execution results. Partner can refer Health Check Job Configuration for details stepsdetailed steps on how to setup jenkins job for health check.

Steps to schedule

...

health check

...

• Schedule the health check for the list of devices Please refer Schedule Health Check for more details on how to schedule executions for health check.
• On successful scheduling success pop will be seen and dashboard will be updated.

...