This file contains additional info of how to setup your system so that
NetQ (Net Question: search facility for HTML help) is properly supported.
It also gives help on recovery from a broken installation.

A. NetQ installation
1.) Install the VAC 3.6.5 product
2.) Open the TCPIP configuration notebook (tcpcfg.exe):
    a.) On the "Network" page make sure that
        I.)  loopback interface is enabled with IP address 127.0.0.1
        II.) LAN interface 0 is enabled. If you only have a dialup connection (modem, DSL modem etc.)
             you will still need to enable this interface but in that case, you don't need to specify
             an IP address
    b.) On the "Hosts" pages make sure that
        I.)  on page 1, you have specified a hostname for the machine,
             for the following assume it's ITSMYMACHINE
        II.) on page 2, you add a new entry to the "host name configuration without DNS"
             you add the following:
             IP address: 127.0.0.1
             host name : ITSMYMACHINE
             alias name: localhost
        III.) check button "use HOSTS list before querying nameserver"
3.) Switch to the \NETQOS2 installation directory and run
    netqinit.exe ITSMYMACHINE DATA
    That will update the netq configuration file (netq.cfg)
4.) If you are using a DSL modem dialup connection with PPPoE protocol (like Injoy or SafeFire)
    you might not yet have set up the TCPIP protocol in your network configuration (TCPIP is set up
    implicitely by the network configuration and the PPPoE protocol drivers mentioned will make use
    of it).
    However not having explicitely installed TCPIP protocol will prevent NetQ from working properly.
    On the other hand, adding TCPIP protocol in addition to "PPPoE" protocol to your MAC driver
    will lead to an error on bootup (at least on my system). You can circumvent this problem this way:
    a.) Open the Network configuration (mpts.exe)
    b.) Add the "No network adapter" adapter to your configuration (funny eh ?)
    c.) Add the "TCPIP" protocol to the adapter you added in b.)
    d.) Select the "TCPIP" protocol from the list "current configuration" and change its number to 0
    e.) Save and allow config.sys update
5.) Now you have to add the necessary calls to start the HTTP server (for the HTML help system in general)
    and to start the netq service (for the search facility in the HTML help system). You also have to properly
    set your hostid. You can do so through a batch file or through a file \setup.cmd (on the bootdrive) or
    you can use the batch files that are called via \TCPIP\BIN\TCPSTART.CMD (if TCPSTART.CMD is executed on
    your system). I added them to \TCPIP\BIN\TCPEXIT.CMD (for the following, assume NetQ was installed to D:\NETQOS2):

    hostid 127.0.0.1
    D:
    CD \NETQOS2
    detach httpdl.exe -r httpd.cnf
    netq.exe start server

    That will start the HTTP Server service as well as the NetQ service
6.) If in your browser configuration you use a proxy server, make sure that

    localhost:49213

    is specified in the exclusion list

7.) Finally, specify the full path to the browser you intend to use with the help system in config.sys:
    SET HTML_BROWSER=D:\Moz\Mozilla\Mozilla.exe (or the like)

8.) Finally you can check for the following:
    a.) make sure SET HOSTNAME=ITSMYMACHINE is in config.sys
    b.) make sure SET USE_HOSTS_FIRST=1 is in config.sys
    c.) make sure SET HTML_BROWSER=... is in config.sys
    d.) make sure that

        127.0.0.1 ITSMYMACHINE localhost

        is in \MPTN\ETC\hosts file

    e.) make sure that

        ifconfig lo 127.0.0.1
        ifconfig lan0 

        are in \MPTN\BIN\SETUP.CMD file

    f.) check with a process viewer tool (Watchcat etc.) that these processes are running detached:
        HTTPDL.EXE (HTTP server process)
        IMNSVDEM.EXE (initial NetQ process: Background task for Admin-Table)
        IMNCSSRV.EXE (NetQ Communication Server)
        IMNCSCLT.EXE (NetQ Communication Client Handler, 1. instance)
        IMNCSCLT.EXE (NetQ Communication Client Handler, 2. instance)


B. Recovering from a broken installation
    Unfortunately, Feature Install (the facility that Netscape uses to install the VAC 3.6.5 product) is not very forgiving if an installation
    is prematurely aborted. If you unsuccessfully attempt to reinstall, consider these steps for recovery before attempting a new installation :
1.) Open \OS2\INSTALL\FI.INI and remove all blocks:

    Object=(
        ...
        InstalledOn=...
        ...
    	TopObject=...
    )

    that list a "TopObject" of ...ROOT... (for a failed initial VAC 3.6.5 installation) or ...PPAK... (for a failed Fixpak installation)
    You can also check the "InstalledOn" installation date.

2.) Remove any "PPAK_FI" Feature installation objects (and subobjects) from the following directories:
    \OS2\INSTALL
    \OS2\INSTALL\Installed Features

    Info: Feature installation objects look like "blue parcels with red wrapper" (but physically they are nothing more than directories in the filesystem)

3.) for the installation itself "Feature installer" will use Netscape as its installation utility (no matter what). Make sure that you have
    Netscape (4.6) installed and running on your system. Make also sure that you place the "Feature Installer Plugin" (npfi.dll) into
    the Netscape PLUGIN folder

4.) Remove directory \NETQOS2 and all of its contents before reattempting installation

5.) Remove root directory of the VAC 3.6.5 installation and all of its contents before reattempting installation

6.) When you hit the page that asks for Drive and directories for VAC 3.6.5 and the OS/2 Toolkit, enter or reenter something in these fields even when
    you want to stick to the suggested values. Entering something in these fields seems to circumvent a bug in NPFI Plugin (the Netscape Feature Install
    plugin) that otherwise leads to a trap at the end of the installation.

7.) BEFORE you start installation, configure Netscape:
    a.) Smart Browsing: Turn off all stuff that is not really necessary as "Activate Related Sites", "Activate Internet keywords" etc.
    b.) Cache: Set "Compare document with internet" to "Never" and clear the Cache
    c.) SmartUpdate: Completely disable/uncheck everything

8.) I have separated the Registration Utility (do you know ART ?) and made it an optional installation feature which is deactivated per default.
    However, when you run the normal installation process (running install.exe from the root of installation) this feature is not visible/selectable.
    However, if you create a FI installation object (see below) you could then activate this feature.


C.  Invoking installation directly through an installation object
    I have reworked and modified PORTAPAK.RSP (on your VAC 3.6.5 installation CD-ROM) so that it can also be used to create an installation object.
    You create an installation object via CLIFI.EXE (it is installed on every OS/2 machine) once you have burned a new CD-ROM from the original
    CD-ROM and these patches.

    For what follows, assume this:
    a.) your CD-ROM is drive V:
    b.) you want VAC 3.6.5 installed to drive D: and directory IBMC365
    c.) you want the OS/2 toolkit installed to drive E: and directory TOOLKIT

    echo /O:ROOT >parms.txt
    echo /SET:InstDrv1=D: >> parms.txt
    echo /SET:InstDrv2=E: >> parms.txt
    echo /SET:InstDir1=IBMC365 >> parms.txt
    echo /SET:InstDir2=TOOLKIT >> parms.txt
    echo /SET:PackagedFromPath=V:\COMPILER >> parms.txt
    echo /SET:ImageMediaPath=V:\COMPILER >>parms.txt
    echo /R:V:\COMPILER\PORTAPAK.RSP >>parms.txt
    echo /S:V:\COMPILER >>parms.txt

    clifi.exe /A:B /F:"<WP_DESKTOP>" /PARMS:parms.txt

    The installation object is created on your desktop. If you open it you can select/deselect the individual features to install. After installation
    you can either delete the object or keep it around somewhere if you want to install later on.
    During installation, you are asked to specify the "Source Media": just reenter the path: V:\COMPILER
