Citrix NetScaler

Quick way to brand Access Gateway and Web Interface 5.4 with company logo and colors

on

If you have a need to quickly brand your Netscaler Access Gateway and Web Interface 5.4 with your company colors and logo, it’s pretty easy and can be done in less than 30 minutes if you are under a deadline. It’s easy in StoreFront too, just don’t have one in front of me right now to write about. This is quick and dirty, you can do more work to match them up exactly but I just wanted to knock this out in 30 minutes.

NETSCALER ACCESS GATEWAY
Just download one of these available themes Jeff Sani posted:

http://blogs.citrix.com/2011/04/11/horizon-theme-for-citrix-netscaler/
http://blogs.citrix.com/2012/06/19/symphony-theme-for-citrix-netscaler/
http://blogs.citrix.com/2012/04/19/green-bubble-theme-for-citrix-netscaler/

I chose the Horizon theme because it matches WI 5.4 the closest. Here’s what you need to do to implement it. I did this on a Netscaler running NS 9.3 but 10.x will work too:

1. Download the Horizon.txt script and rename it to Horizon1.sh like Jeff says. Then download Horizon1.gz.
2. Now use WinSCP to copy both to your primary Netscaler to /var/vpn/themes
3. Putty/SSH into the primary Netscaler, enter shell, and navigate to /var/vpn/themes
4. Type:

sh Horizon1.sh

This script by Andre Perry does all the stuff Jeff says in the posts above. Very nice Andre! At this point you have deployed the theme. Now to customize for your company.

5. Just change 3 files on the Netscaler:

/var/vpn/themes/Horizon1/ns_gui/vpn/images/Background.png – your company colors in the background. I usually use 2 colors here. Just play with the height of the colors in Photoshop to adjust and make them line up with the login box the way you want.

logo.jpg – Create it from scratch and drop it in /var/vpn/themes/Horizon1/ns_gui/vpn/images/

index.html – change the following:

TO

NOTE: If you use 2 factor authentication or allow password changing for expired passwords you will also want to modify the caxtonstyle.css and nsshare.js files.

6. Now make sure to copy all 3 of these files to the flash (where everything is currently running from) here:

/netscaler/ns_gui/vpn/images/Background.png
/netscaler/ns_gui/vpn/images/logo.jpg
/netscaler/ns_gui/vpn/index.html

7. Refresh the Access Gateway page and your changes should appear there. Sometimes you may need to clear your cache. I use FireFox which is pretty good about it and I didn’t have to clear anything. If you need to adjust anything, go ahead and do so now. Just remember, after a reboot of your Netscaler anything you put in Flash at the paths in step 6 above will revert. Stuff gets copied over from the /var folder in step 5 above. So make sure you put your files there as well to prevent this.

8. Now login to your secondary Netscaler and perform all the same steps. None of this stuff gets synched between devices.

Here is how my final product looks:

WEB INTERFACE
Andrew Morgan has an excellent post here that goes pretty in depth:

http://andrewmorgan.ie/2011/08/30/decrapifying-the-citrix-web-interface-5-4/

I needed something quick so I just modified 4 things under c:\inetpub\wwwroot\Citrix\XenApp\media:

1. CitrixXenApp.png and CitrixXenApp.gif – I changed this to my company logo
2. HorizonBgTop.png – I went with solid white in Photoshop with this one
3. HorizonBgBottom.png – I went with solid blue in Photoshop with this one
4. HeaderGradient.png – Did a gradient in Photoshop using two of my company’s colors. This appears once you login along the top.

This located under c:\inetpub\wwwroot\Citrix\XenApp\app_data\include:
5. fullStyle.inc – I changed this to rip out that ugly HDX logo:

and this to give me a solid white background along the bottom:

And this under c:\Program Files (x86)\Citrix\Web Interface\5.4.0\languages:
6. accessplatform_strings.properties – I customized the text in this. While playing with it I noticed it does support HTML just fine so I did this:

Done, upload all your files and you have a pretty nice simple company branded Web Interface. You should change the “loggedoff” images that are greyed over to match when you get some time or you’ll see the default images there greyed over instead.

Here is how my final product looks:

About Jason Samuel

Jason Samuel lives in Houston, TX with a primary focus on strategic advisory and architecture of end-user computing, security, enterprise mobility, virtualization, and cloud technologies from Citrix, Microsoft, & VMware. He also has an extensive background in web architecture and networking over his 20+ year career in IT. He is an Author, Speaker, and Local User Group Community Leader. He is certified in several technologies and is 1 of 63 people globally that is a recipient of the prestigious Citrix Technology Professional (CTP) award. He is 1 of 42 people in the world that has been awarded as a VMware EUC Champion and VMware vExpert. He is a featured author on DABCC which provides the latest IT Community News on Cloud, Data Center, Desktop, Mobility, Security, Storage, & Virtualization. In his spare time Jason enjoys writing how-to articles and evangelizing the technologies he works with. Disclaimer: The content and opinions expressed in articles and posts are his own and are by no means associated with his employer.

Recommended for you

3 Comments

  1. Sanuel

    November 20, 2013 at 9:08 AM

    hello,
    am getting the error below when trying to implement the horizon 1 theme

    [email protected]# cd /var/vpn/themes
    [email protected]# sh Horizon1.sh
    Horizon1.sh: Downloading skin archive ‘Horizon1.gz’ to /tmp
    Horizon1.sh: Extracting skin archive ‘/tmp/Horizon1.gz’

    gzip: stdin: unexpected end of file
    tar: Child returned status 1
    tar: Error exit delayed from previous errors
    [email protected]#

  2. Don Russell

    April 28, 2014 at 3:14 PM

    @Sanuel
    I got them same error attempting to implement the Symphony2.sh theme. Any suggestions.

  3. Jason Samuel

    May 1, 2014 at 6:05 PM

    Hi guys,

    The Green Bubbles theme and the ability to set a custom theme is now built into the GUI of the Netscaler main release as of firmware 10.1. You don’t need the script anymore. Let’s say you want to use Horizon like in my example.

    1. Download the Horizon theme, unzip to your hard drive, and customize the files.

    2. Putty in, enter shell, and run the following

    /var/ns_gui_custom; cd /netscaler; tar -cvzf /var/ns_gui_custom/customtheme.tar.gz ns_gui/*

    This will create a folder called “/var/ns_gui_custom/” and inside you will find a file called “customtheme.tar.gz“. This is a compressed copy of the currently running default skin. WinSCP it down to your PC and unzip it.

    3. Overwite the default skin files with the ones you have modified from the Horizon theme. Then upload it into “/var/ns_gui_custom/” so your full path to the files will be “/var/ns_gui_custom/ns_gui“. All the other directories like admin_ui, epa, images, themes, vpn, vpns will all be under here. Also zip up the ns_gui folder on your PC and rename it “customtheme.tar.gz” and upload it into “/var/ns_gui_custom/” folder.

    4. Login to the Netscaler GUI and go to Netscaler Gateway > Global Settings > Change global settings > Client Experience tab > UI Theme dropdown box. You will see Default, Green Bubble, and Custom as your options. Set it to Custom. The Netscaler will decompress the files in “customtheme.tar.gz” to the new ns_gui folder when you do this.

    5. Now reboot the Netscaler and verify your new theme persists.

    Hope this makes sense. More info here: http://support.citrix.com/proddocs/topic/netscaler-gateway-101/ng-connect-custom-theme-page-tsk.html

    Jason

Leave a Reply

Your email address will not be published.