A Basic Guide To Installing and Running the HLT (Human Language Technology) Demo System

Part I. Server Installation

In order to compile and run the demo code, we first need to make sure the necessary dependencies are available. The first step would be to compile and install the production and prototype system. The following instructions can be used to install the production system (under the assumption that the user already has an environment setup and has a local repository):

    cd $ISIP_DEVEL/ (Note: case sensitive)
    cvs update -P -d . (To make sure the local repository is uptodate with the main repository.)
    ./configure --with-sphere=/cavs/hse/ies/isip/common/local/sphere --with-audiofile=/cavs/hse/ies/isip/common/local/audiofile --with-communicator=/cavs/hse/ies/isip/common/local/communicator --with-communicator-include=/cavs/hse/ies/isip/common/local/communicator/include --with-communicator-libdir=/cavs/hse/ies/isip/common/local/communicator/lib/x86-linux --with-sctk=/cavs/hse/ies/isip/common/local/sctk (Configure the repository.)

Once the repository is configured, an ISIP_BASE_ENV.sh file will be created under $ISIP_DEVEL. As the demo system will need some external libraries to compile, make sure the EXTRA_LIBS and EXTRA_INCLUDE in the file have the following:

    EXTRA_LIBS="-L/cavs/hse/ies/isip/common/local/audiofile/lib -laudiofile -L/cavs/hse/ies/isip/common/local/sphere/lib -lsp -lutil -L/cavs/hse/ies/isip/common/local/communicator/lib/x86-linux -lGalaxy -L -lexpat -L$ISIP_LIB_DIR -l_dialog_parse -l_dialog_dm -l_dialog_widget -L/usr/local/mysql/lib -lmysqlclient -lz -lcrypt -lm";

    EXTRA_INCLUDE="-I/cavs/hse/ies/isip/common/local/audiofile/include -I/cavs/hse/ies/isip/common/local/sphere/include -I/cavs/hse/ies/isip/common/local/communicator/include -I/usr/local/mysql/include";

In order to compile and install the production system type:

    source $ISIP_DEVEL/ISIP_BASE_ENV.sh
    make install

To install the prototype system:

    cd $ISIP_DEVEL/util/speech/proto
    ./configure     (configure the system)
    source $ISIP_DEVEL/util/speech/proto/ISIP_ENV.sh
    make install

Now, both the production system and the prototype system have been compiled and installed. Goto,

    cd $ISIP_DEVEL/util/demo
    source $ISIP_DEVEL/ISIP_BASE_ENV.sh
    source $ISIP_DEVEL/util/speech/proto/ISIP_ENV.sh     (to make sure both the production and the prototype system are sourced)
    make install

Once the above processes are completed the demo system has been sucessfully compiled. The demo code consists of the clients and the servers. The servers run computationally intensive tasks on the linux boxes while the clients which basicallyuser interfaces run on laptops. To run the servers:

    cd $ISIP_DEVEL/util/demo/isip_comm_server_process_manager
    ./isip_process_manager.sh

The above command will run the process manager that will wait for communication from any client program and start the necessary servers needed for the client program.

In order to run the client, download the demo.msi from the following link:

Once the demo.msi is downloaded, click it and follow the steps to finish the installation. Before you can run the demo.msi, make sure you have installed java and galaxy communicator. You have to supply the installation paths for java and galaxy communicator during the client installation process. Once the client is installed successfully, go to start->All Programs>Speech Demonstrations to start the demo. You can choose among the four different demos available on the HLT system.