Page Comparison

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

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

   
   

...

Note that the abicloudDefault folder contains the predefined default theme; do not overwrite this folder or the login screen will not display correctly.

1. Compress your theme folder

2. Log in to the Abiquo Server and copy your theme to theme folder
   

   • The theme folder is /var/www/html/ui/theme

   • For example, using wget from the Abiquo Server to a Linux machine

     Code Block
     wget myuser@mymachine:~/Downloads/mytheme_base_theme.tar.gz /var/www/html/ui/theme

     
     

3. Move or copy any existing theme with this name to another folder name

   Code Block
   cd /var/www/html/ui/theme mv my_custom_theme my_custom_theme_backup

   
   

4. Extract the theme (which will OVERWRITE any theme with the same name). For example, when the theme was compressed with tar and gzip

   Code Block
   tar -zxvf my_custom_theme.tar.gz

   Remember to check the file ownership and access settings, because the Abiquo Tomcat server will need to access the branding files

...

Edit UI configuration to add new themes to enterprise menu

To add new themes to the enterprise menu, edit the UI configuration:

1. Log in to a shell on the Abiquo server as a user with the appropriate permissions (e.g. root or sudo user)

2. Edit the client-config-custom.json file to add new enterprise themes

   Code Block
   cd /var/www/html/ui/config vi client-config-custom.json

   
   

3. Edit the file and add the base theme and the custom themes as an element within the brackets { and }. 

   Code Block
   "client.themes": [ "abicloudDefault", "my_custom_theme" ]

   
   

    You must add abicloudDefault or the user interface will not load properly.
    Check your JSON file format with a JSON checker to ensure that the UI will load properly