Abiquo branding admin guide

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:

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/

To upload a branding theme do these steps:

Compress the theme, for example, if the theme is in a folder called customer
```
tar -cvfz customer.tar.gz customer
```

Copy the theme to the UI server, for example

scp root@api-ui-server:~/Downloads/customer.tar.gz customer.tar.gz

Log in to the UI server and go to the theme directory.
```
cd /var/www/html/ui/theme
```
Back up any existing customer theme by copying the theme directory
Copy the customer theme to the theme directory and uncompress it
This will overwrite any existing theme
```
cp ~/customer.tar.gz . 
tar -xvzf customer.tar.gz
```
To check that the Apache server can read the theme, list all files and permissions:
```
ls -al
```
If the owner of the files is not the same as other UI files, change it to match. For example:
```
chown -R root:root customer
```

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