NAME

setup_dkbench - DKbench Perl CPU Benchmark utility setup script

DESCRIPTION

This is a setup script, part of the Benchmark::DKbench distribution.

Refer to the distribution POD for more information on the DKbench suite:

 perldoc Benchmark::DKbench

SYNOPSIS

Simple setup script to check/get the reference versions of CPAN modules and download the Genbank data file required for the BioPerl benchmarks of the DKbench suite.

 setup_dkbench [options]

 Options:
 --sudo   : Will use sudo for cpanm calls.
 --force  : Will install reference CPAN module versions and re-download the genbank data.
 --test   : Will run the test suites for the CPAN module (default behavior is to skip).
 --data=s : Data dir path to copy files from. Should not need if you installed DKbench.
 --help   : Print this help text and exit.

If you don't match the recommended Perl and CPAN module versions, the benchmarks may show 'Fail' under Pass/Fail and scores may not be comparable to the baseline. This might be perfectly fine for your purposes - in fact it might be intended if you are benchmarking to compare different software instead of hardware.

This installer assumes you have at least cpanm (App::cpanminus) already installed. If not, on must systems you can do that with:

 # System-wide with sudo:
 curl -L https://cpanmin.us | perl - --sudo App::cpanminus

 # Locally or system-wide when root
 curl -L https://cpanmin.us | perl - App::cpanminus

You will also need to have a build enviroment set up (compiler, make etc). If you want to add a couple of optional BioPerl bencharks you'd want an XML library in addition. Example commands to have everything you might need installed with the most popular pqckage managers (run as root or with sudo):

 # Debian/Ubuntu etc
 apt-get update
 apt-get install wget build-essential perl cpanminus libxml-simple-perl

 # CentOS/Redhat
 yum update
 yum install wget gcc make patch perl perl-App-cpanminus perl-XML-LibXML perl-XML-Parser

The above will have you ready for using the default (system) perl. If you want to specifically install the reference perl version for this suite (currently 5.36.0), the simplest way is using perlbrew (no need for root/sudo):

 \curl -L https://install.perlbrew.pl | bash
 source ~/perl5/perlbrew/etc/bashrc
 perlbrew install perl-5.36.0 -n -j 4
 perlbrew use perl-5.36.0
 perlbrew install-cpanm

Note that the suite can be installed to as low as perl 5.12, however if you have a perl version lower than 5.14 make sure you install IO::Socket::IP 0.41 or lower first:

 cpanm -n http://cpan.metacpan.org/authors/id/P/PE/PEVANS/IO-Socket-IP-0.41.tar.gz

Some benchmarks will report failure on "ancient" Perls.