Install query_contents on UNIX-based Web servers

The following steps describe the installation of query_contents on back-end UNIX-based Web servers.

Steps

  1. In the LMI, go to Web > Tools > Query Site Contents to locate the shell script named query_contents.sh.

  2. Ensure the back-end Web server has a CGI directory correctly configured.

  3. For testing purposes, ensure that a valid document exists in the document root of the back-end Web server.

  4. Copy query_contents.sh into a functioning cgi-bin directory on the back-end Web server. Consult the appropriate documentation for the Web server to identify the location of this directory.

  5. Specify query_contents.sh as the correct file name for WebSEAL to use using the -q location option when creating a junction to the back-end Web server.

    The -q location option and argument provides WebSEAL with the correct name of the file and where to find the file. For example, assuming other options are additionally selected ):

      pdadmin> server task default-webseald-www.example.com create -t tcp -h host-name <...> -q /cgi-bin/query_contents.sh /junction-name

    The location argument value is used in the actual URL string that calls the query_contents program. For example:

      http://unix-machine-name/cgi-bin/query_contents.sh?dirlist=/

  6. Manually edit the script file to correctly specify the document root directory.

    Change the value of the DOCROOTDIR variable (default is /usr/local/html) to the document root of the back-end Web server. For example (IBM HTTP Server, version 6.0): 

      ADD_TO_ROOT=
DOCROOTDIR=/opt/IBMIHS/htdocs
#ADD_TO_ROOT="cgi-bin//"

        The blank ADD_TO_ROOT line is required for the variable initialization.

        Additionally, if the back-end Web server's cgi-bin directory is not located below the document root on the Web server's file system, uncomment the line for the ADD_TO_ROOT variable. For example: 

          ADD_TO_ROOT=
DOCROOTDIR=/opt/IBMIHS/htdocs
ADD_TO_ROOT="cgi-bin//"

      • Set the UNIX execute bit for the administration account of the back-end Web server.

Parent topic: How to generate a back-end server Web space (query_contents)