Written by Thomas Koetzing at Saturday, 04 March 2006
Citrix has published many "How to..." articles about Web Interface 4.x and published also a very good Web Interface SDK (CTX106665) with a lot of details but there are always some "other How to questions". Most people know how to change the header, footer or the welcome area but in this article I will show some of the other Answers to How to questions.
Question like: How to speed-up WI logins? How to set default values? How to use the original multilanguage footer? How to disable right-click? How to redirect to HTTPS and so on.
How to speed-up Web Interface logins
When somebody tries to open the Web Interface login page early in the morning, then it might take some time before the page is loaded. Additional requests are fast and is due to the fact that in the background the worker processes needed to be started. If they are idle for 20min, then they get closed and new logins will again take some time. Now this behaviour can be disabled.
This can be done with the Internet Information Server (IIS) that comes with Windows 2003. Open the IIS Manager | Application Pools | Disable idle timeout for “worker processes” for CitrixWebInterface4.xAppPool
How to use the multilanguage footer function
Close any Access Suite Console (ASC) that might be open and enabled the footer manually through the webinterface.conf file that is located by default in /Citrix/MetaFrame/Conf
Change the following lines
# FooterTextDefaultLocale=[language code] # FooterText_<lang-code>=[Customized footer text in the specified language]
to something like
FooterTextDefaultLocale=en FooterText_en=This is a example. FooterText_de=Dies ist ein Beispiel. FooterText_fr=Cela est un exemple.
How to set per Application settings
Therefore edit the default.ica file loacted by default in /Citrix/MetaFrame/Conf
In the [wfclient] section add the AppDN of your Publish Application, like [notepad] but remember the value is case sensitive to what you have used in the CMC! Now add any Application specific setting you like. For instance adding TWIMode=Off will result in a none seamless session for the Publish Application notepad
How to create a simple website
Sometimes a simple website is needed to launch a Publish Application. The option to create an html file with a linked ica file has been in the CMC since day one.
Open CMC | Applications | Application property | Create html file
How to change the STA ID when cloning PSE Server
Cloning Presentation Server 4.0 will not change the STA ID that is integrated in the XML service! To change the STA ID edit CtxSta.conf file in %ProgramFiles%\Citrix\system32 and change the STA ID with a value you like.
[GlobalConfig] UID=STABB4BD26E58F5 <= change this (sample) value
After changing the STA ID, restart the Citrix XML service to pick-up the new ID.
How to disable right mouse click
This is a very old feature from Project Columbia but was never included to any Web Interface version. The following change is the simplest way to do it.
Edit the ayout.ascx file in /Citrix/MetaFrame/auth/include and /Citrix/MetaFrame/include Search for the <body> html tag and add oncontextmenu="return false" Like <body oncontextmenu="return false"...
How to Disable "Remember folder location" and start always in the root
Web Interface "remembers" (in a cookie) the folder location by default where users exit Web Interface and at the next login starts automatically in that folder. To overwrite the default of remembering folders and starting always in the root, two things need to be changed.
-- change to -- viewControl.setShowAppDetails( true );
How to securely redirect to Web Interface
As default Web Interface should be used with SSL encryption (HTTPS) enabled, since users are sending credentials overt the wire. This is even more important when using WI internally because researches showed that most attacks are coming from inside.
Difficult part is that users are not very familiar with typing httpS...
After the Server certificate was applied to IIS, SSL should be disabled IIS Manager | Default Web Site | Directory Security | Edit secure communications | Disable SSL
Next is to enable SSL ONLY for Web Interface and every other site/folder you like. IIS Manager | Default Web Site | Citrix | MetaFrame | Directory Security | Edit secure communications | Enable SSL
Redirect user to Web Interface via secure channel When Web Interface 3.0/4.x was set as default Web Site, then the file webinterface.htm is placed in the IIS root (default %RootDrive%\Inetpub\wwwroot). Now the following line needs to be changed:
This way user can connect to FQDN_WI_SERVER using port 80 (HTTP) but they will be redirected to WI using HTTPS. Direct connection to http://FQDN_WI_SERVER/Citrix/MetaFrame/ will fail, since SSL is required. If direct connect should also supported, then a bit more scripting is required.
Written by sanchito75 on 2006-06-12 19:03:13keep up the good work thomas!
Thank you so much Written by Guest on 2006-08-15 22:01:14I tried this out today and wow what a difference on the time it takes to load the initial page. Thanks Thomas.
very good Written by Gast on 2006-09-04 11:21:55you continue to impress :-) very good info - worker-process startup tip works nicely. info: name of process seems to be "w3wp". Apparently it doesn't start until the first user starts WI. Perhaps on bootup one could start the MSIE with a link to the WI start-page as a scheduled job - or is there a more intelligent way to make sur ethe w3wp is up and running before the first user.
wow Written by Guest on 2006-09-13 01:45:41same as above
Excellent Information Written by Guest on 2007-01-19 21:03:24Excellent website with very useful information and easy to find.
WI 4.0 Link Issues Written by Guest on 2007-02-07 16:10:09Great work! As you know the only client that works with VISTA is the Network Neighborhood client 9.2 How do I put a static link on the WI page that users click to downloads it, and does not have the link dissapear everytime I run the Wizards in Access suite?
WI 4.0 Link Issues Written by thomas koetzing on 2007-02-08 01:18:40Please, use my forum for questions on troubleshooting etc. For the english section of the forum you have to scroll down.
Disable "Remember folder location" Written by Guest on 2007-02-20 22:54:16any way to do this in 4.5?
Web Interface 4.5 Written by thomas koetzing on 2007-04-25 22:03:48Most of the stuff should work with WI 4.5 but you have to look in other locations for the files.
C# files like XXX.cs are now named XXX.aspxf and the file location will often be Citrix/AccessPlatform/app_data
Great Article Written by Guest on 2007-04-05 19:34:41Thanks for posting!
Another HTTP to HTTPS Redirection Tip Written by Guest on 2007-06-13 02:18:28Great article! Here's another little trick to ensuring that the users are using your new SSL cert. The redirection included in this article only covers the users that go to http://FQDN it does not cover the people that already have a shortcut pointing http://FQDN/citrix/metaframe/auth/login.aspx. Add this little bit of text to the global.asax file in the metaframe directory and it will ensure that the users are using the new SSL certificate. *** Add the following text right after *****