This article describes how to troubleshoot NetScaler Gateway portal customization in NetScaler 11.0 release.

Instructions

Ensure that customization are present within NetScaler file structure

All the custom themes created will be present in the following file structure -  /var/netscaler/logon/themes.

For any label or element which has been customized through the portal customization wizard and not applied while accessing the portal page, you need to first check and make sure that those customization are present within NetScaler file structure.

File Structure Snippet:
root@ns# pwd
/var/netscaler/logon/themes
root@ns# ls
Default
EULA Greenbubble
Harisha

root@ns# cd Harisha/

custom_media

homepage.html

root@ns# ls -l

total 34

drwxr-xr-x  2 root  wheel    512 May 28 10:52 css    

drwxr-xr-x  2 root  wheel    512 May 28 10:53 custom_media

-r--r--r--  1 root  wheel  25885 May 28 10:53 custom_theme.json

-r--r--r--  1 root  wheel    322 May 28 10:48 homepage.html

drwxr-xr-x  2 root  wheel    512 May 28 10:48 resources

root@ns# cd css
root@ns# ls
base.css
custom.css

Files present in the Directory Structure

Cascading style sheet files  - The css folder has a soft link to the base.css file from the theme chosen as template theme for the custom theme. On the other hand , all the modifications in css go into the custom.css file.

custom_theme.json=configuration files. This is used to save all changes made in custom theme and is used by the admin GUI wizard.

custom_media= All the Image Icons

Resources = Contains all modified labels for the gateway portal pages in the five languages supported.

The old way of customization is still valid for customers who want to make more changes compared to options currently exposed by admin wizard. But this procedure will still remain unsupported as before. Moreover, if “set vpn parameter UITHEME CUTSOM” command exists in ns.conf, then the new portaltheme entity doesn’t apply. To apply a theme created by wizard , they need to unset the vpn parameter “UITHEME”.

Log files for Portal customization

/var/log/portaltheme.log – Gets generated when any of the  “portaltheme” related commands are issued.

/var/log/uitheme.log – Gets generated when “set vpn parameter UITHEME” command is issued.