Important:
The tool is not needed for Web Interface 4.0 deployments. One can create additional Web Interface sites using the Access suite console and also move sites. DON’T use this tool with a Web Interface 4.0 server.
This software application is provided to you “AS IS” with no representations, warranties or conditions of any kind. You may use and distribute it at your own risk. CITRIX DISCLAIMS ALL WARRANTIES WHATSOEVER, EXPRESS, IMPLIED, WRITTEN, ORAL OR STATUTORY, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NONINFRINGEMENT. Without limiting the generality of the foregoing, you acknowledge and agree that (a) the software application may exhibit errors, design flaws or other problems, possibly resulting in loss of data or damage to property; (b) it may not be possible to make the software application fully functional; and (c) Citrix may, without notice or liability to you, cease to make available the current version and/or any future versions of the software application. In no event should the code be used to support of ultra-hazardous activities, including but not limited to life support or blasting activities. NEITHER CITRIX NOR ITS AFFILIATES OR AGENTS WILL BE LIABLE, UNDER BREACH OF CONTRACT OR ANY OTHER THEORY OF LIABILITY, FOR ANY DAMAGES WHATSOEVER ARISING FROM USE OF THE SOFTWARE APPLICATION, INCLUDING WITHOUT LIMITATION DIRECT, SPECIAL, INCIDENTAL, PUNITIVE, CONSEQUENTIAL OR OTHER DAMAGES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. You agree to indemnify and defend Citrix against any and all claims arising from your use, modification or distribution of the code.
Introduction
The Web Interface 3.0 Metabase Repair Tool (WI3MBR) can be used to foster multiple instances of Web Interface 3.0 on a single IIS Web server. This document describes how to use WI3MBR to create additional independent instances of Web Interface other than the default instance.
Each instance of Web Interface includes separate Web Interface Console, Program Neighborhood Agent. and Program Neighborhood AgentAdmin applications. Changes made to the configuration files for one instance does not affect any other instances.
When Web Interface 3.0 for Windows is installed, several changes are made to the settings for Internet Information Services (IIS). These settings are in the IIS metabase. If the metabase settings are altered or lost, the WI3MBR tool can be used to restore the original settings required for proper delivery of Web Interface 3.0 for MetaFrame Presentation Server.
If the location of the Web Interface scripts changes after Web Interface is installed, it is necessary to run this tool from the new location.
Web Interface 3.0 Metabase Repair Tool (WI3MBR)
WARNINGS
• While no problems with this technique are known at this time, running multiple instances of Web Interface 3.0 has not been tested extensively by Citrix Systems, and thus, this technique is not supported by Citrix Systems Technical Support. USE THIS TECHNIQUE AT YOUR OWN RISK.
• Attempts to upgrade or uninstall Web Interface 3.0 affects only the originally installed instance. Additional instances of Web Interface 3.0 must be uninstalled or upgraded manually by replacing the duplicated scripts.
• After copying the Web Interface scripts to a new location, they may inherit file security settings that are not as secure as the original location. Follow the instructions carefully to restrict NTFS File permissions for the duplicated scripts.
Feedback
Citrix Technical Support welcomes your feedback regarding the use of this tool. Provide feedback using the Web Interface category of the Citrix Technical Support Forums.
Instructions
The tool is implemented as a Web script that can be executed from a Web browser. To run the tool, follow these steps:
1. Install Web Interface 3.0 and ensure that it works properly.
2. Download the attached file WI3MBR.zip to the server running Web Interface 3.0.
3. Extract and copy the WI3MBR folder into the /Citrix directory beneath your web server’s document root. For example, if your Web site is physically located at C:\Inetpub\wwwroot, place the WI3MBR folder in the C:\Inetpub\wwwroot\Citrix directory alongside the MetaFrame, Program Neighborhood Agent, and Program Neighborhood AgentAdmin folders.
4. Create a new Web site or a new subfolder within your existing Web site where you would like the new Web Interface site to reside.
5. Copy the contents of the wwwroot\Citrix folder and the WI3MBR folder into the new location.
6. Edit the NTFS permissions for the duplicated script folders to ensure the following minimum permissions:
o MetaFrame\site – Everyone: Read
o MetaFrame\conf – Administrators: Full Control, Everyone: Read
o MetaFrame\WIAdmin – Administrators: Read
o Program Neighborhood Agent – Administrators: Full Control, Everyone: Read
o Program Neighborhood AgentAdmin – Administrators: Read
o WI3MBR – Administrators: Read
7. Using Internet Explorer, point to the WI3MBR folder as a Web address and run the script. For example, from the Web server console, point to http://localhost/Citrix/WI3MBR/. You are required to authenticate as an administrator of the Web server. Follow the on-screen directions to confirm that WI3MBR is running from the correct location and click Begin to recreate the metabase settings. After the script completes, you are prompted to connect to the Web Interface site.
o The script performs the following actions from its current location:
o Creates and configures the virtual directory ../MetaFrame/default for Anonymous and Explicit authentication
o Creates and configures the virtual directory ../MetaFrame/integrated for Single Sign-On authentication
o Creates and configures the virtual directory ../MetaFrame/certificate for Smart Card authentication
o Creates a Web application for the ../MetaFrame/WIAdmin folder
o Creates Web applications for the ../PNAgent and ../PNAgentAdmin folders
o (Optional) Creates the WebInterface.htm file at the Web server document root that redirects users to ../MetaFrame/default.htm and sets WebInterface.htm as the default document name with the highest priority
o Configures IIS to deny HTTP access to all configuration files, executables, and server-side scripts
o Configures IIS to parse .ICA files as scripts using ASP.NET
8. You can remove the WI3MBR folder after the script completes successfully.
Note: To preserve disk space and maintain consistent client versions across all instances of Web Interface, you may want to create a virtual directory in the new location that corresponds to the ICAWEB folder in the original location instead of copying the ICAWEB folder to the new location.
EXAMPLES
Example 1: Separate Web Site
a. Install Web Interface 3.0 to C:\Inetpub\wwwroot\Citrix.
b. Create a new Website for IP address 10.1.2.3 with document root C:\Inetpub\NewSite.
c. Copy the C:\Inetpub\wwwroot\Citrix folder to C:\Inetpub\NewSite\Citrix.
d. Copy the WI3MBR folder to C:\Inetpub\newsite\Citrix\WI3MBR.
e. Point a browser to http://10.1.2.3/Citrix/WI3MBR/.
Example 2: New Subfolder for Existing Web Site
a. Install Web Interface 3.0 to C:\Inetpub\wwwroot\Citrix.
b. Create a new directory as C:\Inetpub\wwwroot\NewFolder.
c. Copy the contents of C:\Inetpub\wwwroot\Citrix folder to C:\Inetpub\wwwroot\NewFolder.
d. Copy the WI3MBR folder to C:\Inetpub\wwwroot\NewFolder\WI3MBR.
e. Point a browser to http://localhost/NewFolder/WI3MBR/.
Example 3: New Virtual Directory for Existing Web Site
a. Install Web Interface 3.0 to C:\Inetpub\wwwroot\Citrix.
b. Create a new folder on drive D, D:\WI3.
c. Copy the contents of C:\Inetpub\wwwroot\Citrix to D:\WI3.
d. Copy the WI3MBR folder to D:\WI3.
e. Create a new virtual directory where the alias is Citrix2 and the directory is D:\WI3.
f. Point a browser to http://localhost/Citrix2/WI3MBR/.
Troubleshooting
Issue | Resolution |
The script hangs at “Creating WebInterface.htm and setting default document for this site.” | Stop the script. From a command prompt, type regsvr32 scrrun.dll. Type iisreset. Run the script again. |
After the script completes, clicking the Access Web Interface Now link yields the error message HTTP 404 – File not found. | The WI3MBR folder was not copied to the correct location. Ensure that the WI3MBR folder is located alongside the MetaFrame, Program Neighborhood Agent and Program Neighborhood AgentAdmin folders: |
FATAL ERROR: Unable to enumerate IIS metabase settings. | Log on as an administrator of the Web server. If you are accessing the WI3MBR tool through a proxy server, you must either bypass the proxy server or use HTTPS to reach the Web server. For best results, log on to the Web server console as an administrator and access the script using localhost as the Web server address. |
