This document provides the deployment steps for setting up Device Manager UI server and all its dependencies.

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

1. JDK – 1.8
2. TOMCAT – v8.5.xx
3. MAVEN – v3
4. Device Manager 

MySQL DB

Check whether My SQL DB is already installed and up and running.  For installation of MySQL in the below OS refer the below links

• Linux:

https://dev.mysql.com/doc/refman/5.6/en/linux-installation.html

Following page provide details on setting up MySQL 5.6 on linux .

Automatics Orchestration Setup#MySql5.6

• Microsoft Windows: https://dev.mysql.com/doc/refman/5.6/en/windows-installation.html

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 – v8.5 or above

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

• 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 from Apache Tomcat Download Webpage. You can use below wget command to download it. 

             $ wget <Apache Tomcat 8 archive file link>

Example:

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

Example:

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

Sample Output:

Maven – 3

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

• Download: https://maven.apache.org/download.cgi
• Installation: https://maven.apache.org/install.html

Following page will provide the detailed steps to setup maven.

Automatics Orchestration Setup#Maven3

Device Manager Server

Device Manager Server is used to manage different device details , add device details, edit device details, add device groups etc..

Please refer below link to bring up device manager setup .

Device Manager Deployment Document

Build Device Manager UI .war file

Build the .war file of Device Manager UI  using Maven 3 and JDK 8.

To do this follow the below steps:

1. Pull the latest Device Manager UI project from the repository.
2. After completing the pull, go the resources folder in the device manager UI project, and add the device manager server url as shown below.
   1. Navigae to (device-manager-ui\src\main\resource) open application.properties file
   2. set device_manager url to devicemanager.path

1. If you need to run the application other than localhost:8080 host, please follow the below steps to update in application.properties file.
   • Navigate to resource folder in device manager project(device-manager\src\main\resource) folder.
   • Open application.properties and update springfox.documentation.swagger.v2.host={protocol}:{host:port} value with selected port of your choice.
2. Now navigate to the project Home folder and run the command “mvn clean install”.
3. This will build device-manager-1.0.0-SNAPSHOT.war file of device-manager server in the folder “project_home/target”.