Introduction

Automatics system reads configuration data required for test execution from Automatics Props application. It is configuration management tool for Automatics system. User can configure automatics and partner specific config data and device model specific config data using this tool. The data from Automatics Properties will be consumed by  Automatics Core/Partner Implementation/Rest Implementation Projects for executing the test cases. Partner can also configure their environment specific config data to it.

There are two types of configuration data in Automatics Props. The templates of configuration files are available at source rdk/tools/automatics/automatics-props.

• Automatics properties - Java properties file with key value pair.  (automatics.properties)
• Device Props – Json file containing device configuration for each model. (device_config.json)

Following are the properties expected in automatics.properties file. In addition to this, partner can configure their data also.

Login Page

Automatics Properties page will be displayed upn on login. Following are the default properties.

To edit, the properties, click on 'UNLOCKED' link on left top side of page. This will allow only one person to update the document at a time. We will get pop message, "Successfully Locked".

Now user can edit the values and finally click on 'Submit' button to save the values. On submit, the application will save the values and logout and display message "Updated Successfully".

Automatics properties file

• Launch {protocol}//{host:port}/AutomaticsProps/automatics/props.
• User will be redirected to automatics properties page where it contains all the Properties which can be changed based on the requirements.
• Automatics Core/Partner Implementation/Rest Implementation Projects will read configuration values from this file.
• To edit the values, please click on “unlocked” button. Update the values and click on submit. This will save the configuration values.

Device properties file

• Launch {protocol}// {host:port}/AutomaticsProps/deviceProps.
• User will be redirected to device json page, where it contains the device model based configuration.
• To edit device properties, user has to update the file device_config.json deployed in tomcat server at path apache-tomcat/webapps/automatics/. Currently, UI support is not available to edit values of device_config.json.

Software Requirement

• JDK 1.8

Following page provide the detailed to setup Java 1.8 on linux

Automatics Orchestration Setup#JDK1.8 

• Tomcat 7.0.XX or above

Following page provide the detailed steps to setup Tomcat 7 version on linux

Automatics Orchestration Setup#Tomcat7.0.XX

• Maven 3

Following page provide the detailed steps to setup maven on linux

Automatics Orchestration Setup#Maven3

Setup

• Clone AutomaticsProps project from the repository (rdk/tools/automatics/automatics-props) with branch (“rdk-next”).
• Execute “mvn clean install”, and war file will be generated at target directory.
• Copy automaticsProps.war file to apache-tomcat/webapps directory and rename it to AutomaticsProps.war.
• Create a directory named “backup_file”, in apache-tomcat and place the sample “automatics.properties” file.  When ever user edits automatics properties, a backup file will be generated inside this directory.
• Create a directory “automatics” inside apache-tomcat/webapps.
• Copy “automatics.properties”, "device_config.json" and “config.properties” from automatics-props\src to tomcat/webapps/automatics folder. 
• Configure“config.properties” with username and password required for Automatics Properties UI login.
•  Start the server using command ./startup.sh.