< install >      
 PTF install guide



Step 1: install libprelude and libpreludedb

Follow instructions given on the libpreludedb page (see the local copy if the original is unavailable).

Basically, you just need the libprelude and libpreludedb modules. Decide where will the final installation directory be, and do:

export DEST=/your/install/dir
export PATH=$PATH:$DEST/bin

If you're installing it to coexist on the system with your 0.8.x Prelude installation, make sure DEST points to a different installation directory than 0.8.x. In each of the modules you get from CVS (that is, for libprelude and libpreludedb at least), you need to do:

./autogen.sh
./configure --prefix $DEST
make
make install

If you see any error messages, you'll have to read some more on the source build process basics.

Step 2: obtain PTF

Go to the main page and follow one of the download links, for the CVS (development) or stable versions. Actually, since no releases are available, the CVS is your only option. Create a temporary directory and follow the CVS link for instructions.

Actually, you'll only have to do something like this:

cvs -z3 -d:pserver:anonymous@cvs.ptf.sarovar.org:/cvsroot/ptf co ptf

And the PTF will appear under the ptf/ directory.

Step3: install needed Perl modules

see the README for a list of modules you'll need to install (click on the first "download" you see there, and then read the section titled Non-standard modules, available from CPAN) .

For each CPAN module, you can:

  • install it from your distribution media (if available), or
  • do cpan Module::Name, or
  • download the module source from CPAN manually, then follow its installation instructions.

You will also need some Perl modules which I modified for PTF and are not available from CPAN. You can find all of them under the lib/ directory in the PTF CVS. For the time being, I do not have complete packages ready; that means you'll either have to run ptf directly from the CVS checkout directory, or copy lib/ to your ~/.ptf/.

Step 4: adjust user config file

Switch to the PTF directory and do perl Makefile.PL to be sure you have the appropriate Perl version, and all the required modules are found.

The minimal setup you have to do is tell PTF where your databases are; edit ~/.ptf/dbspec to look like this:

db main mysql%classic.sql~localhost!3306@prelude:prelude/prelude
which specifies the main database. The specification is a piqt-like string with the following meaning:
TYPE  FORMAT  CLS HOST      PORT USER    PWD     DBNAME
mysql%classic.sql~localhost!3306@prelude:prelude/prelude

Where TYPE can be mysql or pgsql, and FORMAT and CLS have no other possible values as nothing else is currently supported by the preludedb layer.

Step 5: run the PTF

For the moment, I did not bother with proper installation routines, so your best chance is to run PTF directly from the checkout directory like this:

perl -I./lib ./ptf


2003-08-05 14:34:22