...

For setting up this server the below applications or tools should be available in the server machine:

1. JDK – 1.817
2. TOMCAT – v8v9.50.xx
3. MAVEN – v3.8 or above
4. Device Manager 

The below software should be installed and available for running Device Manager UI.

Jdk – 1.8

JDK should be available in the build machine where the .war file for Device Manager server is build and it should be available in the server machine.

• Linux:

https://docs.oracle.com/javase/8/docs/technotes/guides/install/linux_jdk.html

Following page provides details on installing Java 1.8 on linux.

Automatics Orchestration Setup#JDK1.8

• Microsoft Windows: 

https://docs.oracle.com/javase/8/docs/technotes/guides/install/windows_jdk_install.html#CHDEBCCJ

Tomcat – 8 - Ver above v8.5

Tomcast 8 is required to deploy Device Manager server. Tomcat server installation file and setup documents can be found in the below links:

If you already have an existing setup of Automatics you can follow the steps in this page for upgrading the software's Automatics Technology Stack - Upgrade 

Software Requirement

• JDK 17

Please note that even though the recommended version of Orchestration is JDK17, it is reverse compatible with JDK11 also. So code also be compiled with JDK11. Follow Steps below to install Java 17 on CentOS/linux.

• • Update before installing any new program

sudo yum -y update

• • Install Java 17

sudo yum install java-17-openjdk

• • Verify Java is Installed

java -version

Sample output:

Image Added

• MariaDB 10.11

Follow below steps to install and configure MariaDB on CentOS/linux

• • All the packages need to be up-to-date. Use the following command to update your packages.

    Code Block
    language bash
    sudo yum update

    Create a new repo file for the latest version.

    Code Block
    language bash
    vi /etc/yum.repos.d/MariaDB.repo

    Copy and paste the following contents into the /etc/yum.repos.d/mariadb.repo file.

    Code Block
    [mariadb] name = MariaDB baseurl = http://yum.mariadb.org/10.11/centos7-amd64 gpgkey=https://yum.mariadb.org/RPM-GPG-KEY-MariaDB gpgcheck=1

    To exit and save the Vim file, type :wq and press Enter.

  • Install the Latest Version of MariaDB

Install 10.11 of MariaDB and the most common packages, using the command below.

sudo yum install MariaDB-server galera-4 MariaDB-client MariaDB-shared MariaDB-backup MariaDB-common

• • Start MariaDB

    Start the MariaDB service with this command.

    Code Block
    language bash
    sudo systemctl start mariadb

    To set MariaDB to start automatically when the VM boots up, use the following command.

    Code Block
    language bash
    sudo systemctl enable mariadb

    Check the current status of MariaDB using this command.

    Code Block
    language bash
    sudo systemctl status mariadb

    Check the currently installed MariaDB version with this command.

    Code Block
    language bash
    sudo mysql -u root -p -V

• Tomcat 9.0.XX

• Download: https://tomcat.apache.org/download-80.cgi
• Setup: https://tomcat.apache.org/tomcat-8.5-doc/setup.html

Follow below Steps to setup Tomcat server  on CentOs/linux.

• • Download
Apache
• • Tomcat
archive file
• • 9 from
 Apache Tomcat Download Webpage. You can use below wget command to download it. 

             $ wget <Apache Tomcat 8 archive file link>

Example:

Image Removed

• After competed download extract archive file in /tmp directory and move to the proper location as per your need.

Example:

...

• • the Apache Tomcat Archive

wget -c https://downloads.apache.org/tomcat/tomcat-9/v9.0.85/bin/apache-tomcat-9.0.85.tar.gz

• • Extract the Tomcat archive to the directory in which you want to deploy the Automatics Tools

    Code Block
    language bash
    sudo tar -xvf apache-tomcat-9.0.85.tar.gz -C /opt/automatics/

  • Navigate to the tomcat file path and run ./bin/startup.sh cmd to start the tomcat server.

Sample Output:

Image Modified

Maven – 3

Maven is the tool used for building and managing Device Manager project. Please follow the below links to download and install Maven:

...

Automatics Orchestration Setup#Maven3

Device Manager REST API Back End Server

Device Manager REST API Server is REST API based tool to manage different device details , add device details, & edit device details, add device groups etc. Device Manager REST API Server Deployment is mandatory to use Device Manager UIUI is an application for visualizing and perform actions on different functionalities of device manager backend server.

Please refer below link to bring up know more about device manager setup and deployment.

Device Manager Deployment Document

...

Following are the steps to be followed to setup Device Manager UI and its dependent softwares software's in a Machine:

Build Device Manager UI .war file

...

• Pull the latest Device Manager UI project from the repository link : https://code.rdkcentral.com/r/admin/repos/rdk/tools/device-manager-ui.
• After completing the pull, go the resources folder in the device manager project, and add DeviceManager URL in application.properties.(device-manager-ui\src\main\resources).

Example:

...

...

• Now navigate to the project Home folder and run the command “mvn clean install”.
• This will build DeviceManagerUI.war file of device-manager-ui in the folder “project_home/target”.

...