UI customization

Introduction

AdvanNet includes a GUI web-based application: AdvanNet Manager.

AdvanNet Manager application is entirely written in HTML5 and uses the REST API offered by AdvanNet.

Its customization can be achieved by a relatively easy process.

Configuration

Locate AdvanNet directory:

You must require root access

Check if your device has the folder:

/home/keonn/kernel/module/app.AdvanNet/alternatives

If so, select the subfolder that corresponds to the Advannet version you are running.

If the device has no "alternatives" folder, the default install directory is at:

/home/keonn/kernel/module/app.Advannet

Uncompress web application file

1. Make a copy of /home/keonn/kernel/module/app.Advannet/[alternatives/x.x.x]/lib/AdvanNetRest.war

2. Uncompress the file /home/keonn/kernel/module/app.Advannet/[alternatives/x.x.x]/lib/AdvanNetRest.war

Regardless of the war suffix, the file is a regular zip file that can be handled by any zip enabled compress utility.

Customize contents

Several customizations can be made. Amongst the most common requests are to customize the following:

  • Corporate logo: change the image file images/logo.png and images/login-logo.png

Keep the same dimension and exact file name.

  • favicon.ico: change the image files favicon.ico and images/favicon.ico

make sure the image type follows the favicon standard

  • Page titles: in files index.html and main.html change the tags <title>xxx</title> to whatever text.

Note that changes to other parts of the web application are possible although unsupported by Keonn Technologies S.L.

Compress the file again.

1. If necessary, use .zip extension and change it to .war

2. Make sure the contents of the web application keep the same organization than in the original file.

The final .war file must not contain any root directory in it. Make sure the .war file contents have the following structure:

    • config/

    • css/

    • ...

    • META-INF/

    • WEB_INF/

    • favicon.ico

    • index.html

    • main.html

Remove device cache

On embedded devices, it is necessary to remove the tmp web application cache located under:

/home/keonn/tmp/AdvanNet-2.x.x

Remove browser cache

To ensure your browser loads the new version of the page, remove its caché (instructions for Chrome)

Restart AdvanNet