3.2 Installing Endpoint

Ensure your networking software is working correctly before installing the endpoint software. For more information, see the Help for your networking software, and Configuring Windows Endpoints.

The endpoint for Microsoft Windows is installed as a service and runs as a service. To successfully install the endpoint, you must be logged in with Administrator authority. The permissions of the directory where the endpoint is installed must also be set to allow the account running the endpoint service full control permission on all files in the NetIQ\Endpoint directory or the directory where you installed the endpoint, plus any relevant subdirectories.

The security implementation in Windows Server 2003 differs noticeably from that in earlier versions of Windows. Before you install the endpoint on Windows Server 2003, ensure your user account is running in “Install” mode and not in “Execute” mode.

To change the mode so you have the necessary installation privileges, run the following at a command prompt:

change user /install

If you try to install from the wrong mode, the installation on Windows Server 2003 fails with the following message: The InstallShield-generated file that allows uninstallation is missing.

3.2.1 Installing from the Web

To install endpoint:

  1. Save the endpoint download package to a directory on a local hard drive.

  2. Navigate to the endpoint file, gsendw32.exe, and double-click it to begin installation.

  3. The first dialog box after the Setup dialog box lets you select the directory where the endpoint will be installed. You should install it on a local hard disk of the computer you are using. If you install on a LAN drive, the additional network traffic may influence your performance results. The default directory is \Program Files\NetIQ\Endpoint, on your boot drive.

  4. If you have a previous installation of the endpoint, you will be asked if you want it removed. If you click Yes, the previous installation is removed, and the new installation continues. If you click No, the install program exits with no changes to your existing installation because a new version cannot be added until the old version is removed. It then adds Endpoint (the endpoint program) as a service.

  5. The next dialog box contains two check boxes.

    • The first check box lets you opt to install pre-built data files. You should clear this box. This feature is for Chariot users only.

    • Check the second box to start the endpoint installation. If you leave this box cleared, the endpoint starts when you restart the computer. No window is shown while the endpoint is running because it runs as a service.

Windows services are controlled from the Services dialog box inside the Control Panel. To restart a service without restarting Windows, use the Services dialog box.

You can also manually start the endpoint after installation. For more information, see Starting Endpoint.

To prevent the endpoint from running automatically on startup, see the section titled Disabling Automatic Startup. You can manually restore the setting.

After you complete installation, see Configuring Windows Endpoints to ensure your endpoint is ready for testing and monitoring.

3.2.2 Unattended Installation

Unattended, or silent, installation, is available for the endpoints for Windows. You install an endpoint once, by hand, while the install facility saves your input in an answer file. You can then install that same endpoint silently on other computers, that is, without providing input other than the answer file.

To perform silent installation:

  1. Run gsendw32.exe. An answer file called update.iss is created in the \Updates subdirectory of the directory where you installed the endpoint.

  2. Specify the “-s” option on SETUP. Ensure the answers documented in the answer file update.iss are appropriate for the silent installation.

  3. If the update.iss file is not in the same directory as setup.exe, specify the path and filename with the “-f1” option. The following example shows how to install using the update.iss file in the \Program Files\NetIQ\Endpoint directory on a NetIQ n: LAN drive:

    SETUP -s -f1n:\Program Files\NetIQ\Endpoint\update.iss

    If you do not specify the path and filename with -f1, the default filename is setup.iss. Do not mix the .iss files among different Windows operating systems because their endpoint installations require slightly different input.

It is common to use unattended install from a LAN drive. Ensure you copied all files for each type of endpoint into a single directory, rather than into separate diskette images, and ensure you created your initial update.iss file from that directory. Unattended install does not keep track of diskette label information, and will need user input if you install from separate disk images. You probably do not want your unattended install to ask you for n:\disk1\, n:\disk2\, and so on.

3.2.3 What Happens During Installation

During installation, the endpoint is installed by default into the \Program Files\NetIQ\Endpoint directory. The directory is created with the following contents:

  • The executable programs

  • The directory Cmpfiles. This directory contains files with the .CMP file extension. These are files containing data of different types, such as typical text or binary data. These files are used by the endpoint as data on SEND commands. The different data types can be used to vary the data compression performance of your network hardware and software.

  • The endpoint.ini file. For more information, see Section 2.0, Endpoint Initialization File.

The endpoint is installed as a service, which means nothing is visible while the endpoint is running. During installation, the endpoint is configured to automatically start when the system reboots. A service can be controlled from the Services dialog box inside the Control Panel. For more information, see Starting Endpoint.