Abiquo branding admin guide

 

For details of how to manage branding within the UI see https://abiquo.atlassian.net/wiki/spaces/doc/pages/360939624

This section applies to Abiquo CSS branding, which is in versions prior to Abiquo 6.1. You can also use this process to upload CSS files for extra branding configuration, such as changes to buttons in the UI.

This page describes how to upload a theme for whitelabelling and install it on an Abiquo UI Server

Back up the Abiquo UI

In addition to regular backups, we recommend that you make a quick backup of the UI before enabling branding.

To back up the Abiquo UI:

  1. Log in to a shell on the Abiquo server with a user with root permissions and make a copy of the UI folder

    mkdir /opt/abiquo/quick_ui_backup tar -cvfz /opt/abiquo/quick_ui_backup/ui_`date +%Y%m%d`.tar.gz /var/www/html/ui/




Upload a branding theme

To upload a branding theme do these steps:

  1. Compress the theme, for example, if the theme is in a folder called customer

    tar -cvfz customer.tar.gz customer
  2. Copy the theme to the UI server, for example

    scp root@api-ui-server:~/Downloads/customer.tar.gz customer.tar.gz
  3. Log in to the UI server and go to the theme directory.

    Back up any existing customer theme by copying the theme directory

  4. Copy the customer theme to the theme directory and uncompress it
    This will overwrite any existing theme

  5. To check that the Apache server can read the theme, list all files and permissions:

    If the owner of the files is not the same as other UI files, change it to match. For example:

The abicloudDefault folder contains the predefined default theme. Do not overwrite this folder or the login screen will not display correctly.




Copyright © 2006-2024, Abiquo Holdings SL. All rights reserved