Updating Login Portal on NetScaler with ADM

 

 Customizing the login portal on a Netscaler login page can be a bit tricky, especially since Citrix doesn’t officially support it. The challenge lies in updating multiple Netscaler devices across the environment. Unlike pushing CLI commands, which can be automated, portal changes are typically done manually through the GUI. These modifications often result in changes to specific files rather than the main ns.conf configuration file. For instance, when configuring background images or logos, the process involves adjusting these files directly. 🛠️🔒

Below is the path where the significant changes in custom portals will happen 

Logos

/var/netscaler/logon/themes/<custom theme name>/custom_media/

Configs Related to button/background header color/footer color/text file etc will happen for the below files in the path 

File: custom.css  and theme.css

path: var/netscaler/logon/themes/<custom theme name>/css/custom.css

           var/netscaler/logon/themes/<custom theme name>/css/theme.css

Also along with this please replace the custom_theme.json file which  is available under the custom theme folder

path: var/netscaler/logon/themes/<custom theme name>/custom_theme.json

The easiest way to handle this is to take one Netscaler and update the portal as needed and then the configs on that Netscaler should be on the 3 files along with logos. If we  do a config job on ADM to push the files to all Netscaler this will replace the files and changes will be effective immediately  ( no reboot needed)

The config job on Netscaler should look as below

Please note the custom_portal in the path is not a default. It is the name of folder if you create a custom theme.

Things to Note for the config job on ADM

1) Ensure we select "scp" for the dropdown before each command

2) Ensure we select the variable type as File. You should be able to see when you click on the variable or if you select the Preview Variable option on the right side top. 

3) Ensure we give the complete name of the file when specifying the path. Below is an example

Hope this helps 

cheeers!!!!