Installation
     
  1. System Requirements

    2.  
  2. Software Pre-requisites

    3.  
  3. Installing the Binary package

    4.  
  4. Installing the Source package

    5.  
  5. Installing on an unsupported platform

 

System Requirements

Platform
This version of VSLDAP has been developed to operate with the Linux operating system (versions 2.2+) on Pentium-class PCs. The pre-built binary libraries and executable files provided are for use with such a system. Support can only be formally provided for VSLDAP when being used on this platform.

The test suite should run on most up-to-date Linux and UNIX systems. If you wish to use VSLDAP on a system other than Linux then you must use the source code of VSLDAP (included) to build new native libraries and executables.

The TETware component is available as a binary release for various other platforms as a trial product with a 90 day license. If you wish to attempt to use VSLDAP on an unsupported platform you will have to obtain the relevant TETware package and also a copy of the Netscape SDK library for your system. Should you attempt this, we will interested to hear of your experiences.

Disk Space
The VSLDAP package requires approximately 10MB of disk space.

Runtime Overhead
Execution of tests requires a Java execution environment which may require (typically) around 10-20MB of system memory.
 


 
Software Pre-requisites
  • JAVA Development Kit (JDK) Version 1.2 or later.

    Note that for Linux systems the JDK is likely to require libc version 2.1.2 or later.
    VSLDAP has been developed with the Blackdown JDK version 1.3.1


    •  
  • Bourne shell or similar for command line operation.

    •  
  • gzip - the GNU zip compression utility.

    •  
  • tar - the file archive utility.

    •  
  • A C compiler capable of generating shared object libraries (dynamic libraries). e.g. gcc. This is only required for building the test suite from the source code.

    •  
  • make - the software maintenance utility. This is only required for building the test suite from the source code.

    •  

     

    Installing the Binary package

    This is the standard way to install VSLDAP on Linux.

    If you are planning to install VSLDAP on an unsupported platform then please read the section below 'Installing the Source package'.

    The package will be a file named vsldap_[bin|src]_linux-x.y.tar.gz where x.y will be the release version of the test suite. This is a gzipped tar file.

    Place the distribution file in a working directory of your choice. Unzip this file using gzip.
    Extract the files from the tar archive, e.g.
    tar xvf vsldap_src_linux-x.y.tar

    This will create two directories: TETware/ and vsldap/.

    TETware/ contains a stand-alone version of the TETware system.
    vsldap/ contains the data, libraries and tests specific to VSLDAP.

    Environment Variables

     
  • TETware requires some environment variables to be set in the shell from which you will execute test runs.

    • TET_ROOT: Set this to the pathname of the TETware directory
    TET_SUITE_ROOT: Set this to the pathname of the vsldap/ directory.

    Example (Bourne shell). If you have extracted the package in /home/test then set:

    TET_ROOT=/home/test/TETware
    TET_SUITE_ROOT=/home/test/vsldap

    Ensure that these variables are exported to the environment for use by any program that is called from your shell. e.g:
    export TET_ROOT TET_SUITE_ROOT
     

  • Add $TET_ROOT/bin to your executable search PATH.

    • e.g. PATH=${PATH}:${TET_ROOT}/bin
    export PATH
     
  • Add the following paths to the LD_LIBRARY_PATH, which specifies the directories to be searched by the dynamic library loader:

    • $TET_ROOT/lib/tet3, $TET_SUITE_ROOT/lib and $TET_SUITE_ROOT/sdk/netscape40/lib

    e..g. LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${TET_ROOT}/lib/tet3:${TET_SUITE_ROOT}/lib:${TET_SUITE_ROOT}/sdk/netscape40/lib

    export LD_LIBRARY_PATH
     

  • Set the Java CLASSPATH to include the path of the TETware jet.jar and vsldap.jar file: CLASSPATH=${CLASSPATH}:${TET_ROOT}/lib/java/jet.jar:${TET_SUITE_ROOT}/lib/vsldap.jar

    • export CLASSPATH


  • Test that TETware is correctly installed, type tcc -V

    • You should see:
    tcc: TETware-Lite Release 3.4

    If not, you have a problem. Check that the environment variables are set correctly. If they are, check that the tcc binary exists in the TETware/bin directory.

    Test the VSLDAP operation environment by typing:

    tcc -bec -s ldap-certified-base.scn . intest

    Check the indicated journal file (in vsldap/results) to ensure that no errors were reported.


    Binary installation is now complete. You are now ready to use VSLDAP.
     
     


     

    Installing the Source package

  • Follow the procedure described in `Installing the Binary Package' for unpacking the software and setting up the runtime environment variables.

    The (binary) TETware package needs no further installation beyond this stage.


    •  
  • Set up the development environment as follows:

  • Create an environment variable `JDK' and set the value to the path of your system's JDK. The JDK directory must contain the necessary include/ header files. For example, if the JDK is installed in /usr/local/java, then set (Bourne shell example)

    • JDK=/usr/local/java
    export JDK
     

  • Add the directory $TET_SUITE_ROOT/.. (the parent of vsldap/)  to your CLASSPATH. e.g:

    • CLASSPATH=${CLASSPATH}:${TET_SUITE_ROOT}/..
    export CLASSPATH
     
     

  • To build VSLDAP, cd to the vsldap/ directory (i.e $TET_SUITE_ROOT) and run the `build' program in the bin/ directory.

    •  
  • Test the build by running tcc with the following options (as with binary installation):

    •  

    tcc -bec -s ldap-certified-base.scn . intest

    Check the indicated journal file (in vsldap/results) to ensure that no errors were reported.


    Source installation and build is now complete. You are now ready to use VSLDAP.


     


     

    Installing on an unsupported platform

    VSLDAP is known to work on several variations of the supported system and others, for example:

    More recent Java virtual machines may offer 'classic' or 'hotspot' modes. If Hotspot-related problems occur when running vsldap, try using java in classic mode. This can be done for supporting JVMs by adding the '-classic' option to the java execution line in the main tetexec.cfg file. This is the final line of the file and looks like this:
    TET_EXEC_TOOL=${TET_ROOT}/bin/jet-exec
    To pass arguments to java, add them to the end of this line, e.g:
    TET_EXEC_TOOL=${TET_ROOT}/bin/jet-exec -classic

    If you plan to install VSLDAP on a UNIX or Linux-like system then there are several steps that must be taken:

    1. Since TETware is only provided with a binary license you must acquire a binary TETware distribution for your system.

      The TETware component is available as a binary release for various platforms as a trial product with a 90 day license. If you wish to attempt to use VSLDAP on an unsupported platform you will have to obtain the relevant TETware package.


    2. VSLDAP uses a C library back-end for basic LDAP functionality. This is provided in the supported version by the Netscape Directory SDK. This (SDK v4) is provided on a binary license and as with TETware you must acquire a binary copy of the SDK for your platform. These are available from Sun/iPlanet

      ensure that you get the version with SSL support

      Install the SDK library and headers in the $TET_SUITE_ROOT/sdk/netscape40 directory, replacing the native linux files in inc/ and lib/.


    3. Ensure that you satisfy the Software Pre-requisites for your target system.


    4. Procede with the standard installation

     
    Contents << Prev Next >>

      VSLDAP User Guide.  Release 2.3 GA, February 2007.

    Copyright ©  2007 The Open Group
    All rights reserved.