How to Run Multiple Unique Web Interface Sites Using WI 3.0 - Gabe Knuth - BrianMadden.com
Brian Madden Logo
Your independent source for desktop virtualization, consumerization, and enterprise mobility management.
Gabe Knuth's Blog

Past Articles

How to Run Multiple Unique Web Interface Sites Using WI 3.0

Written on Sep 29 2004 15,435 views, 17 comments


by Gabe Knuth

A little note up front: This article only refers to running Web Interface 3.0 on IIS web servers.  I’m sure that this can be done on other types of web servers too.

Introduction

Years ago, system administrators were able to run multiple NFuse sites by simply copying the directory structure that NFuse used to another web site in IIS.  This enabled organizations to provide separate web interfaces for different purposes. 

For example, one NFuse site could be configured with the company’s intranet layout using the java client and forcing the user to log on to an internal domain.  Another NFuse site could’ve been configured to do something completely different, such as forcing the user to another domain and to use the Windows client. 

When NFuse 1.5 was introduced, administrators were only allowed to create one NFuse site on each server due to the addition of NFuse Java objects.  The NFuse Java objects were responsible for authenticating users to the MetaFrame farm and retrieving information about the applications, among other things. They gave administrators a lot more flexibility with NFuse features. Unfortunately, they were only configurable on a server-wide basis. The reason for this was that Java objects main configuration file, “NFuse.conf,” was stored in a centralized folder (most recently “%Program Files%\Citrix\Nfuse”). In one way or another, this configuration was used from NFuse 1.5 to NFuse 1.7, and in Web Interface 2.x.

With the introduction of MetaFrame Presentation Server 3.0, Citrix also released Web Interface 3.0 (WI 3.0).  WI 3.0 decentralized the Java objects and places a .conf file (now called “WebInterface.conf”) in the “\Citrix\MetaFrame\conf” folder off the root of each Web Interface site.  Because of this decentralization, administrators can now create multiple NFuse / Web Interface sites per server, each with their own settings.

The Nitty Gritty

Creating a second (or third, fourth, ...) Web Interface site is a simple process, although there are several steps to follow.  If you’ve performed a default WI 3.0 install, the following information should have you creating multiple sites in no time.  For this article, we’ll assume that your IIS and WI installation is standard and that the location of the WI website is under C:\INETPUB\WWWROOT\CITRIX.

To create a second WI 3.0 installation:

1. Stop the IISAdmin service (which will stop the WWW Publishing service).

2. Navigate to c:\INETPUB\WWWROOT\ and copy the Citrix folder to another location, such as C:\WIDefault.

3. Under C:\INETPUB, create a new folder that will contain the new WI site.  We’ll call it WEBINT2.

4. Copy the Citrix folder under C:\WIDEFAULT to the new folder created under C:\INETPUB (so you’re folder structure will look like “C:\INETPUB\WEBINT2\CITRIX”)

5. Start the IISAdmin and WWW Publishing services.

6. In IIS Manager, create a new site that points to the new folder you created.  For the host header name, you should enter the DNS name that users will use to access your new site.  When you expand all the folders in this site, it should look almost identical to the original WI site. Almost, that is, except for a few missing folders with a goofy icon that looks like this: .  These icons mean that the directory is an IIS application, and Web Interface uses these directories to build files and sites for different scenarios.  In order to use your new WI site, these virtual directories and applications will have to be recreated.

7. In IIS Manager, under your new site, right-click the site name (the level above the Citrix folder) and select New > Virtual Directory.

8. Click Next at the welcome screen, then on the Alias screen, enter the alias of “Scripts” (without quotes).  Click Next.

9. At the next screen, enter the path to the SCRIPTS folder, which is C:\INETPUB\SCRIPTS.  Click Next, then Finish.

10. Now, right click on the PNAgent folder (under the Citrix folder of your new site in IIS Manager) and select properties.

11. Under the Application Settings section, click the Create button next to Application Name.  This should cause the text box to change to PNAgent.  Now click OK.  You’ll note that the icon for the PNAgent folder has changed from a regular folder icon to the application icon.  This is good.

12. Repeat Step 11 for the PNAgentAdmin folder.

13. Next, right-click on the MetaFrame folder and select New > Virtual Directory.  Click Next at the Welcome screen and enter the alias of “certificate” (again, no quotes).  Click Next.

14. For the path, enter C:\INETPUB\WEBINT2\CITRIX\METAFRAME\SITE and click Next.

15. Click Next again at the Permissions screen, then click Finish.

Now we have to tell IIS what to do when it encounters an ICA file.  By default it has no idea what an ICA file is, so it just sends it down to the user's web browser when it's requested. However, the template ICA file used by WI 3.0 actually contains some ASP code, so it needs to be parsed by the IIS ASP engine before it's sent to the client. To do this, you'll need to configure your new IIS virtual directory use a certain ASP processing DLL to process ICA files before they're sent to users. (If you don't do this, your users will receive an error stating "[ApplicationServers] section not found.")

16. Right-click on the virtual folder that you just created and select Properties.  Click the Configuration... button. 

17. Click Add... and enter “C:\WINDOWS\Microsoft.NET\Framework\v1.1.4322\aspnet_isapi.dll” in the Executable box.  In the Extension box, enter “.ica”. 

18. In the Verbs section, select Limit To: and enter “GET,HEAD,POST,DEBUG” in the text box.  Uncheck the “Verify that file exists” checkbox, and click OK.  Click OK two more times to exit the properties window.

19. Repeat steps 13 through 18 for the following virtual directories: default and integrated.

20. Now, right-click on the WIAdmin folder and select Properties. Click the Create button (just like in Step 11).  Do the same for the aspexamples folder.

At this point, you have created your second Web Interface site.  You can browse to your site by typing http://<site_domain_name>/Citrix/MetaFrame.  If you want, you can place a redirect page under the C:\INETPUB\WEBINT2 folder so that you only need to browse to http://<site_domain_name>. (This redirect can be a simple default.asp file with one line of code:

<%response.redirect("http://<site_domain_name>/Citrix/MetaFrame")%>

To administer the site, you can browse to http://<site_domain_name>/Citrix/MetaFrame/WIAdmin just like you would for a single site WI environment.  You can also edit the WebInterface.conf file directly.  The file is located in the \CITRIX\METAFRAME\CONF folder.

There you have it.  It’s not exactly painless, but it’s better (and cheaper) than having several servers for your Web Interfaces.  As always, I’m interested in hearing your feedback and experiences.  You can post them below, or shoot me an email at gabe@gabeknuth.com.

 
 




Our Books


Comments

Guest wrote Can you load SG on only one of the WI instances?
on Sun, Dec 12 2004 1:50 PM Link To This Comment
This message was originally posted by SJ on September 30, 2004
Is it possible with this configuration to have Secure Gateway loaded on the same server and only associate it with one (or more) of the Web Interface instances? That way the external users get a SG logon, but you could point your internal users to this server and they wouldn't have the overhead of being 'proxied' by the SG element.
Guest wrote internal users
on Sun, Dec 12 2004 1:50 PM Link To This Comment
This message was originally posted by xs4citrix on September 30, 2004
SJ; to send internal users directly to the servers, and not through the CSG, you can do woth the following lines in your webinterface.conf:

AlternateAddress=Mapped
ClientAddressMap=192.168.0.,Normal,*,SG
Guest wrote SG on One Server
on Sun, Dec 12 2004 1:50 PM Link To This Comment
This message was originally posted by Brian Madden on September 30, 2004
Yes, you can have some users use SG with others not using SG with a single instance of WI. You only need to build multiple WIs if you want to have different users use different farms, or if you want to have different looks and feels, etc.
Guest wrote *nix technique
on Sun, Dec 12 2004 1:50 PM Link To This Comment
This message was originally posted by jsekel on September 30, 2004
For the few people who might be running WI on *nix servers the process is much easier (well, if you know *nix). Once you set up the intial site using the .war file their will be a folder called Citrix in the /tomcat/webapps/ folder. If you copy this folder to another folder with a different name like Citrix2 then you now have a second WI site with the new name.
Guest wrote RE: *nix technique
on Sun, Dec 12 2004 1:50 PM Link To This Comment
This message was originally posted by Gabe Knuth on September 30, 2004
Thanks for posting that! Makes me think harder about becoming a nix guy...
Guest wrote Supported by citrix
on Sun, Dec 12 2004 1:50 PM Link To This Comment
This message was originally posted by sk on October 1, 2004
i have the information, that citrix states, that running multiple instances of the wi on one system is working but not yet supported. is this still true?
Guest wrote RE: Supported by citrix
on Sun, Dec 12 2004 1:50 PM Link To This Comment
This message was originally posted by Gabe Knuth on October 1, 2004
As far as I know, yes. But what's the fun if it IS supported? :)
Guest wrote RE: Supported by citrix
on Sun, Dec 12 2004 1:50 PM Link To This Comment
This message was originally posted by Leo van der Mee on October 1, 2004
Citrix actually gave a presentation here in the Netherlands explaining this possibility at one of the value add meetings. That sounds like 'supported' to me...
Guest wrote An easier solution... (using Citrix&#39;s WI3MBR tool)
on Sun, Dec 12 2004 1:50 PM Link To This Comment
This message was originally posted by Leo van der Mee on October 1, 2004
Read this thread (Topic: Guide 2 Multiple WI3 sites on the same web server)
from the Citrix support site originally posted by Henrik Christensen:

http://support.citrix.com/forums/thread.jspa?forumID=69&threadID=51669&tstart=15
Guest wrote supported
on Sun, Dec 12 2004 1:50 PM Link To This Comment
This message was originally posted by xs4citrix on October 1, 2004
There is an internal document for citrix engineers to be used on this.
It has never made it to an offical kb article though.
So consider it partially supported.
Guest wrote another posibility...
on Sun, Dec 12 2004 1:50 PM Link To This Comment
This message was originally posted by AndyH on October 4, 2004
see...
http://support.citrix.com/forums/thread.jspa?messageID=226723&fromSearchPage=true&#226723

Guest wrote NOT supported
on Sun, Dec 12 2004 1:52 PM Link To This Comment
This message was originally posted by an anonymous visitor on October 7, 2004
I asked our Citrix account manager about this and they said that it was definitely NOT supported...
Guest wrote SSL 443
on Sun, Dec 12 2004 1:52 PM Link To This Comment
This message was originally posted by an anonymous visitor on October 18, 2004
When I turn on port 443 for the new site and point to https://, login and select the app I get and open dialog box for the launch.ica file. Without port 443 on it works fine. Any ideas?
Guest wrote Please Post Technical Questions to the Forum, not Here!
on Sun, Dec 12 2004 1:52 PM Link To This Comment
This message was originally posted by Brian Madden on October 19, 2004
The forum at forum.brianmadden.com is better because (1) people look there to help others, and (2) it handles threaded discussions.
Guest wrote NAT address
on Mon, Feb 7 2005 4:16 PM Link To This Comment
Do I need a seperate server in order to have NAT address applied for various custormers, or will WI 3.0 allow me to nat each website accordingly for my customers?
Guest wrote just gr8! documentation dear...
on Fri, Jan 27 2006 10:16 AM Link To This Comment
thank you very much.
it resolved my problem.
 
chirag gandhi
india
Guest wrote Citrix Administration
on Thu, May 18 2006 6:13 PM Link To This Comment
Does anyone have a document for citrix 4.0 administration from adding users, group etc..

(Note: You must be logged in to post a comment.)

If you log in and nothing happens, delete your cookies from BrianMadden.com and try again. Sorry about that, but we had to make a one-time change to the cookie path when we migrated web servers.