Installation instructions

Basic Installation

Unzip and de-tar the distribution file as follows: 
        tar xzf metameme-3.3.arch.tar.gz
or 
        gunzip metameme-3.3.arch.tar.gz
        tar xf metameme-3.3.arch.tar

This will expand the Meta-MEME files into a directory named 'metameme_3.3'. If you have downloaded a binary distribution you will find the compiled components of Meta-MEME in the bin subdirectory.

You will need to add the Meta-MEME bin directory to your path. If you use 'csh' add the following lines to your .cshrc or .login file

        set path = ($path install-path/bin)
If you use 'sh' or 'bash' add the following lines to your .profile or .bash_profile file: 
        PATH=$PATH:install-path/bin
        export PATH
In both cases 'install-path' is the path to the directory where you installed Meta-MEME).

If you have downloaded a source only distribution you will need to configure and build the program. Configure the installation using the commands:

cd metameme_3.3
./configure --enable-metameme --prefix=<directory>
where <directory> is the path to where you want Meta-MEME to be installed. If you omit the --prefix argument Meta-MEME will be installed to /usr/local.

Once you have configured the installation you can build and install Meta-MEME using the commands:

make
make test
make install
'make' compiles the Meta-MEME software, 'make check' tests basic Meta-MEME functionality to see if the build was successful, and 'make install' copies the Meta-MEME components to the directory specified in the configuration step. The command 'make uninstall' will remove the Meta-MEME components from the installation directory and the command 'make clean' will remove compiled files from the build directory.

Advanced Installation Options

Using An Alternate Compiler

Meta-MEME prefers the 'gcc' compiler. If this compiler is not available on your system, you can specify that a different compiler should be used by passing a CC argument to 'configure'. For example: 
./configure CC=c89 --enable-metameme --prefix=/opt/meta-meme

Supporting Multiple Architectures

If you wish to support Meta-MEME on multiple processor architectures from a single directory tree you can use the --exec-prefix option of configure. Processor architecture specific files will be put in the directory specified by the --exec-prefix. For example, if you were building Meta-MEME for Linux on a 686 processor, you would used the command: 
./configure --enable-metameme --prefix=/opt/meta-meme --exec-prefix=/opt/meta-meme/Linux686
This would place common files in the directory /opt/meta-meme while the processor dependent files would be installed to /opt/meta-meme/Linux686.

Installing the Meta-MEME Web Application

The Meta-MEME distribution includes an optional Perl CGI web application. These files are not built or installed by default. To install the web components configure the build with the command: 
./configure --enable-metameme --prefix=<directory> --enable-web[=<web directory>] \
           [--with-url=<url>] \
           [--with-contact=<contact>] \
           [--with-perl-shebang=<perl path>]
The --enable-web argument turns on building of the web application. The optional web directory argument specifies where the web application should be installed to. The default is the web subdirectory of the Meta-MEME directory. The optional --with-url argument specifies the root URL of the web application. This defaults to http://localhost/meta-meme. The optional --contact arugment specifies the email address of the administrator for the web appications. This defaults to webmaster@`hostname`. The optional --with-perl-shebang argument allows you to specify the path to the version of Perl the application should use. This defaults to /usr/bin/perl

Once you have run the configure command make and make install will include the web applications components in the build and installation. After the web application is installed you will need to configure your web server to serve the web pages in the htdocs subdirectory, and to enable CGI in the htdocs/cgi-bin subdirectory.

Meta-MEME has been tested on SunOS, Solaris, DEC Alpha and SGI Irix systems. All Meta-MEME code is written in ANSI C and should easily port to other systems. If you have any problems installing or using Meta-MEME, please don't hesitate to send email to cegrant@u.washington.edu.

Author: William Stafford Noble.