Preparing to deploy IAG components offline with an installation file

Updated: February 10, 2010

Applies To: Intelligent Application Gateway (IAG)

Install Whale Communications Intelligent Application Gateway (IAG) 2007 client endpoint components with a download file for end-users who do not have ActiveX download rights on Windows Internet Explorer and are non-privileged (guest/user) users. In this setup, the administrator has to log in to the endpoint computer by using power-user or Administrator privileges and install the components before the user accesses the site.

In order to enable offline component installation with a download file, take the following steps:

  1. Configure the settings of the offline component installation.

  2. Deploy the component library to end-users.

You can configure the following aspects of the offline component installation:

  • Determine which components users will be able to install. For example, you can select to enable the SSL Wrapper component, but not the Socket Forwarding component.

  • Replace the graphic that appears in the installation.

  • Enable or disable custom installation mode, where users can select which of the enabled components to install. If custom mode is disabled, the installation will run in typical mode, where all enabled components are installed. Note that custom mode is only applicable when you deploy the components installation in interactive mode.

To configure offline component installation

  1. Copy the file ComponentsConfig.xml from this location:


    To the following location:


  2. In the file you copied in step 1, determine whether to enable the installation of each component or not, whereas:

    • Install="1": install

    • Install="0": don’t install

    For example:

    The following line enables the installation of the Network Connector component:

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

  3. In the file you copied in step 1, determine whether to enable the

    Custom installation mode, whereas:

    • <CustomSetup Enable="1"/>: enable Custom installation

    • <CustomSetup Enable="0"/>: disable Custom installation

  4. In order to replace the graphic that appears in the installation, place your graphic in the following location:


    The replacement graphic must have the following attributes:

    • A Bitmap (.bmp) format graphic

    • File name: logo.bmp

    • Size of the graphic must be the same size as the original graphic: Width 118 x Height 238 pixels

After you configure the installation settings you can deploy the installation to end-users in the following modes:

  • Silent mode—Where no user intervention is required. Note that when you use this deployment method, Custom installation is not applicable.

  • Interactive mode—Where an installation wizard guides the user through the installation.

Both deployment methods are described in this section. Note that you should inform users that during component installation, they should not access the portal homepage or any other location within the site. If the installation detects that client components are already installed on the computer, it upgrades any of the components that are of older versions, even if their installation in not enabled in the current installation configuration.

To deploy the offline component installation in Silent mode

  1. On IAG servers that do not have a service pack installed, or for IAG servers running Service Pack One and deploying to clients that are not running on Windows Vista, use the following command line to execute component installation in silent mode:

    …\Whale-Com\e-Gap\utils\OfflineClientSetup\Setup.exe -s

    For example: use a batch file to run this command from the offline client setup location.

  2. On IAG servers that are running Service Pack One and deploying to Windows Vista clients use the following command line to execute component installation in silent mode:

.../Whale-Com/e-Gap/von/PortalHomePage/VistaWhaleClientSetup-Basic.exe /a /s Or .../Whale-Com/e-Gap/von/PortalHomePage/VistaWhaleClientSetup-SocketForwarder.exe /a /s"

  1. On IAG servers that have IAG Service Pack 2 installed, obtain the WhlClientSetp.msi file provided with Service Pack 2. Make the folder …\Whale-Com\e-Gap\utils\OfflineClientSetup available to the client endpoint. Then on the client endpoint run the setup file by navigating to the OfflineClientSetup location, and typing the following at the command line to execute component installation in silent mode:

OfflineClientSetup\WhlClientSetup.msi /qn

The .msi file should be run with administrator privileges

Once these commands are run, the client components are installed on the client endpoint with no user intervention.

To deploy the offline component installation in Interactive mode

  1. Deploy the following folder, including all files and subfolders:


  2. Advise users to double-click the file Setup.exe, located under this folder.

    The Whale Client Components Installation wizard starts. Users can follow the instructions in order to complete the wizard and install the components on their client endpoints.