Modifying the list of automatically installed client components

Updated: April 8, 2010

Applies To: Unified Access Gateway

When an endpoint device connects to the Forefront Unified Access Gateway (UAG) portal, the portal installs the following client endpoint components, by default:

• Forefront UAG Endpoint Session Cleanup.

• Client Trace utility.

• Forefront UAG Endpoint Detection.

The following procedure describes how you can configure additional components to be installed automatically, if required.

To add components to the list of automatically installed components

1. On the Forefront UAG server, open the folder Microsoft Forefront Unified Access Gateway\von\InternalSite\inc\CustomUpdate. If the folder does not exist, create it.

2. In the CustomUpdate folder, do the following:

   • If you want your changes to affect all trunks, create the following file:

     InstallXml.inc

   • If you want your changes to be applied to a specific trunk, create the following file:

     <Trunk_Name><Secure(0=no/1=yes)>InstallXml.inc

     For example, for an HTTPS trunk named “MyTrunk”, create the file mytrunk1InstallXml.inc.

   If such a file already exists, use the existing file.

3. Copy the following lines into the file you created:

   <%
   Response.write "<Component Name=""SSL Wrapper"" ID=""1"" Install=""1"" />"
   Response.write "<Component Name=""Network Connector"" ID=""17"" Install=""1"" />"
   
   if uninstall_lln = "0" and remove_lln = "0" then
       Response.write "<Component Name=""Socket Forwarding"" ID=""8"" Install=""1"" />"
       Response.write "<Component Name=""Socket Forwarding activation: Basic"" ID=""33"" Install=""1"" />"
       Response.write "<Component Name=""Socket Forwarding activation: Extended"" ID=""65"" Install=""1"" />"
       Response.write "<Component Name=""Socket Forwarding activation: VPN"" ID=""129"" Install=""1"" />"
   end if
   %>
   

4. Insert a comment mark for lines that are not applicable, by adding ' at the beginning of the line, as follows:

   • The following line adds the SSL Application Tunneling component to the list of automatically installed components:

     Response.write "<Component Name=""SSL Wrapper"" ID=""1"" Install=""1"" />"

   • The following line adds the SSL Network Tunneling component to the list:

     Response.write "<Component Name=""Network Connector"" ID=""17"" Install=""1"" />"

   • The following line adds the Socket Forwarding component to the list:

     Response.write "<Component Name=""Socket Forwarding"" ID=""8"" Install=""1"" />"

     In addition, the following lines enable the Socket Forwarding activation mode:

     Basic mode:

     Response.write "<Component Name=""Socket Forwarding activation: Basic"" ID=""33"" Install=""1"" />"

     Extended mode:

     Response.write "<Component Name=""Socket Forwarding activation: Extended"" ID=""65"" Install=""1"" />"

     VPN mode:

     Response.write "<Component Name=""Socket Forwarding activation: VPN"" ID=""129"" Install=""1"" />"

     Make sure the required Socket Forwarding Activation mode is enabled. If the component is used by multiple applications, in various Activation modes, make sure all the applicable modes are enabled.

   When users next access the site, the automatic component installation will include the additional components you defined.