Chapter 5. Customizing the Fuse Console branding
You can customize the Fuse Console branding information, such as title, logo, and login page information, by using the Fuse Console branding plugin.
By default, the Fuse Console branding is defined in the hawtconfig.json that is located in the Fuse Console WAR file (karaf-install-dir/system/io/hawt/hawtio-war/<version>/hawtio-war-<version>.war). When you implement the Fuse Console branding plugin, you can override the default branding with your own custom branding.
Procedure
-
Download the branding plugin example from
https://github.com/hawtio/hawtio/tree/master/examples/branding-pluginto a local directory of your choice. In an editor of your choice, open the Fuse Console branding plugin’s
src/main/webapp/plugin/brandingPlugin.jsfile to customize the Fuse Console branding.You can change the values of the configuration properties listed in Table A.1, “Fuse Console Configuration Properties”.
- Save your changes.
In an editor of your choice, open the Fuse Console branding plugin’s
pom.xmlfile to its<parent>section:<parent> <groupId>io.hawt</groupId> <artifactId>project</artifactId> <version>2.9-SNAPSHOT</version> <relativePath>../..</relativePath> </parent>Edit the
<parent>section as follows:-
Change the value of the
<version>property to match the version of your Fuse on Karaf installation. For example, if your Fuse on Karaf installation directory name is 2.0.0.fuse-760015, set the version to 2.0.0.fuse-760015. Remove the
<relativePath>../..</relativePath>line.For example:
<parent> <groupId>io.hawt</groupId> <artifactId>project</artifactId> <version> 2.0.0.fuse-760015</version> </parent>
-
Change the value of the
In a Terminal window, build the branding-plugin project by running the following command:
mvn clean install
If Fuse is not already running, start it by running the following command:
Linux/Unix:
bin/fuseWindows:
bin\fuse.bat`At the Karaf CLI prompt, type the following command to install the Fuse Console branding plugin (where
<version>is the version of your Fuse on Karaf installation):Linux/Unix:
install -s mvn:io.hawt/branding-plugin/<version>/warWindows:
install -s mvn:io.hawt\branding-plugin\<version>\war-
In a web browser, open the Fuse Console by using the URL that the start command returned in Step 7 (the default URL is
http://localhost:8181/hawtio/).
If you have already run the Fuse Console in a web browser, the branding is stored in the browser’s local storage. To use new branding settings, you must clear the browser’s local storage.