INSTALL(1)            User Contributed Perl Documentation           INSTALL(1)




       UMLS-Similarity

TTEESSTTIINNGG PPLLAATTFFOORRMMSS
       UMLS-Interface has been developed and tested on Linux and Solaris,
       primarily using Perl and the C shell (csh).

RREEQQUUIIRREEMMEENNTTSS
       UMLS-Interface REQUIRES that the following software be installed.  More
       details on how to obtain and install appear below.

       --Programming Languages Perl (version 5.8.5 or better)

       --CPAN modules UMLS::Interface

PPRROOGGGGRRAAMMMMIINNGG LLAANNGGUUAAGGEESS
   PPeerrll ((vveerrssiioonn 55..88..55 oorr bbeetttteerr))
       Perl is freely available at:

       <http://www.perl.org>

       It is very likely that you will already have Perl installed if you are
       using a Unix/Linux based system.

CCPPAANN MMOODDUULLEESS
   UUMMLLSS--IInntteerrffaaccee
       Please see the UMLS-Interface documentation.

IINNSSTTAALLLLAATTIIOONN
       If you have supervisor access, or have configured MCPAN for local
       install, you can install via:

        perl -MCPAN -e shell
        > install UMLS-Similarity

       If not, you can, "manually" install by downloading the *.tar.gz file,
       unpacking, and executing the following commands.

                       perl Makefile.PL PREFIX=/home/programs LIB=/home/lib
                       make
                       make test
                       make install

       Note that the PREFIX and LIB settings are just examples to help you
       create a local install, if you do not have supervisor (su) access.

       You must include /home/lib in your PERL5LIB environment variable to
       access this module when running.

       If you have the super-user access, then you can install UMLS-Similarity
       into system directories via :

                       perl Makefile.PL
                       make
                       make install
                       make clean

       The exact location of where UMLS-Similarity will be installed depends
       on your system configuration. A message will be printed out after ’make
       install’ telling your exactly where it was installed.

UUSSIINNGG vveeccttoorr..ppmm
       The vector measure is in a pre-beta stage at this point. It requires
       the BerkelyDB which I apologize because after installing the UMLS into
       MySQL the last thing you really want to do is install another database.
       This shouldn’t be as painful and I promise to work on getting this
       updated so you will no longer be required to do this.

       You can download BerkleyDB from here:

       <http://www.oracle.com/technology/software/products/berkeley-db/index.html>

       You can either chose the encripted or non-encripted version. I chose
       the non-ensripted because it was smaller. I am using linux (ubuntu to
       be specific) so I downloaded the following file:

                 Berkeley DB 4.7.25NC.tar.gz

       Extract the package using gunzip and tar

                 % gunzip db-4.7.25.NC.tar.gz
                 % tar -xf db-4.7.25.NC.tar

       In the directory, there is a file called doc/index.html which has the
       installation instructions. I installed it using the following steps and
       series of commands:

                 %  cd build_unix
                 %  ../dist/configure
                 %  make
                 %  sudo make install

       Next, download the BerkleyDB.pm module from CPAN:

       <http://search.cpan.org/dist/BerkeleyDB/>

       The installation directions are in the README. Below are the steps and
       commands that I used to install the package.

       Extract the package using gunzip and tar      % gunzip
       BerkeleyDB-0.38.tar.gz      % tar -xf BerkeleyDB-0.38.tar

       In the BerkeleyDB-0.38 directory, you are going to have to modify the
       config.in file.

       First, change the path of the INCLUDE variable to point to the
       directory where db.h is installed. For example:

               INCLUDE = /home/bridget/programs/db-4.7.25.NC/build_unix

       Second, change the path of the LIB veriable to point to the directory
       where the libdb is installed. For example:

               LIB     = /home/bridget/programs/db-4.7.25.NC/build_unix

       Then continue on with the typical perl module install:

              % perl Makefile.PL
              % make
              % sudo make install

       Theoretically, that should do it. As I said before this is the beta
       version so in the near future these additional steps will not be
       necessary to use the vector measure module.

       To use this method you will need to specify the --dbfile option, which
       is BerkleyDB file that contains the vector information. If you need a
       test file for this please email me at: bthomson@cs.umn.edu

CCOONNTTAACCTT UUSS
       If you have any trouble installing and using UMLS-Interface, please
       contact us via the users mailing list :

       umls-similarity@yahoogroups.com

       You can join this group by going to:

       <http://tech.groups.yahoo.com/group/umls-similarity/>

       You may also contact us directly if you prefer :

        Bridget T. McInnes: bthomson at cs.umn.edu
        Ted Pedersen      : tpederse at d.umn.edu



perl v5.10.0                      2009-10-30                        INSTALL(1)
