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 

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:

• 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. Device Manager Server Deployment is mandatory to use Device Manager UI.

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. Navigate to (device-manager-ui\src\main\resource) open application.properties file
   2. Update Device Manager URL to device-manager-ui  as shown below.

3.  Now navigate to the project Home folder and run the command “mvn clean install”.

4. This will build DeviceManagerUI.war file of device-manager-ui in the folder “project_home/target”.

Deploy Device Manager UI application

Device Manager application should be deployed in Tomcat server (ver 8.5 or above). Follow the below steps to deploy the application.

1. Copy DeviceManagerUI.war file from “project_home/target” to “TOMCAT_HOME/webapps” folder.
2. If you need to run the tomcat server in a port other than 8080, please follow the below steps to change the same.
   • Navigate to the folder “TOMCAT_HOME/conf”.
   • Open server.xml and change the connector port in this file from 8080 to an available port of your choice. If another tomcat is running the same machine then change the DEFAULT Tomcat server SHUTDOWN port from 8005 to another available port. If you dont need to a SHUTDOWN port for tomcat then change the default port from 8005 to “-1”.
3. To start Device Manager application go to “TOMCAT_HOME/bin” folder and run sh or startup.bat (if its running on Microsoft windows) script.
4. To verify server logs check “TOMCAT_HOME/logs/catalina.out” file.

To verify Device Manager UI application go to the URL : “{protocol}://{host:port}/DeviceManagerUI/login.html“